METADATA 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. Metadata-Version: 2.1
  2. Name: distlib
  3. Version: 0.4.0
  4. Summary: Distribution utilities
  5. Home-page: https://github.com/pypa/distlib
  6. Author: Vinay Sajip
  7. Author-email: vinay_sajip@red-dove.com
  8. License: PSF-2.0
  9. Project-URL: Documentation, https://distlib.readthedocs.io/
  10. Project-URL: Source, https://github.com/pypa/distlib
  11. Project-URL: Tracker, https://github.com/pypa/distlib/issues
  12. Platform: any
  13. Classifier: Development Status :: 5 - Production/Stable
  14. Classifier: Environment :: Console
  15. Classifier: Intended Audience :: Developers
  16. Classifier: License :: OSI Approved :: Python Software Foundation License
  17. Classifier: Operating System :: OS Independent
  18. Classifier: Programming Language :: Python
  19. Classifier: Programming Language :: Python :: 2
  20. Classifier: Programming Language :: Python :: 3
  21. Classifier: Programming Language :: Python :: 2.7
  22. Classifier: Programming Language :: Python :: 3.6
  23. Classifier: Programming Language :: Python :: 3.7
  24. Classifier: Programming Language :: Python :: 3.8
  25. Classifier: Programming Language :: Python :: 3.9
  26. Classifier: Programming Language :: Python :: 3.10
  27. Classifier: Programming Language :: Python :: 3.11
  28. Classifier: Programming Language :: Python :: 3.12
  29. Classifier: Programming Language :: Python :: 3.13
  30. Classifier: Topic :: Software Development
  31. License-File: LICENSE.txt
  32. |badge1| |badge2|
  33. .. |badge1| image:: https://img.shields.io/github/actions/workflow/status/pypa/distlib/package-tests.yml
  34. :alt: GitHub Workflow Status (with event)
  35. .. |badge2| image:: https://img.shields.io/codecov/c/github/pypa/distlib
  36. :target: https://app.codecov.io/gh/pypa/distlib
  37. :alt: GitHub coverage status
  38. What is it?
  39. -----------
  40. Distlib is a library which implements low-level functions that relate to
  41. packaging and distribution of Python software. It is intended to be used as the
  42. basis for third-party packaging tools. The documentation is available at
  43. https://distlib.readthedocs.io/
  44. Main features
  45. -------------
  46. Distlib currently offers the following features:
  47. * The package ``distlib.database``, which implements a database of installed
  48. distributions, as defined by :pep:`376`, and distribution dependency graph
  49. logic. Support is also provided for non-installed distributions (i.e.
  50. distributions registered with metadata on an index like PyPI), including
  51. the ability to scan for dependencies and building dependency graphs.
  52. * The package ``distlib.index``, which implements an interface to perform
  53. operations on an index, such as registering a project, uploading a
  54. distribution or uploading documentation. Support is included for verifying
  55. SSL connections (with domain matching) and signing/verifying packages using
  56. GnuPG.
  57. * The package ``distlib.metadata``, which implements distribution metadata as
  58. defined by :pep:`643`, :pep:`566`, :pep:`345`, :pep:`314` and :pep:`241`.
  59. * The package ``distlib.markers``, which implements environment markers as
  60. defined by :pep:`508`.
  61. * The package ``distlib.manifest``, which implements lists of files used
  62. in packaging source distributions.
  63. * The package ``distlib.locators``, which allows finding distributions, whether
  64. on PyPI (XML-RPC or via the "simple" interface), local directories or some
  65. other source.
  66. * The package ``distlib.resources``, which allows access to data files stored
  67. in Python packages, both in the file system and in .zip files.
  68. * The package ``distlib.scripts``, which allows installing of scripts with
  69. adjustment of shebang lines and support for native Windows executable
  70. launchers.
  71. * The package ``distlib.version``, which implements version specifiers as
  72. defined by :pep:`440`, but also support for working with "legacy" versions and
  73. semantic versions.
  74. * The package ``distlib.wheel``, which provides support for building and
  75. installing from the Wheel format for binary distributions (see :pep:`427`).
  76. * The package ``distlib.util``, which contains miscellaneous functions and
  77. classes which are useful in packaging, but which do not fit neatly into
  78. one of the other packages in ``distlib``.* The package implements enhanced
  79. globbing functionality such as the ability to use ``**`` in patterns to
  80. specify recursing into subdirectories.
  81. Python version and platform compatibility
  82. -----------------------------------------
  83. Distlib is intended to be used on and is tested on Python versions 2.7 and 3.6 or later,
  84. pypy-2.7 and pypy3 on Linux, Windows, and macOS.
  85. Project status
  86. --------------
  87. The project has reached a mature status in its development: there is a comprehensive
  88. test suite and it has been exercised on Windows, Ubuntu and macOS. The project is used
  89. by well-known projects such as `pip <https://pypi.org/pypi/pip>`_ and `caniusepython3
  90. <https://pypi.org/pypi/caniusepython3>`_.
  91. This project was migrated from Mercurial to Git and from BitBucket to GitHub, and
  92. although all information of importance has been retained across the migration, some
  93. commit references in issues and issue comments may have become invalid.
  94. Code of Conduct
  95. ---------------
  96. Everyone interacting in the distlib project's codebases, issue trackers, chat
  97. rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
  98. .. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/