README.rst 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  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://img.shields.io/badge/code%20style-black-000000.svg
  11. :target: https://github.com/psf/black
  12. :alt: Code style: Black
  13. .. image:: https://readthedocs.org/projects/importlib-metadata/badge/?version=latest
  14. :target: https://importlib-metadata.readthedocs.io/en/latest/?badge=latest
  15. .. image:: https://img.shields.io/badge/skeleton-2023-informational
  16. :target: https://blog.jaraco.com/skeleton
  17. .. image:: https://tidelift.com/badges/package/pypi/importlib-metadata
  18. :target: https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=readme
  19. Library to access the metadata for a Python package.
  20. This package supplies third-party access to the functionality of
  21. `importlib.metadata <https://docs.python.org/3/library/importlib.metadata.html>`_
  22. including improvements added to subsequent Python versions.
  23. Compatibility
  24. =============
  25. New features are introduced in this third-party library and later merged
  26. into CPython. The following table indicates which versions of this library
  27. were contributed to different versions in the standard library:
  28. .. list-table::
  29. :header-rows: 1
  30. * - importlib_metadata
  31. - stdlib
  32. * - 7.0
  33. - 3.13
  34. * - 6.5
  35. - 3.12
  36. * - 4.13
  37. - 3.11
  38. * - 4.6
  39. - 3.10
  40. * - 1.4
  41. - 3.8
  42. Usage
  43. =====
  44. See the `online documentation <https://importlib-metadata.readthedocs.io/>`_
  45. for usage details.
  46. `Finder authors
  47. <https://docs.python.org/3/reference/import.html#finders-and-loaders>`_ can
  48. also add support for custom package installers. See the above documentation
  49. for details.
  50. Caveats
  51. =======
  52. This project primarily supports third-party packages installed by PyPA
  53. tools (or other conforming packages). It does not support:
  54. - Packages in the stdlib.
  55. - Packages installed without metadata.
  56. Project details
  57. ===============
  58. * Project home: https://github.com/python/importlib_metadata
  59. * Report bugs at: https://github.com/python/importlib_metadata/issues
  60. * Code hosting: https://github.com/python/importlib_metadata
  61. * Documentation: https://importlib-metadata.readthedocs.io/
  62. For Enterprise
  63. ==============
  64. Available as part of the Tidelift Subscription.
  65. 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.
  66. `Learn more <https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=referral&utm_campaign=github>`_.