README.rst 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. packaging
  2. =========
  3. .. start-intro
  4. Reusable core utilities for various Python Packaging
  5. `interoperability specifications <https://packaging.python.org/specifications/>`_.
  6. This library provides utilities that implement the interoperability
  7. specifications which have clearly one correct behaviour (eg: :pep:`440`)
  8. or benefit greatly from having a single shared implementation (eg: :pep:`425`).
  9. .. end-intro
  10. The ``packaging`` project includes the following: version handling, specifiers,
  11. markers, requirements, tags, utilities.
  12. Documentation
  13. -------------
  14. The `documentation`_ provides information and the API for the following:
  15. - Version Handling
  16. - Specifiers
  17. - Markers
  18. - Requirements
  19. - Tags
  20. - Utilities
  21. Installation
  22. ------------
  23. Use ``pip`` to install these utilities::
  24. pip install packaging
  25. Discussion
  26. ----------
  27. If you run into bugs, you can file them in our `issue tracker`_.
  28. You can also join ``#pypa`` on Freenode to ask questions or get involved.
  29. .. _`documentation`: https://packaging.pypa.io/
  30. .. _`issue tracker`: https://github.com/pypa/packaging/issues
  31. Code of Conduct
  32. ---------------
  33. Everyone interacting in the packaging project's codebases, issue trackers, chat
  34. rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.
  35. .. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
  36. Contributing
  37. ------------
  38. The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as
  39. well as how to report a potential security issue. The documentation for this
  40. project also covers information about `project development`_ and `security`_.
  41. .. _`project development`: https://packaging.pypa.io/en/latest/development/
  42. .. _`security`: https://packaging.pypa.io/en/latest/security/
  43. Project History
  44. ---------------
  45. Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for
  46. recent changes and project history.
  47. .. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/