1
1
Fork 0
mirror of https://github.com/pypa/pip synced 2023-12-13 21:30:23 +01:00
The Python package installer https://pip.pypa.io/
Find a file
Pradyun Gedam d37aa211b4
Add a dedicated "Build system interface" reference section
This reworks a substantial portion of our existing build system related
documentation, putting it all in a single location.

There are certain areas that have been rephrased or rewritten:

- The setup.py interface is now considered an implementation detail.
- The setup.py interface is explicitly noted as a legacy interface, due
  for removal.
- The pyproject.toml interface now has clearer documentation on how it
  is used and how it operates.
- Clearer separation of `--use-pep-517` and `--no-build-isolation`, to
  make the difference between the two clearer.
2021-09-28 21:10:32 +01:00
.github Add a GitHub Actions workflow, to lock closed threads 2021-09-22 07:18:13 +01:00
docs Add a dedicated "Build system interface" reference section 2021-09-28 21:10:32 +01:00
news Merge pull request #10436 from jdufresne/fixture-data 2021-09-28 21:50:37 +08:00
src/pip Remove unnecessary TYPE_CHECKING guards around packaging imports 2021-09-26 10:42:38 -07:00
tests Merge pull request #10436 from jdufresne/fixture-data 2021-09-28 21:50:37 +08:00
tools Bump to vendoring 1.0.x 2021-09-13 08:11:45 +01:00
.gitattributes Get rid of the tools/automation folder 2021-04-01 23:25:09 +01:00
.gitignore Add .venv to .gitignore 2021-06-29 19:21:12 +00:00
.mailmap Clean up my Git entries 2020-12-14 18:50:19 +02:00
.pre-commit-config.yaml Install pytest in mypy environment 2021-09-12 20:49:56 -07:00
.readthedocs.yml Move docs requirements to docs/ 2021-07-24 12:06:51 +01:00
AUTHORS.txt Update AUTHORS.txt 2021-08-06 18:26:51 +08:00
LICENSE.txt Update copyright year from 2020 to 2021 2021-01-25 00:34:50 +05:30
MANIFEST.in Clean up leftover references to removed Travis and Azure CI 2021-08-28 20:01:58 -07:00
NEWS.rst Bump for release 2021-08-12 22:43:06 +08:00
noxfile.py Bump to vendoring 1.0.x 2021-09-13 08:11:45 +01:00
pyproject.toml Simplify vendoring configuration 2021-09-13 18:38:13 -07:00
README.rst Fix broken link in README.rst 2021-07-31 15:12:25 +08:00
setup.cfg Complete type annotations of tests/unit/ directory 2021-09-23 05:44:54 -07:00
setup.py Upgrade distlib to 0.3.3 (#10502) 2021-09-26 09:36:25 +01:00
tox.ini Bump to vendoring 1.0.x 2021-09-13 08:11:45 +01:00

pip - The Python Package Installer
==================================

.. image:: https://img.shields.io/pypi/v/pip.svg
   :target: https://pypi.org/project/pip/

.. image:: https://readthedocs.org/projects/pip/badge/?version=latest
   :target: https://pip.pypa.io/en/latest

pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes.

Please take a look at our documentation for how to install and use pip:

* `Installation`_
* `Usage`_

We release updates regularly, with a new version every 3 months. Find more details in our documentation:

* `Release notes`_
* `Release process`_

In pip 20.3, we've `made a big improvement to the heart of pip`_; `learn more`_. We want your input, so `sign up for our user experience research studies`_ to help us do it right.

**Note**: pip 21.0, in January 2021, removed Python 2 support, per pip's `Python 2 support policy`_. Please migrate to Python 3.

If you find bugs, need help, or want to talk to the developers, please use our mailing lists or chat rooms:

* `Issue tracking`_
* `Discourse channel`_
* `User IRC`_

If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms:

* `GitHub page`_
* `Development documentation`_
* `Development mailing list`_
* `Development IRC`_

Code of Conduct
---------------

Everyone interacting in the pip project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.

.. _package installer: https://packaging.python.org/guides/tool-recommendations/
.. _Python Package Index: https://pypi.org
.. _Installation: https://pip.pypa.io/en/stable/installation/
.. _Usage: https://pip.pypa.io/en/stable/
.. _Release notes: https://pip.pypa.io/en/stable/news.html
.. _Release process: https://pip.pypa.io/en/latest/development/release-process/
.. _GitHub page: https://github.com/pypa/pip
.. _Development documentation: https://pip.pypa.io/en/latest/development
.. _made a big improvement to the heart of pip: https://pyfound.blogspot.com/2020/11/pip-20-3-new-resolver.html
.. _learn more: https://pip.pypa.io/en/latest/user_guide/#changes-to-the-pip-dependency-resolver-in-20-3-2020
.. _sign up for our user experience research studies: https://pyfound.blogspot.com/2020/03/new-pip-resolver-to-roll-out-this-year.html
.. _Python 2 support policy: https://pip.pypa.io/en/latest/development/release-process/#python-2-support
.. _Issue tracking: https://github.com/pypa/pip/issues
.. _Discourse channel: https://discuss.python.org/c/packaging
.. _Development mailing list: https://mail.python.org/mailman3/lists/distutils-sig.python.org/
.. _User IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa
.. _Development IRC: https://kiwiirc.com/nextclient/#ircs://irc.libera.chat:+6697/pypa-dev
.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md