test_uuid.py 40 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899
  1. import unittest
  2. from test import support
  3. from test.support import import_helper
  4. import builtins
  5. import contextlib
  6. import copy
  7. import enum
  8. import io
  9. import os
  10. import pickle
  11. import sys
  12. import weakref
  13. from unittest import mock
  14. py_uuid = import_helper.import_fresh_module('uuid', blocked=['_uuid'])
  15. c_uuid = import_helper.import_fresh_module('uuid', fresh=['_uuid'])
  16. def importable(name):
  17. try:
  18. __import__(name)
  19. return True
  20. except:
  21. return False
  22. def mock_get_command_stdout(data):
  23. def get_command_stdout(command, args):
  24. return io.BytesIO(data.encode())
  25. return get_command_stdout
  26. class BaseTestUUID:
  27. uuid = None
  28. def test_safe_uuid_enum(self):
  29. class CheckedSafeUUID(enum.Enum):
  30. safe = 0
  31. unsafe = -1
  32. unknown = None
  33. enum._test_simple_enum(CheckedSafeUUID, py_uuid.SafeUUID)
  34. def test_UUID(self):
  35. equal = self.assertEqual
  36. ascending = []
  37. for (string, curly, hex, bytes, bytes_le, fields, integer, urn,
  38. time, clock_seq, variant, version) in [
  39. ('00000000-0000-0000-0000-000000000000',
  40. '{00000000-0000-0000-0000-000000000000}',
  41. '00000000000000000000000000000000',
  42. b'\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0',
  43. b'\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0',
  44. (0, 0, 0, 0, 0, 0),
  45. 0,
  46. 'urn:uuid:00000000-0000-0000-0000-000000000000',
  47. 0, 0, self.uuid.RESERVED_NCS, None),
  48. ('00010203-0405-0607-0809-0a0b0c0d0e0f',
  49. '{00010203-0405-0607-0809-0a0b0c0d0e0f}',
  50. '000102030405060708090a0b0c0d0e0f',
  51. b'\0\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\x0d\x0e\x0f',
  52. b'\x03\x02\x01\0\x05\x04\x07\x06\x08\t\n\x0b\x0c\x0d\x0e\x0f',
  53. (0x00010203, 0x0405, 0x0607, 8, 9, 0x0a0b0c0d0e0f),
  54. 0x000102030405060708090a0b0c0d0e0f,
  55. 'urn:uuid:00010203-0405-0607-0809-0a0b0c0d0e0f',
  56. 0x607040500010203, 0x809, self.uuid.RESERVED_NCS, None),
  57. ('02d9e6d5-9467-382e-8f9b-9300a64ac3cd',
  58. '{02d9e6d5-9467-382e-8f9b-9300a64ac3cd}',
  59. '02d9e6d59467382e8f9b9300a64ac3cd',
  60. b'\x02\xd9\xe6\xd5\x94\x67\x38\x2e\x8f\x9b\x93\x00\xa6\x4a\xc3\xcd',
  61. b'\xd5\xe6\xd9\x02\x67\x94\x2e\x38\x8f\x9b\x93\x00\xa6\x4a\xc3\xcd',
  62. (0x02d9e6d5, 0x9467, 0x382e, 0x8f, 0x9b, 0x9300a64ac3cd),
  63. 0x02d9e6d59467382e8f9b9300a64ac3cd,
  64. 'urn:uuid:02d9e6d5-9467-382e-8f9b-9300a64ac3cd',
  65. 0x82e946702d9e6d5, 0xf9b, self.uuid.RFC_4122, 3),
  66. ('12345678-1234-5678-1234-567812345678',
  67. '{12345678-1234-5678-1234-567812345678}',
  68. '12345678123456781234567812345678',
  69. b'\x12\x34\x56\x78'*4,
  70. b'\x78\x56\x34\x12\x34\x12\x78\x56\x12\x34\x56\x78\x12\x34\x56\x78',
  71. (0x12345678, 0x1234, 0x5678, 0x12, 0x34, 0x567812345678),
  72. 0x12345678123456781234567812345678,
  73. 'urn:uuid:12345678-1234-5678-1234-567812345678',
  74. 0x678123412345678, 0x1234, self.uuid.RESERVED_NCS, None),
  75. ('6ba7b810-9dad-11d1-80b4-00c04fd430c8',
  76. '{6ba7b810-9dad-11d1-80b4-00c04fd430c8}',
  77. '6ba7b8109dad11d180b400c04fd430c8',
  78. b'\x6b\xa7\xb8\x10\x9d\xad\x11\xd1\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  79. b'\x10\xb8\xa7\x6b\xad\x9d\xd1\x11\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  80. (0x6ba7b810, 0x9dad, 0x11d1, 0x80, 0xb4, 0x00c04fd430c8),
  81. 0x6ba7b8109dad11d180b400c04fd430c8,
  82. 'urn:uuid:6ba7b810-9dad-11d1-80b4-00c04fd430c8',
  83. 0x1d19dad6ba7b810, 0xb4, self.uuid.RFC_4122, 1),
  84. ('6ba7b811-9dad-11d1-80b4-00c04fd430c8',
  85. '{6ba7b811-9dad-11d1-80b4-00c04fd430c8}',
  86. '6ba7b8119dad11d180b400c04fd430c8',
  87. b'\x6b\xa7\xb8\x11\x9d\xad\x11\xd1\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  88. b'\x11\xb8\xa7\x6b\xad\x9d\xd1\x11\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  89. (0x6ba7b811, 0x9dad, 0x11d1, 0x80, 0xb4, 0x00c04fd430c8),
  90. 0x6ba7b8119dad11d180b400c04fd430c8,
  91. 'urn:uuid:6ba7b811-9dad-11d1-80b4-00c04fd430c8',
  92. 0x1d19dad6ba7b811, 0xb4, self.uuid.RFC_4122, 1),
  93. ('6ba7b812-9dad-11d1-80b4-00c04fd430c8',
  94. '{6ba7b812-9dad-11d1-80b4-00c04fd430c8}',
  95. '6ba7b8129dad11d180b400c04fd430c8',
  96. b'\x6b\xa7\xb8\x12\x9d\xad\x11\xd1\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  97. b'\x12\xb8\xa7\x6b\xad\x9d\xd1\x11\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  98. (0x6ba7b812, 0x9dad, 0x11d1, 0x80, 0xb4, 0x00c04fd430c8),
  99. 0x6ba7b8129dad11d180b400c04fd430c8,
  100. 'urn:uuid:6ba7b812-9dad-11d1-80b4-00c04fd430c8',
  101. 0x1d19dad6ba7b812, 0xb4, self.uuid.RFC_4122, 1),
  102. ('6ba7b814-9dad-11d1-80b4-00c04fd430c8',
  103. '{6ba7b814-9dad-11d1-80b4-00c04fd430c8}',
  104. '6ba7b8149dad11d180b400c04fd430c8',
  105. b'\x6b\xa7\xb8\x14\x9d\xad\x11\xd1\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  106. b'\x14\xb8\xa7\x6b\xad\x9d\xd1\x11\x80\xb4\x00\xc0\x4f\xd4\x30\xc8',
  107. (0x6ba7b814, 0x9dad, 0x11d1, 0x80, 0xb4, 0x00c04fd430c8),
  108. 0x6ba7b8149dad11d180b400c04fd430c8,
  109. 'urn:uuid:6ba7b814-9dad-11d1-80b4-00c04fd430c8',
  110. 0x1d19dad6ba7b814, 0xb4, self.uuid.RFC_4122, 1),
  111. ('7d444840-9dc0-11d1-b245-5ffdce74fad2',
  112. '{7d444840-9dc0-11d1-b245-5ffdce74fad2}',
  113. '7d4448409dc011d1b2455ffdce74fad2',
  114. b'\x7d\x44\x48\x40\x9d\xc0\x11\xd1\xb2\x45\x5f\xfd\xce\x74\xfa\xd2',
  115. b'\x40\x48\x44\x7d\xc0\x9d\xd1\x11\xb2\x45\x5f\xfd\xce\x74\xfa\xd2',
  116. (0x7d444840, 0x9dc0, 0x11d1, 0xb2, 0x45, 0x5ffdce74fad2),
  117. 0x7d4448409dc011d1b2455ffdce74fad2,
  118. 'urn:uuid:7d444840-9dc0-11d1-b245-5ffdce74fad2',
  119. 0x1d19dc07d444840, 0x3245, self.uuid.RFC_4122, 1),
  120. ('e902893a-9d22-3c7e-a7b8-d6e313b71d9f',
  121. '{e902893a-9d22-3c7e-a7b8-d6e313b71d9f}',
  122. 'e902893a9d223c7ea7b8d6e313b71d9f',
  123. b'\xe9\x02\x89\x3a\x9d\x22\x3c\x7e\xa7\xb8\xd6\xe3\x13\xb7\x1d\x9f',
  124. b'\x3a\x89\x02\xe9\x22\x9d\x7e\x3c\xa7\xb8\xd6\xe3\x13\xb7\x1d\x9f',
  125. (0xe902893a, 0x9d22, 0x3c7e, 0xa7, 0xb8, 0xd6e313b71d9f),
  126. 0xe902893a9d223c7ea7b8d6e313b71d9f,
  127. 'urn:uuid:e902893a-9d22-3c7e-a7b8-d6e313b71d9f',
  128. 0xc7e9d22e902893a, 0x27b8, self.uuid.RFC_4122, 3),
  129. ('eb424026-6f54-4ef8-a4d0-bb658a1fc6cf',
  130. '{eb424026-6f54-4ef8-a4d0-bb658a1fc6cf}',
  131. 'eb4240266f544ef8a4d0bb658a1fc6cf',
  132. b'\xeb\x42\x40\x26\x6f\x54\x4e\xf8\xa4\xd0\xbb\x65\x8a\x1f\xc6\xcf',
  133. b'\x26\x40\x42\xeb\x54\x6f\xf8\x4e\xa4\xd0\xbb\x65\x8a\x1f\xc6\xcf',
  134. (0xeb424026, 0x6f54, 0x4ef8, 0xa4, 0xd0, 0xbb658a1fc6cf),
  135. 0xeb4240266f544ef8a4d0bb658a1fc6cf,
  136. 'urn:uuid:eb424026-6f54-4ef8-a4d0-bb658a1fc6cf',
  137. 0xef86f54eb424026, 0x24d0, self.uuid.RFC_4122, 4),
  138. ('f81d4fae-7dec-11d0-a765-00a0c91e6bf6',
  139. '{f81d4fae-7dec-11d0-a765-00a0c91e6bf6}',
  140. 'f81d4fae7dec11d0a76500a0c91e6bf6',
  141. b'\xf8\x1d\x4f\xae\x7d\xec\x11\xd0\xa7\x65\x00\xa0\xc9\x1e\x6b\xf6',
  142. b'\xae\x4f\x1d\xf8\xec\x7d\xd0\x11\xa7\x65\x00\xa0\xc9\x1e\x6b\xf6',
  143. (0xf81d4fae, 0x7dec, 0x11d0, 0xa7, 0x65, 0x00a0c91e6bf6),
  144. 0xf81d4fae7dec11d0a76500a0c91e6bf6,
  145. 'urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6',
  146. 0x1d07decf81d4fae, 0x2765, self.uuid.RFC_4122, 1),
  147. ('fffefdfc-fffe-fffe-fffe-fffefdfcfbfa',
  148. '{fffefdfc-fffe-fffe-fffe-fffefdfcfbfa}',
  149. 'fffefdfcfffefffefffefffefdfcfbfa',
  150. b'\xff\xfe\xfd\xfc\xff\xfe\xff\xfe\xff\xfe\xff\xfe\xfd\xfc\xfb\xfa',
  151. b'\xfc\xfd\xfe\xff\xfe\xff\xfe\xff\xff\xfe\xff\xfe\xfd\xfc\xfb\xfa',
  152. (0xfffefdfc, 0xfffe, 0xfffe, 0xff, 0xfe, 0xfffefdfcfbfa),
  153. 0xfffefdfcfffefffefffefffefdfcfbfa,
  154. 'urn:uuid:fffefdfc-fffe-fffe-fffe-fffefdfcfbfa',
  155. 0xffefffefffefdfc, 0x3ffe, self.uuid.RESERVED_FUTURE, None),
  156. ('ffffffff-ffff-ffff-ffff-ffffffffffff',
  157. '{ffffffff-ffff-ffff-ffff-ffffffffffff}',
  158. 'ffffffffffffffffffffffffffffffff',
  159. b'\xff'*16,
  160. b'\xff'*16,
  161. (0xffffffff, 0xffff, 0xffff, 0xff, 0xff, 0xffffffffffff),
  162. 0xffffffffffffffffffffffffffffffff,
  163. 'urn:uuid:ffffffff-ffff-ffff-ffff-ffffffffffff',
  164. 0xfffffffffffffff, 0x3fff, self.uuid.RESERVED_FUTURE, None),
  165. ]:
  166. equivalents = []
  167. # Construct each UUID in several different ways.
  168. for u in [self.uuid.UUID(string), self.uuid.UUID(curly), self.uuid.UUID(hex),
  169. self.uuid.UUID(bytes=bytes), self.uuid.UUID(bytes_le=bytes_le),
  170. self.uuid.UUID(fields=fields), self.uuid.UUID(int=integer),
  171. self.uuid.UUID(urn)]:
  172. # Test all conversions and properties of the UUID object.
  173. equal(str(u), string)
  174. equal(int(u), integer)
  175. equal(u.bytes, bytes)
  176. equal(u.bytes_le, bytes_le)
  177. equal(u.fields, fields)
  178. equal(u.time_low, fields[0])
  179. equal(u.time_mid, fields[1])
  180. equal(u.time_hi_version, fields[2])
  181. equal(u.clock_seq_hi_variant, fields[3])
  182. equal(u.clock_seq_low, fields[4])
  183. equal(u.node, fields[5])
  184. equal(u.hex, hex)
  185. equal(u.int, integer)
  186. equal(u.urn, urn)
  187. equal(u.time, time)
  188. equal(u.clock_seq, clock_seq)
  189. equal(u.variant, variant)
  190. equal(u.version, version)
  191. equivalents.append(u)
  192. # Different construction methods should give the same UUID.
  193. for u in equivalents:
  194. for v in equivalents:
  195. equal(u, v)
  196. # Bug 7380: "bytes" and "bytes_le" should give the same type.
  197. equal(type(u.bytes), builtins.bytes)
  198. equal(type(u.bytes_le), builtins.bytes)
  199. ascending.append(u)
  200. # Test comparison of UUIDs.
  201. for i in range(len(ascending)):
  202. for j in range(len(ascending)):
  203. equal(i < j, ascending[i] < ascending[j])
  204. equal(i <= j, ascending[i] <= ascending[j])
  205. equal(i == j, ascending[i] == ascending[j])
  206. equal(i > j, ascending[i] > ascending[j])
  207. equal(i >= j, ascending[i] >= ascending[j])
  208. equal(i != j, ascending[i] != ascending[j])
  209. # Test sorting of UUIDs (above list is in ascending order).
  210. resorted = ascending[:]
  211. resorted.reverse()
  212. resorted.sort()
  213. equal(ascending, resorted)
  214. def test_exceptions(self):
  215. badvalue = lambda f: self.assertRaises(ValueError, f)
  216. badtype = lambda f: self.assertRaises(TypeError, f)
  217. # Badly formed hex strings.
  218. badvalue(lambda: self.uuid.UUID(''))
  219. badvalue(lambda: self.uuid.UUID('abc'))
  220. badvalue(lambda: self.uuid.UUID('1234567812345678123456781234567'))
  221. badvalue(lambda: self.uuid.UUID('123456781234567812345678123456789'))
  222. badvalue(lambda: self.uuid.UUID('123456781234567812345678z2345678'))
  223. # Badly formed bytes.
  224. badvalue(lambda: self.uuid.UUID(bytes='abc'))
  225. badvalue(lambda: self.uuid.UUID(bytes='\0'*15))
  226. badvalue(lambda: self.uuid.UUID(bytes='\0'*17))
  227. # Badly formed bytes_le.
  228. badvalue(lambda: self.uuid.UUID(bytes_le='abc'))
  229. badvalue(lambda: self.uuid.UUID(bytes_le='\0'*15))
  230. badvalue(lambda: self.uuid.UUID(bytes_le='\0'*17))
  231. # Badly formed fields.
  232. badvalue(lambda: self.uuid.UUID(fields=(1,)))
  233. badvalue(lambda: self.uuid.UUID(fields=(1, 2, 3, 4, 5)))
  234. badvalue(lambda: self.uuid.UUID(fields=(1, 2, 3, 4, 5, 6, 7)))
  235. # Field values out of range.
  236. badvalue(lambda: self.uuid.UUID(fields=(-1, 0, 0, 0, 0, 0)))
  237. badvalue(lambda: self.uuid.UUID(fields=(0x100000000, 0, 0, 0, 0, 0)))
  238. badvalue(lambda: self.uuid.UUID(fields=(0, -1, 0, 0, 0, 0)))
  239. badvalue(lambda: self.uuid.UUID(fields=(0, 0x10000, 0, 0, 0, 0)))
  240. badvalue(lambda: self.uuid.UUID(fields=(0, 0, -1, 0, 0, 0)))
  241. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0x10000, 0, 0, 0)))
  242. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, -1, 0, 0)))
  243. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, 0x100, 0, 0)))
  244. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, 0, -1, 0)))
  245. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, 0, 0x100, 0)))
  246. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, 0, 0, -1)))
  247. badvalue(lambda: self.uuid.UUID(fields=(0, 0, 0, 0, 0, 0x1000000000000)))
  248. # Version number out of range.
  249. badvalue(lambda: self.uuid.UUID('00'*16, version=0))
  250. badvalue(lambda: self.uuid.UUID('00'*16, version=6))
  251. # Integer value out of range.
  252. badvalue(lambda: self.uuid.UUID(int=-1))
  253. badvalue(lambda: self.uuid.UUID(int=1<<128))
  254. # Must supply exactly one of hex, bytes, fields, int.
  255. h, b, f, i = '00'*16, b'\0'*16, (0, 0, 0, 0, 0, 0), 0
  256. self.uuid.UUID(h)
  257. self.uuid.UUID(hex=h)
  258. self.uuid.UUID(bytes=b)
  259. self.uuid.UUID(bytes_le=b)
  260. self.uuid.UUID(fields=f)
  261. self.uuid.UUID(int=i)
  262. # Wrong number of arguments (positional).
  263. badtype(lambda: self.uuid.UUID())
  264. badtype(lambda: self.uuid.UUID(h, b))
  265. badtype(lambda: self.uuid.UUID(h, b, b))
  266. badtype(lambda: self.uuid.UUID(h, b, b, f))
  267. badtype(lambda: self.uuid.UUID(h, b, b, f, i))
  268. # Duplicate arguments.
  269. for hh in [[], [('hex', h)]]:
  270. for bb in [[], [('bytes', b)]]:
  271. for bble in [[], [('bytes_le', b)]]:
  272. for ii in [[], [('int', i)]]:
  273. for ff in [[], [('fields', f)]]:
  274. args = dict(hh + bb + bble + ii + ff)
  275. if len(args) != 0:
  276. badtype(lambda: self.uuid.UUID(h, **args))
  277. if len(args) != 1:
  278. badtype(lambda: self.uuid.UUID(**args))
  279. # Immutability.
  280. u = self.uuid.UUID(h)
  281. badtype(lambda: setattr(u, 'hex', h))
  282. badtype(lambda: setattr(u, 'bytes', b))
  283. badtype(lambda: setattr(u, 'bytes_le', b))
  284. badtype(lambda: setattr(u, 'fields', f))
  285. badtype(lambda: setattr(u, 'int', i))
  286. badtype(lambda: setattr(u, 'time_low', 0))
  287. badtype(lambda: setattr(u, 'time_mid', 0))
  288. badtype(lambda: setattr(u, 'time_hi_version', 0))
  289. badtype(lambda: setattr(u, 'time_hi_version', 0))
  290. badtype(lambda: setattr(u, 'clock_seq_hi_variant', 0))
  291. badtype(lambda: setattr(u, 'clock_seq_low', 0))
  292. badtype(lambda: setattr(u, 'node', 0))
  293. # Comparison with a non-UUID object
  294. badtype(lambda: u < object())
  295. badtype(lambda: u > object())
  296. def test_getnode(self):
  297. node1 = self.uuid.getnode()
  298. self.assertTrue(0 < node1 < (1 << 48), '%012x' % node1)
  299. # Test it again to ensure consistency.
  300. node2 = self.uuid.getnode()
  301. self.assertEqual(node1, node2, '%012x != %012x' % (node1, node2))
  302. def test_pickle_roundtrip(self):
  303. def check(actual, expected):
  304. self.assertEqual(actual, expected)
  305. self.assertEqual(actual.is_safe, expected.is_safe)
  306. with support.swap_item(sys.modules, 'uuid', self.uuid):
  307. for is_safe in self.uuid.SafeUUID:
  308. u = self.uuid.UUID('d82579ce6642a0de7ddf490a7aec7aa5',
  309. is_safe=is_safe)
  310. check(copy.copy(u), u)
  311. check(copy.deepcopy(u), u)
  312. for proto in range(pickle.HIGHEST_PROTOCOL + 1):
  313. with self.subTest(protocol=proto):
  314. check(pickle.loads(pickle.dumps(u, proto)), u)
  315. def test_unpickle_previous_python_versions(self):
  316. def check(actual, expected):
  317. self.assertEqual(actual, expected)
  318. self.assertEqual(actual.is_safe, expected.is_safe)
  319. pickled_uuids = [
  320. # Python 2.7, protocol 0
  321. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  322. b'tR(dS\'int\'\nL287307832597519156748809049798316161701L\nsb.',
  323. # Python 2.7, protocol 1
  324. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  325. b'tR}U\x03intL287307832597519156748809049798316161701L\nsb.',
  326. # Python 2.7, protocol 2
  327. b'\x80\x02cuuid\nUUID\n)\x81}U\x03int\x8a\x11\xa5z\xecz\nI\xdf}'
  328. b'\xde\xa0Bf\xcey%\xd8\x00sb.',
  329. # Python 3.6, protocol 0
  330. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  331. b'tR(dVint\nL287307832597519156748809049798316161701L\nsb.',
  332. # Python 3.6, protocol 1
  333. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  334. b'tR}X\x03\x00\x00\x00intL287307832597519156748809049798316161701L'
  335. b'\nsb.',
  336. # Python 3.6, protocol 2
  337. b'\x80\x02cuuid\nUUID\n)\x81}X\x03\x00\x00\x00int\x8a\x11\xa5z\xec'
  338. b'z\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00sb.',
  339. # Python 3.6, protocol 3
  340. b'\x80\x03cuuid\nUUID\n)\x81}X\x03\x00\x00\x00int\x8a\x11\xa5z\xec'
  341. b'z\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00sb.',
  342. # Python 3.6, protocol 4
  343. b'\x80\x04\x95+\x00\x00\x00\x00\x00\x00\x00\x8c\x04uuid\x8c\x04UUI'
  344. b'D\x93)\x81}\x8c\x03int\x8a\x11\xa5z\xecz\nI\xdf}\xde\xa0Bf\xcey%'
  345. b'\xd8\x00sb.',
  346. # Python 3.7, protocol 0
  347. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  348. b'tR(dVint\nL287307832597519156748809049798316161701L\nsVis_safe\n'
  349. b'cuuid\nSafeUUID\n(NtRsb.',
  350. # Python 3.7, protocol 1
  351. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  352. b'tR}(X\x03\x00\x00\x00intL287307832597519156748809049798316161701'
  353. b'L\nX\x07\x00\x00\x00is_safecuuid\nSafeUUID\n(NtRub.',
  354. # Python 3.7, protocol 2
  355. b'\x80\x02cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  356. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  357. b'id\nSafeUUID\nN\x85Rub.',
  358. # Python 3.7, protocol 3
  359. b'\x80\x03cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  360. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  361. b'id\nSafeUUID\nN\x85Rub.',
  362. # Python 3.7, protocol 4
  363. b'\x80\x04\x95F\x00\x00\x00\x00\x00\x00\x00\x8c\x04uuid\x94\x8c'
  364. b'\x04UUID\x93)\x81}(\x8c\x03int\x8a\x11\xa5z\xecz\nI\xdf}\xde\xa0'
  365. b'Bf\xcey%\xd8\x00\x8c\x07is_safeh\x00\x8c\x08SafeUUID\x93N\x85Rub'
  366. b'.',
  367. ]
  368. pickled_uuids_safe = [
  369. # Python 3.7, protocol 0
  370. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  371. b'tR(dVint\nL287307832597519156748809049798316161701L\nsVis_safe\n'
  372. b'cuuid\nSafeUUID\n(I0\ntRsb.',
  373. # Python 3.7, protocol 1
  374. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  375. b'tR}(X\x03\x00\x00\x00intL287307832597519156748809049798316161701'
  376. b'L\nX\x07\x00\x00\x00is_safecuuid\nSafeUUID\n(K\x00tRub.',
  377. # Python 3.7, protocol 2
  378. b'\x80\x02cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  379. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  380. b'id\nSafeUUID\nK\x00\x85Rub.',
  381. # Python 3.7, protocol 3
  382. b'\x80\x03cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  383. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  384. b'id\nSafeUUID\nK\x00\x85Rub.',
  385. # Python 3.7, protocol 4
  386. b'\x80\x04\x95G\x00\x00\x00\x00\x00\x00\x00\x8c\x04uuid\x94\x8c'
  387. b'\x04UUID\x93)\x81}(\x8c\x03int\x8a\x11\xa5z\xecz\nI\xdf}\xde\xa0'
  388. b'Bf\xcey%\xd8\x00\x8c\x07is_safeh\x00\x8c\x08SafeUUID\x93K\x00'
  389. b'\x85Rub.',
  390. ]
  391. pickled_uuids_unsafe = [
  392. # Python 3.7, protocol 0
  393. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  394. b'tR(dVint\nL287307832597519156748809049798316161701L\nsVis_safe\n'
  395. b'cuuid\nSafeUUID\n(I-1\ntRsb.',
  396. # Python 3.7, protocol 1
  397. b'ccopy_reg\n_reconstructor\n(cuuid\nUUID\nc__builtin__\nobject\nN'
  398. b'tR}(X\x03\x00\x00\x00intL287307832597519156748809049798316161701'
  399. b'L\nX\x07\x00\x00\x00is_safecuuid\nSafeUUID\n(J\xff\xff\xff\xfftR'
  400. b'ub.',
  401. # Python 3.7, protocol 2
  402. b'\x80\x02cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  403. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  404. b'id\nSafeUUID\nJ\xff\xff\xff\xff\x85Rub.',
  405. # Python 3.7, protocol 3
  406. b'\x80\x03cuuid\nUUID\n)\x81}(X\x03\x00\x00\x00int\x8a\x11\xa5z'
  407. b'\xecz\nI\xdf}\xde\xa0Bf\xcey%\xd8\x00X\x07\x00\x00\x00is_safecuu'
  408. b'id\nSafeUUID\nJ\xff\xff\xff\xff\x85Rub.',
  409. # Python 3.7, protocol 4
  410. b'\x80\x04\x95J\x00\x00\x00\x00\x00\x00\x00\x8c\x04uuid\x94\x8c'
  411. b'\x04UUID\x93)\x81}(\x8c\x03int\x8a\x11\xa5z\xecz\nI\xdf}\xde\xa0'
  412. b'Bf\xcey%\xd8\x00\x8c\x07is_safeh\x00\x8c\x08SafeUUID\x93J\xff'
  413. b'\xff\xff\xff\x85Rub.',
  414. ]
  415. u = self.uuid.UUID('d82579ce6642a0de7ddf490a7aec7aa5')
  416. u_safe = self.uuid.UUID('d82579ce6642a0de7ddf490a7aec7aa5',
  417. is_safe=self.uuid.SafeUUID.safe)
  418. u_unsafe = self.uuid.UUID('d82579ce6642a0de7ddf490a7aec7aa5',
  419. is_safe=self.uuid.SafeUUID.unsafe)
  420. with support.swap_item(sys.modules, 'uuid', self.uuid):
  421. for pickled in pickled_uuids:
  422. # is_safe was added in 3.7. When unpickling values from older
  423. # versions, is_safe will be missing, so it should be set to
  424. # SafeUUID.unknown.
  425. check(pickle.loads(pickled), u)
  426. for pickled in pickled_uuids_safe:
  427. check(pickle.loads(pickled), u_safe)
  428. for pickled in pickled_uuids_unsafe:
  429. check(pickle.loads(pickled), u_unsafe)
  430. # bpo-32502: UUID1 requires a 48-bit identifier, but hardware identifiers
  431. # need not necessarily be 48 bits (e.g., EUI-64).
  432. def test_uuid1_eui64(self):
  433. # Confirm that uuid.getnode ignores hardware addresses larger than 48
  434. # bits. Mock out each platform's *_getnode helper functions to return
  435. # something just larger than 48 bits to test. This will cause
  436. # uuid.getnode to fall back on uuid._random_getnode, which will
  437. # generate a valid value.
  438. too_large_getter = lambda: 1 << 48
  439. with mock.patch.multiple(
  440. self.uuid,
  441. _node=None, # Ignore any cached node value.
  442. _GETTERS=[too_large_getter],
  443. ):
  444. node = self.uuid.getnode()
  445. self.assertTrue(0 < node < (1 << 48), '%012x' % node)
  446. # Confirm that uuid1 can use the generated node, i.e., the that
  447. # uuid.getnode fell back on uuid._random_getnode() rather than using
  448. # the value from too_large_getter above.
  449. try:
  450. self.uuid.uuid1(node=node)
  451. except ValueError:
  452. self.fail('uuid1 was given an invalid node ID')
  453. def test_uuid1(self):
  454. equal = self.assertEqual
  455. # Make sure uuid1() generates UUIDs that are actually version 1.
  456. for u in [self.uuid.uuid1() for i in range(10)]:
  457. equal(u.variant, self.uuid.RFC_4122)
  458. equal(u.version, 1)
  459. self.assertIn(u.is_safe, {self.uuid.SafeUUID.safe,
  460. self.uuid.SafeUUID.unsafe,
  461. self.uuid.SafeUUID.unknown})
  462. # Make sure the generated UUIDs are actually unique.
  463. uuids = {}
  464. for u in [self.uuid.uuid1() for i in range(1000)]:
  465. uuids[u] = 1
  466. equal(len(uuids.keys()), 1000)
  467. # Make sure the supplied node ID appears in the UUID.
  468. u = self.uuid.uuid1(0)
  469. equal(u.node, 0)
  470. u = self.uuid.uuid1(0x123456789abc)
  471. equal(u.node, 0x123456789abc)
  472. u = self.uuid.uuid1(0xffffffffffff)
  473. equal(u.node, 0xffffffffffff)
  474. # Make sure the supplied clock sequence appears in the UUID.
  475. u = self.uuid.uuid1(0x123456789abc, 0)
  476. equal(u.node, 0x123456789abc)
  477. equal(((u.clock_seq_hi_variant & 0x3f) << 8) | u.clock_seq_low, 0)
  478. u = self.uuid.uuid1(0x123456789abc, 0x1234)
  479. equal(u.node, 0x123456789abc)
  480. equal(((u.clock_seq_hi_variant & 0x3f) << 8) |
  481. u.clock_seq_low, 0x1234)
  482. u = self.uuid.uuid1(0x123456789abc, 0x3fff)
  483. equal(u.node, 0x123456789abc)
  484. equal(((u.clock_seq_hi_variant & 0x3f) << 8) |
  485. u.clock_seq_low, 0x3fff)
  486. # bpo-29925: On Mac OS X Tiger, self.uuid.uuid1().is_safe returns
  487. # self.uuid.SafeUUID.unknown
  488. @support.requires_mac_ver(10, 5)
  489. @unittest.skipUnless(os.name == 'posix', 'POSIX-only test')
  490. def test_uuid1_safe(self):
  491. if not self.uuid._has_uuid_generate_time_safe:
  492. self.skipTest('requires uuid_generate_time_safe(3)')
  493. u = self.uuid.uuid1()
  494. # uuid_generate_time_safe() may return 0 or -1 but what it returns is
  495. # dependent on the underlying platform support. At least it cannot be
  496. # unknown (unless I suppose the platform is buggy).
  497. self.assertNotEqual(u.is_safe, self.uuid.SafeUUID.unknown)
  498. @contextlib.contextmanager
  499. def mock_generate_time_safe(self, safe_value):
  500. """
  501. Mock uuid._generate_time_safe() to return a given *safe_value*.
  502. """
  503. if os.name != 'posix':
  504. self.skipTest('POSIX-only test')
  505. self.uuid._load_system_functions()
  506. f = self.uuid._generate_time_safe
  507. if f is None:
  508. self.skipTest('need uuid._generate_time_safe')
  509. with mock.patch.object(self.uuid, '_generate_time_safe',
  510. lambda: (f()[0], safe_value)):
  511. yield
  512. @unittest.skipUnless(os.name == 'posix', 'POSIX-only test')
  513. def test_uuid1_unknown(self):
  514. # Even if the platform has uuid_generate_time_safe(), let's mock it to
  515. # be uuid_generate_time() and ensure the safety is unknown.
  516. with self.mock_generate_time_safe(None):
  517. u = self.uuid.uuid1()
  518. self.assertEqual(u.is_safe, self.uuid.SafeUUID.unknown)
  519. @unittest.skipUnless(os.name == 'posix', 'POSIX-only test')
  520. def test_uuid1_is_safe(self):
  521. with self.mock_generate_time_safe(0):
  522. u = self.uuid.uuid1()
  523. self.assertEqual(u.is_safe, self.uuid.SafeUUID.safe)
  524. @unittest.skipUnless(os.name == 'posix', 'POSIX-only test')
  525. def test_uuid1_is_unsafe(self):
  526. with self.mock_generate_time_safe(-1):
  527. u = self.uuid.uuid1()
  528. self.assertEqual(u.is_safe, self.uuid.SafeUUID.unsafe)
  529. @unittest.skipUnless(os.name == 'posix', 'POSIX-only test')
  530. def test_uuid1_bogus_return_value(self):
  531. with self.mock_generate_time_safe(3):
  532. u = self.uuid.uuid1()
  533. self.assertEqual(u.is_safe, self.uuid.SafeUUID.unknown)
  534. def test_uuid1_time(self):
  535. with mock.patch.object(self.uuid, '_has_uuid_generate_time_safe', False), \
  536. mock.patch.object(self.uuid, '_generate_time_safe', None), \
  537. mock.patch.object(self.uuid, '_last_timestamp', None), \
  538. mock.patch.object(self.uuid, 'getnode', return_value=93328246233727), \
  539. mock.patch('time.time_ns', return_value=1545052026752910643), \
  540. mock.patch('random.getrandbits', return_value=5317): # guaranteed to be random
  541. u = self.uuid.uuid1()
  542. self.assertEqual(u, self.uuid.UUID('a7a55b92-01fc-11e9-94c5-54e1acf6da7f'))
  543. with mock.patch.object(self.uuid, '_has_uuid_generate_time_safe', False), \
  544. mock.patch.object(self.uuid, '_generate_time_safe', None), \
  545. mock.patch.object(self.uuid, '_last_timestamp', None), \
  546. mock.patch('time.time_ns', return_value=1545052026752910643):
  547. u = self.uuid.uuid1(node=93328246233727, clock_seq=5317)
  548. self.assertEqual(u, self.uuid.UUID('a7a55b92-01fc-11e9-94c5-54e1acf6da7f'))
  549. def test_uuid3(self):
  550. equal = self.assertEqual
  551. # Test some known version-3 UUIDs.
  552. for u, v in [(self.uuid.uuid3(self.uuid.NAMESPACE_DNS, 'python.org'),
  553. '6fa459ea-ee8a-3ca4-894e-db77e160355e'),
  554. (self.uuid.uuid3(self.uuid.NAMESPACE_URL, 'http://python.org/'),
  555. '9fe8e8c4-aaa8-32a9-a55c-4535a88b748d'),
  556. (self.uuid.uuid3(self.uuid.NAMESPACE_OID, '1.3.6.1'),
  557. 'dd1a1cef-13d5-368a-ad82-eca71acd4cd1'),
  558. (self.uuid.uuid3(self.uuid.NAMESPACE_X500, 'c=ca'),
  559. '658d3002-db6b-3040-a1d1-8ddd7d189a4d'),
  560. ]:
  561. equal(u.variant, self.uuid.RFC_4122)
  562. equal(u.version, 3)
  563. equal(u, self.uuid.UUID(v))
  564. equal(str(u), v)
  565. def test_uuid4(self):
  566. equal = self.assertEqual
  567. # Make sure uuid4() generates UUIDs that are actually version 4.
  568. for u in [self.uuid.uuid4() for i in range(10)]:
  569. equal(u.variant, self.uuid.RFC_4122)
  570. equal(u.version, 4)
  571. # Make sure the generated UUIDs are actually unique.
  572. uuids = {}
  573. for u in [self.uuid.uuid4() for i in range(1000)]:
  574. uuids[u] = 1
  575. equal(len(uuids.keys()), 1000)
  576. def test_uuid5(self):
  577. equal = self.assertEqual
  578. # Test some known version-5 UUIDs.
  579. for u, v in [(self.uuid.uuid5(self.uuid.NAMESPACE_DNS, 'python.org'),
  580. '886313e1-3b8a-5372-9b90-0c9aee199e5d'),
  581. (self.uuid.uuid5(self.uuid.NAMESPACE_URL, 'http://python.org/'),
  582. '4c565f0d-3f5a-5890-b41b-20cf47701c5e'),
  583. (self.uuid.uuid5(self.uuid.NAMESPACE_OID, '1.3.6.1'),
  584. '1447fa61-5277-5fef-a9b3-fbc6e44f4af3'),
  585. (self.uuid.uuid5(self.uuid.NAMESPACE_X500, 'c=ca'),
  586. 'cc957dd1-a972-5349-98cd-874190002798'),
  587. ]:
  588. equal(u.variant, self.uuid.RFC_4122)
  589. equal(u.version, 5)
  590. equal(u, self.uuid.UUID(v))
  591. equal(str(u), v)
  592. @support.requires_fork()
  593. def testIssue8621(self):
  594. # On at least some versions of OSX self.uuid.uuid4 generates
  595. # the same sequence of UUIDs in the parent and any
  596. # children started using fork.
  597. fds = os.pipe()
  598. pid = os.fork()
  599. if pid == 0:
  600. os.close(fds[0])
  601. value = self.uuid.uuid4()
  602. os.write(fds[1], value.hex.encode('latin-1'))
  603. os._exit(0)
  604. else:
  605. os.close(fds[1])
  606. self.addCleanup(os.close, fds[0])
  607. parent_value = self.uuid.uuid4().hex
  608. support.wait_process(pid, exitcode=0)
  609. child_value = os.read(fds[0], 100).decode('latin-1')
  610. self.assertNotEqual(parent_value, child_value)
  611. def test_uuid_weakref(self):
  612. # bpo-35701: check that weak referencing to a UUID object can be created
  613. strong = self.uuid.uuid4()
  614. weak = weakref.ref(strong)
  615. self.assertIs(strong, weak())
  616. class TestUUIDWithoutExtModule(BaseTestUUID, unittest.TestCase):
  617. uuid = py_uuid
  618. @unittest.skipUnless(c_uuid, 'requires the C _uuid module')
  619. class TestUUIDWithExtModule(BaseTestUUID, unittest.TestCase):
  620. uuid = c_uuid
  621. class BaseTestInternals:
  622. _uuid = py_uuid
  623. def check_parse_mac(self, aix):
  624. if not aix:
  625. patch = mock.patch.multiple(self.uuid,
  626. _MAC_DELIM=b':',
  627. _MAC_OMITS_LEADING_ZEROES=False)
  628. else:
  629. patch = mock.patch.multiple(self.uuid,
  630. _MAC_DELIM=b'.',
  631. _MAC_OMITS_LEADING_ZEROES=True)
  632. with patch:
  633. # Valid MAC addresses
  634. if not aix:
  635. tests = (
  636. (b'52:54:00:9d:0e:67', 0x5254009d0e67),
  637. (b'12:34:56:78:90:ab', 0x1234567890ab),
  638. )
  639. else:
  640. # AIX format
  641. tests = (
  642. (b'fe.ad.c.1.23.4', 0xfead0c012304),
  643. )
  644. for mac, expected in tests:
  645. self.assertEqual(self.uuid._parse_mac(mac), expected)
  646. # Invalid MAC addresses
  647. for mac in (
  648. b'',
  649. # IPv6 addresses with same length than valid MAC address
  650. # (17 characters)
  651. b'fe80::5054:ff:fe9',
  652. b'123:2:3:4:5:6:7:8',
  653. # empty 5rd field
  654. b'52:54:00:9d::67',
  655. # only 5 fields instead of 6
  656. b'52:54:00:9d:0e'
  657. # invalid character 'x'
  658. b'52:54:00:9d:0e:6x'
  659. # dash separator
  660. b'52-54-00-9d-0e-67',
  661. ):
  662. if aix:
  663. mac = mac.replace(b':', b'.')
  664. with self.subTest(mac=mac):
  665. self.assertIsNone(self.uuid._parse_mac(mac))
  666. def test_parse_mac(self):
  667. self.check_parse_mac(False)
  668. def test_parse_mac_aix(self):
  669. self.check_parse_mac(True)
  670. def test_find_under_heading(self):
  671. data = '''\
  672. Name Mtu Network Address Ipkts Ierrs Opkts Oerrs Coll
  673. en0 1500 link#2 fe.ad.c.1.23.4 1714807956 0 711348489 0 0
  674. 01:00:5e:00:00:01
  675. en0 1500 192.168.129 x071 1714807956 0 711348489 0 0
  676. 224.0.0.1
  677. en0 1500 192.168.90 x071 1714807956 0 711348489 0 0
  678. 224.0.0.1
  679. '''
  680. # The above data is from AIX - with '.' as _MAC_DELIM and strings
  681. # shorter than 17 bytes (no leading 0). (_MAC_OMITS_LEADING_ZEROES=True)
  682. with mock.patch.multiple(self.uuid,
  683. _MAC_DELIM=b'.',
  684. _MAC_OMITS_LEADING_ZEROES=True,
  685. _get_command_stdout=mock_get_command_stdout(data)):
  686. mac = self.uuid._find_mac_under_heading(
  687. command='netstat',
  688. args='-ian',
  689. heading=b'Address',
  690. )
  691. self.assertEqual(mac, 0xfead0c012304)
  692. def test_find_under_heading_ipv6(self):
  693. # bpo-39991: IPv6 address "fe80::5054:ff:fe9" looks like a MAC address
  694. # (same string length) but must be skipped
  695. data = '''\
  696. Name Mtu Network Address Ipkts Ierrs Idrop Opkts Oerrs Coll
  697. vtnet 1500 <Link#1> 52:54:00:9d:0e:67 10017 0 0 8174 0 0
  698. vtnet - fe80::%vtnet0 fe80::5054:ff:fe9 0 - - 4 - -
  699. vtnet - 192.168.122.0 192.168.122.45 8844 - - 8171 - -
  700. lo0 16384 <Link#2> lo0 260148 0 0 260148 0 0
  701. lo0 - ::1/128 ::1 193 - - 193 - -
  702. ff01::1%lo0
  703. ff02::2:2eb7:74fa
  704. ff02::2:ff2e:b774
  705. ff02::1%lo0
  706. ff02::1:ff00:1%lo
  707. lo0 - fe80::%lo0/64 fe80::1%lo0 0 - - 0 - -
  708. ff01::1%lo0
  709. ff02::2:2eb7:74fa
  710. ff02::2:ff2e:b774
  711. ff02::1%lo0
  712. ff02::1:ff00:1%lo
  713. lo0 - 127.0.0.0/8 127.0.0.1 259955 - - 259955 - -
  714. 224.0.0.1
  715. '''
  716. with mock.patch.multiple(self.uuid,
  717. _MAC_DELIM=b':',
  718. _MAC_OMITS_LEADING_ZEROES=False,
  719. _get_command_stdout=mock_get_command_stdout(data)):
  720. mac = self.uuid._find_mac_under_heading(
  721. command='netstat',
  722. args='-ian',
  723. heading=b'Address',
  724. )
  725. self.assertEqual(mac, 0x5254009d0e67)
  726. def test_find_mac_near_keyword(self):
  727. # key and value are on the same line
  728. data = '''
  729. fake Link encap:UNSPEC hwaddr 00-00
  730. cscotun0 Link encap:UNSPEC HWaddr 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00
  731. eth0 Link encap:Ethernet HWaddr 12:34:56:78:90:ab
  732. '''
  733. # The above data will only be parsed properly on non-AIX unixes.
  734. with mock.patch.multiple(self.uuid,
  735. _MAC_DELIM=b':',
  736. _MAC_OMITS_LEADING_ZEROES=False,
  737. _get_command_stdout=mock_get_command_stdout(data)):
  738. mac = self.uuid._find_mac_near_keyword(
  739. command='ifconfig',
  740. args='',
  741. keywords=[b'hwaddr'],
  742. get_word_index=lambda x: x + 1,
  743. )
  744. self.assertEqual(mac, 0x1234567890ab)
  745. def check_node(self, node, requires=None):
  746. if requires and node is None:
  747. self.skipTest('requires ' + requires)
  748. hex = '%012x' % node
  749. if support.verbose >= 2:
  750. print(hex, end=' ')
  751. self.assertTrue(0 < node < (1 << 48),
  752. "%s is not an RFC 4122 node ID" % hex)
  753. @unittest.skipUnless(_uuid._ifconfig_getnode in _uuid._GETTERS,
  754. "ifconfig is not used for introspection on this platform")
  755. def test_ifconfig_getnode(self):
  756. node = self.uuid._ifconfig_getnode()
  757. self.check_node(node, 'ifconfig')
  758. @unittest.skipUnless(_uuid._ip_getnode in _uuid._GETTERS,
  759. "ip is not used for introspection on this platform")
  760. def test_ip_getnode(self):
  761. node = self.uuid._ip_getnode()
  762. self.check_node(node, 'ip')
  763. @unittest.skipUnless(_uuid._arp_getnode in _uuid._GETTERS,
  764. "arp is not used for introspection on this platform")
  765. def test_arp_getnode(self):
  766. node = self.uuid._arp_getnode()
  767. self.check_node(node, 'arp')
  768. @unittest.skipUnless(_uuid._lanscan_getnode in _uuid._GETTERS,
  769. "lanscan is not used for introspection on this platform")
  770. def test_lanscan_getnode(self):
  771. node = self.uuid._lanscan_getnode()
  772. self.check_node(node, 'lanscan')
  773. @unittest.skipUnless(_uuid._netstat_getnode in _uuid._GETTERS,
  774. "netstat is not used for introspection on this platform")
  775. def test_netstat_getnode(self):
  776. node = self.uuid._netstat_getnode()
  777. self.check_node(node, 'netstat')
  778. def test_random_getnode(self):
  779. node = self.uuid._random_getnode()
  780. # The multicast bit, i.e. the least significant bit of first octet,
  781. # must be set for randomly generated MAC addresses. See RFC 4122,
  782. # $4.1.6.
  783. self.assertTrue(node & (1 << 40), '%012x' % node)
  784. self.check_node(node)
  785. node2 = self.uuid._random_getnode()
  786. self.assertNotEqual(node2, node, '%012x' % node)
  787. class TestInternalsWithoutExtModule(BaseTestInternals, unittest.TestCase):
  788. uuid = py_uuid
  789. @unittest.skipUnless(c_uuid, 'requires the C _uuid module')
  790. class TestInternalsWithExtModule(BaseTestInternals, unittest.TestCase):
  791. uuid = c_uuid
  792. @unittest.skipUnless(os.name == 'posix', 'requires Posix')
  793. def test_unix_getnode(self):
  794. if not importable('_uuid') and not importable('ctypes'):
  795. self.skipTest("neither _uuid extension nor ctypes available")
  796. try: # Issues 1481, 3581: _uuid_generate_time() might be None.
  797. node = self.uuid._unix_getnode()
  798. except TypeError:
  799. self.skipTest('requires uuid_generate_time')
  800. self.check_node(node, 'unix')
  801. @unittest.skipUnless(os.name == 'nt', 'requires Windows')
  802. def test_windll_getnode(self):
  803. node = self.uuid._windll_getnode()
  804. self.check_node(node)
  805. if __name__ == '__main__':
  806. unittest.main()