This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Document return value for ZipFile.extract()
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.4, Python 3.5, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, matrixise, mjpieters, python-dev, zach.ware
Priority: normal Keywords: patch

Created on 2015-03-21 09:11 by mjpieters, last changed 2022-04-11 14:58 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
issue23730.diff matrixise, 2015-04-13 17:58 review
Messages (4)
msg238778 - (view) Author: Martijn Pieters (mjpieters) * Date: 2015-03-21 09:11
The documentation for zipfile.ZipFile.extract() doesn't mention at all that it returns the local path created, either for the directory that the member represents, or the new file created from the zipped data.

*Returns the full local path created (a directory or new file)* or similar.
msg240687 - (view) Author: Stéphane Wirtel (matrixise) * (Python committer) Date: 2015-04-13 17:58
fix for the documentation of ZipFile.extract.

In the code of _extract_member, there is a normalisation of the target path, I use this term "normalized" for the fix.
msg240770 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-04-13 21:44
New changeset 731e366885f5 by Zachary Ware in branch '2.7':
Issue #23730: Document the return value of ZipFile.extract
https://hg.python.org/cpython/rev/731e366885f5

New changeset 7ac1c2307a70 by Zachary Ware in branch '3.4':
Issue #23730: Document the return value of ZipFile.extract
https://hg.python.org/cpython/rev/7ac1c2307a70

New changeset d958c74ddb0c by Zachary Ware in branch 'default':
Closes #23730: merge with 3.4
https://hg.python.org/cpython/rev/d958c74ddb0c
msg240771 - (view) Author: Zachary Ware (zach.ware) * (Python committer) Date: 2015-04-13 21:46
Thanks for the patch!
History
Date User Action Args
2022-04-11 14:58:14adminsetgithub: 67918
2015-04-13 21:46:02zach.waresetnosy: + zach.ware

messages: + msg240771
versions: - Python 3.6
2015-04-13 21:44:17python-devsetstatus: open -> closed

nosy: + python-dev
messages: + msg240770

resolution: fixed
stage: resolved
2015-04-13 17:58:47matrixisesetfiles: + issue23730.diff

nosy: + matrixise
messages: + msg240687

keywords: + patch
2015-03-21 09:11:29mjpieterscreate