Sitelet https://web.archive.org/web/20220324071837/https://bugs.python.org/issue23730

➜

This issue tracker will soon become read-only and move to GitHub.
For a smoother transition, remember to log in and link your GitHub username to your profile.
For more information, see this post about the migration.

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 2015-04-13 21:46 by zach.ware. 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
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