Bump for release

NEWS.rst

@@ -7,6 +7,126 @@
 
 .. towncrier release notes start
 
+20.0 (2020-01-21)
+=================
+
+Process
+-------
+
+- Switch to a dedicated CLI tool for vendoring dependencies.
+
+Deprecations and Removals
+-------------------------
+
+- Remove wheel tag calculation from pip and use ``packaging.tags``. This
+  should provide more tags ordered better than in prior releases. (`#6908 <https://github.com/pypa/pip/issues/6908>`_)
+- Deprecate setup.py-based builds that do not generate an ``.egg-info`` directory. (`#6998 <https://github.com/pypa/pip/issues/6998>`_)
+- The pip>=20 wheel cache is not retro-compatible with previous versions. Until
+  pip 21.0, pip will continue to take advantage of existing legacy cache
+  entries. (`#7296 <https://github.com/pypa/pip/issues/7296>`_)
+- Deprecate undocumented ``--skip-requirements-regex`` option. (`#7297 <https://github.com/pypa/pip/issues/7297>`_)
+- Deprecate passing install-location-related options via ``--install-option``. (`#7309 <https://github.com/pypa/pip/issues/7309>`_)
+- Use literal "abi3" for wheel tag on CPython 3.x, to align with PEP 384
+  which only defines it for this platform. (`#7327 <https://github.com/pypa/pip/issues/7327>`_)
+- Remove interpreter-specific major version tag e.g. ``cp3-none-any``
+  from consideration. This behavior was not documented strictly, and this
+  tag in particular is `not useful <https://snarky.ca/the-challenges-in-designing-a-library-for-pep-425/>`_.
+  Anyone with a use case can create an issue with pypa/packaging. (`#7355 <https://github.com/pypa/pip/issues/7355>`_)
+- Wheel processing no longer permits wheels containing more than one top-level
+  .dist-info directory. (`#7487 <https://github.com/pypa/pip/issues/7487>`_)
+- Support for the ``git+git@`` form of VCS requirement is being deprecated and
+  will be removed in pip 21.0. Switch to ``git+https://`` or
+  ``git+ssh://``. ``git+git://`` also works but its use is discouraged as it is
+  insecure. (`#7543 <https://github.com/pypa/pip/issues/7543>`_)
+
+Features
+--------
+
+- Default to doing a user install (as if ``--user`` was passed) when the main
+  site-packages directory is not writeable and user site-packages are enabled. (`#1668 <https://github.com/pypa/pip/issues/1668>`_)
+- Warn if a path in PATH starts with tilde during ``pip install``. (`#6414 <https://github.com/pypa/pip/issues/6414>`_)
+- Cache wheels built from Git requirements that are considered immutable,
+  because they point to a commit hash. (`#6640 <https://github.com/pypa/pip/issues/6640>`_)
+- Add option ``--no-python-version-warning`` to silence warnings
+  related to deprecation of Python versions. (`#6673 <https://github.com/pypa/pip/issues/6673>`_)
+- Cache wheels that ``pip wheel`` built locally, matching what
+  ``pip install`` does. This particularly helps performance in workflows where
+  ``pip wheel`` is used for `building before installing
+  <https://pip.pypa.io/en/stable/user_guide/#installing-from-local-packages>`_.
+  Users desiring the original behavior can use ``pip wheel --no-cache-dir``. (`#6852 <https://github.com/pypa/pip/issues/6852>`_)
+- Display CA information in ``pip debug``. (`#7146 <https://github.com/pypa/pip/issues/7146>`_)
+- Show only the filename (instead of full URL), when downloading from PyPI. (`#7225 <https://github.com/pypa/pip/issues/7225>`_)
+- Suggest a more robust command to upgrade pip itself to avoid confusion when the
+  current pip command is not available as ``pip``. (`#7376 <https://github.com/pypa/pip/issues/7376>`_)
+- Define all old pip console script entrypoints to prevent import issues in
+  stale wrapper scripts. (`#7498 <https://github.com/pypa/pip/issues/7498>`_)
+- The build step of ``pip wheel`` now builds all wheels to a cache first,
+  then copies them to the wheel directory all at once.
+  Before, it built them to a temporary direcory and moved
+  them to the wheel directory one by one. (`#7517 <https://github.com/pypa/pip/issues/7517>`_)
+- Expand ``~`` prefix to user directory in path options, configs, and
+  environment variables. Values that may be either URL or path are not
+  currently supported, to avoid ambiguity:
+
+  * ``--find-links``
+  * ``--constraint``, ``-c``
+  * ``--requirement``, ``-r``
+  * ``--editable``, ``-e`` (`#980 <https://github.com/pypa/pip/issues/980>`_)
+
+Bug Fixes
+---------
+
+- Correctly handle system site-packages, in virtual environments created with venv (PEP 405). (`#5702 <https://github.com/pypa/pip/issues/5702>`_, `#7155 <https://github.com/pypa/pip/issues/7155>`_)
+- Fix case sensitive comparison of pip freeze when used with -r option. (`#5716 <https://github.com/pypa/pip/issues/5716>`_)
+- Enforce PEP 508 requirement format in ``pyproject.toml``
+  ``build-system.requires``. (`#6410 <https://github.com/pypa/pip/issues/6410>`_)
+- Make ``ensure_dir()`` also ignore ``ENOTEMPTY`` as seen on Windows. (`#6426 <https://github.com/pypa/pip/issues/6426>`_)
+- Fix building packages which specify ``backend-path`` in pyproject.toml. (`#6599 <https://github.com/pypa/pip/issues/6599>`_)
+- Do not attempt to run ``setup.py clean`` after a ``pep517`` build error,
+  since a ``setup.py`` may not exist in that case. (`#6642 <https://github.com/pypa/pip/issues/6642>`_)
+- Fix passwords being visible in the index-url in
+  "Downloading <url>" message. (`#6783 <https://github.com/pypa/pip/issues/6783>`_)
+- Change method from shutil.remove to shutil.rmtree in noxfile.py. (`#7191 <https://github.com/pypa/pip/issues/7191>`_)
+- Skip running tests which require subversion, when svn isn't installed (`#7193 <https://github.com/pypa/pip/issues/7193>`_)
+- Fix not sending client certificates when using ``--trusted-host``. (`#7207 <https://github.com/pypa/pip/issues/7207>`_)
+- Make sure ``pip wheel`` never outputs pure python wheels with a
+  python implementation tag. Better fix/workaround for
+  `#3025 <https://github.com/pypa/pip/issues/3025>`_ by
+  using a per-implementation wheel cache instead of caching pure python
+  wheels with an implementation tag in their name. (`#7296 <https://github.com/pypa/pip/issues/7296>`_)
+- Include ``subdirectory`` URL fragments in cache keys. (`#7333 <https://github.com/pypa/pip/issues/7333>`_)
+- Fix typo in warning message when any of ``--build-option``, ``--global-option``
+  and ``--install-option`` is used in requirements.txt (`#7340 <https://github.com/pypa/pip/issues/7340>`_)
+- Fix the logging of cached HTTP response shown as downloading. (`#7393 <https://github.com/pypa/pip/issues/7393>`_)
+- Effectively disable the wheel cache when it is not writable, as is the
+  case with the http cache. (`#7488 <https://github.com/pypa/pip/issues/7488>`_)
+- Correctly handle relative cache directory provided via --cache-dir. (`#7541 <https://github.com/pypa/pip/issues/7541>`_)
+
+Vendored Libraries
+------------------
+
+- Upgrade CacheControl to 0.12.5
+- Upgrade certifi to 2019.9.11
+- Upgrade colorama to 0.4.1
+- Upgrade distlib to 0.2.9.post0
+- Upgrade ipaddress to 1.0.22
+- Update packaging to 20.0.
+- Upgrade pkg_resources (via setuptools) to 44.0.0
+- Upgrade pyparsing to 2.4.2
+- Upgrade six to 1.12.0
+- Upgrade urllib3 to 1.25.6
+
+Improved Documentation
+----------------------
+
+- Document that "coding: utf-8" is supported in requirements.txt (`#7182 <https://github.com/pypa/pip/issues/7182>`_)
+- Explain how to get pip's source code in `Getting Started <https://pip.pypa.io/en/stable/development/getting-started/>`_ (`#7197 <https://github.com/pypa/pip/issues/7197>`_)
+- Describe how basic authentication credentials in URLs work. (`#7201 <https://github.com/pypa/pip/issues/7201>`_)
+- Add more clear installation instructions (`#7222 <https://github.com/pypa/pip/issues/7222>`_)
+- Fix documentation links for index options (`#7347 <https://github.com/pypa/pip/issues/7347>`_)
+- Better document the requirements file format (`#7385 <https://github.com/pypa/pip/issues/7385>`_)
+
+
 19.3.1 (2019-10-17)
 ===================
 

news/1668.feature

-Default to doing a user install (as if ``--user`` was passed) when the main
-site-packages directory is not writeable and user site-packages are enabled.

news/4785.process

-Switch to a dedicated CLI tool for vendoring dependencies.

news/5702.bugfix

-Correctly handle system site-packages, in virtual environments created with venv (PEP 405).

news/5716.bugfix

-Fix case sensitive comparison of pip freeze when used with -r option.

news/5860.trivial

-Updated info about pip support for url_req portion of PEP508 in doc.

news/6004.trivial

-Read version in setup.py without re

news/6410.bugfix

-Enforce PEP 508 requirement format in ``pyproject.toml``
-``build-system.requires``.

news/6414.feature

-Warn if a path in PATH starts with tilde during ``pip install``.

news/6426.bugfix

-Make ``ensure_dir()`` also ignore ``ENOTEMPTY`` as seen on Windows.

news/6599.bugfix

-Fix building packages which specify ``backend-path`` in pyproject.toml.

news/6640.feature

-Cache wheels built from Git requirements that are considered immutable,
-because they point to a commit hash.

news/6642.bugfix

-Do not attempt to run ``setup.py clean`` after a ``pep517`` build error,
-since a ``setup.py`` may not exist in that case.

news/6673.feature

-Add option ``--no-python-version-warning`` to silence warnings
-related to deprecation of Python versions.

news/6783.bugfix

-Fix passwords being visible in the index-url in
-"Downloading <url>" message.

news/6852.feature

-Cache wheels that ``pip wheel`` built locally, matching what
-``pip install`` does. This particularly helps performance in workflows where
-``pip wheel`` is used for `building before installing
-<https://pip.pypa.io/en/stable/user_guide/#installing-from-local-packages>`_.
-Users desiring the original behavior can use ``pip wheel --no-cache-dir``.

news/6908.removal

-Remove wheel tag calculation from pip and use ``packaging.tags``. This
-should provide more tags ordered better than in prior releases.

news/6998.removal

-Deprecate setup.py-based builds that do not generate an ``.egg-info`` directory.

news/7146.feature

-Display CA information in ``pip debug``.

news/7155.bugfix

-Correctly handle system site-packages, in virtual environments created with venv (PEP 405).

news/7182.doc

-Document that "coding: utf-8" is supported in requirements.txt

news/7191.bugfix

-Change method from shutil.remove to shutil.rmtree in noxfile.py.

news/7193.bugfix

-Skip running tests which require subversion, when svn isn't installed

news/7197.doc

-Explain how to get pip's source code in `Getting Started <https://pip.pypa.io/en/stable/development/getting-started/>`_

news/7199.trivial

-adding line in trivial file to avoid linter issues.

news/7201.doc

-Describe how basic authentication credentials in URLs work.

news/7207.bugfix

-Fix not sending client certificates when using ``--trusted-host``.

news/7222.doc

-Add more clear installation instructions

news/7225.feature

-Show only the filename (instead of full URL), when downloading from PyPI.

news/7230.trivial

-Change ``pip._internal.wheel`` to respect docstring conventions.

news/7268.trivial

-refactoring: remove should_use_ephemeral_cache

news/7281.trivial

-refactor _get_used_vcs_backend

news/7296.bugfix

-Make sure ``pip wheel`` never outputs pure python wheels with a
-python implementation tag. Better fix/workaround for
-`#3025 <https://github.com/pypa/pip/issues/3025>`_ by
-using a per-implementation wheel cache instead of caching pure python
-wheels with an implementation tag in their name.

news/7296.removal

-The pip>=20 wheel cache is not retro-compatible with previous versions. Until
-pip 21.0, pip will continue to take advantage of existing legacy cache
-entries.

news/7297.removal

-Deprecate undocumented ``--skip-requirements-regex`` option.

news/7309.removal

-Deprecate passing install-location-related options via ``--install-option``.

news/7327.removal

-Use literal "abi3" for wheel tag on CPython 3.x, to align with PEP 384
-which only defines it for this platform.

news/7333.bugfix

-Include ``subdirectory`` URL fragments in cache keys.

news/7340.bugfix

-Fix typo in warning message when any of ``--build-option``, ``--global-option``
-and ``--install-option`` is used in requirements.txt

news/7347.doc

-Fix documentation links for index options

news/7355.removal

-Remove interpreter-specific major version tag e.g. ``cp3-none-any``
-from consideration. This behavior was not documented strictly, and this
-tag in particular is `not useful <https://snarky.ca/the-challenges-in-designing-a-library-for-pep-425/>`_.
-Anyone with a use case can create an issue with pypa/packaging.

news/7376.feature

-Suggest a more robust command to upgrade pip itself to avoid confusion when the
-current pip command is not available as ``pip``.

news/7385.doc

-Better document the requirements file format

news/7393.bugfix

-Fix the logging of cached HTTP response shown as downloading.

news/7411.trivial

-Added a note about # noqa comments in the Getting Started Guide

news/7487.removal

-Wheel processing no longer permits wheels containing more than one top-level
-.dist-info directory.

news/7488.bugfix

-Effectively disable the wheel cache when it is not writable, as is the
-case with the http cache.

news/7490.trivial

-Fix unrelease bug from #7319.

news/7498.feature

-Define all old pip console script entrypoints to prevent import issues in
-stale wrapper scripts.

news/7517.feature

-The build step of ``pip wheel`` now builds all wheels to a cache first,
-then copies them to the wheel directory all at once.
-Before, it built them to a temporary direcory and moved
-them to the wheel directory one by one.

news/7541.bugfix

-Correctly handle relative cache directory provided via --cache-dir.

news/7543.removal

-Support for the ``git+git@`` form of VCS requirement is being deprecated and
-will be removed in pip 21.0. Switch to ``git+https://`` or
-``git+ssh://``. ``git+git://`` also works but its use is discouraged as it is
-insecure.

news/980.feature

-Expand ``~`` prefix to user directory in path options, configs, and
-environment variables. Values that may be either URL or path are not
-currently supported, to avoid ambiguity:
-
-* ``--find-links``
-* ``--constraint``, ``-c``
-* ``--requirement``, ``-r``
-* ``--editable``, ``-e``

news/CacheControl.vendor

-Upgrade CacheControl to 0.12.5

news/certifi.vendor

-Upgrade certifi to 2019.9.11

news/colorama.vendor

-Upgrade colorama to 0.4.1

news/distlib.vendor

-Upgrade distlib to 0.2.9.post0

news/ipaddress.vendor

-Upgrade ipaddress to 1.0.22

news/packaging.vendor

-Update packaging to 20.0.

news/pkg_resources.vendor

-Upgrade pkg_resources (via setuptools) to 44.0.0

news/pyparsing.vendor

-Upgrade pyparsing to 2.4.2

news/six.vendor

-Upgrade six to 1.12.0

news/urllib3.vendor

-Upgrade urllib3 to 1.25.6

src/pip/__init__.py

@@ -4,7 +4,7 @@ if MYPY_CHECK_RUNNING:
     from typing import List, Optional
 
 
-__version__ = "20.0.dev0"
+__version__ = "20.0"
 
 
 def main(args=None):