changeset:   92174:5875c50e93fe
parent:      92170:92dcee426014
user:        Serhiy Storchaka <storchaka@gmail.com>
date:        Thu Aug 21 10:01:16 2014 +0300
files:       Doc/library/tarfile.rst Lib/tarfile.py Lib/test/test_tarfile.py Misc/NEWS
description:
Issue #21549: Added the "members" parameter to TarFile.list().


diff -r 92dcee426014 -r 5875c50e93fe Doc/library/tarfile.rst
--- a/Doc/library/tarfile.rst	Wed Aug 20 18:41:57 2014 -0500
+++ b/Doc/library/tarfile.rst	Thu Aug 21 10:01:16 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 92dcee426014 -r 5875c50e93fe Lib/tarfile.py
--- a/Lib/tarfile.py	Wed Aug 20 18:41:57 2014 -0500
+++ b/Lib/tarfile.py	Thu Aug 21 10:01:16 2014 +0300
@@ -1842,14 +1842,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 92dcee426014 -r 5875c50e93fe Lib/test/test_tarfile.py
--- a/Lib/test/test_tarfile.py	Wed Aug 20 18:41:57 2014 -0500
+++ b/Lib/test/test_tarfile.py	Thu Aug 21 10:01:16 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
diff -r 92dcee426014 -r 5875c50e93fe Misc/NEWS
--- a/Misc/NEWS	Wed Aug 20 18:41:57 2014 -0500
+++ b/Misc/NEWS	Thu Aug 21 10:01:16 2014 +0300
@@ -124,6 +124,8 @@
 Library
 -------
 
+- Issue #21549: Added the "members" parameter to TarFile.list().
+
 - Issue #19628: Allow compileall recursion depth to be specified with a -r
   option.