blob: ec6f82fd8bfcb33005726bdc051302455e223aa9 [file] [log] [blame]
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001import sys
2import os
Lars Gustäbelb506dc32007-08-07 18:36:16 +00003import io
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00004import shutil
Guido van Rossum34d19282007-08-09 01:03:29 +00005import io
Guido van Rossuma8add0e2007-05-14 22:03:55 +00006from hashlib import md5
Guido van Rossumd8faa362007-04-27 19:54:29 +00007import errno
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00008
9import unittest
10import tarfile
11
Benjamin Petersonee8712c2008-05-20 21:35:26 +000012from test import support
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000013
14# Check for our compression modules.
15try:
16 import gzip
Neal Norwitzae323192003-04-14 01:18:32 +000017 gzip.GzipFile
18except (ImportError, AttributeError):
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000019 gzip = None
20try:
21 import bz2
22except ImportError:
23 bz2 = None
24
Guido van Rossumd8faa362007-04-27 19:54:29 +000025def md5sum(data):
Guido van Rossuma8add0e2007-05-14 22:03:55 +000026 return md5(data).hexdigest()
Guido van Rossumd8faa362007-04-27 19:54:29 +000027
Antoine Pitrou941ee882009-11-11 20:59:38 +000028TEMPDIR = os.path.abspath(support.TESTFN)
29tarname = support.findfile("testtar.tar")
Guido van Rossumd8faa362007-04-27 19:54:29 +000030gzipname = os.path.join(TEMPDIR, "testtar.tar.gz")
31bz2name = os.path.join(TEMPDIR, "testtar.tar.bz2")
32tmpname = os.path.join(TEMPDIR, "tmp.tar")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000033
Guido van Rossumd8faa362007-04-27 19:54:29 +000034md5_regtype = "65f477c818ad9e15f7feab0c6d37742f"
35md5_sparse = "a54fbc4ca4f4399a90e1b27164012fc6"
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000036
37
Guido van Rossumd8faa362007-04-27 19:54:29 +000038class ReadTest(unittest.TestCase):
39
40 tarname = tarname
41 mode = "r:"
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000042
43 def setUp(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +000044 self.tar = tarfile.open(self.tarname, mode=self.mode, encoding="iso8859-1")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000045
46 def tearDown(self):
47 self.tar.close()
48
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000049
Guido van Rossumd8faa362007-04-27 19:54:29 +000050class UstarReadTest(ReadTest):
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000051
Guido van Rossumd8faa362007-04-27 19:54:29 +000052 def test_fileobj_regular_file(self):
53 tarinfo = self.tar.getmember("ustar/regtype")
54 fobj = self.tar.extractfile(tarinfo)
55 data = fobj.read()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000056 self.assertTrue((len(data), md5sum(data)) == (tarinfo.size, md5_regtype),
Guido van Rossumd8faa362007-04-27 19:54:29 +000057 "regular file extraction failed")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000058
Guido van Rossumd8faa362007-04-27 19:54:29 +000059 def test_fileobj_readlines(self):
60 self.tar.extract("ustar/regtype", TEMPDIR)
61 tarinfo = self.tar.getmember("ustar/regtype")
Lars Gustäbelb506dc32007-08-07 18:36:16 +000062 fobj1 = open(os.path.join(TEMPDIR, "ustar/regtype"), "r")
63 fobj2 = io.TextIOWrapper(self.tar.extractfile(tarinfo))
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000064
Guido van Rossumd8faa362007-04-27 19:54:29 +000065 lines1 = fobj1.readlines()
66 lines2 = fobj2.readlines()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000067 self.assertTrue(lines1 == lines2,
Guido van Rossumd8faa362007-04-27 19:54:29 +000068 "fileobj.readlines() failed")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000069 self.assertTrue(len(lines2) == 114,
Guido van Rossumd8faa362007-04-27 19:54:29 +000070 "fileobj.readlines() failed")
Benjamin Peterson886af962010-03-21 23:13:07 +000071 self.assertTrue(lines2[83] ==
Guido van Rossumd8faa362007-04-27 19:54:29 +000072 "I will gladly admit that Python is not the fastest running scripting language.\n",
73 "fileobj.readlines() failed")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +000074
Guido van Rossumd8faa362007-04-27 19:54:29 +000075 def test_fileobj_iter(self):
76 self.tar.extract("ustar/regtype", TEMPDIR)
77 tarinfo = self.tar.getmember("ustar/regtype")
78 fobj1 = open(os.path.join(TEMPDIR, "ustar/regtype"), "rU")
79 fobj2 = self.tar.extractfile(tarinfo)
80 lines1 = fobj1.readlines()
Lars Gustäbelb506dc32007-08-07 18:36:16 +000081 lines2 = list(io.TextIOWrapper(fobj2))
Benjamin Petersonc9c0f202009-06-30 23:06:06 +000082 self.assertTrue(lines1 == lines2,
Guido van Rossumd8faa362007-04-27 19:54:29 +000083 "fileobj.__iter__() failed")
Martin v. Löwisdf241532005-03-03 08:17:42 +000084
Guido van Rossumd8faa362007-04-27 19:54:29 +000085 def test_fileobj_seek(self):
86 self.tar.extract("ustar/regtype", TEMPDIR)
87 fobj = open(os.path.join(TEMPDIR, "ustar/regtype"), "rb")
88 data = fobj.read()
Neal Norwitzf3396542005-10-28 05:52:22 +000089 fobj.close()
90
Guido van Rossumd8faa362007-04-27 19:54:29 +000091 tarinfo = self.tar.getmember("ustar/regtype")
92 fobj = self.tar.extractfile(tarinfo)
93
94 text = fobj.read()
95 fobj.seek(0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +000096 self.assertEqual(0, fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +000097 "seek() to file's start failed")
98 fobj.seek(2048, 0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +000099 self.assertEqual(2048, fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000100 "seek() to absolute position failed")
101 fobj.seek(-1024, 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000102 self.assertEqual(1024, fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000103 "seek() to negative relative position failed")
104 fobj.seek(1024, 1)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000105 self.assertEqual(2048, fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000106 "seek() to positive relative position failed")
107 s = fobj.read(10)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000108 self.assertTrue(s == data[2048:2058],
Guido van Rossumd8faa362007-04-27 19:54:29 +0000109 "read() after seek failed")
110 fobj.seek(0, 2)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000111 self.assertEqual(tarinfo.size, fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000112 "seek() to file's end failed")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000113 self.assertTrue(fobj.read() == b"",
Guido van Rossumd8faa362007-04-27 19:54:29 +0000114 "read() at file's end did not return empty string")
115 fobj.seek(-tarinfo.size, 2)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000116 self.assertEqual(0, fobj.tell(),
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000117 "relative seek() to file's end failed")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000118 fobj.seek(512)
119 s1 = fobj.readlines()
120 fobj.seek(512)
121 s2 = fobj.readlines()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000122 self.assertTrue(s1 == s2,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000123 "readlines() after seek failed")
124 fobj.seek(0)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000125 self.assertEqual(len(fobj.readline()), fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000126 "tell() after readline() failed")
127 fobj.seek(512)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000128 self.assertTrue(len(fobj.readline()) + 512 == fobj.tell(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000129 "tell() after seek() and readline() failed")
130 fobj.seek(0)
131 line = fobj.readline()
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000132 self.assertEqual(fobj.read(), data[len(line):],
Guido van Rossumd8faa362007-04-27 19:54:29 +0000133 "read() after readline() failed")
134 fobj.close()
135
136
Lars Gustäbel9520a432009-11-22 18:48:49 +0000137class CommonReadTest(ReadTest):
138
139 def test_empty_tarfile(self):
140 # Test for issue6123: Allow opening empty archives.
141 # This test checks if tarfile.open() is able to open an empty tar
142 # archive successfully. Note that an empty tar archive is not the
143 # same as an empty file!
144 tarfile.open(tmpname, self.mode.replace("r", "w")).close()
145 try:
146 tar = tarfile.open(tmpname, self.mode)
147 tar.getnames()
148 except tarfile.ReadError:
149 self.fail("tarfile.open() failed on empty archive")
150 self.assertListEqual(tar.getmembers(), [])
151
152 def test_null_tarfile(self):
153 # Test for issue6123: Allow opening empty archives.
154 # This test guarantees that tarfile.open() does not treat an empty
155 # file as an empty tar archive.
156 open(tmpname, "wb").close()
157 self.assertRaises(tarfile.ReadError, tarfile.open, tmpname, self.mode)
158 self.assertRaises(tarfile.ReadError, tarfile.open, tmpname)
159
160 def test_ignore_zeros(self):
161 # Test TarFile's ignore_zeros option.
162 if self.mode.endswith(":gz"):
163 _open = gzip.GzipFile
164 elif self.mode.endswith(":bz2"):
165 _open = bz2.BZ2File
166 else:
167 _open = open
168
169 for char in (b'\0', b'a'):
170 # Test if EOFHeaderError ('\0') and InvalidHeaderError ('a')
171 # are ignored correctly.
172 fobj = _open(tmpname, "wb")
173 fobj.write(char * 1024)
174 fobj.write(tarfile.TarInfo("foo").tobuf())
175 fobj.close()
176
177 tar = tarfile.open(tmpname, mode="r", ignore_zeros=True)
178 self.assertListEqual(tar.getnames(), ["foo"],
179 "ignore_zeros=True should have skipped the %r-blocks" % char)
180 tar.close()
181
182
183class MiscReadTest(CommonReadTest):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000184
Thomas Woutersed03b412007-08-28 21:37:11 +0000185 def test_no_name_argument(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000186 fobj = open(self.tarname, "rb")
187 tar = tarfile.open(fileobj=fobj, mode=self.mode)
188 self.assertEqual(tar.name, os.path.abspath(fobj.name))
189
Thomas Woutersed03b412007-08-28 21:37:11 +0000190 def test_no_name_attribute(self):
191 data = open(self.tarname, "rb").read()
192 fobj = io.BytesIO(data)
193 self.assertRaises(AttributeError, getattr, fobj, "name")
194 tar = tarfile.open(fileobj=fobj, mode=self.mode)
195 self.assertEqual(tar.name, None)
196
197 def test_empty_name_attribute(self):
198 data = open(self.tarname, "rb").read()
199 fobj = io.BytesIO(data)
200 fobj.name = ""
201 tar = tarfile.open(fileobj=fobj, mode=self.mode)
202 self.assertEqual(tar.name, None)
203
Christian Heimesd8654cf2007-12-02 15:22:16 +0000204 def test_fileobj_with_offset(self):
205 # Skip the first member and store values from the second member
206 # of the testtar.
207 tar = tarfile.open(self.tarname, mode=self.mode)
208 tar.next()
209 t = tar.next()
210 name = t.name
211 offset = t.offset
212 data = tar.extractfile(t).read()
213 tar.close()
214
215 # Open the testtar and seek to the offset of the second member.
216 if self.mode.endswith(":gz"):
217 _open = gzip.GzipFile
218 elif self.mode.endswith(":bz2"):
219 _open = bz2.BZ2File
220 else:
221 _open = open
222 fobj = _open(self.tarname, "rb")
223 fobj.seek(offset)
224
225 # Test if the tarfile starts with the second member.
226 tar = tar.open(self.tarname, mode="r:", fileobj=fobj)
227 t = tar.next()
228 self.assertEqual(t.name, name)
229 # Read to the end of fileobj and test if seeking back to the
230 # beginning works.
231 tar.getmembers()
232 self.assertEqual(tar.extractfile(t).read(), data,
233 "seek back did not work")
234 tar.close()
235
Guido van Rossumd8faa362007-04-27 19:54:29 +0000236 def test_fail_comp(self):
237 # For Gzip and Bz2 Tests: fail with a ReadError on an uncompressed file.
238 if self.mode == "r:":
239 return
240 self.assertRaises(tarfile.ReadError, tarfile.open, tarname, self.mode)
241 fobj = open(tarname, "rb")
242 self.assertRaises(tarfile.ReadError, tarfile.open, fileobj=fobj, mode=self.mode)
243
244 def test_v7_dirtype(self):
245 # Test old style dirtype member (bug #1336623):
246 # Old V7 tars create directory members using an AREGTYPE
247 # header with a "/" appended to the filename field.
248 tarinfo = self.tar.getmember("misc/dirtype-old-v7")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000249 self.assertTrue(tarinfo.type == tarfile.DIRTYPE,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000250 "v7 dirtype failed")
251
Christian Heimes126d29a2008-02-11 22:57:17 +0000252 def test_xstar_type(self):
253 # The xstar format stores extra atime and ctime fields inside the
254 # space reserved for the prefix field. The prefix field must be
255 # ignored in this case, otherwise it will mess up the name.
256 try:
257 self.tar.getmember("misc/regtype-xstar")
258 except KeyError:
259 self.fail("failed to find misc/regtype-xstar (mangled prefix?)")
260
Guido van Rossumd8faa362007-04-27 19:54:29 +0000261 def test_check_members(self):
262 for tarinfo in self.tar:
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000263 self.assertTrue(int(tarinfo.mtime) == 0o7606136617,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000264 "wrong mtime for %s" % tarinfo.name)
265 if not tarinfo.name.startswith("ustar/"):
266 continue
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000267 self.assertTrue(tarinfo.uname == "tarfile",
Guido van Rossumd8faa362007-04-27 19:54:29 +0000268 "wrong uname for %s" % tarinfo.name)
269
270 def test_find_members(self):
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000271 self.assertTrue(self.tar.getmembers()[-1].name == "misc/eof",
Guido van Rossumd8faa362007-04-27 19:54:29 +0000272 "could not find all members")
273
274 def test_extract_hardlink(self):
275 # Test hardlink extraction (e.g. bug #857297).
276 tar = tarfile.open(tarname, errorlevel=1, encoding="iso8859-1")
277
278 tar.extract("ustar/regtype", TEMPDIR)
Neal Norwitzf3396542005-10-28 05:52:22 +0000279 try:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000280 tar.extract("ustar/lnktype", TEMPDIR)
281 except EnvironmentError as e:
282 if e.errno == errno.ENOENT:
283 self.fail("hardlink not extracted properly")
Neal Norwitzf3396542005-10-28 05:52:22 +0000284
Guido van Rossumd8faa362007-04-27 19:54:29 +0000285 data = open(os.path.join(TEMPDIR, "ustar/lnktype"), "rb").read()
286 self.assertEqual(md5sum(data), md5_regtype)
Neal Norwitzf3396542005-10-28 05:52:22 +0000287
Guido van Rossumd8faa362007-04-27 19:54:29 +0000288 try:
289 tar.extract("ustar/symtype", TEMPDIR)
290 except EnvironmentError as e:
291 if e.errno == errno.ENOENT:
292 self.fail("symlink not extracted properly")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000293
Guido van Rossumd8faa362007-04-27 19:54:29 +0000294 data = open(os.path.join(TEMPDIR, "ustar/symtype"), "rb").read()
295 self.assertEqual(md5sum(data), md5_regtype)
296
Christian Heimesfaf2f632008-01-06 16:59:19 +0000297 def test_extractall(self):
298 # Test if extractall() correctly restores directory permissions
299 # and times (see issue1735).
Christian Heimesfaf2f632008-01-06 16:59:19 +0000300 tar = tarfile.open(tarname, encoding="iso8859-1")
301 directories = [t for t in tar if t.isdir()]
302 tar.extractall(TEMPDIR, directories)
303 for tarinfo in directories:
304 path = os.path.join(TEMPDIR, tarinfo.name)
Lars Gustäbel43fcf3a2008-12-12 14:58:38 +0000305 if sys.platform != "win32":
306 # Win32 has no support for fine grained permissions.
307 self.assertEqual(tarinfo.mode & 0o777, os.stat(path).st_mode & 0o777)
Christian Heimesfaf2f632008-01-06 16:59:19 +0000308 self.assertEqual(tarinfo.mtime, os.path.getmtime(path))
309 tar.close()
310
Lars Gustäbelb7f09232009-11-23 15:48:33 +0000311 def test_init_close_fobj(self):
312 # Issue #7341: Close the internal file object in the TarFile
313 # constructor in case of an error. For the test we rely on
314 # the fact that opening an empty file raises a ReadError.
315 empty = os.path.join(TEMPDIR, "empty")
316 open(empty, "wb").write(b"")
317
318 try:
319 tar = object.__new__(tarfile.TarFile)
320 try:
321 tar.__init__(empty)
322 except tarfile.ReadError:
323 self.assertTrue(tar.fileobj.closed)
324 else:
325 self.fail("ReadError not raised")
326 finally:
327 os.remove(empty)
328
Guido van Rossumd8faa362007-04-27 19:54:29 +0000329
Lars Gustäbel9520a432009-11-22 18:48:49 +0000330class StreamReadTest(CommonReadTest):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000331
332 mode="r|"
333
334 def test_fileobj_regular_file(self):
335 tarinfo = self.tar.next() # get "regtype" (can't use getmember)
336 fobj = self.tar.extractfile(tarinfo)
337 data = fobj.read()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000338 self.assertTrue((len(data), md5sum(data)) == (tarinfo.size, md5_regtype),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000339 "regular file extraction failed")
340
341 def test_provoke_stream_error(self):
342 tarinfos = self.tar.getmembers()
343 f = self.tar.extractfile(tarinfos[0]) # read the first member
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000344 self.assertRaises(tarfile.StreamError, f.read)
345
Guido van Rossumd8faa362007-04-27 19:54:29 +0000346 def test_compare_members(self):
347 tar1 = tarfile.open(tarname, encoding="iso8859-1")
348 tar2 = self.tar
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000349
Guido van Rossumd8faa362007-04-27 19:54:29 +0000350 while True:
351 t1 = tar1.next()
352 t2 = tar2.next()
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000353 if t1 is None:
354 break
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000355 self.assertTrue(t2 is not None, "stream.next() failed.")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000356
357 if t2.islnk() or t2.issym():
Guido van Rossumd8faa362007-04-27 19:54:29 +0000358 self.assertRaises(tarfile.StreamError, tar2.extractfile, t2)
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000359 continue
Guido van Rossumd8faa362007-04-27 19:54:29 +0000360
361 v1 = tar1.extractfile(t1)
362 v2 = tar2.extractfile(t2)
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000363 if v1 is None:
364 continue
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000365 self.assertTrue(v2 is not None, "stream.extractfile() failed")
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000366 self.assertEqual(v1.read(), v2.read(), "stream extraction failed")
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000367
Guido van Rossumd8faa362007-04-27 19:54:29 +0000368 tar1.close()
Thomas Wouters902d6eb2007-01-09 23:18:33 +0000369
Thomas Wouters89f507f2006-12-13 04:49:30 +0000370
Guido van Rossumd8faa362007-04-27 19:54:29 +0000371class DetectReadTest(unittest.TestCase):
Thomas Wouterscf297e42007-02-23 15:07:44 +0000372
Guido van Rossumd8faa362007-04-27 19:54:29 +0000373 def _testfunc_file(self, name, mode):
374 try:
375 tarfile.open(name, mode)
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000376 except tarfile.ReadError as e:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000377 self.fail()
Thomas Wouterscf297e42007-02-23 15:07:44 +0000378
Guido van Rossumd8faa362007-04-27 19:54:29 +0000379 def _testfunc_fileobj(self, name, mode):
380 try:
381 tarfile.open(name, mode, fileobj=open(name, "rb"))
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000382 except tarfile.ReadError as e:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000383 self.fail()
384
385 def _test_modes(self, testfunc):
386 testfunc(tarname, "r")
387 testfunc(tarname, "r:")
388 testfunc(tarname, "r:*")
389 testfunc(tarname, "r|")
390 testfunc(tarname, "r|*")
391
392 if gzip:
393 self.assertRaises(tarfile.ReadError, tarfile.open, tarname, mode="r:gz")
394 self.assertRaises(tarfile.ReadError, tarfile.open, tarname, mode="r|gz")
395 self.assertRaises(tarfile.ReadError, tarfile.open, gzipname, mode="r:")
396 self.assertRaises(tarfile.ReadError, tarfile.open, gzipname, mode="r|")
397
398 testfunc(gzipname, "r")
399 testfunc(gzipname, "r:*")
400 testfunc(gzipname, "r:gz")
401 testfunc(gzipname, "r|*")
402 testfunc(gzipname, "r|gz")
403
404 if bz2:
405 self.assertRaises(tarfile.ReadError, tarfile.open, tarname, mode="r:bz2")
406 self.assertRaises(tarfile.ReadError, tarfile.open, tarname, mode="r|bz2")
407 self.assertRaises(tarfile.ReadError, tarfile.open, bz2name, mode="r:")
408 self.assertRaises(tarfile.ReadError, tarfile.open, bz2name, mode="r|")
409
410 testfunc(bz2name, "r")
411 testfunc(bz2name, "r:*")
412 testfunc(bz2name, "r:bz2")
413 testfunc(bz2name, "r|*")
414 testfunc(bz2name, "r|bz2")
415
416 def test_detect_file(self):
417 self._test_modes(self._testfunc_file)
418
419 def test_detect_fileobj(self):
420 self._test_modes(self._testfunc_fileobj)
421
422
423class MemberReadTest(ReadTest):
424
425 def _test_member(self, tarinfo, chksum=None, **kwargs):
426 if chksum is not None:
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000427 self.assertTrue(md5sum(self.tar.extractfile(tarinfo).read()) == chksum,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000428 "wrong md5sum for %s" % tarinfo.name)
429
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000430 kwargs["mtime"] = 0o7606136617
Guido van Rossumd8faa362007-04-27 19:54:29 +0000431 kwargs["uid"] = 1000
432 kwargs["gid"] = 100
433 if "old-v7" not in tarinfo.name:
434 # V7 tar can't handle alphabetic owners.
435 kwargs["uname"] = "tarfile"
436 kwargs["gname"] = "tarfile"
437 for k, v in kwargs.items():
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000438 self.assertTrue(getattr(tarinfo, k) == v,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000439 "wrong value in %s field of %s" % (k, tarinfo.name))
440
441 def test_find_regtype(self):
442 tarinfo = self.tar.getmember("ustar/regtype")
443 self._test_member(tarinfo, size=7011, chksum=md5_regtype)
444
445 def test_find_conttype(self):
446 tarinfo = self.tar.getmember("ustar/conttype")
447 self._test_member(tarinfo, size=7011, chksum=md5_regtype)
448
449 def test_find_dirtype(self):
450 tarinfo = self.tar.getmember("ustar/dirtype")
451 self._test_member(tarinfo, size=0)
452
453 def test_find_dirtype_with_size(self):
454 tarinfo = self.tar.getmember("ustar/dirtype-with-size")
455 self._test_member(tarinfo, size=255)
456
457 def test_find_lnktype(self):
458 tarinfo = self.tar.getmember("ustar/lnktype")
459 self._test_member(tarinfo, size=0, linkname="ustar/regtype")
460
461 def test_find_symtype(self):
462 tarinfo = self.tar.getmember("ustar/symtype")
463 self._test_member(tarinfo, size=0, linkname="regtype")
464
465 def test_find_blktype(self):
466 tarinfo = self.tar.getmember("ustar/blktype")
467 self._test_member(tarinfo, size=0, devmajor=3, devminor=0)
468
469 def test_find_chrtype(self):
470 tarinfo = self.tar.getmember("ustar/chrtype")
471 self._test_member(tarinfo, size=0, devmajor=1, devminor=3)
472
473 def test_find_fifotype(self):
474 tarinfo = self.tar.getmember("ustar/fifotype")
475 self._test_member(tarinfo, size=0)
476
477 def test_find_sparse(self):
478 tarinfo = self.tar.getmember("ustar/sparse")
479 self._test_member(tarinfo, size=86016, chksum=md5_sparse)
480
481 def test_find_umlauts(self):
Guido van Rossuma0557702007-08-07 23:19:53 +0000482 tarinfo = self.tar.getmember("ustar/umlauts-\xc4\xd6\xdc\xe4\xf6\xfc\xdf")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000483 self._test_member(tarinfo, size=7011, chksum=md5_regtype)
484
485 def test_find_ustar_longname(self):
486 name = "ustar/" + "12345/" * 39 + "1234567/longname"
Benjamin Peterson577473f2010-01-19 00:09:57 +0000487 self.assertIn(name, self.tar.getnames())
Guido van Rossumd8faa362007-04-27 19:54:29 +0000488
489 def test_find_regtype_oldv7(self):
490 tarinfo = self.tar.getmember("misc/regtype-old-v7")
491 self._test_member(tarinfo, size=7011, chksum=md5_regtype)
492
493 def test_find_pax_umlauts(self):
494 self.tar = tarfile.open(self.tarname, mode=self.mode, encoding="iso8859-1")
Guido van Rossuma0557702007-08-07 23:19:53 +0000495 tarinfo = self.tar.getmember("pax/umlauts-\xc4\xd6\xdc\xe4\xf6\xfc\xdf")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000496 self._test_member(tarinfo, size=7011, chksum=md5_regtype)
497
498
499class LongnameTest(ReadTest):
500
501 def test_read_longname(self):
502 # Test reading of longname (bug #1471427).
Guido van Rossume7ba4952007-06-06 23:52:48 +0000503 longname = self.subdir + "/" + "123/" * 125 + "longname"
Guido van Rossumd8faa362007-04-27 19:54:29 +0000504 try:
Guido van Rossume7ba4952007-06-06 23:52:48 +0000505 tarinfo = self.tar.getmember(longname)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000506 except KeyError:
507 self.fail("longname not found")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000508 self.assertTrue(tarinfo.type != tarfile.DIRTYPE, "read longname as dirtype")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000509
510 def test_read_longlink(self):
511 longname = self.subdir + "/" + "123/" * 125 + "longname"
512 longlink = self.subdir + "/" + "123/" * 125 + "longlink"
513 try:
514 tarinfo = self.tar.getmember(longlink)
515 except KeyError:
516 self.fail("longlink not found")
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000517 self.assertTrue(tarinfo.linkname == longname, "linkname wrong")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000518
519 def test_truncated_longname(self):
520 longname = self.subdir + "/" + "123/" * 125 + "longname"
521 tarinfo = self.tar.getmember(longname)
522 offset = tarinfo.offset
523 self.tar.fileobj.seek(offset)
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000524 fobj = io.BytesIO(self.tar.fileobj.read(3 * 512))
Guido van Rossumd8faa362007-04-27 19:54:29 +0000525 self.assertRaises(tarfile.ReadError, tarfile.open, name="foo.tar", fileobj=fobj)
526
Guido van Rossume7ba4952007-06-06 23:52:48 +0000527 def test_header_offset(self):
528 # Test if the start offset of the TarInfo object includes
529 # the preceding extended header.
530 longname = self.subdir + "/" + "123/" * 125 + "longname"
531 offset = self.tar.getmember(longname).offset
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000532 fobj = open(tarname, "rb")
Guido van Rossume7ba4952007-06-06 23:52:48 +0000533 fobj.seek(offset)
Lars Gustäbelb506dc32007-08-07 18:36:16 +0000534 tarinfo = tarfile.TarInfo.frombuf(fobj.read(512), "iso8859-1", "strict")
Guido van Rossume7ba4952007-06-06 23:52:48 +0000535 self.assertEqual(tarinfo.type, self.longnametype)
536
Guido van Rossumd8faa362007-04-27 19:54:29 +0000537
538class GNUReadTest(LongnameTest):
539
540 subdir = "gnu"
Guido van Rossume7ba4952007-06-06 23:52:48 +0000541 longnametype = tarfile.GNUTYPE_LONGNAME
Guido van Rossumd8faa362007-04-27 19:54:29 +0000542
543 def test_sparse_file(self):
544 tarinfo1 = self.tar.getmember("ustar/sparse")
545 fobj1 = self.tar.extractfile(tarinfo1)
546 tarinfo2 = self.tar.getmember("gnu/sparse")
547 fobj2 = self.tar.extractfile(tarinfo2)
Guido van Rossume61fd5b2007-07-11 12:20:59 +0000548 self.assertEqual(fobj1.read(), fobj2.read(),
Guido van Rossumd8faa362007-04-27 19:54:29 +0000549 "sparse file extraction failed")
550
551
Guido van Rossume7ba4952007-06-06 23:52:48 +0000552class PaxReadTest(LongnameTest):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000553
554 subdir = "pax"
Guido van Rossume7ba4952007-06-06 23:52:48 +0000555 longnametype = tarfile.XHDTYPE
Guido van Rossumd8faa362007-04-27 19:54:29 +0000556
Guido van Rossume7ba4952007-06-06 23:52:48 +0000557 def test_pax_global_headers(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000558 tar = tarfile.open(tarname, encoding="iso8859-1")
Guido van Rossume7ba4952007-06-06 23:52:48 +0000559
Guido van Rossumd8faa362007-04-27 19:54:29 +0000560 tarinfo = tar.getmember("pax/regtype1")
561 self.assertEqual(tarinfo.uname, "foo")
562 self.assertEqual(tarinfo.gname, "bar")
Guido van Rossuma0557702007-08-07 23:19:53 +0000563 self.assertEqual(tarinfo.pax_headers.get("VENDOR.umlauts"), "\xc4\xd6\xdc\xe4\xf6\xfc\xdf")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000564
565 tarinfo = tar.getmember("pax/regtype2")
566 self.assertEqual(tarinfo.uname, "")
567 self.assertEqual(tarinfo.gname, "bar")
Guido van Rossuma0557702007-08-07 23:19:53 +0000568 self.assertEqual(tarinfo.pax_headers.get("VENDOR.umlauts"), "\xc4\xd6\xdc\xe4\xf6\xfc\xdf")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000569
570 tarinfo = tar.getmember("pax/regtype3")
571 self.assertEqual(tarinfo.uname, "tarfile")
572 self.assertEqual(tarinfo.gname, "tarfile")
Guido van Rossuma0557702007-08-07 23:19:53 +0000573 self.assertEqual(tarinfo.pax_headers.get("VENDOR.umlauts"), "\xc4\xd6\xdc\xe4\xf6\xfc\xdf")
Guido van Rossume7ba4952007-06-06 23:52:48 +0000574
575 def test_pax_number_fields(self):
576 # All following number fields are read from the pax header.
577 tar = tarfile.open(tarname, encoding="iso8859-1")
578 tarinfo = tar.getmember("pax/regtype4")
579 self.assertEqual(tarinfo.size, 7011)
580 self.assertEqual(tarinfo.uid, 123)
581 self.assertEqual(tarinfo.gid, 123)
582 self.assertEqual(tarinfo.mtime, 1041808783.0)
583 self.assertEqual(type(tarinfo.mtime), float)
584 self.assertEqual(float(tarinfo.pax_headers["atime"]), 1041808783.0)
585 self.assertEqual(float(tarinfo.pax_headers["ctime"]), 1041808783.0)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000586
587
Georg Brandlf08a9dd2008-06-10 16:57:31 +0000588class WriteTestBase(unittest.TestCase):
589 # Put all write tests in here that are supposed to be tested
590 # in all possible mode combinations.
591
592 def test_fileobj_no_close(self):
593 fobj = io.BytesIO()
594 tar = tarfile.open(fileobj=fobj, mode=self.mode)
595 tar.addfile(tarfile.TarInfo("foo"))
596 tar.close()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000597 self.assertTrue(fobj.closed is False, "external fileobjs must never closed")
Georg Brandlf08a9dd2008-06-10 16:57:31 +0000598
599
600class WriteTest(WriteTestBase):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000601
602 mode = "w:"
603
604 def test_100_char_name(self):
605 # The name field in a tar header stores strings of at most 100 chars.
606 # If a string is shorter than 100 chars it has to be padded with '\0',
607 # which implies that a string of exactly 100 chars is stored without
608 # a trailing '\0'.
609 name = "0123456789" * 10
610 tar = tarfile.open(tmpname, self.mode)
611 t = tarfile.TarInfo(name)
612 tar.addfile(t)
Thomas Wouterscf297e42007-02-23 15:07:44 +0000613 tar.close()
614
Guido van Rossumd8faa362007-04-27 19:54:29 +0000615 tar = tarfile.open(tmpname)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000616 self.assertTrue(tar.getnames()[0] == name,
Thomas Wouters89f507f2006-12-13 04:49:30 +0000617 "failed to store 100 char filename")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000618 tar.close()
Thomas Wouters89f507f2006-12-13 04:49:30 +0000619
Guido van Rossumd8faa362007-04-27 19:54:29 +0000620 def test_tar_size(self):
621 # Test for bug #1013882.
622 tar = tarfile.open(tmpname, self.mode)
623 path = os.path.join(TEMPDIR, "file")
624 fobj = open(path, "wb")
Lars Gustäbela280ca752007-08-28 07:34:33 +0000625 fobj.write(b"aaa")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000626 fobj.close()
627 tar.add(path)
628 tar.close()
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000629 self.assertTrue(os.path.getsize(tmpname) > 0,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000630 "tarfile is empty")
Thomas Wouters89f507f2006-12-13 04:49:30 +0000631
Guido van Rossumd8faa362007-04-27 19:54:29 +0000632 # The test_*_size tests test for bug #1167128.
633 def test_file_size(self):
634 tar = tarfile.open(tmpname, self.mode)
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000635
Guido van Rossumd8faa362007-04-27 19:54:29 +0000636 path = os.path.join(TEMPDIR, "file")
637 fobj = open(path, "wb")
638 fobj.close()
639 tarinfo = tar.gettarinfo(path)
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000640 self.assertEqual(tarinfo.size, 0)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000641
642 fobj = open(path, "wb")
Lars Gustäbela280ca752007-08-28 07:34:33 +0000643 fobj.write(b"aaa")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000644 fobj.close()
645 tarinfo = tar.gettarinfo(path)
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000646 self.assertEqual(tarinfo.size, 3)
647
Guido van Rossumd8faa362007-04-27 19:54:29 +0000648 tar.close()
649
650 def test_directory_size(self):
651 path = os.path.join(TEMPDIR, "directory")
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000652 os.mkdir(path)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000653 try:
654 tar = tarfile.open(tmpname, self.mode)
655 tarinfo = tar.gettarinfo(path)
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000656 self.assertEqual(tarinfo.size, 0)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000657 finally:
658 os.rmdir(path)
659
660 def test_link_size(self):
661 if hasattr(os, "link"):
662 link = os.path.join(TEMPDIR, "link")
663 target = os.path.join(TEMPDIR, "link_target")
Lars Gustäbel2470ff12010-06-03 10:11:52 +0000664 fobj = open(target, "wb")
665 fobj.write(b"aaa")
666 fobj.close()
Guido van Rossumd8faa362007-04-27 19:54:29 +0000667 os.link(target, link)
668 try:
669 tar = tarfile.open(tmpname, self.mode)
Lars Gustäbel2470ff12010-06-03 10:11:52 +0000670 # Record the link target in the inodes list.
671 tar.gettarinfo(target)
Guido van Rossumd8faa362007-04-27 19:54:29 +0000672 tarinfo = tar.gettarinfo(link)
673 self.assertEqual(tarinfo.size, 0)
674 finally:
675 os.remove(target)
676 os.remove(link)
677
678 def test_symlink_size(self):
679 if hasattr(os, "symlink"):
680 path = os.path.join(TEMPDIR, "symlink")
681 os.symlink("link_target", path)
682 try:
683 tar = tarfile.open(tmpname, self.mode)
684 tarinfo = tar.gettarinfo(path)
685 self.assertEqual(tarinfo.size, 0)
686 finally:
687 os.remove(path)
688
689 def test_add_self(self):
690 # Test for #1257255.
691 dstname = os.path.abspath(tmpname)
692
693 tar = tarfile.open(tmpname, self.mode)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000694 self.assertTrue(tar.name == dstname, "archive name must be absolute")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000695
696 tar.add(dstname)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000697 self.assertTrue(tar.getnames() == [], "added the archive to itself")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000698
699 cwd = os.getcwd()
700 os.chdir(TEMPDIR)
701 tar.add(dstname)
702 os.chdir(cwd)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000703 self.assertTrue(tar.getnames() == [], "added the archive to itself")
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000704
Guido van Rossum486364b2007-06-30 05:01:58 +0000705 def test_exclude(self):
706 tempdir = os.path.join(TEMPDIR, "exclude")
707 os.mkdir(tempdir)
708 try:
709 for name in ("foo", "bar", "baz"):
710 name = os.path.join(tempdir, name)
711 open(name, "wb").close()
712
Benjamin Peterson886af962010-03-21 23:13:07 +0000713 exclude = os.path.isfile
Guido van Rossum486364b2007-06-30 05:01:58 +0000714
715 tar = tarfile.open(tmpname, self.mode, encoding="iso8859-1")
Benjamin Peterson886af962010-03-21 23:13:07 +0000716 with support.check_warnings(("use the filter argument",
717 DeprecationWarning)):
718 tar.add(tempdir, arcname="empty_dir", exclude=exclude)
Guido van Rossum486364b2007-06-30 05:01:58 +0000719 tar.close()
720
721 tar = tarfile.open(tmpname, "r")
722 self.assertEqual(len(tar.getmembers()), 1)
723 self.assertEqual(tar.getnames()[0], "empty_dir")
724 finally:
725 shutil.rmtree(tempdir)
726
Lars Gustäbel049d2aa2009-09-12 10:44:00 +0000727 def test_filter(self):
728 tempdir = os.path.join(TEMPDIR, "filter")
729 os.mkdir(tempdir)
730 try:
731 for name in ("foo", "bar", "baz"):
732 name = os.path.join(tempdir, name)
733 open(name, "wb").close()
734
735 def filter(tarinfo):
736 if os.path.basename(tarinfo.name) == "bar":
737 return
738 tarinfo.uid = 123
739 tarinfo.uname = "foo"
740 return tarinfo
741
742 tar = tarfile.open(tmpname, self.mode, encoding="iso8859-1")
743 tar.add(tempdir, arcname="empty_dir", filter=filter)
744 tar.close()
745
746 tar = tarfile.open(tmpname, "r")
747 for tarinfo in tar:
748 self.assertEqual(tarinfo.uid, 123)
749 self.assertEqual(tarinfo.uname, "foo")
750 self.assertEqual(len(tar.getmembers()), 3)
751 tar.close()
752 finally:
753 shutil.rmtree(tempdir)
754
Lars Gustäbelbfdfdda2009-08-28 19:59:59 +0000755 # Guarantee that stored pathnames are not modified. Don't
756 # remove ./ or ../ or double slashes. Still make absolute
757 # pathnames relative.
758 # For details see bug #6054.
759 def _test_pathname(self, path, cmp_path=None, dir=False):
760 # Create a tarfile with an empty member named path
761 # and compare the stored name with the original.
762 foo = os.path.join(TEMPDIR, "foo")
763 if not dir:
764 open(foo, "w").close()
765 else:
766 os.mkdir(foo)
767
768 tar = tarfile.open(tmpname, self.mode)
769 tar.add(foo, arcname=path)
770 tar.close()
771
772 tar = tarfile.open(tmpname, "r")
773 t = tar.next()
774 tar.close()
775
776 if not dir:
777 os.remove(foo)
778 else:
779 os.rmdir(foo)
780
781 self.assertEqual(t.name, cmp_path or path.replace(os.sep, "/"))
782
783 def test_pathnames(self):
784 self._test_pathname("foo")
785 self._test_pathname(os.path.join("foo", ".", "bar"))
786 self._test_pathname(os.path.join("foo", "..", "bar"))
787 self._test_pathname(os.path.join(".", "foo"))
788 self._test_pathname(os.path.join(".", "foo", "."))
789 self._test_pathname(os.path.join(".", "foo", ".", "bar"))
790 self._test_pathname(os.path.join(".", "foo", "..", "bar"))
791 self._test_pathname(os.path.join(".", "foo", "..", "bar"))
792 self._test_pathname(os.path.join("..", "foo"))
793 self._test_pathname(os.path.join("..", "foo", ".."))
794 self._test_pathname(os.path.join("..", "foo", ".", "bar"))
795 self._test_pathname(os.path.join("..", "foo", "..", "bar"))
796
797 self._test_pathname("foo" + os.sep + os.sep + "bar")
798 self._test_pathname("foo" + os.sep + os.sep, "foo", dir=True)
799
800 def test_abs_pathnames(self):
801 if sys.platform == "win32":
802 self._test_pathname("C:\\foo", "foo")
803 else:
804 self._test_pathname("/foo", "foo")
805 self._test_pathname("///foo", "foo")
806
807 def test_cwd(self):
808 # Test adding the current working directory.
809 cwd = os.getcwd()
810 os.chdir(TEMPDIR)
811 try:
812 open("foo", "w").close()
813
814 tar = tarfile.open(tmpname, self.mode)
815 tar.add(".")
816 tar.close()
817
818 tar = tarfile.open(tmpname, "r")
819 for t in tar:
820 self.assert_(t.name == "." or t.name.startswith("./"))
821 tar.close()
822 finally:
823 os.chdir(cwd)
824
Martin v. Löwis5dbdc592005-08-27 10:07:56 +0000825
Georg Brandlf08a9dd2008-06-10 16:57:31 +0000826class StreamWriteTest(WriteTestBase):
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +0000827
Guido van Rossumd8faa362007-04-27 19:54:29 +0000828 mode = "w|"
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000829
Guido van Rossumd8faa362007-04-27 19:54:29 +0000830 def test_stream_padding(self):
831 # Test for bug #1543303.
832 tar = tarfile.open(tmpname, self.mode)
833 tar.close()
834
835 if self.mode.endswith("gz"):
836 fobj = gzip.GzipFile(tmpname)
837 data = fobj.read()
838 fobj.close()
839 elif self.mode.endswith("bz2"):
840 dec = bz2.BZ2Decompressor()
841 data = open(tmpname, "rb").read()
842 data = dec.decompress(data)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000843 self.assertTrue(len(dec.unused_data) == 0,
Guido van Rossumd8faa362007-04-27 19:54:29 +0000844 "found trailing data")
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000845 else:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000846 fobj = open(tmpname, "rb")
847 data = fobj.read()
848 fobj.close()
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000849
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000850 self.assertTrue(data.count(b"\0") == tarfile.RECORDSIZE,
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000851 "incorrect zero padding")
852
Lars Gustäbeld6eb70b2010-04-29 15:37:02 +0000853 def test_file_mode(self):
854 # Test for issue #8464: Create files with correct
855 # permissions.
856 if sys.platform == "win32" or not hasattr(os, "umask"):
857 return
858
859 if os.path.exists(tmpname):
860 os.remove(tmpname)
861
862 original_umask = os.umask(0o022)
863 try:
864 tar = tarfile.open(tmpname, self.mode)
865 tar.close()
866 mode = os.stat(tmpname).st_mode & 0o777
867 self.assertEqual(mode, 0o644, "wrong file permissions")
868 finally:
869 os.umask(original_umask)
870
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000871
Guido van Rossumd8faa362007-04-27 19:54:29 +0000872class GNUWriteTest(unittest.TestCase):
873 # This testcase checks for correct creation of GNU Longname
874 # and Longlink extended headers (cp. bug #812325).
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000875
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000876 def _length(self, s):
877 blocks, remainder = divmod(len(s) + 1, 512)
878 if remainder:
879 blocks += 1
880 return blocks * 512
881
882 def _calc_size(self, name, link=None):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000883 # Initial tar header
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000884 count = 512
885
886 if len(name) > tarfile.LENGTH_NAME:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000887 # GNU longname extended header + longname
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000888 count += 512
889 count += self._length(name)
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000890 if link is not None and len(link) > tarfile.LENGTH_LINK:
Guido van Rossumd8faa362007-04-27 19:54:29 +0000891 # GNU longlink extended header + longlink
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000892 count += 512
893 count += self._length(link)
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000894 return count
895
896 def _test(self, name, link=None):
897 tarinfo = tarfile.TarInfo(name)
898 if link:
899 tarinfo.linkname = link
900 tarinfo.type = tarfile.LNKTYPE
901
Guido van Rossumd8faa362007-04-27 19:54:29 +0000902 tar = tarfile.open(tmpname, "w")
903 tar.format = tarfile.GNU_FORMAT
Thomas Wouters89f507f2006-12-13 04:49:30 +0000904 tar.addfile(tarinfo)
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000905
906 v1 = self._calc_size(name, link)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000907 v2 = tar.offset
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000908 self.assertTrue(v1 == v2, "GNU longname/longlink creation failed")
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000909
Thomas Wouters89f507f2006-12-13 04:49:30 +0000910 tar.close()
911
Guido van Rossumd8faa362007-04-27 19:54:29 +0000912 tar = tarfile.open(tmpname)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000913 member = tar.next()
Benjamin Peterson886af962010-03-21 23:13:07 +0000914 self.assertIsNotNone(member,
915 "unable to read longname member")
916 self.assertEqual(tarinfo.name, member.name,
917 "unable to read longname member")
918 self.assertEqual(tarinfo.linkname, member.linkname,
919 "unable to read longname member")
Thomas Wouters89f507f2006-12-13 04:49:30 +0000920
Neal Norwitz0662f8a2004-07-20 21:54:18 +0000921 def test_longname_1023(self):
922 self._test(("longnam/" * 127) + "longnam")
923
924 def test_longname_1024(self):
925 self._test(("longnam/" * 127) + "longname")
926
927 def test_longname_1025(self):
928 self._test(("longnam/" * 127) + "longname_")
929
930 def test_longlink_1023(self):
931 self._test("name", ("longlnk/" * 127) + "longlnk")
932
933 def test_longlink_1024(self):
934 self._test("name", ("longlnk/" * 127) + "longlink")
935
936 def test_longlink_1025(self):
937 self._test("name", ("longlnk/" * 127) + "longlink_")
938
939 def test_longnamelink_1023(self):
940 self._test(("longnam/" * 127) + "longnam",
941 ("longlnk/" * 127) + "longlnk")
942
943 def test_longnamelink_1024(self):
944 self._test(("longnam/" * 127) + "longname",
945 ("longlnk/" * 127) + "longlink")
946
947 def test_longnamelink_1025(self):
948 self._test(("longnam/" * 127) + "longname_",
949 ("longlnk/" * 127) + "longlink_")
950
Guido van Rossumd8faa362007-04-27 19:54:29 +0000951
952class HardlinkTest(unittest.TestCase):
953 # Test the creation of LNKTYPE (hardlink) members in an archive.
Thomas Wouters477c8d52006-05-27 19:21:47 +0000954
955 def setUp(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000956 self.foo = os.path.join(TEMPDIR, "foo")
957 self.bar = os.path.join(TEMPDIR, "bar")
Thomas Wouters477c8d52006-05-27 19:21:47 +0000958
Guido van Rossumd8faa362007-04-27 19:54:29 +0000959 fobj = open(self.foo, "wb")
Lars Gustäbela280ca752007-08-28 07:34:33 +0000960 fobj.write(b"foo")
Guido van Rossumd8faa362007-04-27 19:54:29 +0000961 fobj.close()
Thomas Wouters477c8d52006-05-27 19:21:47 +0000962
Guido van Rossumd8faa362007-04-27 19:54:29 +0000963 os.link(self.foo, self.bar)
Thomas Wouters477c8d52006-05-27 19:21:47 +0000964
Guido van Rossumd8faa362007-04-27 19:54:29 +0000965 self.tar = tarfile.open(tmpname, "w")
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000966 self.tar.add(self.foo)
967
Guido van Rossumd8faa362007-04-27 19:54:29 +0000968 def tearDown(self):
Hirokazu Yamamotoaf079d42008-09-21 11:50:03 +0000969 self.tar.close()
Guido van Rossumd8faa362007-04-27 19:54:29 +0000970 os.remove(self.foo)
971 os.remove(self.bar)
972
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000973 def test_add_twice(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +0000974 # The same name will be added as a REGTYPE every
975 # time regardless of st_nlink.
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000976 tarinfo = self.tar.gettarinfo(self.foo)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000977 self.assertTrue(tarinfo.type == tarfile.REGTYPE,
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000978 "add file as regular failed")
979
980 def test_add_hardlink(self):
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000981 tarinfo = self.tar.gettarinfo(self.bar)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000982 self.assertTrue(tarinfo.type == tarfile.LNKTYPE,
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000983 "add file as hardlink failed")
984
985 def test_dereference_hardlink(self):
986 self.tar.dereference = True
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000987 tarinfo = self.tar.gettarinfo(self.bar)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000988 self.assertTrue(tarinfo.type == tarfile.REGTYPE,
Neal Norwitzb0e32e22005-10-20 04:50:13 +0000989 "dereferencing hardlink failed")
990
Neal Norwitza4f651a2004-07-20 22:07:44 +0000991
Guido van Rossumd8faa362007-04-27 19:54:29 +0000992class PaxWriteTest(GNUWriteTest):
Martin v. Löwis78be7df2005-03-05 12:47:42 +0000993
Guido van Rossumd8faa362007-04-27 19:54:29 +0000994 def _test(self, name, link=None):
995 # See GNUWriteTest.
996 tarinfo = tarfile.TarInfo(name)
997 if link:
998 tarinfo.linkname = link
999 tarinfo.type = tarfile.LNKTYPE
Andrew M. Kuchlingd4f25522004-10-20 11:47:01 +00001000
Guido van Rossumd8faa362007-04-27 19:54:29 +00001001 tar = tarfile.open(tmpname, "w", format=tarfile.PAX_FORMAT)
1002 tar.addfile(tarinfo)
1003 tar.close()
Andrew M. Kuchlingd4f25522004-10-20 11:47:01 +00001004
Guido van Rossumd8faa362007-04-27 19:54:29 +00001005 tar = tarfile.open(tmpname)
1006 if link:
1007 l = tar.getmembers()[0].linkname
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001008 self.assertTrue(link == l, "PAX longlink creation failed")
Guido van Rossumd8faa362007-04-27 19:54:29 +00001009 else:
1010 n = tar.getmembers()[0].name
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001011 self.assertTrue(name == n, "PAX longname creation failed")
Guido van Rossumd8faa362007-04-27 19:54:29 +00001012
Guido van Rossume7ba4952007-06-06 23:52:48 +00001013 def test_pax_global_header(self):
1014 pax_headers = {
Guido van Rossum9cbfffd2007-06-07 00:54:15 +00001015 "foo": "bar",
1016 "uid": "0",
1017 "mtime": "1.23",
Guido van Rossuma0557702007-08-07 23:19:53 +00001018 "test": "\xe4\xf6\xfc",
1019 "\xe4\xf6\xfc": "test"}
Guido van Rossume7ba4952007-06-06 23:52:48 +00001020
Benjamin Peterson886af962010-03-21 23:13:07 +00001021 tar = tarfile.open(tmpname, "w", format=tarfile.PAX_FORMAT,
Guido van Rossume7ba4952007-06-06 23:52:48 +00001022 pax_headers=pax_headers)
1023 tar.addfile(tarfile.TarInfo("test"))
1024 tar.close()
1025
1026 # Test if the global header was written correctly.
1027 tar = tarfile.open(tmpname, encoding="iso8859-1")
1028 self.assertEqual(tar.pax_headers, pax_headers)
1029 self.assertEqual(tar.getmembers()[0].pax_headers, pax_headers)
1030
Lars Gustäbelb506dc32007-08-07 18:36:16 +00001031 # Test if all the fields are strings.
Guido van Rossume7ba4952007-06-06 23:52:48 +00001032 for key, val in tar.pax_headers.items():
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001033 self.assertTrue(type(key) is not bytes)
1034 self.assertTrue(type(val) is not bytes)
Guido van Rossume7ba4952007-06-06 23:52:48 +00001035 if key in tarfile.PAX_NUMBER_FIELDS:
1036 try:
1037 tarfile.PAX_NUMBER_FIELDS[key](val)
1038 except (TypeError, ValueError):
1039 self.fail("unable to convert pax header field")
1040
1041 def test_pax_extended_header(self):
1042 # The fields from the pax header have priority over the
1043 # TarInfo.
Guido van Rossum9cbfffd2007-06-07 00:54:15 +00001044 pax_headers = {"path": "foo", "uid": "123"}
Guido van Rossume7ba4952007-06-06 23:52:48 +00001045
1046 tar = tarfile.open(tmpname, "w", format=tarfile.PAX_FORMAT, encoding="iso8859-1")
1047 t = tarfile.TarInfo()
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001048 t.name = "\xe4\xf6\xfc" # non-ASCII
1049 t.uid = 8**8 # too large
Guido van Rossume7ba4952007-06-06 23:52:48 +00001050 t.pax_headers = pax_headers
1051 tar.addfile(t)
1052 tar.close()
1053
1054 tar = tarfile.open(tmpname, encoding="iso8859-1")
1055 t = tar.getmembers()[0]
1056 self.assertEqual(t.pax_headers, pax_headers)
1057 self.assertEqual(t.name, "foo")
1058 self.assertEqual(t.uid, 123)
1059
1060
1061class UstarUnicodeTest(unittest.TestCase):
Guido van Rossume7ba4952007-06-06 23:52:48 +00001062
1063 format = tarfile.USTAR_FORMAT
1064
1065 def test_iso8859_1_filename(self):
1066 self._test_unicode_filename("iso8859-1")
1067
1068 def test_utf7_filename(self):
1069 self._test_unicode_filename("utf7")
Guido van Rossumd8faa362007-04-27 19:54:29 +00001070
1071 def test_utf8_filename(self):
1072 self._test_unicode_filename("utf8")
1073
Guido van Rossumd8faa362007-04-27 19:54:29 +00001074 def _test_unicode_filename(self, encoding):
Guido van Rossume7ba4952007-06-06 23:52:48 +00001075 tar = tarfile.open(tmpname, "w", format=self.format, encoding=encoding, errors="strict")
Guido van Rossuma0557702007-08-07 23:19:53 +00001076 name = "\xe4\xf6\xfc"
Guido van Rossumd8faa362007-04-27 19:54:29 +00001077 tar.addfile(tarfile.TarInfo(name))
1078 tar.close()
1079
1080 tar = tarfile.open(tmpname, encoding=encoding)
Lars Gustäbelb506dc32007-08-07 18:36:16 +00001081 self.assertEqual(tar.getmembers()[0].name, name)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001082 tar.close()
1083
1084 def test_unicode_filename_error(self):
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001085 if self.format == tarfile.PAX_FORMAT:
1086 # PAX_FORMAT ignores encoding in write mode.
1087 return
1088
Guido van Rossume7ba4952007-06-06 23:52:48 +00001089 tar = tarfile.open(tmpname, "w", format=self.format, encoding="ascii", errors="strict")
1090 tarinfo = tarfile.TarInfo()
1091
Guido van Rossuma0557702007-08-07 23:19:53 +00001092 tarinfo.name = "\xe4\xf6\xfc"
Guido van Rossume7ba4952007-06-06 23:52:48 +00001093 self.assertRaises(UnicodeError, tar.addfile, tarinfo)
1094
1095 tarinfo.name = "foo"
Guido van Rossuma0557702007-08-07 23:19:53 +00001096 tarinfo.uname = "\xe4\xf6\xfc"
Guido van Rossume7ba4952007-06-06 23:52:48 +00001097 self.assertRaises(UnicodeError, tar.addfile, tarinfo)
1098
1099 def test_unicode_argument(self):
1100 tar = tarfile.open(tarname, "r", encoding="iso8859-1", errors="strict")
1101 for t in tar:
Benjamin Petersonc9c0f202009-06-30 23:06:06 +00001102 self.assertTrue(type(t.name) is str)
1103 self.assertTrue(type(t.linkname) is str)
1104 self.assertTrue(type(t.uname) is str)
1105 self.assertTrue(type(t.gname) is str)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001106 tar.close()
1107
Guido van Rossume7ba4952007-06-06 23:52:48 +00001108 def test_uname_unicode(self):
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001109 t = tarfile.TarInfo("foo")
1110 t.uname = "\xe4\xf6\xfc"
1111 t.gname = "\xe4\xf6\xfc"
Guido van Rossumd8faa362007-04-27 19:54:29 +00001112
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001113 tar = tarfile.open(tmpname, mode="w", format=self.format, encoding="iso8859-1")
1114 tar.addfile(t)
1115 tar.close()
Guido van Rossumd8faa362007-04-27 19:54:29 +00001116
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001117 tar = tarfile.open(tmpname, encoding="iso8859-1")
1118 t = tar.getmember("foo")
1119 self.assertEqual(t.uname, "\xe4\xf6\xfc")
1120 self.assertEqual(t.gname, "\xe4\xf6\xfc")
1121
1122 if self.format != tarfile.PAX_FORMAT:
1123 tar = tarfile.open(tmpname, encoding="ascii")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001124 t = tar.getmember("foo")
Victor Stinnerde629d42010-05-05 21:43:57 +00001125 self.assertEqual(t.uname, "\udce4\udcf6\udcfc")
1126 self.assertEqual(t.gname, "\udce4\udcf6\udcfc")
Guido van Rossumd8faa362007-04-27 19:54:29 +00001127
Lars Gustäbelb506dc32007-08-07 18:36:16 +00001128
Guido van Rossume7ba4952007-06-06 23:52:48 +00001129class GNUUnicodeTest(UstarUnicodeTest):
Guido van Rossumd8faa362007-04-27 19:54:29 +00001130
Guido van Rossume7ba4952007-06-06 23:52:48 +00001131 format = tarfile.GNU_FORMAT
Guido van Rossumd8faa362007-04-27 19:54:29 +00001132
Lars Gustäbel1465cc22010-05-17 18:02:50 +00001133 def test_bad_pax_header(self):
1134 # Test for issue #8633. GNU tar <= 1.23 creates raw binary fields
1135 # without a hdrcharset=BINARY header.
1136 for encoding, name in (("utf8", "pax/bad-pax-\udce4\udcf6\udcfc"),
1137 ("iso8859-1", "pax/bad-pax-\xe4\xf6\xfc"),):
1138 with tarfile.open(tarname, encoding=encoding, errors="surrogateescape") as tar:
1139 try:
1140 t = tar.getmember(name)
1141 except KeyError:
1142 self.fail("unable to read bad GNU tar pax header")
1143
Guido van Rossumd8faa362007-04-27 19:54:29 +00001144
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001145class PAXUnicodeTest(UstarUnicodeTest):
1146
1147 format = tarfile.PAX_FORMAT
1148
Lars Gustäbel1465cc22010-05-17 18:02:50 +00001149 def test_binary_header(self):
1150 # Test a POSIX.1-2008 compatible header with a hdrcharset=BINARY field.
1151 for encoding, name in (("utf8", "pax/hdrcharset-\udce4\udcf6\udcfc"),
1152 ("iso8859-1", "pax/hdrcharset-\xe4\xf6\xfc"),):
1153 with tarfile.open(tarname, encoding=encoding, errors="surrogateescape") as tar:
1154 try:
1155 t = tar.getmember(name)
1156 except KeyError:
1157 self.fail("unable to read POSIX.1-2008 binary header")
1158
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001159
Guido van Rossumd8faa362007-04-27 19:54:29 +00001160class AppendTest(unittest.TestCase):
1161 # Test append mode (cp. patch #1652681).
Thomas Wouters902d6eb2007-01-09 23:18:33 +00001162
Guido van Rossumd8faa362007-04-27 19:54:29 +00001163 def setUp(self):
1164 self.tarname = tmpname
1165 if os.path.exists(self.tarname):
1166 os.remove(self.tarname)
Thomas Wouters902d6eb2007-01-09 23:18:33 +00001167
Guido van Rossumd8faa362007-04-27 19:54:29 +00001168 def _add_testfile(self, fileobj=None):
1169 tar = tarfile.open(self.tarname, "a", fileobj=fileobj)
1170 tar.addfile(tarfile.TarInfo("bar"))
1171 tar.close()
Tim Peters8ceefc52004-10-25 03:19:41 +00001172
Guido van Rossumd8faa362007-04-27 19:54:29 +00001173 def _create_testtar(self, mode="w:"):
1174 src = tarfile.open(tarname, encoding="iso8859-1")
1175 t = src.getmember("ustar/regtype")
1176 t.name = "foo"
1177 f = src.extractfile(t)
1178 tar = tarfile.open(self.tarname, mode)
1179 tar.addfile(t, f)
1180 tar.close()
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001181
Guido van Rossumd8faa362007-04-27 19:54:29 +00001182 def _test(self, names=["bar"], fileobj=None):
1183 tar = tarfile.open(self.tarname, fileobj=fileobj)
1184 self.assertEqual(tar.getnames(), names)
1185
1186 def test_non_existing(self):
1187 self._add_testfile()
1188 self._test()
1189
1190 def test_empty(self):
Lars Gustäbel9520a432009-11-22 18:48:49 +00001191 tarfile.open(self.tarname, "w:").close()
Guido van Rossumd8faa362007-04-27 19:54:29 +00001192 self._add_testfile()
1193 self._test()
1194
1195 def test_empty_fileobj(self):
Lars Gustäbel9520a432009-11-22 18:48:49 +00001196 fobj = io.BytesIO(b"\0" * 1024)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001197 self._add_testfile(fobj)
1198 fobj.seek(0)
1199 self._test(fileobj=fobj)
1200
1201 def test_fileobj(self):
1202 self._create_testtar()
Guido van Rossum34d19282007-08-09 01:03:29 +00001203 data = open(self.tarname, "rb").read()
1204 fobj = io.BytesIO(data)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001205 self._add_testfile(fobj)
1206 fobj.seek(0)
1207 self._test(names=["foo", "bar"], fileobj=fobj)
1208
1209 def test_existing(self):
1210 self._create_testtar()
1211 self._add_testfile()
1212 self._test(names=["foo", "bar"])
1213
1214 def test_append_gz(self):
1215 if gzip is None:
1216 return
1217 self._create_testtar("w:gz")
1218 self.assertRaises(tarfile.ReadError, tarfile.open, tmpname, "a")
1219
1220 def test_append_bz2(self):
1221 if bz2 is None:
1222 return
1223 self._create_testtar("w:bz2")
1224 self.assertRaises(tarfile.ReadError, tarfile.open, tmpname, "a")
1225
Lars Gustäbel9520a432009-11-22 18:48:49 +00001226 # Append mode is supposed to fail if the tarfile to append to
1227 # does not end with a zero block.
1228 def _test_error(self, data):
1229 open(self.tarname, "wb").write(data)
1230 self.assertRaises(tarfile.ReadError, self._add_testfile)
1231
1232 def test_null(self):
1233 self._test_error(b"")
1234
1235 def test_incomplete(self):
1236 self._test_error(b"\0" * 13)
1237
1238 def test_premature_eof(self):
1239 data = tarfile.TarInfo("foo").tobuf()
1240 self._test_error(data)
1241
1242 def test_trailing_garbage(self):
1243 data = tarfile.TarInfo("foo").tobuf()
1244 self._test_error(data + b"\0" * 13)
1245
1246 def test_invalid(self):
1247 self._test_error(b"a" * 512)
1248
Guido van Rossumd8faa362007-04-27 19:54:29 +00001249
1250class LimitsTest(unittest.TestCase):
1251
1252 def test_ustar_limits(self):
1253 # 100 char name
1254 tarinfo = tarfile.TarInfo("0123456789" * 10)
Guido van Rossume7ba4952007-06-06 23:52:48 +00001255 tarinfo.tobuf(tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001256
1257 # 101 char name that cannot be stored
1258 tarinfo = tarfile.TarInfo("0123456789" * 10 + "0")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001259 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001260
1261 # 256 char name with a slash at pos 156
1262 tarinfo = tarfile.TarInfo("123/" * 62 + "longname")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001263 tarinfo.tobuf(tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001264
1265 # 256 char name that cannot be stored
1266 tarinfo = tarfile.TarInfo("1234567/" * 31 + "longname")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001267 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001268
1269 # 512 char name
1270 tarinfo = tarfile.TarInfo("123/" * 126 + "longname")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001271 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001272
1273 # 512 char linkname
1274 tarinfo = tarfile.TarInfo("longlink")
1275 tarinfo.linkname = "123/" * 126 + "longname"
Guido van Rossume7ba4952007-06-06 23:52:48 +00001276 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001277
1278 # uid > 8 digits
1279 tarinfo = tarfile.TarInfo("name")
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001280 tarinfo.uid = 0o10000000
Guido van Rossume7ba4952007-06-06 23:52:48 +00001281 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.USTAR_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001282
1283 def test_gnu_limits(self):
1284 tarinfo = tarfile.TarInfo("123/" * 126 + "longname")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001285 tarinfo.tobuf(tarfile.GNU_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001286
1287 tarinfo = tarfile.TarInfo("longlink")
1288 tarinfo.linkname = "123/" * 126 + "longname"
Guido van Rossume7ba4952007-06-06 23:52:48 +00001289 tarinfo.tobuf(tarfile.GNU_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001290
1291 # uid >= 256 ** 7
1292 tarinfo = tarfile.TarInfo("name")
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001293 tarinfo.uid = 0o4000000000000000000
Guido van Rossume7ba4952007-06-06 23:52:48 +00001294 self.assertRaises(ValueError, tarinfo.tobuf, tarfile.GNU_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001295
1296 def test_pax_limits(self):
Guido van Rossumd8faa362007-04-27 19:54:29 +00001297 tarinfo = tarfile.TarInfo("123/" * 126 + "longname")
Guido van Rossume7ba4952007-06-06 23:52:48 +00001298 tarinfo.tobuf(tarfile.PAX_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001299
1300 tarinfo = tarfile.TarInfo("longlink")
1301 tarinfo.linkname = "123/" * 126 + "longname"
Guido van Rossume7ba4952007-06-06 23:52:48 +00001302 tarinfo.tobuf(tarfile.PAX_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001303
1304 tarinfo = tarfile.TarInfo("name")
Guido van Rossumcd16bf62007-06-13 18:07:49 +00001305 tarinfo.uid = 0o4000000000000000000
Guido van Rossume7ba4952007-06-06 23:52:48 +00001306 tarinfo.tobuf(tarfile.PAX_FORMAT)
Guido van Rossumd8faa362007-04-27 19:54:29 +00001307
1308
Lars Gustäbelb506dc32007-08-07 18:36:16 +00001309class MiscTest(unittest.TestCase):
1310
1311 def test_char_fields(self):
1312 self.assertEqual(tarfile.stn("foo", 8, "ascii", "strict"), b"foo\0\0\0\0\0")
1313 self.assertEqual(tarfile.stn("foobar", 3, "ascii", "strict"), b"foo")
1314 self.assertEqual(tarfile.nts(b"foo\0\0\0\0\0", "ascii", "strict"), "foo")
1315 self.assertEqual(tarfile.nts(b"foo\0bar\0", "ascii", "strict"), "foo")
1316
1317 def test_number_fields(self):
1318 self.assertEqual(tarfile.itn(1), b"0000001\x00")
1319 self.assertEqual(tarfile.itn(0xffffffff), b"\x80\x00\x00\x00\xff\xff\xff\xff")
1320
1321
Lars Gustäbel01385812010-03-03 12:08:54 +00001322class ContextManagerTest(unittest.TestCase):
1323
1324 def test_basic(self):
1325 with tarfile.open(tarname) as tar:
1326 self.assertFalse(tar.closed, "closed inside runtime context")
1327 self.assertTrue(tar.closed, "context manager failed")
1328
1329 def test_closed(self):
1330 # The __enter__() method is supposed to raise IOError
1331 # if the TarFile object is already closed.
1332 tar = tarfile.open(tarname)
1333 tar.close()
1334 with self.assertRaises(IOError):
1335 with tar:
1336 pass
1337
1338 def test_exception(self):
1339 # Test if the IOError exception is passed through properly.
1340 with self.assertRaises(Exception) as exc:
1341 with tarfile.open(tarname) as tar:
1342 raise IOError
1343 self.assertIsInstance(exc.exception, IOError,
1344 "wrong exception raised in context manager")
1345 self.assertTrue(tar.closed, "context manager failed")
1346
1347 def test_no_eof(self):
1348 # __exit__() must not write end-of-archive blocks if an
1349 # exception was raised.
1350 try:
1351 with tarfile.open(tmpname, "w") as tar:
1352 raise Exception
1353 except:
1354 pass
1355 self.assertEqual(os.path.getsize(tmpname), 0,
1356 "context manager wrote an end-of-archive block")
1357 self.assertTrue(tar.closed, "context manager failed")
1358
1359 def test_eof(self):
1360 # __exit__() must write end-of-archive blocks, i.e. call
1361 # TarFile.close() if there was no error.
1362 with tarfile.open(tmpname, "w"):
1363 pass
1364 self.assertNotEqual(os.path.getsize(tmpname), 0,
1365 "context manager wrote no end-of-archive block")
1366
1367 def test_fileobj(self):
1368 # Test that __exit__() did not close the external file
1369 # object.
1370 fobj = open(tmpname, "wb")
1371 try:
1372 with tarfile.open(fileobj=fobj, mode="w") as tar:
1373 raise Exception
1374 except:
1375 pass
1376 self.assertFalse(fobj.closed, "external file object was closed")
1377 self.assertTrue(tar.closed, "context manager failed")
1378 fobj.close()
1379
1380
Guido van Rossumd8faa362007-04-27 19:54:29 +00001381class GzipMiscReadTest(MiscReadTest):
1382 tarname = gzipname
1383 mode = "r:gz"
1384class GzipUstarReadTest(UstarReadTest):
1385 tarname = gzipname
1386 mode = "r:gz"
1387class GzipStreamReadTest(StreamReadTest):
1388 tarname = gzipname
1389 mode = "r|gz"
1390class GzipWriteTest(WriteTest):
1391 mode = "w:gz"
1392class GzipStreamWriteTest(StreamWriteTest):
1393 mode = "w|gz"
1394
1395
1396class Bz2MiscReadTest(MiscReadTest):
1397 tarname = bz2name
1398 mode = "r:bz2"
1399class Bz2UstarReadTest(UstarReadTest):
1400 tarname = bz2name
1401 mode = "r:bz2"
1402class Bz2StreamReadTest(StreamReadTest):
1403 tarname = bz2name
1404 mode = "r|bz2"
1405class Bz2WriteTest(WriteTest):
1406 mode = "w:bz2"
1407class Bz2StreamWriteTest(StreamWriteTest):
1408 mode = "w|bz2"
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001409
Lars Gustäbel42e00912009-03-22 20:34:29 +00001410class Bz2PartialReadTest(unittest.TestCase):
1411 # Issue5068: The _BZ2Proxy.read() method loops forever
1412 # on an empty or partial bzipped file.
1413
1414 def _test_partial_input(self, mode):
1415 class MyBytesIO(io.BytesIO):
1416 hit_eof = False
1417 def read(self, n):
1418 if self.hit_eof:
1419 raise AssertionError("infinite loop detected in tarfile.open()")
1420 self.hit_eof = self.tell() == len(self.getvalue())
1421 return super(MyBytesIO, self).read(n)
Lars Gustäbel9520a432009-11-22 18:48:49 +00001422 def seek(self, *args):
1423 self.hit_eof = False
1424 return super(MyBytesIO, self).seek(*args)
Lars Gustäbel42e00912009-03-22 20:34:29 +00001425
1426 data = bz2.compress(tarfile.TarInfo("foo").tobuf())
1427 for x in range(len(data) + 1):
Lars Gustäbel9520a432009-11-22 18:48:49 +00001428 try:
1429 tarfile.open(fileobj=MyBytesIO(data[:x]), mode=mode)
1430 except tarfile.ReadError:
1431 pass # we have no interest in ReadErrors
Lars Gustäbel42e00912009-03-22 20:34:29 +00001432
1433 def test_partial_input(self):
1434 self._test_partial_input("r")
1435
1436 def test_partial_input_bz2(self):
1437 self._test_partial_input("r:bz2")
1438
1439
Neal Norwitz996acf12003-02-17 14:51:41 +00001440def test_main():
Antoine Pitrou941ee882009-11-11 20:59:38 +00001441 os.makedirs(TEMPDIR)
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001442
Walter Dörwald21d3a322003-05-01 17:45:56 +00001443 tests = [
Guido van Rossumd8faa362007-04-27 19:54:29 +00001444 UstarReadTest,
1445 MiscReadTest,
1446 StreamReadTest,
1447 DetectReadTest,
1448 MemberReadTest,
1449 GNUReadTest,
1450 PaxReadTest,
Walter Dörwald21d3a322003-05-01 17:45:56 +00001451 WriteTest,
Guido van Rossumd8faa362007-04-27 19:54:29 +00001452 StreamWriteTest,
1453 GNUWriteTest,
1454 PaxWriteTest,
Guido van Rossume7ba4952007-06-06 23:52:48 +00001455 UstarUnicodeTest,
1456 GNUUnicodeTest,
Lars Gustäbel3741eff2007-08-21 12:17:05 +00001457 PAXUnicodeTest,
Thomas Wouterscf297e42007-02-23 15:07:44 +00001458 AppendTest,
Guido van Rossumd8faa362007-04-27 19:54:29 +00001459 LimitsTest,
Lars Gustäbelb506dc32007-08-07 18:36:16 +00001460 MiscTest,
Lars Gustäbel01385812010-03-03 12:08:54 +00001461 ContextManagerTest,
Walter Dörwald21d3a322003-05-01 17:45:56 +00001462 ]
1463
Neal Norwitza4f651a2004-07-20 22:07:44 +00001464 if hasattr(os, "link"):
Guido van Rossumd8faa362007-04-27 19:54:29 +00001465 tests.append(HardlinkTest)
1466
1467 fobj = open(tarname, "rb")
1468 data = fobj.read()
1469 fobj.close()
Neal Norwitza4f651a2004-07-20 22:07:44 +00001470
Walter Dörwald21d3a322003-05-01 17:45:56 +00001471 if gzip:
Guido van Rossumd8faa362007-04-27 19:54:29 +00001472 # Create testtar.tar.gz and add gzip-specific tests.
1473 tar = gzip.open(gzipname, "wb")
1474 tar.write(data)
1475 tar.close()
1476
1477 tests += [
1478 GzipMiscReadTest,
1479 GzipUstarReadTest,
1480 GzipStreamReadTest,
1481 GzipWriteTest,
1482 GzipStreamWriteTest,
1483 ]
Walter Dörwald21d3a322003-05-01 17:45:56 +00001484
1485 if bz2:
Guido van Rossumd8faa362007-04-27 19:54:29 +00001486 # Create testtar.tar.bz2 and add bz2-specific tests.
1487 tar = bz2.BZ2File(bz2name, "wb")
1488 tar.write(data)
1489 tar.close()
1490
1491 tests += [
1492 Bz2MiscReadTest,
1493 Bz2UstarReadTest,
1494 Bz2StreamReadTest,
1495 Bz2WriteTest,
1496 Bz2StreamWriteTest,
Lars Gustäbel42e00912009-03-22 20:34:29 +00001497 Bz2PartialReadTest,
Guido van Rossumd8faa362007-04-27 19:54:29 +00001498 ]
1499
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001500 try:
Benjamin Petersonee8712c2008-05-20 21:35:26 +00001501 support.run_unittest(*tests)
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001502 finally:
Guido van Rossumd8faa362007-04-27 19:54:29 +00001503 if os.path.exists(TEMPDIR):
1504 shutil.rmtree(TEMPDIR)
Neal Norwitzb9ef4ae2003-01-05 23:19:43 +00001505
Neal Norwitz996acf12003-02-17 14:51:41 +00001506if __name__ == "__main__":
1507 test_main()