Skip to content

Commit 216397d

Browse files
committed
Reword backport philosophy to capture intention on subsequent Python releases. Fixes #254.
1 parent ac1d9e8 commit 216397d

File tree

2 files changed

+10
-7
lines changed

2 files changed

+10
-7
lines changed

README.rst

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,11 @@
55
``importlib_metadata`` is a library to access the metadata for a
66
Python package.
77

8-
It has been `added to the Python standard library
9-
<https://docs.python.org/3/library/importlib.metadata.html>`_ as of
10-
Python 3.8, but exists here to support backported usage in earlier
11-
versions.
8+
As of Python 3.8, this functionality has been added to the
9+
`Python standard library
10+
<https://docs.python.org/3/library/importlib.metadata.html>`_.
11+
This package supplies backports of that functionality including
12+
improvements added to subsequent Python versions.
1213

1314

1415
Usage

docs/index.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,11 @@ Python 3.7 and newer (backported as :doc:`importlib_resources <importlib_resourc
1010
versions of Python), this can eliminate the need to use the older and less
1111
efficient ``pkg_resources`` package.
1212

13-
``importlib_metadata`` is a backport of Python 3.8's standard library
14-
:doc:`importlib.metadata <library/importlib.metadata>` module for Python 2.7, and 3.4 through 3.7. Users of
15-
Python 3.8 and beyond are encouraged to use the standard library module.
13+
``importlib_metadata`` supplies a backport of
14+
:doc:`importlib.metadata <library/importlib.metadata>` as found in
15+
Python 3.8 and later for earlier Python releases. Users of
16+
Python 3.8 and beyond are encouraged to use the standard library module
17+
when possible and fall back to ``importlib_metadata`` when necessary.
1618
When imported on Python 3.8 and later, ``importlib_metadata`` replaces the
1719
DistributionFinder behavior from the stdlib, but leaves the API in tact.
1820
Developers looking for detailed API descriptions should refer to the Python

0 commit comments

Comments
 (0)