importlib_metadata NEWS

v2.0.0

  • importlib_metadata no longer presents a __version__ attribute. Consumers wishing to resolve the version of the package should query it directly with importlib_metadata.version('importlib-metadata'). Closes #71.

v1.7.0

2020-06-14

  • PathNotFoundError now has a custom __str__ mentioning “package metadata” being missing to help guide users to the cause when the package is installed but no metadata is present. Closes #124.

v1.6.1

2020-06-05

  • Added Distribution._local() as a provisional demonstration of how to load metadata for a local package. Implicitly requires that 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.

  • Support any iterable from find_distributions. Closes #122.

v1.6.0

2020-03-27

  • Added module and attr attributes to EntryPoint

v1.5.2

2020-03-26

  • Fix redundant entries from FastPath.zip_children. Closes #117.

v1.5.1

2020-03-25

  • Improve reliability and consistency of compatibility imports for contextlib and pathlib when running tests. Closes #116.

v1.5.0

2020-01-29

  • Additional performance optimizations in FastPath now saves an additional 20% on a typical call.

  • Correct for issue where PyOxidizer finder has no __module__ attribute. Closes #110.

v1.4.0

2020-01-10

  • Through careful optimization, distribution() is 3-4x faster. Thanks to Antony Lee for the contribution. Closes #95.

  • When searching through sys.path, if any error occurs attempting to list a path entry, that entry is skipped, making the system much more lenient to errors. Closes #94.

v1.3.0

2019-12-10

  • Improve custom finders documentation. Closes #105.

v1.2.0

2019-12-04

  • Once again, drop support for Python 3.4. Ref #104.

v1.1.3

2019-12-04

  • Restored support for Python 3.4 due to improper version compatibility declarations in the v1.1.0 and v1.1.1 releases. Closes #104.

v1.1.2

2019-12-04

  • Repaired project metadata to correctly declare the python_requires directive. Closes #103.

v1.1.1

2019-12-04

  • Fixed repr(EntryPoint) on PyPy 3 also. Closes #102.

v1.1.0

2019-12-01

  • Dropped support for Python 3.4.

  • EntryPoints are now pickleable. Closes #96.

  • Fixed repr(EntryPoint) on PyPy 2. Closes #97.

v1.0.0

2019-11-30

  • Project adopts semver for versioning.

  • Removed compatibility shim introduced in 0.23.

  • For better compatibility with the stdlib implementation and to avoid the same distributions being discovered by the stdlib and backport implementations, the backport now disables the stdlib DistributionFinder during initialization (import time). Closes #91 and closes #100.

0.23

2019-09-16

  • Added a compatibility shim to prevent failures on beta releases of Python before the signature changed to accept the “context” parameter on find_distributions. This workaround will have a limited lifespan, not to extend beyond release of Python 3.8 final.

0.22

2019-09-11

  • Renamed package parameter to distribution_name as recommended in the following functions: distribution, metadata, version, files, and requires. This backward-incompatible change is expected to have little impact as these functions are assumed to be primarily used with positional parameters.

0.21

2019-09-10

  • importlib.metadata now exposes the DistributionFinder metaclass and references it in the docs for extending the search algorithm.

  • Add Distribution.at for constructing a Distribution object from a known metadata directory on the file system. Closes #80.

  • Distribution finders now receive a context object that supplies .path and .name properties. This change introduces a fundamental backward incompatibility for any projects implementing a find_distributions method on a MetaPathFinder. This new layer of abstraction allows this context to be supplied directly or constructed on demand and opens the opportunity for a find_distributions method to solicit additional context from the caller. Closes #85.

0.20

2019-09-02

  • Clarify in the docs that calls to .files could return None when the metadata is not present. Closes #69.

  • Return all requirements and not just the first for dist-info packages. Closes #67.

0.19

2019-07-28

  • Restrain over-eager egg metadata resolution.

  • Add support for entry points with colons in the name. Closes #75.

0.18

2019-06-09

  • Parse entry points case sensitively. Closes #68

  • Add a version constraint on the backport configparser package. Closes #66

0.17

2019-05-29

  • Fix a permission problem in the tests on Windows.

0.16

2019-05-29

  • Don’t crash if there exists an EGG-INFO directory on sys.path.

0.15

2019-05-24

  • Fix documentation.

0.14

2019-05-24

  • Removed local_distribution function from the API. This backward-incompatible change removes this behavior summarily. Projects should remove their reliance on this behavior. A replacement behavior is under review in the pep517 project. Closes #42.

0.13

2019-05-18

  • Update docstrings to match PEP 8. Closes #63.

  • Merged modules into one module. Closes #62.

0.12

2019-05-14

  • Add support for eggs. !65; Closes #19.

0.11

2019-05-09

  • Support generic zip files (not just wheels). Closes #59

  • Support zip files with multiple distributions in them. Closes #60

  • Fully expose the public API in importlib_metadata.__all__.

0.10

2019-05-07

  • The Distribution ABC is now officially part of the public API. Closes #37.

  • Fixed support for older single file egg-info formats. Closes #43.

  • Fixed a testing bug when $CWD has spaces in the path. Closes #50.

  • Add Python 3.8 to the tox testing matrix.

0.9

2019-03-25

  • Fixed issue where entry points without an attribute would raise an Exception. Closes #40.

  • Removed unused name parameter from entry_points(). Closes #44.

  • DistributionFinder classes must now be instantiated before being placed on sys.meta_path.

0.8

2019-01-01

  • This library can now discover/enumerate all installed packages. This backward-incompatible change alters the protocol finders must implement to support distribution package discovery. Closes #24.

  • The signature of find_distributions() on custom installer finders should now accept two parameters, name and path and these parameters must supply defaults.

  • The entry_points() method no longer accepts a package name but instead returns all entry points in a dictionary keyed by the EntryPoint.group. The resolve method has been removed. Instead, call EntryPoint.load(), which has the same semantics as pkg_resources and entrypoints. This is a backward incompatible change.

  • Metadata is now always returned as Unicode text regardless of Python version. Closes #29.

  • This library can now discover metadata for a ‘local’ package (found in the current-working directory). Closes #27.

  • Added files() function for resolving files from a distribution.

  • Added a new requires() function, which returns the requirements for a package suitable for parsing by packaging.requirements.Requirement. Closes #18.

  • The top-level read_text() function has been removed. Use PackagePath.read_text() on instances returned by the files() function. This is a backward incompatible change.

  • Release dates are now automatically injected into the changelog based on SCM tags.

0.7

2018-11-27

  • Fixed issue where packages with dashes in their names would not be discovered. Closes #21.

  • Distribution lookup is now case-insensitive. Closes #20.

  • Wheel distributions can no longer be discovered by their module name. Like Path distributions, they must be indicated by their distribution package name.

0.6

2018-10-07

  • Removed importlib_metadata.distribution function. Now the public interface is primarily the utility functions exposed in importlib_metadata.__all__. Closes #14.

  • Added two new utility functions read_text and metadata.

0.5

2018-09-18

  • Updated README and removed details about Distribution class, now considered private. Closes #15.

  • Added test suite support for Python 3.4+.

  • Fixed SyntaxErrors on Python 3.4 and 3.5. !12

  • Fixed errors on Windows joining Path elements. !15

0.4

2018-09-14

  • Housekeeping.

0.3

2018-09-14

  • Added usage documentation. Closes #8

  • Add support for getting metadata from wheels on sys.path. Closes #9

0.2

2018-09-11

  • Added importlib_metadata.entry_points(). Closes #1

  • Added importlib_metadata.resolve(). Closes #12

  • Add support for Python 2.7. Closes #4

0.1

2018-09-09

  • Initial release.