bpo-43643: Sync with python/importlib_resources@c17a610aad. (GH-26284)

* bpo-43643: Sync with python/importlib_resources@c17a610aad.
* Sync with python/importlib_resources@89fd5e961a.

Author: jaraco

Lib/importlib/_common.py

@@ -7,14 +7,15 @@
 import importlib
 
 from typing import Union, Any, Optional
-from .abc import ResourceReader
+from .abc import ResourceReader, Traversable
 
 from ._adapters import wrap_spec
 
 Package = Union[types.ModuleType, str]
 
 
 def files(package):
+    # type: (Package) -> Traversable
     """
     Get a Traversable resource from a package
     """

Lib/importlib/readers.py

@@ -96,6 +96,7 @@ def joinpath(self, child):
     def open(self, *args, **kwargs):
         raise FileNotFoundError('{} is not a file'.format(self))
 
+    @property
     def name(self):
         return self._paths[0].name
 

Lib/test/test_importlib/test_reader.py

@@ -82,6 +82,12 @@ def test_repr(self):
             "MultiplexedPath('{}')".format(self.folder),
         )
 
+    def test_name(self):
+        self.assertEqual(
+            MultiplexedPath(self.folder).name,
+            os.path.basename(self.folder),
+        )
+
 
 class NamespaceReaderTest(unittest.TestCase):
     site_dir = str(pathlib.Path(__file__).parent)

Misc/NEWS.d/next/Library/2021-05-21-12-12-35.bpo-43643.GWnmcF.rst

@@ -0,0 +1 @@
+Declare readers.MultiplexedPath.name as a property per the spec.