Make _local a private method, available provisionally.

Author: jaraco

importlib_metadata/__init__.py

@@ -243,7 +243,7 @@ def _discover_resolvers():
         return filter(None, declared)
 
     @classmethod
-    def find_local(cls, root='.'):
+    def _local(cls, root='.'):
         from pep517 import build, meta
         system = build.compat_system(root)
         builder = functools.partial(

importlib_metadata/docs/changelog.rst

@@ -5,6 +5,11 @@
 v1.6.1
 ======
 
+* Added ``Distribution._local()`` as a provisional
+  demonstration of how to load metadata for a local
+  package. Implicitly requires that
+  `pep517 <https://pypi.org/project/pep517>`_ is
+  installed. Ref #42.
 * Ensure inputs to FastPath are Unicode. Closes #121.
 * Tests now rely on ``importlib.resources.files`` (and
   backport) instead of the older ``path`` function.

importlib_metadata/tests/test_api.py

@@ -178,6 +178,6 @@ def test_distribution_at_str(self):
 
 class LocalProjectTests(fixtures.LocalPackage, unittest.TestCase):
     def test_find_local(self):
-        dist = Distribution.find_local()
+        dist = Distribution._local()
         assert dist.metadata['Name'] == 'local-pkg'
         assert dist.version == '2.0.1'