Skip to content

Commit a18592c

Browse files
committed
Add detail to docs on constraints changes with new resolver
Related to pypa#8307, pypa#8115.
1 parent 97fb574 commit a18592c

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

docs/html/user_guide.rst

+14-9
Original file line numberDiff line numberDiff line change
@@ -1438,22 +1438,27 @@ install x y`` in a single command. We would like your thoughts on what
14381438
pip's behavior should be; please answer `our survey on upgrades that
14391439
create conflicts`_.
14401440

1441-
We are also changing our support for :ref:`Constraints Files` and
1442-
related functionality. We did a fairly comprehensive overhaul and
1443-
stripped constraints files down to being purely a way to specify
1444-
global (version) limits for packages. Specifically:
1441+
We are also changing our support for :ref:`Constraints Files`,
1442+
editable installs, and related functionality. We did a fairly
1443+
comprehensive overhaul and stripped constraints files down to being
1444+
purely a way to specify global (version) limits for packages, and so
1445+
some combinations that used to be allowed will now cause
1446+
errors. Specifically:
14451447

14461448
* Constraints don't override the existing requirements; they simply
14471449
constrain what versions are visible as input to the resolver (see
14481450
:issue:`9020`)
1449-
14501451
* Providing an editable requirement (``-e .``) does not cause pip to
1451-
ignore version specifiers or constraints (see :issue:`8076`)
1452-
1452+
ignore version specifiers or constraints (see :issue:`8076`), and if
1453+
you have a conflict between a pinned requirement and a local
1454+
directory then pip will indicate that it cannot find a version
1455+
satisfying both (see :issue:`8307`)
14531456
* Hash-checking mode requires that all requirements are specified as a
1454-
`==` match on a version and may not work well in combination with
1457+
``==`` match on a version and may not work well in combination with
14551458
constraints (see :issue:`9020` and :issue:`8792`)
1456-
1459+
* If necessary to satisfy constraints, pip will happily reinstall
1460+
packages, upgrading or downgrading, without needing any additional
1461+
command-line options (see :issue:`8115` and :doc:`development/architecture/upgrade-options`)
14571462
* Unnamed requirements are not allowed as constraints (see :issue:`6628` and :issue:`8210`)
14581463
* Links are not allowed as constraints (see :issue:`8253`)
14591464
* Constraints cannot have extras (see :issue:`6628`)

0 commit comments

Comments
 (0)