diff -r 513eea89b80a Doc/library/tarfile.rst --- a/Doc/library/tarfile.rst Thu Jun 19 12:59:32 2014 +0200 +++ b/Doc/library/tarfile.rst Fri Jun 20 12:17:09 2014 +0300 @@ -325,11 +325,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 513eea89b80a Lib/tarfile.py --- a/Lib/tarfile.py Thu Jun 19 12:59:32 2014 +0200 +++ b/Lib/tarfile.py Fri Jun 20 12:17:09 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, diff -r 513eea89b80a Lib/test/test_tarfile.py --- a/Lib/test/test_tarfile.py Thu Jun 19 12:59:32 2014 +0200 +++ b/Lib/test/test_tarfile.py Fri Jun 20 12:17:09 2014 +0300 @@ -285,6 +285,18 @@ self.assertIn(b'pax' + (b'/123' * 125) + b'/longlink link to pax' + (b'/123' * 125) + b'/longname', out) + def test_list_members(self): + tio = io.TextIOWrapper(io.BytesIO(), 'ascii', newline='\n') + def members(tar): + for tarinfo in tar.getmembers(): + if 'reg' in tarinfo.name: + yield tarinfo + with support.swap_attr(sys, 'stdout', tio): + self.tar.list(verbose=False, members=members(self.tar)) + out = tio.detach().getvalue() + self.assertIn(b'ustar/regtype', out) + self.assertNotIn(b'ustar/conttype', out) + class GzipListTest(GzipTest, ListTest): pass