Skip to main content

Read metadata from Python packages

Project description

=========================
``importlib_metadata``
=========================

``importlib_metadata`` is a library to access the metadata for a Python
package. It is intended to be ported to Python 3.8.


Usage
=====

``importlib_metadata``, unlike its sister packages importlib and
importlib.resources, operates on Python Distribution packages (the
package as installed by pip or similar).

The main feature is the :class:`Distribution` class.

Construct one by passing a top-level module (or package) to
:func:`distribution`:

>>> dist = importlib_resources.distribution(importlib_resources)

From there, the package metadata is available on ``dist.metadata``:

>>> 'Version' in dist.metadata
True

:func:`distribution` also accepts a known distribution package name:

>>> dist = importlib_resources.distribution('importlib_resources')


Package Version
===============

`PEP 396 <https://www.python.org/dev/peps/pep-0396/>` specifies
a convention for presenting a package's version. For many packages,
this version is not defined in code, but is primarily or only defined
in the package metadata. In this case, use of ``importlib_metadata``
can present this version::

__version__ = importlib_metadata.Distribution.from_named_module(__name__).version


Distribution Name
=================

This project introduces the concept of a mapping from an imported module
to its distribution package name. Many times, the name of the imported
module or package matches the distribution package (e.g. requests).

Other times, the imported name and distribution package name differ.
For example, the ``path`` module is the top-level module in the
`path.py <https://pypi.org/project/path.py>`_ distribution package
and in the `setuptools <https://pypi.org/project/setuptools>`_
project, there are two top-level packages, ``setuptools`` and
``pkg_resources``, both sharing the same metadata.

For projects where the name of the top level module does not match
exactly to the distribution package name, those modules should present
a ``__dist_name__`` member with the distribution package name
and this property will be used by importlib_metadata to resolve the
metadata for those Python packages.


Support for Custom Package Installers
=====================================

``importlib_metadata`` provides hooks for third-party package installers
through their declared finders. A custom installer, if it provides its
own finder for installed packages, should also provide on that finder
a ``find_distribution`` callable that when called with
the name of a package will return a ``Distribution`` instance capable
of loading the metadata for that named package (or None if that finder
has no knowledge of that package or its metadata).


Caveats
=======

This project primarily supports third-party packages installed by PyPA
tools (or other conforming packages). It does not support:

- Packages in the stdlib.
- Packages installed without metadata.
- Zip packages.


Project details
===============

* Project home: https://gitlab.com/python-devs/importlib_metadata
* Report bugs at: https://gitlab.com/python-devs/importlib_metadata/issues
* Code hosting: https://gitlab.com/python-devs/importlib_metadata.git
* Documentation: http://importlib_metadata.readthedocs.io/


Project details


Release history Release notifications | RSS feed

This version

0.4

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

importlib_metadata-0.4.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

importlib_metadata-0.4-py2.py3-none-any.whl (17.1 kB view details)

Uploaded Python 2Python 3

File details

Details for the file importlib_metadata-0.4.tar.gz.

File metadata

  • Download URL: importlib_metadata-0.4.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.5.2

File hashes

Hashes for importlib_metadata-0.4.tar.gz
Algorithm Hash digest
SHA256 64ce007aeedc7e5d72a4447806181fc38ae2949de66dab8b8f11d165fba1f144
MD5 003a542e88fa543dbcdeef83020faa95
BLAKE2b-256 434e98f8930eb8d1170f8babf6997928b4c1cf8f9423ede35d2668aea1a15a22

See more details on using hashes here.

File details

Details for the file importlib_metadata-0.4-py2.py3-none-any.whl.

File metadata

  • Download URL: importlib_metadata-0.4-py2.py3-none-any.whl
  • Upload date:
  • Size: 17.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.5.2

File hashes

Hashes for importlib_metadata-0.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 63d19c1114a18d6d528b72b3f527627967a2c29bb6534b35c7eed95005a85ecf
MD5 7238a46b4051256d7174815197468960
BLAKE2b-256 c3d5a1c38b767edd81d58603fcb0e02b1eb4d7b9df281bddccc361830db695bd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page