mirror of https://github.com/pypa/pip
pip is spelt all-lowercase
This commit is contained in:
parent
59c47ab88c
commit
e648e00dc0
|
@ -1,3 +1,3 @@
|
||||||
* Pip version:
|
* pip version:
|
||||||
* Python version:
|
* Python version:
|
||||||
* Operating system:
|
* Operating system:
|
||||||
|
|
8
NEWS.rst
8
NEWS.rst
|
@ -1538,7 +1538,7 @@ Improved Documentation
|
||||||
convince some servers who double compress the downloaded file to stop doing
|
convince some servers who double compress the downloaded file to stop doing
|
||||||
so. (#1688)
|
so. (#1688)
|
||||||
- Stop breaking when given pip commands in uppercase (#1559, #1725)
|
- Stop breaking when given pip commands in uppercase (#1559, #1725)
|
||||||
- Pip no longer adds duplicate logging consumers, so it won't create duplicate
|
- pip no longer adds duplicate logging consumers, so it won't create duplicate
|
||||||
output when being called multiple times. (#1618, #1723)
|
output when being called multiple times. (#1618, #1723)
|
||||||
- `pip wheel` now returns an error code if any wheels fail to build. (#1769)
|
- `pip wheel` now returns an error code if any wheels fail to build. (#1769)
|
||||||
- `pip wheel` wasn't building wheels for dependencies of editable requirements.
|
- `pip wheel` wasn't building wheels for dependencies of editable requirements.
|
||||||
|
@ -1661,7 +1661,7 @@ Improved Documentation
|
||||||
- pip will now install Mac OSX platform wheels from PyPI. (:pull:`1278`)
|
- pip will now install Mac OSX platform wheels from PyPI. (:pull:`1278`)
|
||||||
- pip now generates the appropriate platform-specific console scripts when
|
- pip now generates the appropriate platform-specific console scripts when
|
||||||
installing wheels. (#1251)
|
installing wheels. (#1251)
|
||||||
- Pip now confirms a wheel is supported when installing directly from a path or
|
- pip now confirms a wheel is supported when installing directly from a path or
|
||||||
url. (#1315)
|
url. (#1315)
|
||||||
- ``--ignore-installed`` now behaves again as designed, after it was
|
- ``--ignore-installed`` now behaves again as designed, after it was
|
||||||
unintentionally broke in v0.8.3 when fixing #14. (#1097, #1352)
|
unintentionally broke in v0.8.3 when fixing #14. (#1097, #1352)
|
||||||
|
@ -1870,7 +1870,7 @@ Improved Documentation
|
||||||
Dan Callahan for report and patch. (#182)
|
Dan Callahan for report and patch. (#182)
|
||||||
- Understand version tags without minor version ("py3") in sdist filenames.
|
- Understand version tags without minor version ("py3") in sdist filenames.
|
||||||
Thanks Stuart Andrews for report and Olivier Girardot for patch. (#310)
|
Thanks Stuart Andrews for report and Olivier Girardot for patch. (#310)
|
||||||
- Pip now supports optionally installing setuptools "extras" dependencies; e.g.
|
- pip now supports optionally installing setuptools "extras" dependencies; e.g.
|
||||||
"pip install Paste[openid]". Thanks Matt Maker and Olivier Girardot. (#7)
|
"pip install Paste[openid]". Thanks Matt Maker and Olivier Girardot. (#7)
|
||||||
- freeze no longer borks on requirements files with --index-url or --find-links.
|
- freeze no longer borks on requirements files with --index-url or --find-links.
|
||||||
Thanks Herbert Pfennig. (#391)
|
Thanks Herbert Pfennig. (#391)
|
||||||
|
@ -1995,7 +1995,7 @@ Improved Documentation
|
||||||
|
|
||||||
- Track which ``build/`` directories pip creates, never remove directories
|
- Track which ``build/`` directories pip creates, never remove directories
|
||||||
it doesn't create. From Hugo Lopes Tavares.
|
it doesn't create. From Hugo Lopes Tavares.
|
||||||
- Pip now accepts file:// index URLs. Thanks Dave Abrahams.
|
- pip now accepts file:// index URLs. Thanks Dave Abrahams.
|
||||||
- Various cleanup to make test-running more consistent and less fragile.
|
- Various cleanup to make test-running more consistent and less fragile.
|
||||||
Thanks Dave Abrahams.
|
Thanks Dave Abrahams.
|
||||||
- Real Windows support (with passing tests). Thanks Dave Abrahams.
|
- Real Windows support (with passing tests). Thanks Dave Abrahams.
|
||||||
|
|
|
@ -77,7 +77,7 @@ Within ``src/``:
|
||||||
* ``__init__.py``
|
* ``__init__.py``
|
||||||
* ``__main__.py``
|
* ``__main__.py``
|
||||||
* ``__pycache__/`` *[not discussing contents right now]*
|
* ``__pycache__/`` *[not discussing contents right now]*
|
||||||
* ``_internal/`` *[where all the pip code lives that’s written by pip maintainers -- underscore means private. Pip is not a library -- it’s a command line tool! A very important distinction! People who want to install stuff with pip should not use the internals -- they should use the CLI. There’s a note on this in the docs.]*
|
* ``_internal/`` *[where all the pip code lives that’s written by pip maintainers -- underscore means private. pip is not a library -- it’s a command line tool! A very important distinction! People who want to install stuff with pip should not use the internals -- they should use the CLI. There’s a note on this in the docs.]*
|
||||||
|
|
||||||
* ``__init__.py``
|
* ``__init__.py``
|
||||||
* ``build_env.py`` [not discussing now]
|
* ``build_env.py`` [not discussing now]
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
Broad functionality overview
|
Broad functionality overview
|
||||||
****************************
|
****************************
|
||||||
|
|
||||||
Pip is a package installer.
|
pip is a package installer.
|
||||||
|
|
||||||
pip does a lot more than installation; it also has a cache, and it has
|
pip does a lot more than installation; it also has a cache, and it has
|
||||||
configuration, and it has a CLI, which has its own quirks. But mainly:
|
configuration, and it has a CLI, which has its own quirks. But mainly:
|
||||||
|
@ -53,7 +53,7 @@ In sequence, what does pip do?:
|
||||||
|
|
||||||
4. Install the actual items to be installed.
|
4. Install the actual items to be installed.
|
||||||
|
|
||||||
Why? Pip installs from places other than PyPI! But also, we’ve never had
|
Why? pip installs from places other than PyPI! But also, we’ve never had
|
||||||
guarantees of PyPI’s JSON API before now, so no one has been getting
|
guarantees of PyPI’s JSON API before now, so no one has been getting
|
||||||
metadata from PyPI separate from downloading the package itself.
|
metadata from PyPI separate from downloading the package itself.
|
||||||
|
|
||||||
|
@ -118,7 +118,7 @@ When pip looks at the package index, the place where it looks has
|
||||||
basically a link. The link’s text is the name of the file
|
basically a link. The link’s text is the name of the file
|
||||||
|
|
||||||
This is the `PyPI Simple API`_ (PyPI has several APIs, some are being
|
This is the `PyPI Simple API`_ (PyPI has several APIs, some are being
|
||||||
deprecated). Pip looks at Simple API, documented initially at :pep:`503` --
|
deprecated). pip looks at Simple API, documented initially at :pep:`503` --
|
||||||
packaging.python.org has PyPA specifications with more details for
|
packaging.python.org has PyPA specifications with more details for
|
||||||
Simple Repository API
|
Simple Repository API
|
||||||
|
|
||||||
|
|
|
@ -74,7 +74,7 @@ when decision is needed.
|
||||||
Build System Interface
|
Build System Interface
|
||||||
======================
|
======================
|
||||||
|
|
||||||
Pip builds packages by invoking the build system. By default, builds will use
|
pip builds packages by invoking the build system. By default, builds will use
|
||||||
``setuptools``, but if a project specifies a different build system using a
|
``setuptools``, but if a project specifies a different build system using a
|
||||||
``pyproject.toml`` file, as per :pep:`517`, pip will use that instead. As well
|
``pyproject.toml`` file, as per :pep:`517`, pip will use that instead. As well
|
||||||
as package building, the build system is also invoked to install packages
|
as package building, the build system is also invoked to install packages
|
||||||
|
@ -113,7 +113,7 @@ ASCII, pip assumes UTF-8 (to account for the behaviour of some Unix systems).
|
||||||
Build systems should ensure that any tools they invoke (compilers, etc) produce
|
Build systems should ensure that any tools they invoke (compilers, etc) produce
|
||||||
output in the correct encoding. In practice - and in particular on Windows,
|
output in the correct encoding. In practice - and in particular on Windows,
|
||||||
where tools are inconsistent in their use of the "OEM" and "ANSI" codepages -
|
where tools are inconsistent in their use of the "OEM" and "ANSI" codepages -
|
||||||
this may not always be possible. Pip will therefore attempt to recover cleanly
|
this may not always be possible. pip will therefore attempt to recover cleanly
|
||||||
if presented with incorrectly encoded build tool output, by translating
|
if presented with incorrectly encoded build tool output, by translating
|
||||||
unexpected byte sequences to Python-style hexadecimal escape sequences
|
unexpected byte sequences to Python-style hexadecimal escape sequences
|
||||||
(``"\x80\xff"``, etc). However, it is still possible for output to be displayed
|
(``"\x80\xff"``, etc). However, it is still possible for output to be displayed
|
||||||
|
|
|
@ -21,7 +21,7 @@ Description
|
||||||
Overview
|
Overview
|
||||||
--------
|
--------
|
||||||
|
|
||||||
Pip install has several stages:
|
pip install has several stages:
|
||||||
|
|
||||||
1. Identify the base requirements. The user supplied arguments are processed
|
1. Identify the base requirements. The user supplied arguments are processed
|
||||||
here.
|
here.
|
||||||
|
@ -574,7 +574,7 @@ Windows
|
||||||
Wheel Cache
|
Wheel Cache
|
||||||
^^^^^^^^^^^
|
^^^^^^^^^^^
|
||||||
|
|
||||||
Pip will read from the subdirectory ``wheels`` within the pip cache directory
|
pip will read from the subdirectory ``wheels`` within the pip cache directory
|
||||||
and use any packages found there. This is disabled via the same
|
and use any packages found there. This is disabled via the same
|
||||||
``--no-cache-dir`` option that disables the HTTP cache. The internal structure
|
``--no-cache-dir`` option that disables the HTTP cache. The internal structure
|
||||||
of that is not part of the pip API. As of 7.0, pip makes a subdirectory for
|
of that is not part of the pip API. As of 7.0, pip makes a subdirectory for
|
||||||
|
@ -583,7 +583,7 @@ each sdist that wheels are built from and places the resulting wheels inside.
|
||||||
As of version 20.0, pip also caches wheels when building from an immutable Git
|
As of version 20.0, pip also caches wheels when building from an immutable Git
|
||||||
reference (i.e. a commit hash).
|
reference (i.e. a commit hash).
|
||||||
|
|
||||||
Pip attempts to choose the best wheels from those built in preference to
|
pip attempts to choose the best wheels from those built in preference to
|
||||||
building a new wheel. Note that this means when a package has both optional
|
building a new wheel. Note that this means when a package has both optional
|
||||||
C extensions and builds ``py`` tagged wheels when the C extension can't be built
|
C extensions and builds ``py`` tagged wheels when the C extension can't be built
|
||||||
that pip will not attempt to build a better wheel for Pythons that would have
|
that pip will not attempt to build a better wheel for Pythons that would have
|
||||||
|
|
|
@ -224,7 +224,7 @@ Installing from Wheels
|
||||||
to building and installing from source archives. For more information, see the
|
to building and installing from source archives. For more information, see the
|
||||||
`Wheel docs <https://wheel.readthedocs.io>`_ , :pep:`427`, and :pep:`425`.
|
`Wheel docs <https://wheel.readthedocs.io>`_ , :pep:`427`, and :pep:`425`.
|
||||||
|
|
||||||
Pip prefers Wheels where they are available. To disable this, use the
|
pip prefers Wheels where they are available. To disable this, use the
|
||||||
:ref:`--no-binary <install_--no-binary>` flag for :ref:`pip install`.
|
:ref:`--no-binary <install_--no-binary>` flag for :ref:`pip install`.
|
||||||
|
|
||||||
If no satisfactory wheels are found, pip will default to finding source
|
If no satisfactory wheels are found, pip will default to finding source
|
||||||
|
|
|
@ -489,7 +489,7 @@ class InstallCommand(RequirementCommand):
|
||||||
if os.path.islink(target_item_dir):
|
if os.path.islink(target_item_dir):
|
||||||
logger.warning(
|
logger.warning(
|
||||||
'Target directory %s already exists and is '
|
'Target directory %s already exists and is '
|
||||||
'a link. Pip will not automatically replace '
|
'a link. pip will not automatically replace '
|
||||||
'links, please remove if replacement is '
|
'links, please remove if replacement is '
|
||||||
'desired.',
|
'desired.',
|
||||||
target_item_dir
|
target_item_dir
|
||||||
|
|
|
@ -204,7 +204,7 @@ def check_compatibility(version, name):
|
||||||
# type: (Tuple[int, ...], str) -> None
|
# type: (Tuple[int, ...], str) -> None
|
||||||
"""Raises errors or warns if called with an incompatible Wheel-Version.
|
"""Raises errors or warns if called with an incompatible Wheel-Version.
|
||||||
|
|
||||||
Pip should refuse to install a Wheel-Version that's a major series
|
pip should refuse to install a Wheel-Version that's a major series
|
||||||
ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
|
ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
|
||||||
installing a version only minor version ahead (e.g 1.2 > 1.1).
|
installing a version only minor version ahead (e.g 1.2 > 1.1).
|
||||||
|
|
||||||
|
|
|
@ -122,7 +122,7 @@ def test_more_than_one_package():
|
||||||
Search for more than one package.
|
Search for more than one package.
|
||||||
|
|
||||||
"""
|
"""
|
||||||
result = list(search_packages_info(['Pip', 'pytest', 'Virtualenv']))
|
result = list(search_packages_info(['pIp', 'pytest', 'Virtualenv']))
|
||||||
assert len(result) == 3
|
assert len(result) == 3
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue