mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-21 16:10:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 6

bpo-39693: mention KeyError in tarfile extractfile documentation (GH-18639)

Browse source 
Co-authored-by: Andrey Darascheka <andrei.daraschenka@leverx.com>
(cherry picked from commit ec42789e6e)

Closes bpo-39693.
This commit is contained in:
Miss Skeleton (bot) 2020-10-20 07:31:03 -07:00 • committed by GitHub
parent 38a17d0752
commit b249aeae89
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
4 changed files with 11 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/library/tarfile.rst
View file

@ -445,10 +445,11 @@ be finalized; only the internally used file object will be closed. See the
.. method:: TarFile.extractfile(member) .. method:: TarFile.extractfile(member)
Extract a member from the archive as a file object. *member* may be a filename Extract a member from the archive as a file object. *member* may be
or a :class:`TarInfo` object. If *member* is a regular file or a link, an a filename or a :class:`TarInfo` object. If *member* is a regular file or
:class:`io.BufferedReader` object is returned. Otherwise, :const:`None` is a link, an :class:`io.BufferedReader` object is returned. For all other
returned. existing members, :const:`None` is returned. If *member* does not appear
in the archive, :exc:`KeyError` is raised.
.. versionchanged:: 3.3 .. versionchanged:: 3.3
Return an :class:`io.BufferedReader` object. Return an :class:`io.BufferedReader` object.

7
Lib/tarfile.py
View file

@ -2091,9 +2091,10 @@ class TarFile(object):
def extractfile(self, member): def extractfile(self, member):
"""Extract a member from the archive as a file object. `member' may be """Extract a member from the archive as a file object. `member' may be
a filename or a TarInfo object. If `member' is a regular file or a a filename or a TarInfo object. If `member' is a regular file or
link, an io.BufferedReader object is returned. Otherwise, None is a link, an io.BufferedReader object is returned. For all other
returned. existing members, None is returned. If `member' does not appear
in the archive, KeyError is raised.
""" """
self._check("r") self._check("r")

1
Misc/ACKS
View file

@ -1941,5 +1941,6 @@ Gennadiy Zlobin
Doug Zongker Doug Zongker
Peter Åstrand Peter Åstrand
Vlad Emelianov Vlad Emelianov
Andrey Doroschenko
(Entries should be added in rough alphabetical order by last names) (Entries should be added in rough alphabetical order by last names)

1
Misc/NEWS.d/next/Documentation/2020-02-24-09-02-05.bpo-39693.QXw0Fm.rst Normal file
View file

@ -0,0 +1 @@
Fix tarfile's extractfile documentation