Skip to content

Commit b884587

Browse files
committed
Add documentation on pip's role as an installer
1 parent 99a82b7 commit b884587

File tree

2 files changed

+22
-0
lines changed

2 files changed

+22
-0
lines changed

docs/html/topics/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,4 +21,5 @@ repeatable-installs
2121
secure-installs
2222
vcs-support
2323
python-option
24+
workflow
2425
```

docs/html/topics/workflow.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
# Pip is not a workflow tool
2+
3+
The core purpose of pip is to *install packages*. Whilst installing packages is
4+
an important part of most Python development workflows, it is only one part.
5+
Managing a development workflow is, in itself, a complex task and one where
6+
there are many views on the "correct approach".
7+
8+
Pip has a number of features which make it useful in development workflows - for
9+
example, the ability to install the current project via `pip install .`,
10+
editable installs, and requirements files. However, there is no intention that
11+
pip will manage the workflow as a whole.
12+
13+
## The role of `ensurepip`
14+
15+
Pip is available in a standard Python installation, via the `ensurepip` stdlib
16+
module. This provides users with an "out of the box" installer, which can be
17+
used to gain access to all of the various tools and libraries available on PyPI.
18+
In particular, this includes a number of workflow tools.
19+
20+
This "bootstrapping" mechanism was proposed (and accepted) in [PEP
21+
453](https://www.python.org/dev/peps/pep-0453/).

0 commit comments

Comments
 (0)