Merge branch 'open' of https://gitlab.com/benthayer/importlib_resources. Ref #80.

Author: jaraco

importlib_resources/trees.py

@@ -59,6 +59,16 @@ def __truediv__(self, child):
         Return Traversable child in self
         """
 
+    @abc.abstractmethod
+    def open(self, mode='r', *args, **kwargs):
+        """
+        mode may be 'r' or 'rb' to open as text or binary. Return a handle
+        suitable for reading (same as pathlib.Path.open).
+
+        When opening as text, accepts encoding parameters such as those
+        accepted by io.TextIOWrapper.
+        """
+
 
 def from_package(package):
     """Return a Traversable object for the given package"""