Debian Codegraph @

Lib/test/test_pwd.py

raw
1 import random
2 import string
3 import sys
4 import unittest
5 from test.support import import_helper
6
7 pwd = import_helper.import_module('pwd')
8
9 @unittest.skipUnless(hasattr(pwd, 'getpwall'), 'Does not have getpwall()')
10 class PwdTest(unittest.TestCase):
11
12 def test_values(self):
13 entries = pwd.getpwall()
14
15 for e in entries:
16 self.assertEqual(len(e), 7)
17 self.assertEqual(e[0], e.pw_name)
18 self.assertIsInstance(e.pw_name, str)
19 self.assertEqual(e[1], e.pw_passwd)
20 self.assertIsInstance(e.pw_passwd, str)
21 self.assertEqual(e[2], e.pw_uid)
22 self.assertIsInstance(e.pw_uid, int)
23 self.assertEqual(e[3], e.pw_gid)
24 self.assertIsInstance(e.pw_gid, int)
25 self.assertEqual(e[4], e.pw_gecos)
26 self.assertIn(type(e.pw_gecos), (str, type(None)))
27 self.assertEqual(e[5], e.pw_dir)
28 self.assertIsInstance(e.pw_dir, str)
29 self.assertEqual(e[6], e.pw_shell)
30 self.assertIsInstance(e.pw_shell, str)
31
32 # The following won't work, because of duplicate entries
33 # for one uid
34 # self.assertEqual(pwd.getpwuid(e.pw_uid), e)
35 # instead of this collect all entries for one uid
36 # and check afterwards (done in test_values_extended)
37
38 def test_values_extended(self):
39 entries = pwd.getpwall()
40 entriesbyname = {}
41 entriesbyuid = {}
42
43 if len(entries) > 1000: # Huge passwd file (NIS?) -- skip this test
44 self.skipTest('passwd file is huge; extended test skipped')
45
46 for e in entries:
47 entriesbyname.setdefault(e.pw_name, []).append(e)
48 entriesbyuid.setdefault(e.pw_uid, []).append(e)
49
50 # check whether the entry returned by getpwuid()
51 # for each uid is among those from getpwall() for this uid
52 for e in entries:
53 if not e[0] or e[0] == '+':
54 continue # skip NIS entries etc.
55 self.assertIn(pwd.getpwnam(e.pw_name), entriesbyname[e.pw_name])
56 self.assertIn(pwd.getpwuid(e.pw_uid), entriesbyuid[e.pw_uid])
57
58 def test_errors(self):
59 self.assertRaises(TypeError, pwd.getpwuid)
60 self.assertRaises(TypeError, pwd.getpwuid, 3.14)
61 self.assertRaises(TypeError, pwd.getpwuid, 0.0)
62 self.assertRaises(TypeError, pwd.getpwuid, 0, 0)
63 # should be out of uid_t range
64 self.assertRaises(KeyError, pwd.getpwuid, 2**128)
65 self.assertRaises(KeyError, pwd.getpwuid, -2**128)
66 self.assertRaises(TypeError, pwd.getpwnam)
67 self.assertRaises(TypeError, pwd.getpwnam, 42)
68 self.assertRaises(TypeError, pwd.getpwnam, b'root')
69 self.assertRaises(TypeError, pwd.getpwnam, 'root', 0)
70 # embedded null character
71 self.assertRaisesRegex(ValueError, 'null', pwd.getpwnam, 'a\x00b')
72 self.assertRaisesRegex(ValueError, 'null', pwd.getpwnam, 'root\x00')
73 self.assertRaises(UnicodeEncodeError, pwd.getpwnam, 'roo\udc74')
74 self.assertRaises(KeyError, pwd.getpwnam, '')
75 self.assertRaises(TypeError, pwd.getpwall, 42)
76
77 # Find a non-existent user name.
78 # getpwall() will not necessarily report all existing users
79 # (typical for LDAP based directories in big organizations).
80 for _ in range(30):
81 fakename = ''.join(random.choices(string.ascii_lowercase, k=6))
82 try:
83 pwd.getpwnam(fakename)
84 except KeyError:
85 break
86 else:
87 self.fail('Cannot find non-existent user name')
88
89 # Find a non-existent uid.
90 maxuid = max(e.pw_uid for e in pwd.getpwall())
91 if maxuid < 2**15:
92 maxuid = 2**15
93 elif maxuid < 2**16:
94 maxuid = 2**16-1
95 else:
96 maxuid = 2**31
97 for _ in range(30):
98 fakeuid = random.randrange(maxuid)
99 try:
100 pwd.getpwuid(fakeuid)
101 except KeyError:
102 break
103 else:
104 self.fail('Cannot find non-existent uid')
105
106 # On Cygwin, getpwuid(-1) returns 'Unknown+User' user
107 if sys.platform != 'cygwin':
108 # -1 shouldn't be a valid uid because it has a special meaning in many
109 # uid-related functions
110 self.assertRaises(KeyError, pwd.getpwuid, -1)
111
112
113 if __name__ == "__main__":
114 unittest.main()