Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improve migration guide re: new resolver #9056

Merged
merged 6 commits into from
Oct 29, 2020
Merged

Improve migration guide re: new resolver #9056

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
b7c3503
Add note about install/upgrade behavior to docs
brainwane Oct 26, 2020
5393032
Improve docs on resolver, constraints, and hash-checking
brainwane Oct 27, 2020
27b100e
Explain resolver changes affecting constraints files
brainwane Oct 27, 2020
395e1ae
Add detail to docs on constraints changes with new resolver
brainwane Oct 27, 2020
fbcdeca
Clarify constraints overhaul in user guide
brainwane Oct 27, 2020
3f4e15a
docs: Emphasize that pip may break existing packages
brainwane Oct 29, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Add note about install/upgrade behavior to docs 
Towards #8115.
  • Loading branch information
@brainwane
brainwane committed Oct 29, 2020
commit b7c3503a342ba52b3e782a4a3373f8b31e855e4a
10 changes: 7 additions & 3 deletions docs/html/development/architecture/upgrade-options.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,10 @@
Options that control the installation process
=============================================

When installing packages, pip chooses a distribution file, and installs it in
the user's environment. There are many choices involved in deciding which file
to install, and these are controlled by a variety of options.
When installing packages, pip chooses a distribution file, and
installs it in the user's environment. There are many choices (which
are `still evolving`_) involved in deciding which file to install, and
these are controlled by a variety of options.

.. note::

Expand Down Expand Up @@ -122,3 +123,6 @@ necessarily resolution or what gets installed.
``--constraint``

``--editable <LOCATION>``


.. _still evolving: https://github.com/pypa/pip/issues/8115
3 changes: 3 additions & 0 deletions docs/html/reference/pip_install.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,9 @@ pip install has several stages:
3. Build wheels. All the dependencies that can be are built into wheels.
4. Install the packages (and uninstall anything being upgraded/replaced).

Note that ``pip install`` prefers to leave the installed version as-is
unless ``--upgrade`` is specified.

Argument Handling
-----------------

Expand Down