README.rst 2.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990
  1. .. image:: https://img.shields.io/pypi/v/importlib_metadata.svg
  2. :target: https://pypi.org/project/importlib_metadata
  3. .. image:: https://img.shields.io/pypi/pyversions/importlib_metadata.svg
  4. .. image:: https://github.com/python/importlib_metadata/actions/workflows/main.yml/badge.svg
  5. :target: https://github.com/python/importlib_metadata/actions?query=workflow%3A%22tests%22
  6. :alt: tests
  7. .. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
  8. :target: https://github.com/astral-sh/ruff
  9. :alt: Ruff
  10. .. image:: https://readthedocs.org/projects/importlib-metadata/badge/?version=latest
  11. :target: https://importlib-metadata.readthedocs.io/en/latest/?badge=latest
  12. .. image:: https://img.shields.io/badge/skeleton-2024-informational
  13. :target: https://blog.jaraco.com/skeleton
  14. .. image:: https://tidelift.com/badges/package/pypi/importlib-metadata
  15. :target: https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=readme
  16. Library to access the metadata for a Python package.
  17. This package supplies third-party access to the functionality of
  18. `importlib.metadata <https://docs.python.org/3/library/importlib.metadata.html>`_
  19. including improvements added to subsequent Python versions.
  20. Compatibility
  21. =============
  22. New features are introduced in this third-party library and later merged
  23. into CPython. The following table indicates which versions of this library
  24. were contributed to different versions in the standard library:
  25. .. list-table::
  26. :header-rows: 1
  27. * - importlib_metadata
  28. - stdlib
  29. * - 7.0
  30. - 3.13
  31. * - 6.5
  32. - 3.12
  33. * - 4.13
  34. - 3.11
  35. * - 4.6
  36. - 3.10
  37. * - 1.4
  38. - 3.8
  39. Usage
  40. =====
  41. See the `online documentation <https://importlib-metadata.readthedocs.io/>`_
  42. for usage details.
  43. `Finder authors
  44. <https://docs.python.org/3/reference/import.html#finders-and-loaders>`_ can
  45. also add support for custom package installers. See the above documentation
  46. for details.
  47. Caveats
  48. =======
  49. This project primarily supports third-party packages installed by PyPA
  50. tools (or other conforming packages). It does not support:
  51. - Packages in the stdlib.
  52. - Packages installed without metadata.
  53. Project details
  54. ===============
  55. * Project home: https://github.com/python/importlib_metadata
  56. * Report bugs at: https://github.com/python/importlib_metadata/issues
  57. * Code hosting: https://github.com/python/importlib_metadata
  58. * Documentation: https://importlib-metadata.readthedocs.io/
  59. For Enterprise
  60. ==============
  61. Available as part of the Tidelift Subscription.
  62. This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
  63. `Learn more <https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=referral&utm_campaign=github>`_.