⚫ Fade to black.

Author: jaraco

importlib_metadata/__init__.py

@@ -17,7 +17,7 @@
     NullFinder,
     PyPy_repr,
     install,
-    )
+)
 
 from configparser import ConfigParser
 from contextlib import suppress
@@ -37,7 +37,7 @@
     'metadata',
     'requires',
     'version',
-    ]
+]
 
 
 class PackageNotFoundError(ModuleNotFoundError):
@@ -49,13 +49,13 @@ def __str__(self):
 
     @property
     def name(self):
-        name, = self.args
+        (name,) = self.args
         return name
 
 
 class EntryPoint(
-        PyPy_repr,
-        collections.namedtuple('EntryPointBase', 'name value group')):
+    PyPy_repr, collections.namedtuple('EntryPointBase', 'name value group')
+):
     """An entry point as defined by Python packaging conventions.
 
     See `the packaging docs on entry points
@@ -67,7 +67,7 @@ class EntryPoint(
         r'(?P<module>[\w.]+)\s*'
         r'(:\s*(?P<attr>[\w.]+))?\s*'
         r'(?P<extras>\[.*\])?\s*$'
-        )
+    )
     """
     A regular expression describing the syntax for an entry point,
     which might look like:
@@ -115,7 +115,7 @@ def _from_config(cls, config):
             cls(name, value, group)
             for group in config.sections()
             for name, value in config.items(group)
-            ]
+        ]
 
     @classmethod
     def _from_text(cls, text):
@@ -139,7 +139,7 @@ def __reduce__(self):
         return (
             self.__class__,
             (self.name, self.value, self.group),
-            )
+        )
 
 
 class PackagePath(pathlib.PurePosixPath):
@@ -217,9 +217,8 @@ def discover(cls, **kwargs):
             raise ValueError("cannot accept context and kwargs")
         context = context or DistributionFinder.Context(**kwargs)
         return itertools.chain.from_iterable(
-            resolver(context)
-            for resolver in cls._discover_resolvers()
-            )
+            resolver(context) for resolver in cls._discover_resolvers()
+        )
 
     @staticmethod
     def at(path):
@@ -234,20 +233,20 @@ def at(path):
     def _discover_resolvers():
         """Search the meta_path for resolvers."""
         declared = (
-            getattr(finder, 'find_distributions', None)
-            for finder in sys.meta_path
-            )
+            getattr(finder, 'find_distributions', None) for finder in sys.meta_path
+        )
         return filter(None, declared)
 
     @classmethod
     def _local(cls, root='.'):
         from pep517 import build, meta
+
         system = build.compat_system(root)
         builder = functools.partial(
             meta.build,
             source_dir=root,
             system=system,
-            )
+        )
         return PathDistribution(zipp.Path(meta.build_as_zip(builder)))
 
     @property
@@ -264,7 +263,7 @@ def metadata(self):
             # effect is to just end up using the PathDistribution's self._path
             # (which points to the egg-info file) attribute unchanged.
             or self.read_text('')
-            )
+        )
         return email.message_from_string(text)
 
     @property
@@ -331,9 +330,10 @@ def _deps_from_requires_text(cls, source):
         section_pairs = cls._read_sections(source.splitlines())
         sections = {
             section: list(map(operator.itemgetter('line'), results))
-            for section, results in
-            itertools.groupby(section_pairs, operator.itemgetter('section'))
-            }
+            for section, results in itertools.groupby(
+                section_pairs, operator.itemgetter('section')
+            )
+        }
         return cls._convert_egg_info_reqs_to_simple_reqs(sections)
 
     @staticmethod
@@ -357,6 +357,7 @@ def _convert_egg_info_reqs_to_simple_reqs(sections):
         requirement. This method converts the former to the
         latter. See _test_deps_from_requires_text for an example.
         """
+
         def make_condition(name):
             return name and 'extra == "{name}"'.format(name=name)
 
@@ -445,33 +446,35 @@ def zip_children(self):
         names = zip_path.root.namelist()
         self.joinpath = zip_path.joinpath
 
-        return dict.fromkeys(
-            child.split(posixpath.sep, 1)[0]
-            for child in names
-            )
+        return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names)
 
     def is_egg(self, search):
         base = self.base
         return (
             base == search.versionless_egg_name
             or base.startswith(search.prefix)
-            and base.endswith('.egg'))
+            and base.endswith('.egg')
+        )
 
     def search(self, name):
         for child in self.children():
             n_low = child.lower()
-            if (n_low in name.exact_matches
-                    or n_low.startswith(name.prefix)
-                    and n_low.endswith(name.suffixes)
-                    # legacy case:
-                    or self.is_egg(name) and n_low == 'egg-info'):
+            if (
+                n_low in name.exact_matches
+                or n_low.startswith(name.prefix)
+                and n_low.endswith(name.suffixes)
+                # legacy case:
+                or self.is_egg(name)
+                and n_low == 'egg-info'
+            ):
                 yield self.joinpath(child)
 
 
 class Prepared:
     """
     A prepared search for metadata on a possibly-named package.
     """
+
     normalized = ''
     prefix = ''
     suffixes = '.dist-info', '.egg-info'
@@ -484,8 +487,7 @@ def __init__(self, name):
             return
         self.normalized = name.lower().replace('-', '_')
         self.prefix = self.normalized + '-'
-        self.exact_matches = [
-            self.normalized + suffix for suffix in self.suffixes]
+        self.exact_matches = [self.normalized + suffix for suffix in self.suffixes]
         self.versionless_egg_name = self.normalized + '.egg'
 
 
@@ -513,9 +515,8 @@ def find_distributions(self, context=DistributionFinder.Context()):
     def _search_paths(cls, name, paths):
         """Find metadata directories in paths heuristically."""
         return itertools.chain.from_iterable(
-            path.search(Prepared(name))
-            for path in map(FastPath, paths)
-            )
+            path.search(Prepared(name)) for path in map(FastPath, paths)
+        )
 
 
 class PathDistribution(Distribution):
@@ -528,9 +529,15 @@ def __init__(self, path):
         self._path = path
 
     def read_text(self, filename):
-        with suppress(FileNotFoundError, IsADirectoryError, KeyError,
-                      NotADirectoryError, PermissionError):
+        with suppress(
+            FileNotFoundError,
+            IsADirectoryError,
+            KeyError,
+            NotADirectoryError,
+            PermissionError,
+        ):
             return self._path.joinpath(filename).read_text(encoding='utf-8')
+
     read_text.__doc__ = Distribution.read_text.__doc__
 
     def locate_file(self, path):
@@ -578,15 +585,11 @@ def entry_points():
 
     :return: EntryPoint objects for all installed packages.
     """
-    eps = itertools.chain.from_iterable(
-        dist.entry_points for dist in distributions())
+    eps = itertools.chain.from_iterable(dist.entry_points for dist in distributions())
     by_group = operator.attrgetter('group')
     ordered = sorted(eps, key=by_group)
     grouped = itertools.groupby(ordered, by_group)
-    return {
-        group: tuple(eps)
-        for group, eps in grouped
-        }
+    return {group: tuple(eps) for group, eps in grouped}
 
 
 def files(distribution_name):

importlib_metadata/_compat.py

@@ -25,11 +25,12 @@ def disable_stdlib_finder():
     See #91 for more background for rationale on this sketchy
     behavior.
     """
+
     def matches(finder):
-        return (
-            getattr(finder, '__module__', None) == '_frozen_importlib_external'
-            and hasattr(finder, 'find_distributions')
-            )
+        return getattr(
+            finder, '__module__', None
+        ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions')
+
     for finder in filter(matches, sys.meta_path):  # pragma: nocover
         del finder.find_distributions
 
@@ -39,6 +40,7 @@ class NullFinder:
     A "Finder" (aka "MetaClassFinder") that never finds any modules,
     but may find distributions.
     """
+
     @staticmethod
     def find_spec(*args, **kwargs):
         return None
@@ -57,12 +59,14 @@ class PyPy_repr:
     Override repr for EntryPoint objects on PyPy to avoid __iter__ access.
     Ref #97, #102.
     """
+
     affected = hasattr(sys, 'pypy_version_info')
 
     def __compat_repr__(self):  # pragma: nocover
         def make_param(name):
             value = getattr(self, name)
             return '{name}={value!r}'.format(**locals())
+
         params = ', '.join(map(make_param, self._fields))
         return 'EntryPoint({params})'.format(**locals())
 

prepare/example/setup.py

@@ -1,10 +1,11 @@
 from setuptools import setup
+
 setup(
     name='example',
     version='21.12',
     license='Apache Software License',
     packages=['example'],
     entry_points={
         'console_scripts': ['example = example:main', 'Example=example:main'],
-        },
-    )
+    },
+)

tests/fixtures.py

@@ -86,13 +86,13 @@ class DistInfoPkg(OnSysPath, SiteDir):
                 [entries]
                 main = mod:main
                 ns:sub = mod:main
-            """
-            },
+            """,
+        },
         "mod.py": """
             def main():
                 print("hello world")
             """,
-        }
+    }
 
     def setUp(self):
         super(DistInfoPkg, self).setUp()
@@ -129,13 +129,13 @@ class EggInfoPkg(OnSysPath, SiteDir):
                 [test]
                 pytest
             """,
-            "top_level.txt": "mod\n"
-            },
+            "top_level.txt": "mod\n",
+        },
         "mod.py": """
             def main():
                 print("hello world")
             """,
-        }
+    }
 
     def setUp(self):
         super(EggInfoPkg, self).setUp()
@@ -156,7 +156,7 @@ class EggInfoFile(OnSysPath, SiteDir):
             Description: UNKNOWN
             Platform: UNKNOWN
             """,
-        }
+    }
 
     def setUp(self):
         super(EggInfoFile, self).setUp()
@@ -169,7 +169,7 @@ class LocalPackage:
             import setuptools
             setuptools.setup(name="local-pkg", version="2.0.1")
             """,
-        }
+    }
 
     def setUp(self):
         self.fixtures = contextlib.ExitStack()
@@ -214,8 +214,7 @@ def build_files(file_defs, prefix=pathlib.Path()):
 
 class FileBuilder:
     def unicode_filename(self):
-        return FS_NONASCII or \
-            self.skip("File system does not support non-ascii.")
+        return FS_NONASCII or self.skip("File system does not support non-ascii.")
 
 
 def DALS(str):