diff options
author | Zackery Spytz <zspytz@gmail.com> | 2022-04-05 02:57:17 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-04-05 02:57:17 (GMT) |
commit | e06f920c5bc6e9fad29082ba0d84043722806e17 (patch) | |
tree | 3555c49c5af68917272b9f508608eef4da2edd87 | |
parent | 772d8080c9fd635c3999673ca9fad8b674385c7f (diff) | |
download | cpython-e06f920c5bc6e9fad29082ba0d84043722806e17.zip cpython-e06f920c5bc6e9fad29082ba0d84043722806e17.tar.gz cpython-e06f920c5bc6e9fad29082ba0d84043722806e17.tar.bz2 |
bpo-40982: shutil docs: Remove outdated copytree() example (GH-24778)
It is not preferable to keep a copy of the implementation in the
docs.
-rw-r--r-- | Doc/library/shutil.rst | 37 |
1 files changed, 1 insertions, 36 deletions
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst index 16b8d3c..ac271ce 100644 --- a/Doc/library/shutil.rst +++ b/Doc/library/shutil.rst @@ -476,42 +476,7 @@ file then shutil will silently fallback on using less efficient copytree example ~~~~~~~~~~~~~~~~ -This example is the implementation of the :func:`copytree` function, described -above, with the docstring omitted. It demonstrates many of the other functions -provided by this module. :: - - def copytree(src, dst, symlinks=False): - names = os.listdir(src) - os.makedirs(dst) - errors = [] - for name in names: - srcname = os.path.join(src, name) - dstname = os.path.join(dst, name) - try: - if symlinks and os.path.islink(srcname): - linkto = os.readlink(srcname) - os.symlink(linkto, dstname) - elif os.path.isdir(srcname): - copytree(srcname, dstname, symlinks) - else: - copy2(srcname, dstname) - # XXX What about devices, sockets etc.? - except OSError as why: - errors.append((srcname, dstname, str(why))) - # catch the Error from the recursive copytree so that we can - # continue with other files - except Error as err: - errors.extend(err.args[0]) - try: - copystat(src, dst) - except OSError as why: - # can't copy file access times on Windows - if why.winerror is None: - errors.extend((src, dst, str(why))) - if errors: - raise Error(errors) - -Another example that uses the :func:`ignore_patterns` helper:: +An example that uses the :func:`ignore_patterns` helper:: from shutil import copytree, ignore_patterns |