[New-bugs-announce] [issue4843] copytree improvments
report at bugs.python.org
Mon Jan 5 12:58:24 CET 2009
New submission from Tarek Ziadé <ziade.tarek at gmail.com>:
In one sentence:
Let's enhance shutil.copytree so we can drop distutils.[dir_util/file_util]
I am currently studying what could be removed from Distutils in order to
on what is available in the standard library.
I have a concern about distutils.dir_util and distutils.file_util modules.
Distutils implements its own file and directory copy functions there, that
could be replaced by shutil ones, except four small features:
- verbose : each time a file is copied a "source -> target" is displayed
in the output.
- dry_run : nothing is really copied
- update : each file will only be copied if they don't exist in the
target path or if they are newer
- the copy_tree function returns the list of files copied (or that
should have been copied when dry_run is True).
I think shutil could benefit from these small features, and
distutils code could be refactored to use them.
Here's a small proposal for distutils.copytree::
copytree(src, dst, symlinks=False, ignore=None) -> None
copytree(src, dst, symlinks=False, ignore=None, update=False,
verbose=False, dry_run=False, logger=None) -> list of
- if False, copytree behaves as usual: if os.path.samefile(source,
target) is True it raise an error
- if True, the file is copied only if it's newer or doesn't exists,
otherwise it doesn't raise
- if None, logger is set to logging.info
- verbose: if True, a logger.info("source -> target") call is made on
- dry_run: if True, the files are not really copied
Last, the function returns a tuple of copied files.
>From there, distutils can work with shutil.copytree, shutil.copyfile and
- distutils can rely on this function and its specialized modules dissapear
- shutil.copytree becomes more powerful
- less redundancy in the sdtlib
- the API signature is getting a bit complex
- distutils use case might not be common enough
components: Library (Lib)
title: copytree improvments
type: feature request
versions: Python 2.7, Python 3.1
Python tracker <report at bugs.python.org>
More information about the New-bugs-announce