diff -r b898402e75ef Doc/library/tarfile.rst --- a/Doc/library/tarfile.rst Mon May 19 07:34:08 2014 +0100 +++ b/Doc/library/tarfile.rst Wed May 21 13:18:31 2014 +0300 @@ -321,11 +321,15 @@ returned by :meth:`getmembers`. -.. method:: TarFile.list(verbose=True) +.. method:: TarFile.list(verbose=True, members=None) Print a table of contents to ``sys.stdout``. If *verbose* is :const:`False`, only the names of the members are printed. If it is :const:`True`, output - similar to that of :program:`ls -l` is produced. + similar to that of :program:`ls -l` is produced. If optional *members* is + given, it must be a subset of the list returned by :meth:`getmembers`. + + .. versionchanged:: 3.5 + Added the *members* parameter. .. method:: TarFile.next() diff -r b898402e75ef Lib/tarfile.py --- a/Lib/tarfile.py Mon May 19 07:34:08 2014 +0100 +++ b/Lib/tarfile.py Wed May 21 13:18:31 2014 +0300 @@ -1841,14 +1841,17 @@ tarinfo.devminor = os.minor(statres.st_rdev) return tarinfo - def list(self, verbose=True): + def list(self, verbose=True, members=None): """Print a table of contents to sys.stdout. If `verbose' is False, only the names of the members are printed. If it is True, an `ls -l'-like - output is produced. + output is produced. `members' is optional and must be a subset of the + list returned by getmembers(). """ self._check() - for tarinfo in self: + if members is None: + members = self + for tarinfo in members: if verbose: _safe_print(stat.filemode(tarinfo.mode)) _safe_print("%s/%s" % (tarinfo.uname or tarinfo.uid,