blob: d9e96785b2cb7c9a75ccacc65546e1ab709c6bf9 [file] [log] [blame]
Barry Warsaw7fc2cca2003-01-24 17:34:13 +00001# Copyright (C) 2003 Python Software Foundation
2
3import unittest
4import shutil
5import tempfile
Johannes Gijsbers8e6f2de2004-11-23 09:27:27 +00006import sys
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +00007import stat
Brett Cannon1c3fa182004-06-19 21:11:35 +00008import os
9import os.path
Benjamin Petersonee8712c2008-05-20 21:35:26 +000010from test import support
11from test.support import TESTFN
Tarek Ziadé396fad72010-02-23 05:30:31 +000012from os.path import splitdrive
13from distutils.spawn import find_executable, spawn
14from shutil import (_make_tarball, _make_zipfile, make_archive,
15 register_archive_format, unregister_archive_format,
Tarek Ziadé6ac91722010-04-28 17:51:36 +000016 get_archive_formats, Error, unpack_archive,
17 register_unpack_format, RegistryError,
18 unregister_unpack_format, get_unpack_formats)
Tarek Ziadé396fad72010-02-23 05:30:31 +000019import tarfile
20import warnings
21
22from test import support
23from test.support import TESTFN, check_warnings, captured_stdout
24
Tarek Ziadéffa155a2010-04-29 13:34:35 +000025try:
26 import bz2
27 BZ2_SUPPORTED = True
28except ImportError:
29 BZ2_SUPPORTED = False
30
Antoine Pitrou7fff0962009-05-01 21:09:44 +000031TESTFN2 = TESTFN + "2"
Barry Warsaw7fc2cca2003-01-24 17:34:13 +000032
Tarek Ziadé396fad72010-02-23 05:30:31 +000033try:
34 import grp
35 import pwd
36 UID_GID_SUPPORT = True
37except ImportError:
38 UID_GID_SUPPORT = False
39
40try:
41 import zlib
42except ImportError:
43 zlib = None
44
45try:
46 import zipfile
47 ZIP_SUPPORT = True
48except ImportError:
49 ZIP_SUPPORT = find_executable('zip')
50
Barry Warsaw7fc2cca2003-01-24 17:34:13 +000051class TestShutil(unittest.TestCase):
Tarek Ziadé396fad72010-02-23 05:30:31 +000052
53 def setUp(self):
54 super(TestShutil, self).setUp()
55 self.tempdirs = []
56
57 def tearDown(self):
58 super(TestShutil, self).tearDown()
59 while self.tempdirs:
60 d = self.tempdirs.pop()
61 shutil.rmtree(d, os.name in ('nt', 'cygwin'))
62
63 def write_file(self, path, content='xxx'):
64 """Writes a file in the given path.
65
66
67 path can be a string or a sequence.
68 """
69 if isinstance(path, (list, tuple)):
70 path = os.path.join(*path)
71 f = open(path, 'w')
72 try:
73 f.write(content)
74 finally:
75 f.close()
76
77 def mkdtemp(self):
78 """Create a temporary directory that will be cleaned up.
79
80 Returns the path of the directory.
81 """
82 d = tempfile.mkdtemp()
83 self.tempdirs.append(d)
84 return d
Tarek Ziadé5340db32010-04-19 22:30:51 +000085
Barry Warsaw7fc2cca2003-01-24 17:34:13 +000086 def test_rmtree_errors(self):
87 # filename is guaranteed not to exist
88 filename = tempfile.mktemp()
89 self.assertRaises(OSError, shutil.rmtree, filename)
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +000090
Johannes Gijsbersb8b09d02004-12-06 20:50:15 +000091 # See bug #1071513 for why we don't run this on cygwin
92 # and bug #1076467 for why we don't run this as root.
93 if (hasattr(os, 'chmod') and sys.platform[:6] != 'cygwin'
Johannes Gijsbers6b220b02004-12-12 15:52:57 +000094 and not (hasattr(os, 'geteuid') and os.geteuid() == 0)):
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +000095 def test_on_error(self):
96 self.errorState = 0
97 os.mkdir(TESTFN)
Tim Peters4590c002004-11-01 02:40:52 +000098 self.childpath = os.path.join(TESTFN, 'a')
99 f = open(self.childpath, 'w')
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000100 f.close()
Tim Peters4590c002004-11-01 02:40:52 +0000101 old_dir_mode = os.stat(TESTFN).st_mode
102 old_child_mode = os.stat(self.childpath).st_mode
103 # Make unwritable.
104 os.chmod(self.childpath, stat.S_IREAD)
105 os.chmod(TESTFN, stat.S_IREAD)
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000106
107 shutil.rmtree(TESTFN, onerror=self.check_args_to_onerror)
Johannes Gijsbers8e6f2de2004-11-23 09:27:27 +0000108 # Test whether onerror has actually been called.
Johannes Gijsbersb8b09d02004-12-06 20:50:15 +0000109 self.assertEqual(self.errorState, 2,
110 "Expected call to onerror function did not happen.")
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000111
Tim Peters4590c002004-11-01 02:40:52 +0000112 # Make writable again.
113 os.chmod(TESTFN, old_dir_mode)
114 os.chmod(self.childpath, old_child_mode)
115
116 # Clean up.
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000117 shutil.rmtree(TESTFN)
118
119 def check_args_to_onerror(self, func, arg, exc):
Benjamin Peterson25c95f12009-05-08 20:42:26 +0000120 # test_rmtree_errors deliberately runs rmtree
121 # on a directory that is chmod 400, which will fail.
122 # This function is run when shutil.rmtree fails.
123 # 99.9% of the time it initially fails to remove
124 # a file in the directory, so the first time through
125 # func is os.remove.
126 # However, some Linux machines running ZFS on
127 # FUSE experienced a failure earlier in the process
128 # at os.listdir. The first failure may legally
129 # be either.
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000130 if self.errorState == 0:
Benjamin Peterson25c95f12009-05-08 20:42:26 +0000131 if func is os.remove:
132 self.assertEqual(arg, self.childpath)
133 else:
134 self.assertIs(func, os.listdir,
135 "func must be either os.remove or os.listdir")
136 self.assertEqual(arg, TESTFN)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000137 self.assertTrue(issubclass(exc[0], OSError))
Johannes Gijsbersef5ffc42004-10-31 12:05:31 +0000138 self.errorState = 1
139 else:
140 self.assertEqual(func, os.rmdir)
141 self.assertEqual(arg, TESTFN)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000142 self.assertTrue(issubclass(exc[0], OSError))
Johannes Gijsbers8e6f2de2004-11-23 09:27:27 +0000143 self.errorState = 2
Barry Warsaw7fc2cca2003-01-24 17:34:13 +0000144
Johannes Gijsbersd60e92a2004-09-11 21:26:21 +0000145 def test_rmtree_dont_delete_file(self):
146 # When called on a file instead of a directory, don't delete it.
147 handle, path = tempfile.mkstemp()
148 os.fdopen(handle).close()
149 self.assertRaises(OSError, shutil.rmtree, path)
150 os.remove(path)
151
Tarek Ziadé5340db32010-04-19 22:30:51 +0000152 def _write_data(self, path, data):
153 f = open(path, "w")
154 f.write(data)
155 f.close()
156
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000157 def test_copytree_simple(self):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000158
159 def read_data(path):
160 f = open(path)
161 data = f.read()
162 f.close()
163 return data
164
165 src_dir = tempfile.mkdtemp()
166 dst_dir = os.path.join(tempfile.mkdtemp(), 'destination')
Tarek Ziadé5340db32010-04-19 22:30:51 +0000167 self._write_data(os.path.join(src_dir, 'test.txt'), '123')
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000168 os.mkdir(os.path.join(src_dir, 'test_dir'))
Tarek Ziadé5340db32010-04-19 22:30:51 +0000169 self._write_data(os.path.join(src_dir, 'test_dir', 'test.txt'), '456')
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000170
171 try:
172 shutil.copytree(src_dir, dst_dir)
173 self.assertTrue(os.path.isfile(os.path.join(dst_dir, 'test.txt')))
174 self.assertTrue(os.path.isdir(os.path.join(dst_dir, 'test_dir')))
175 self.assertTrue(os.path.isfile(os.path.join(dst_dir, 'test_dir',
176 'test.txt')))
177 actual = read_data(os.path.join(dst_dir, 'test.txt'))
178 self.assertEqual(actual, '123')
179 actual = read_data(os.path.join(dst_dir, 'test_dir', 'test.txt'))
180 self.assertEqual(actual, '456')
181 finally:
182 for path in (
183 os.path.join(src_dir, 'test.txt'),
184 os.path.join(dst_dir, 'test.txt'),
185 os.path.join(src_dir, 'test_dir', 'test.txt'),
186 os.path.join(dst_dir, 'test_dir', 'test.txt'),
187 ):
188 if os.path.exists(path):
189 os.remove(path)
Christian Heimese052dd82007-11-20 03:20:04 +0000190 for path in (src_dir,
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000191 os.path.dirname(dst_dir)
Christian Heimese052dd82007-11-20 03:20:04 +0000192 ):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000193 if os.path.exists(path):
Christian Heimes94140152007-11-20 01:45:17 +0000194 shutil.rmtree(path)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000195
Georg Brandl2ee470f2008-07-16 12:55:28 +0000196 def test_copytree_with_exclude(self):
197
Georg Brandl2ee470f2008-07-16 12:55:28 +0000198 def read_data(path):
199 f = open(path)
200 data = f.read()
201 f.close()
202 return data
203
204 # creating data
205 join = os.path.join
206 exists = os.path.exists
207 src_dir = tempfile.mkdtemp()
Georg Brandl2ee470f2008-07-16 12:55:28 +0000208 try:
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000209 dst_dir = join(tempfile.mkdtemp(), 'destination')
Tarek Ziadé5340db32010-04-19 22:30:51 +0000210 self._write_data(join(src_dir, 'test.txt'), '123')
211 self._write_data(join(src_dir, 'test.tmp'), '123')
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000212 os.mkdir(join(src_dir, 'test_dir'))
Tarek Ziadé5340db32010-04-19 22:30:51 +0000213 self._write_data(join(src_dir, 'test_dir', 'test.txt'), '456')
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000214 os.mkdir(join(src_dir, 'test_dir2'))
Tarek Ziadé5340db32010-04-19 22:30:51 +0000215 self._write_data(join(src_dir, 'test_dir2', 'test.txt'), '456')
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000216 os.mkdir(join(src_dir, 'test_dir2', 'subdir'))
217 os.mkdir(join(src_dir, 'test_dir2', 'subdir2'))
Tarek Ziadé5340db32010-04-19 22:30:51 +0000218 self._write_data(join(src_dir, 'test_dir2', 'subdir', 'test.txt'),
219 '456')
220 self._write_data(join(src_dir, 'test_dir2', 'subdir2', 'test.py'),
221 '456')
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000222
223
224 # testing glob-like patterns
225 try:
226 patterns = shutil.ignore_patterns('*.tmp', 'test_dir2')
227 shutil.copytree(src_dir, dst_dir, ignore=patterns)
228 # checking the result: some elements should not be copied
229 self.assertTrue(exists(join(dst_dir, 'test.txt')))
230 self.assertTrue(not exists(join(dst_dir, 'test.tmp')))
231 self.assertTrue(not exists(join(dst_dir, 'test_dir2')))
232 finally:
233 if os.path.exists(dst_dir):
234 shutil.rmtree(dst_dir)
235 try:
236 patterns = shutil.ignore_patterns('*.tmp', 'subdir*')
237 shutil.copytree(src_dir, dst_dir, ignore=patterns)
238 # checking the result: some elements should not be copied
239 self.assertTrue(not exists(join(dst_dir, 'test.tmp')))
240 self.assertTrue(not exists(join(dst_dir, 'test_dir2', 'subdir2')))
241 self.assertTrue(not exists(join(dst_dir, 'test_dir2', 'subdir')))
242 finally:
243 if os.path.exists(dst_dir):
244 shutil.rmtree(dst_dir)
245
246 # testing callable-style
247 try:
248 def _filter(src, names):
249 res = []
250 for name in names:
251 path = os.path.join(src, name)
252
253 if (os.path.isdir(path) and
254 path.split()[-1] == 'subdir'):
255 res.append(name)
256 elif os.path.splitext(path)[-1] in ('.py'):
257 res.append(name)
258 return res
259
260 shutil.copytree(src_dir, dst_dir, ignore=_filter)
261
262 # checking the result: some elements should not be copied
263 self.assertTrue(not exists(join(dst_dir, 'test_dir2', 'subdir2',
264 'test.py')))
265 self.assertTrue(not exists(join(dst_dir, 'test_dir2', 'subdir')))
266
267 finally:
268 if os.path.exists(dst_dir):
269 shutil.rmtree(dst_dir)
Georg Brandl2ee470f2008-07-16 12:55:28 +0000270 finally:
Antoine Pitrou97c81ef2009-11-04 00:57:15 +0000271 shutil.rmtree(src_dir)
272 shutil.rmtree(os.path.dirname(dst_dir))
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000273
Hirokazu Yamamoto26681452010-12-05 02:04:16 +0000274 @unittest.skipUnless(hasattr(os, 'link'), 'requires os.link')
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000275 def test_dont_copy_file_onto_link_to_itself(self):
Georg Brandl724d0892010-12-05 07:51:39 +0000276 # Temporarily disable test on Windows.
277 if os.name == 'nt':
278 return
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000279 # bug 851123.
280 os.mkdir(TESTFN)
281 src = os.path.join(TESTFN, 'cheese')
282 dst = os.path.join(TESTFN, 'shop')
283 try:
Hirokazu Yamamoto26681452010-12-05 02:04:16 +0000284 with open(src, 'w') as f:
285 f.write('cheddar')
286 os.link(src, dst)
287 self.assertRaises(shutil.Error, shutil.copyfile, src, dst)
288 with open(src, 'r') as f:
289 self.assertEqual(f.read(), 'cheddar')
290 os.remove(dst)
291 finally:
292 shutil.rmtree(TESTFN, ignore_errors=True)
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000293
Hirokazu Yamamoto26681452010-12-05 02:04:16 +0000294 @unittest.skipUnless(hasattr(os, "symlink"),
295 "Missing symlink implementation")
296 def test_dont_copy_file_onto_symlink_to_itself(self):
297 # bug 851123.
298 os.mkdir(TESTFN)
299 src = os.path.join(TESTFN, 'cheese')
300 dst = os.path.join(TESTFN, 'shop')
301 try:
302 with open(src, 'w') as f:
303 f.write('cheddar')
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000304 # Using `src` here would mean we end up with a symlink pointing
305 # to TESTFN/TESTFN/cheese, while it should point at
306 # TESTFN/cheese.
307 os.symlink('cheese', dst)
308 self.assertRaises(shutil.Error, shutil.copyfile, src, dst)
Antoine Pitrou92f60ed2010-10-14 22:11:44 +0000309 with open(src, 'r') as f:
310 self.assertEqual(f.read(), 'cheddar')
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000311 os.remove(dst)
312 finally:
Hirokazu Yamamoto26681452010-12-05 02:04:16 +0000313 shutil.rmtree(TESTFN, ignore_errors=True)
Johannes Gijsbers68128712004-08-14 13:57:08 +0000314
Brian Curtin52173d42010-12-02 18:29:18 +0000315 @unittest.skipUnless(hasattr(os, "symlink"),
316 "Missing symlink implementation")
Brian Curtind40e6f72010-07-08 21:39:08 +0000317 def test_rmtree_on_symlink(self):
318 # bug 1669.
319 os.mkdir(TESTFN)
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000320 try:
Brian Curtind40e6f72010-07-08 21:39:08 +0000321 src = os.path.join(TESTFN, 'cheese')
322 dst = os.path.join(TESTFN, 'shop')
323 os.mkdir(src)
324 os.symlink(src, dst)
325 self.assertRaises(OSError, shutil.rmtree, dst)
Tarek Ziadé51a6f722010-04-23 13:03:09 +0000326 finally:
Brian Curtind40e6f72010-07-08 21:39:08 +0000327 shutil.rmtree(TESTFN, ignore_errors=True)
328
329 if hasattr(os, "mkfifo"):
330 # Issue #3002: copyfile and copytree block indefinitely on named pipes
331 def test_copyfile_named_pipe(self):
332 os.mkfifo(TESTFN)
333 try:
334 self.assertRaises(shutil.SpecialFileError,
335 shutil.copyfile, TESTFN, TESTFN2)
336 self.assertRaises(shutil.SpecialFileError,
337 shutil.copyfile, __file__, TESTFN)
338 finally:
339 os.remove(TESTFN)
Antoine Pitrou7fff0962009-05-01 21:09:44 +0000340
Brian Curtin52173d42010-12-02 18:29:18 +0000341 @unittest.skipUnless(hasattr(os, "symlink"),
342 "Missing symlink implementation")
343 def test_copytree_named_pipe(self):
344 os.mkdir(TESTFN)
Antoine Pitrou7fff0962009-05-01 21:09:44 +0000345 try:
Brian Curtin52173d42010-12-02 18:29:18 +0000346 subdir = os.path.join(TESTFN, "subdir")
347 os.mkdir(subdir)
348 pipe = os.path.join(subdir, "mypipe")
349 os.mkfifo(pipe)
350 try:
351 shutil.copytree(TESTFN, TESTFN2)
352 except shutil.Error as e:
353 errors = e.args[0]
354 self.assertEqual(len(errors), 1)
355 src, dst, error_msg = errors[0]
356 self.assertEqual("`%s` is a named pipe" % pipe, error_msg)
357 else:
358 self.fail("shutil.Error should have been raised")
359 finally:
360 shutil.rmtree(TESTFN, ignore_errors=True)
361 shutil.rmtree(TESTFN2, ignore_errors=True)
Antoine Pitrou7fff0962009-05-01 21:09:44 +0000362
Tarek Ziadé5340db32010-04-19 22:30:51 +0000363 def test_copytree_special_func(self):
364
365 src_dir = self.mkdtemp()
366 dst_dir = os.path.join(self.mkdtemp(), 'destination')
367 self._write_data(os.path.join(src_dir, 'test.txt'), '123')
368 os.mkdir(os.path.join(src_dir, 'test_dir'))
369 self._write_data(os.path.join(src_dir, 'test_dir', 'test.txt'), '456')
370
371 copied = []
372 def _copy(src, dst):
373 copied.append((src, dst))
374
375 shutil.copytree(src_dir, dst_dir, copy_function=_copy)
Ezio Melottib3aedd42010-11-20 19:04:17 +0000376 self.assertEqual(len(copied), 2)
Tarek Ziadé5340db32010-04-19 22:30:51 +0000377
Brian Curtin52173d42010-12-02 18:29:18 +0000378 @unittest.skipUnless(hasattr(os, "symlink"),
379 "Missing symlink implementation")
Tarek Ziadéfb437512010-04-20 08:57:33 +0000380 def test_copytree_dangling_symlinks(self):
381
382 # a dangling symlink raises an error at the end
383 src_dir = self.mkdtemp()
384 dst_dir = os.path.join(self.mkdtemp(), 'destination')
385 os.symlink('IDONTEXIST', os.path.join(src_dir, 'test.txt'))
386 os.mkdir(os.path.join(src_dir, 'test_dir'))
387 self._write_data(os.path.join(src_dir, 'test_dir', 'test.txt'), '456')
388 self.assertRaises(Error, shutil.copytree, src_dir, dst_dir)
389
390 # a dangling symlink is ignored with the proper flag
391 dst_dir = os.path.join(self.mkdtemp(), 'destination2')
392 shutil.copytree(src_dir, dst_dir, ignore_dangling_symlinks=True)
393 self.assertNotIn('test.txt', os.listdir(dst_dir))
394
395 # a dangling symlink is copied if symlinks=True
396 dst_dir = os.path.join(self.mkdtemp(), 'destination3')
397 shutil.copytree(src_dir, dst_dir, symlinks=True)
398 self.assertIn('test.txt', os.listdir(dst_dir))
399
Tarek Ziadé396fad72010-02-23 05:30:31 +0000400 @unittest.skipUnless(zlib, "requires zlib")
401 def test_make_tarball(self):
402 # creating something to tar
403 tmpdir = self.mkdtemp()
404 self.write_file([tmpdir, 'file1'], 'xxx')
405 self.write_file([tmpdir, 'file2'], 'xxx')
406 os.mkdir(os.path.join(tmpdir, 'sub'))
407 self.write_file([tmpdir, 'sub', 'file3'], 'xxx')
408
409 tmpdir2 = self.mkdtemp()
410 unittest.skipUnless(splitdrive(tmpdir)[0] == splitdrive(tmpdir2)[0],
411 "source and target should be on same drive")
412
413 base_name = os.path.join(tmpdir2, 'archive')
414
415 # working with relative paths to avoid tar warnings
416 old_dir = os.getcwd()
417 os.chdir(tmpdir)
418 try:
419 _make_tarball(splitdrive(base_name)[1], '.')
420 finally:
421 os.chdir(old_dir)
422
423 # check if the compressed tarball was created
424 tarball = base_name + '.tar.gz'
425 self.assertTrue(os.path.exists(tarball))
426
427 # trying an uncompressed one
428 base_name = os.path.join(tmpdir2, 'archive')
429 old_dir = os.getcwd()
430 os.chdir(tmpdir)
431 try:
432 _make_tarball(splitdrive(base_name)[1], '.', compress=None)
433 finally:
434 os.chdir(old_dir)
435 tarball = base_name + '.tar'
436 self.assertTrue(os.path.exists(tarball))
437
438 def _tarinfo(self, path):
439 tar = tarfile.open(path)
440 try:
441 names = tar.getnames()
442 names.sort()
443 return tuple(names)
444 finally:
445 tar.close()
446
447 def _create_files(self):
448 # creating something to tar
449 tmpdir = self.mkdtemp()
450 dist = os.path.join(tmpdir, 'dist')
451 os.mkdir(dist)
452 self.write_file([dist, 'file1'], 'xxx')
453 self.write_file([dist, 'file2'], 'xxx')
454 os.mkdir(os.path.join(dist, 'sub'))
455 self.write_file([dist, 'sub', 'file3'], 'xxx')
456 os.mkdir(os.path.join(dist, 'sub2'))
457 tmpdir2 = self.mkdtemp()
458 base_name = os.path.join(tmpdir2, 'archive')
459 return tmpdir, tmpdir2, base_name
460
461 @unittest.skipUnless(zlib, "Requires zlib")
462 @unittest.skipUnless(find_executable('tar') and find_executable('gzip'),
463 'Need the tar command to run')
464 def test_tarfile_vs_tar(self):
465 tmpdir, tmpdir2, base_name = self._create_files()
466 old_dir = os.getcwd()
467 os.chdir(tmpdir)
468 try:
469 _make_tarball(base_name, 'dist')
470 finally:
471 os.chdir(old_dir)
472
473 # check if the compressed tarball was created
474 tarball = base_name + '.tar.gz'
475 self.assertTrue(os.path.exists(tarball))
476
477 # now create another tarball using `tar`
478 tarball2 = os.path.join(tmpdir, 'archive2.tar.gz')
479 tar_cmd = ['tar', '-cf', 'archive2.tar', 'dist']
480 gzip_cmd = ['gzip', '-f9', 'archive2.tar']
481 old_dir = os.getcwd()
482 os.chdir(tmpdir)
483 try:
484 with captured_stdout() as s:
485 spawn(tar_cmd)
486 spawn(gzip_cmd)
487 finally:
488 os.chdir(old_dir)
489
490 self.assertTrue(os.path.exists(tarball2))
491 # let's compare both tarballs
Ezio Melottib3aedd42010-11-20 19:04:17 +0000492 self.assertEqual(self._tarinfo(tarball), self._tarinfo(tarball2))
Tarek Ziadé396fad72010-02-23 05:30:31 +0000493
494 # trying an uncompressed one
495 base_name = os.path.join(tmpdir2, 'archive')
496 old_dir = os.getcwd()
497 os.chdir(tmpdir)
498 try:
499 _make_tarball(base_name, 'dist', compress=None)
500 finally:
501 os.chdir(old_dir)
502 tarball = base_name + '.tar'
503 self.assertTrue(os.path.exists(tarball))
504
505 # now for a dry_run
506 base_name = os.path.join(tmpdir2, 'archive')
507 old_dir = os.getcwd()
508 os.chdir(tmpdir)
509 try:
510 _make_tarball(base_name, 'dist', compress=None, dry_run=True)
511 finally:
512 os.chdir(old_dir)
513 tarball = base_name + '.tar'
514 self.assertTrue(os.path.exists(tarball))
515
Tarek Ziadé396fad72010-02-23 05:30:31 +0000516 @unittest.skipUnless(zlib, "Requires zlib")
517 @unittest.skipUnless(ZIP_SUPPORT, 'Need zip support to run')
518 def test_make_zipfile(self):
519 # creating something to tar
520 tmpdir = self.mkdtemp()
521 self.write_file([tmpdir, 'file1'], 'xxx')
522 self.write_file([tmpdir, 'file2'], 'xxx')
523
524 tmpdir2 = self.mkdtemp()
525 base_name = os.path.join(tmpdir2, 'archive')
526 _make_zipfile(base_name, tmpdir)
527
528 # check if the compressed tarball was created
529 tarball = base_name + '.zip'
Éric Araujo1c505492010-11-06 02:12:51 +0000530 self.assertTrue(os.path.exists(tarball))
Tarek Ziadé396fad72010-02-23 05:30:31 +0000531
532
533 def test_make_archive(self):
534 tmpdir = self.mkdtemp()
535 base_name = os.path.join(tmpdir, 'archive')
536 self.assertRaises(ValueError, make_archive, base_name, 'xxx')
537
538 @unittest.skipUnless(zlib, "Requires zlib")
539 def test_make_archive_owner_group(self):
540 # testing make_archive with owner and group, with various combinations
541 # this works even if there's not gid/uid support
542 if UID_GID_SUPPORT:
543 group = grp.getgrgid(0)[0]
544 owner = pwd.getpwuid(0)[0]
545 else:
546 group = owner = 'root'
547
548 base_dir, root_dir, base_name = self._create_files()
549 base_name = os.path.join(self.mkdtemp() , 'archive')
550 res = make_archive(base_name, 'zip', root_dir, base_dir, owner=owner,
551 group=group)
552 self.assertTrue(os.path.exists(res))
553
554 res = make_archive(base_name, 'zip', root_dir, base_dir)
555 self.assertTrue(os.path.exists(res))
556
557 res = make_archive(base_name, 'tar', root_dir, base_dir,
558 owner=owner, group=group)
559 self.assertTrue(os.path.exists(res))
560
561 res = make_archive(base_name, 'tar', root_dir, base_dir,
562 owner='kjhkjhkjg', group='oihohoh')
563 self.assertTrue(os.path.exists(res))
564
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000565
Tarek Ziadé396fad72010-02-23 05:30:31 +0000566 @unittest.skipUnless(zlib, "Requires zlib")
567 @unittest.skipUnless(UID_GID_SUPPORT, "Requires grp and pwd support")
568 def test_tarfile_root_owner(self):
569 tmpdir, tmpdir2, base_name = self._create_files()
570 old_dir = os.getcwd()
571 os.chdir(tmpdir)
572 group = grp.getgrgid(0)[0]
573 owner = pwd.getpwuid(0)[0]
574 try:
575 archive_name = _make_tarball(base_name, 'dist', compress=None,
576 owner=owner, group=group)
577 finally:
578 os.chdir(old_dir)
579
580 # check if the compressed tarball was created
581 self.assertTrue(os.path.exists(archive_name))
582
583 # now checks the rights
584 archive = tarfile.open(archive_name)
585 try:
586 for member in archive.getmembers():
Ezio Melottib3aedd42010-11-20 19:04:17 +0000587 self.assertEqual(member.uid, 0)
588 self.assertEqual(member.gid, 0)
Tarek Ziadé396fad72010-02-23 05:30:31 +0000589 finally:
590 archive.close()
591
592 def test_make_archive_cwd(self):
593 current_dir = os.getcwd()
594 def _breaks(*args, **kw):
595 raise RuntimeError()
596
597 register_archive_format('xxx', _breaks, [], 'xxx file')
598 try:
599 try:
600 make_archive('xxx', 'xxx', root_dir=self.mkdtemp())
601 except Exception:
602 pass
Ezio Melottib3aedd42010-11-20 19:04:17 +0000603 self.assertEqual(os.getcwd(), current_dir)
Tarek Ziadé396fad72010-02-23 05:30:31 +0000604 finally:
605 unregister_archive_format('xxx')
606
607 def test_register_archive_format(self):
608
609 self.assertRaises(TypeError, register_archive_format, 'xxx', 1)
610 self.assertRaises(TypeError, register_archive_format, 'xxx', lambda: x,
611 1)
612 self.assertRaises(TypeError, register_archive_format, 'xxx', lambda: x,
613 [(1, 2), (1, 2, 3)])
614
615 register_archive_format('xxx', lambda: x, [(1, 2)], 'xxx file')
616 formats = [name for name, params in get_archive_formats()]
617 self.assertIn('xxx', formats)
618
619 unregister_archive_format('xxx')
620 formats = [name for name, params in get_archive_formats()]
621 self.assertNotIn('xxx', formats)
622
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000623 def _compare_dirs(self, dir1, dir2):
624 # check that dir1 and dir2 are equivalent,
625 # return the diff
626 diff = []
627 for root, dirs, files in os.walk(dir1):
628 for file_ in files:
629 path = os.path.join(root, file_)
630 target_path = os.path.join(dir2, os.path.split(path)[-1])
631 if not os.path.exists(target_path):
632 diff.append(file_)
633 return diff
634
635 @unittest.skipUnless(zlib, "Requires zlib")
636 def test_unpack_archive(self):
Tarek Ziadéffa155a2010-04-29 13:34:35 +0000637 formats = ['tar', 'gztar', 'zip']
638 if BZ2_SUPPORTED:
639 formats.append('bztar')
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000640
Tarek Ziadéffa155a2010-04-29 13:34:35 +0000641 for format in formats:
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000642 tmpdir = self.mkdtemp()
643 base_dir, root_dir, base_name = self._create_files()
644 tmpdir2 = self.mkdtemp()
645 filename = make_archive(base_name, format, root_dir, base_dir)
646
647 # let's try to unpack it now
648 unpack_archive(filename, tmpdir2)
649 diff = self._compare_dirs(tmpdir, tmpdir2)
Ezio Melottib3aedd42010-11-20 19:04:17 +0000650 self.assertEqual(diff, [])
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000651
652 def test_unpack_registery(self):
653
654 formats = get_unpack_formats()
655
656 def _boo(filename, extract_dir, extra):
Ezio Melottib3aedd42010-11-20 19:04:17 +0000657 self.assertEqual(extra, 1)
658 self.assertEqual(filename, 'stuff.boo')
659 self.assertEqual(extract_dir, 'xx')
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000660
661 register_unpack_format('Boo', ['.boo', '.b2'], _boo, [('extra', 1)])
662 unpack_archive('stuff.boo', 'xx')
663
664 # trying to register a .boo unpacker again
665 self.assertRaises(RegistryError, register_unpack_format, 'Boo2',
666 ['.boo'], _boo)
667
668 # should work now
669 unregister_unpack_format('Boo')
670 register_unpack_format('Boo2', ['.boo'], _boo)
671 self.assertIn(('Boo2', ['.boo'], ''), get_unpack_formats())
672 self.assertNotIn(('Boo', ['.boo'], ''), get_unpack_formats())
673
674 # let's leave a clean state
675 unregister_unpack_format('Boo2')
Ezio Melottib3aedd42010-11-20 19:04:17 +0000676 self.assertEqual(get_unpack_formats(), formats)
Tarek Ziadé6ac91722010-04-28 17:51:36 +0000677
Christian Heimes9bd667a2008-01-20 15:14:11 +0000678
Christian Heimesada8c3b2008-03-18 18:26:33 +0000679class TestMove(unittest.TestCase):
680
681 def setUp(self):
682 filename = "foo"
683 self.src_dir = tempfile.mkdtemp()
684 self.dst_dir = tempfile.mkdtemp()
685 self.src_file = os.path.join(self.src_dir, filename)
686 self.dst_file = os.path.join(self.dst_dir, filename)
687 # Try to create a dir in the current directory, hoping that it is
688 # not located on the same filesystem as the system tmp dir.
689 try:
690 self.dir_other_fs = tempfile.mkdtemp(
691 dir=os.path.dirname(__file__))
692 self.file_other_fs = os.path.join(self.dir_other_fs,
693 filename)
694 except OSError:
695 self.dir_other_fs = None
696 with open(self.src_file, "wb") as f:
697 f.write(b"spam")
698
699 def tearDown(self):
700 for d in (self.src_dir, self.dst_dir, self.dir_other_fs):
701 try:
702 if d:
703 shutil.rmtree(d)
704 except:
705 pass
706
707 def _check_move_file(self, src, dst, real_dst):
Antoine Pitrou92f60ed2010-10-14 22:11:44 +0000708 with open(src, "rb") as f:
709 contents = f.read()
Christian Heimesada8c3b2008-03-18 18:26:33 +0000710 shutil.move(src, dst)
Antoine Pitrou92f60ed2010-10-14 22:11:44 +0000711 with open(real_dst, "rb") as f:
712 self.assertEqual(contents, f.read())
Christian Heimesada8c3b2008-03-18 18:26:33 +0000713 self.assertFalse(os.path.exists(src))
714
715 def _check_move_dir(self, src, dst, real_dst):
716 contents = sorted(os.listdir(src))
717 shutil.move(src, dst)
718 self.assertEqual(contents, sorted(os.listdir(real_dst)))
719 self.assertFalse(os.path.exists(src))
720
721 def test_move_file(self):
722 # Move a file to another location on the same filesystem.
723 self._check_move_file(self.src_file, self.dst_file, self.dst_file)
724
725 def test_move_file_to_dir(self):
726 # Move a file inside an existing dir on the same filesystem.
727 self._check_move_file(self.src_file, self.dst_dir, self.dst_file)
728
729 def test_move_file_other_fs(self):
730 # Move a file to an existing dir on another filesystem.
731 if not self.dir_other_fs:
732 # skip
733 return
734 self._check_move_file(self.src_file, self.file_other_fs,
735 self.file_other_fs)
736
737 def test_move_file_to_dir_other_fs(self):
738 # Move a file to another location on another filesystem.
739 if not self.dir_other_fs:
740 # skip
741 return
742 self._check_move_file(self.src_file, self.dir_other_fs,
743 self.file_other_fs)
744
745 def test_move_dir(self):
746 # Move a dir to another location on the same filesystem.
747 dst_dir = tempfile.mktemp()
748 try:
749 self._check_move_dir(self.src_dir, dst_dir, dst_dir)
750 finally:
751 try:
752 shutil.rmtree(dst_dir)
753 except:
754 pass
755
756 def test_move_dir_other_fs(self):
757 # Move a dir to another location on another filesystem.
758 if not self.dir_other_fs:
759 # skip
760 return
761 dst_dir = tempfile.mktemp(dir=self.dir_other_fs)
762 try:
763 self._check_move_dir(self.src_dir, dst_dir, dst_dir)
764 finally:
765 try:
766 shutil.rmtree(dst_dir)
767 except:
768 pass
769
770 def test_move_dir_to_dir(self):
771 # Move a dir inside an existing dir on the same filesystem.
772 self._check_move_dir(self.src_dir, self.dst_dir,
773 os.path.join(self.dst_dir, os.path.basename(self.src_dir)))
774
775 def test_move_dir_to_dir_other_fs(self):
776 # Move a dir inside an existing dir on another filesystem.
777 if not self.dir_other_fs:
778 # skip
779 return
780 self._check_move_dir(self.src_dir, self.dir_other_fs,
781 os.path.join(self.dir_other_fs, os.path.basename(self.src_dir)))
782
783 def test_existing_file_inside_dest_dir(self):
784 # A file with the same name inside the destination dir already exists.
785 with open(self.dst_file, "wb"):
786 pass
787 self.assertRaises(shutil.Error, shutil.move, self.src_file, self.dst_dir)
788
789 def test_dont_move_dir_in_itself(self):
790 # Moving a dir inside itself raises an Error.
791 dst = os.path.join(self.src_dir, "bar")
792 self.assertRaises(shutil.Error, shutil.move, self.src_dir, dst)
793
Antoine Pitrou0dcc3cd2009-01-29 20:26:59 +0000794 def test_destinsrc_false_negative(self):
795 os.mkdir(TESTFN)
796 try:
797 for src, dst in [('srcdir', 'srcdir/dest')]:
798 src = os.path.join(TESTFN, src)
799 dst = os.path.join(TESTFN, dst)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000800 self.assertTrue(shutil._destinsrc(src, dst),
Benjamin Peterson247a9b82009-02-20 04:09:19 +0000801 msg='_destinsrc() wrongly concluded that '
Antoine Pitrou0dcc3cd2009-01-29 20:26:59 +0000802 'dst (%s) is not in src (%s)' % (dst, src))
803 finally:
804 shutil.rmtree(TESTFN, ignore_errors=True)
Christian Heimesada8c3b2008-03-18 18:26:33 +0000805
Antoine Pitrou0dcc3cd2009-01-29 20:26:59 +0000806 def test_destinsrc_false_positive(self):
807 os.mkdir(TESTFN)
808 try:
809 for src, dst in [('srcdir', 'src/dest'), ('srcdir', 'srcdir.new')]:
810 src = os.path.join(TESTFN, src)
811 dst = os.path.join(TESTFN, dst)
Benjamin Petersonc9c0f202009-06-30 23:06:06 +0000812 self.assertFalse(shutil._destinsrc(src, dst),
Benjamin Peterson247a9b82009-02-20 04:09:19 +0000813 msg='_destinsrc() wrongly concluded that '
Antoine Pitrou0dcc3cd2009-01-29 20:26:59 +0000814 'dst (%s) is in src (%s)' % (dst, src))
815 finally:
816 shutil.rmtree(TESTFN, ignore_errors=True)
Christian Heimes9bd667a2008-01-20 15:14:11 +0000817
Tarek Ziadé5340db32010-04-19 22:30:51 +0000818
Tarek Ziadéae4d5c62010-05-05 22:27:31 +0000819class TestCopyFile(unittest.TestCase):
820
821 _delete = False
822
823 class Faux(object):
824 _entered = False
825 _exited_with = None
826 _raised = False
827 def __init__(self, raise_in_exit=False, suppress_at_exit=True):
828 self._raise_in_exit = raise_in_exit
829 self._suppress_at_exit = suppress_at_exit
830 def read(self, *args):
831 return ''
832 def __enter__(self):
833 self._entered = True
834 def __exit__(self, exc_type, exc_val, exc_tb):
835 self._exited_with = exc_type, exc_val, exc_tb
836 if self._raise_in_exit:
837 self._raised = True
838 raise IOError("Cannot close")
839 return self._suppress_at_exit
840
841 def tearDown(self):
842 if self._delete:
843 del shutil.open
844
845 def _set_shutil_open(self, func):
846 shutil.open = func
847 self._delete = True
848
849 def test_w_source_open_fails(self):
850 def _open(filename, mode='r'):
851 if filename == 'srcfile':
852 raise IOError('Cannot open "srcfile"')
853 assert 0 # shouldn't reach here.
854
855 self._set_shutil_open(_open)
856
857 self.assertRaises(IOError, shutil.copyfile, 'srcfile', 'destfile')
858
859 def test_w_dest_open_fails(self):
860
861 srcfile = self.Faux()
862
863 def _open(filename, mode='r'):
864 if filename == 'srcfile':
865 return srcfile
866 if filename == 'destfile':
867 raise IOError('Cannot open "destfile"')
868 assert 0 # shouldn't reach here.
869
870 self._set_shutil_open(_open)
871
872 shutil.copyfile('srcfile', 'destfile')
873 self.assertTrue(srcfile._entered)
874 self.assertTrue(srcfile._exited_with[0] is IOError)
875 self.assertEqual(srcfile._exited_with[1].args,
876 ('Cannot open "destfile"',))
877
878 def test_w_dest_close_fails(self):
879
880 srcfile = self.Faux()
881 destfile = self.Faux(True)
882
883 def _open(filename, mode='r'):
884 if filename == 'srcfile':
885 return srcfile
886 if filename == 'destfile':
887 return destfile
888 assert 0 # shouldn't reach here.
889
890 self._set_shutil_open(_open)
891
892 shutil.copyfile('srcfile', 'destfile')
893 self.assertTrue(srcfile._entered)
894 self.assertTrue(destfile._entered)
895 self.assertTrue(destfile._raised)
896 self.assertTrue(srcfile._exited_with[0] is IOError)
897 self.assertEqual(srcfile._exited_with[1].args,
898 ('Cannot close',))
899
900 def test_w_source_close_fails(self):
901
902 srcfile = self.Faux(True)
903 destfile = self.Faux()
904
905 def _open(filename, mode='r'):
906 if filename == 'srcfile':
907 return srcfile
908 if filename == 'destfile':
909 return destfile
910 assert 0 # shouldn't reach here.
911
912 self._set_shutil_open(_open)
913
914 self.assertRaises(IOError,
915 shutil.copyfile, 'srcfile', 'destfile')
916 self.assertTrue(srcfile._entered)
917 self.assertTrue(destfile._entered)
918 self.assertFalse(destfile._raised)
919 self.assertTrue(srcfile._exited_with[0] is None)
920 self.assertTrue(srcfile._raised)
921
922
Barry Warsaw7fc2cca2003-01-24 17:34:13 +0000923def test_main():
Tarek Ziadéae4d5c62010-05-05 22:27:31 +0000924 support.run_unittest(TestShutil, TestMove, TestCopyFile)
Barry Warsaw7fc2cca2003-01-24 17:34:13 +0000925
Barry Warsaw7fc2cca2003-01-24 17:34:13 +0000926if __name__ == '__main__':
Walter Dörwald21d3a322003-05-01 17:45:56 +0000927 test_main()