Rename 'get' to 'files' and no longer solicit a resource.

Author: jaraco

importlib_resources/_py2.py

@@ -93,10 +93,8 @@ def read_text(package, resource, encoding='utf-8', errors='strict'):
         return fp.read()
 
 
-def get(package, resource):
-    resource = _normalize_path(resource)
-    package = _get_package(package)
-    return trees.from_package(package) / resource
+def files(package):
+    return trees.from_package(_get_package(package))
 
 
 def path(package, resource):
@@ -108,7 +106,7 @@ def path(package, resource):
     raised if the file was deleted prior to the context manager
     exiting).
     """
-    path = get(package, resource)
+    path = files(package).joinpath(_normalize_path(resource))
     if not path.is_file():
         raise FileNotFoundError(path)
     return trees.as_file(path)

importlib_resources/_py3.py

@@ -131,13 +131,11 @@ def read_text(package: Package,
         return fp.read()
 
 
-def get(package: Package, resource: Resource) -> trees.Traversable:
+def files(package: Package) -> trees.Traversable:
     """
     Get a Traversable resource from a package
     """
-    resource = _normalize_path(resource)
-    package = _get_package(package)
-    return trees.from_package(package) / resource
+    return trees.from_package(_get_package(package))
 
 
 def path(
@@ -155,7 +153,7 @@ def path(
     return (
         _path_from_reader(reader, resource)
         if reader else
-        trees.as_file(get(package, resource))
+        trees.as_file(files(package).joinpath(_normalize_path(resource)))
         )
 
 

importlib_resources/trees.py

@@ -9,6 +9,11 @@
 
 
 class Traversable(ABC):
+    """
+    An object with a subset of pathlib.Path methods suitable for
+    traversing directories and opening files.
+    """
+
     @abc.abstractmethod
     def iterdir(self):
         """
@@ -39,6 +44,18 @@ def is_file(self):
         Return True if self is a file
         """
 
+    @abc.abstractmethod
+    def joinpath(self, child):
+        """
+        Return Traversable child in self
+        """
+
+    @abc.abstractmethod
+    def __truediv__(self, child):
+        """
+        Return Traversable child in self
+        """
+
 
 def from_package(package):
     """Return a Traversable object for the given package"""