DESCRIPTION.rst 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198
  1. packaging
  2. =========
  3. Core utilities for Python packages
  4. Documentation
  5. -------------
  6. `documentation`_
  7. Discussion
  8. ----------
  9. If you run into bugs, you can file them in our `issue tracker`_.
  10. You can also join ``#pypa`` on Freenode to ask questions or get involved.
  11. .. _`documentation`: https://packaging.pypa.io/
  12. .. _`issue tracker`: https://github.com/pypa/packaging/issues
  13. Code of Conduct
  14. ---------------
  15. Everyone interacting in the packaging project's codebases, issue trackers, chat
  16. rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
  17. .. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
  18. Changelog
  19. ---------
  20. 16.8 - 2016-10-29
  21. ~~~~~~~~~~~~~~~~~
  22. * Fix markers that utilize ``in`` so that they render correctly.
  23. * Fix an erroneous test on Python RC releases.
  24. 16.7 - 2016-04-23
  25. ~~~~~~~~~~~~~~~~~
  26. * Add support for the deprecated ``python_implementation`` marker which was
  27. an undocumented setuptools marker in addition to the newer markers.
  28. 16.6 - 2016-03-29
  29. ~~~~~~~~~~~~~~~~~
  30. * Add support for the deprecated, PEP 345 environment markers in addition to
  31. the newer markers.
  32. 16.5 - 2016-02-26
  33. ~~~~~~~~~~~~~~~~~
  34. * Fix a regression in parsing requirements with whitespaces between the comma
  35. separators.
  36. 16.4 - 2016-02-22
  37. ~~~~~~~~~~~~~~~~~
  38. * Fix a regression in parsing requirements like ``foo (==4)``.
  39. 16.3 - 2016-02-21
  40. ~~~~~~~~~~~~~~~~~
  41. * Fix a bug where ``packaging.requirements:Requirement`` was overly strict when
  42. matching legacy requirements.
  43. 16.2 - 2016-02-09
  44. ~~~~~~~~~~~~~~~~~
  45. * Add a function that implements the name canonicalization from PEP 503.
  46. 16.1 - 2016-02-07
  47. ~~~~~~~~~~~~~~~~~
  48. * Implement requirement specifiers from PEP 508.
  49. 16.0 - 2016-01-19
  50. ~~~~~~~~~~~~~~~~~
  51. * Relicense so that packaging is available under *either* the Apache License,
  52. Version 2.0 or a 2 Clause BSD license.
  53. * Support installation of packaging when only distutils is available.
  54. * Fix ``==`` comparison when there is a prefix and a local version in play.
  55. (`#41 <https://github.com/pypa/packaging/issues/41>`__).
  56. * Implement environment markers from PEP 508.
  57. 15.3 - 2015-08-01
  58. ~~~~~~~~~~~~~~~~~
  59. * Normalize post-release spellings for rev/r prefixes. `#35 <https://github.com/pypa/packaging/issues/35>`__
  60. 15.2 - 2015-05-13
  61. ~~~~~~~~~~~~~~~~~
  62. * Fix an error where the arbitary specifier (``===``) was not correctly
  63. allowing pre-releases when it was being used.
  64. * Expose the specifier and version parts through properties on the
  65. ``Specifier`` classes.
  66. * Allow iterating over the ``SpecifierSet`` to get access to all of the
  67. ``Specifier`` instances.
  68. * Allow testing if a version is contained within a specifier via the ``in``
  69. operator.
  70. 15.1 - 2015-04-13
  71. ~~~~~~~~~~~~~~~~~
  72. * Fix a logic error that was causing inconsistent answers about whether or not
  73. a pre-release was contained within a ``SpecifierSet`` or not.
  74. 15.0 - 2015-01-02
  75. ~~~~~~~~~~~~~~~~~
  76. * Add ``Version().is_postrelease`` and ``LegacyVersion().is_postrelease`` to
  77. make it easy to determine if a release is a post release.
  78. * Add ``Version().base_version`` and ``LegacyVersion().base_version`` to make
  79. it easy to get the public version without any pre or post release markers.
  80. * Support the update to PEP 440 which removed the implied ``!=V.*`` when using
  81. either ``>V`` or ``<V`` and which instead special cased the handling of
  82. pre-releases, post-releases, and local versions when using ``>V`` or ``<V``.
  83. 14.5 - 2014-12-17
  84. ~~~~~~~~~~~~~~~~~
  85. * Normalize release candidates as ``rc`` instead of ``c``.
  86. * Expose the ``VERSION_PATTERN`` constant, a regular expression matching
  87. a valid version.
  88. 14.4 - 2014-12-15
  89. ~~~~~~~~~~~~~~~~~
  90. * Ensure that versions are normalized before comparison when used in a
  91. specifier with a less than (``<``) or greater than (``>``) operator.
  92. 14.3 - 2014-11-19
  93. ~~~~~~~~~~~~~~~~~
  94. * **BACKWARDS INCOMPATIBLE** Refactor specifier support so that it can sanely
  95. handle legacy specifiers as well as PEP 440 specifiers.
  96. * **BACKWARDS INCOMPATIBLE** Move the specifier support out of
  97. ``packaging.version`` into ``packaging.specifiers``.
  98. 14.2 - 2014-09-10
  99. ~~~~~~~~~~~~~~~~~
  100. * Add prerelease support to ``Specifier``.
  101. * Remove the ability to do ``item in Specifier()`` and replace it with
  102. ``Specifier().contains(item)`` in order to allow flags that signal if a
  103. prerelease should be accepted or not.
  104. * Add a method ``Specifier().filter()`` which will take an iterable and returns
  105. an iterable with items that do not match the specifier filtered out.
  106. 14.1 - 2014-09-08
  107. ~~~~~~~~~~~~~~~~~
  108. * Allow ``LegacyVersion`` and ``Version`` to be sorted together.
  109. * Add ``packaging.version.parse()`` to enable easily parsing a version string
  110. as either a ``Version`` or a ``LegacyVersion`` depending on it's PEP 440
  111. validity.
  112. 14.0 - 2014-09-05
  113. ~~~~~~~~~~~~~~~~~
  114. * Initial release.