-
Notifications
You must be signed in to change notification settings - Fork 3.1k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add documentation on pip's role as an installer
- Loading branch information
Showing
2 changed files
with
22 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -21,4 +21,5 @@ repeatable-installs | |
secure-installs | ||
vcs-support | ||
python-option | ||
workflow | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
# Pip is not a workflow tool | ||
|
||
The core purpose of pip is to *install packages*. Whilst installing packages is | ||
an important part of most Python development workflows, it is only one part. | ||
Managing a development workflow is, in itself, a complex task and one where | ||
there are many views on the "correct approach". | ||
|
||
Pip has a number of features which make it useful in development workflows - for | ||
example, the ability to install the current project via `pip install .`, | ||
editable installs, and requirements files. However, there is no intention that | ||
pip will manage the workflow as a whole. | ||
|
||
## The role of `ensurepip` | ||
|
||
Pip is available in a standard Python installation, via the `ensurepip` stdlib | ||
module. This provides users with an "out of the box" installer, which can be | ||
used to gain access to all of the various tools and libraries available on PyPI. | ||
In particular, this includes a number of workflow tools. | ||
|
||
This "bootstrapping" mechanism was proposed (and accepted) in [PEP | ||
453](https://www.python.org/dev/peps/pep-0453/). |