summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2020-04-15 18:45:25 (GMT)
committerGitHub <noreply@github.com>2020-04-15 18:45:25 (GMT)
commit3e72de9e08b03a15875f5b226c5f096e567dab42 (patch)
treea3d8aa505aa1f50866a062ee46edd65c7ba2073c /Doc/library
parent59047fab0ef37f583c9e7c3a48d67792fd10ff91 (diff)
downloadcpython-3e72de9e08b03a15875f5b226c5f096e567dab42.zip
cpython-3e72de9e08b03a15875f5b226c5f096e567dab42.tar.gz
cpython-3e72de9e08b03a15875f5b226c5f096e567dab42.tar.bz2
[3.8] bpo-39667: Sync zipp 3.0 (GH-18540) (GH-18701)
* bpo-39667: Sync zipp 3.0 (GH-18540) * bpo-39667: Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0 * 📜🤖 Added by blurb_it. * Update docs for new zipfile.Path.open * Rely on dict, faster than OrderedDict. * Syntax edits on docs Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com> (cherry picked from commit 0aeab5c4381f0cc11479362af2533b3a391312ac) Co-authored-by: Jason R. Coombs <jaraco@jaraco.com> * Clarify the change in behavior with a couple of workaround options. * Restore API compatibility while backporting performance improvements. Co-authored-by: Jason R. Coombs <jaraco@jaraco.com>
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/zipfile.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
index e8a2530..97da6ca 100644
--- a/Doc/library/zipfile.rst
+++ b/Doc/library/zipfile.rst
@@ -494,6 +494,12 @@ Path objects are traversable using the ``/`` operator.
Invoke :meth:`ZipFile.open` on the current path. Accepts
the same arguments as :meth:`ZipFile.open`.
+ .. caution::
+
+ The signature on this function changes in an incompatible way
+ in Python 3.9. For a future-compatible version, consider using
+ the third-party zipp.Path package (3.0 or later).
+
.. method:: Path.iterdir()
Enumerate the children of the current directory.