Skip to content

Commit 27b100e

Browse files
committed
Explain resolver changes affecting constraints files
Related to pypa#8792, pypa#8076, pypa#9020.
1 parent 5393032 commit 27b100e

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

docs/html/user_guide.rst

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -291,7 +291,10 @@ organisation and use that everywhere. If the thing being installed requires
291291
"helloworld" to be installed, your fixed version specified in your constraints
292292
file will be used.
293293

294-
Constraints file support was added in pip 7.1.
294+
Constraints file support was added in pip 7.1. In :ref:`Resolver
295+
changes 2020` we did a fairly comprehensive overhaul and stripped
296+
constraints files down to being purely a way to specify global
297+
(version) limits for packages.
295298

296299
.. _`Installing from Wheels`:
297300

@@ -1446,15 +1449,21 @@ install x y`` in a single command. We would like your thoughts on what
14461449
pip's behavior should be; please answer `our survey on upgrades that
14471450
create conflicts`_.
14481451

1449-
We are also changing our support for :ref:`Constraints Files` and related functionality:
1452+
We are also changing our support for :ref:`Constraints Files` and
1453+
related functionality. We did a fairly comprehensive overhaul and
1454+
stripped constraints files down to being purely a way to specify
1455+
global (version) limits for packages. Specifically:
14501456

14511457
* Constraints don't override the existing requirements; they simply
14521458
constrain what versions are visible as input to the resolver (see
14531459
:issue:`9020`)
14541460

1461+
* Providing an editable requirement (``-e .``) does not cause pip to
1462+
ignore version specifiers or constraints (see :issue:`8076`)
1463+
14551464
* Hash-checking mode requires that all requirements are specified as a
1456-
`==` match on a version and may not work well in combination with
1457-
constraints (see :issue:`9020`)
1465+
`==` match on a version and may not work well in combination with
1466+
constraints (see :issue:`9020` and :issue:`8792`)
14581467

14591468
* Unnamed requirements are not allowed as constraints (see :issue:`6628` and :issue:`8210`)
14601469
* Links are not allowed as constraints (see :issue:`8253`)

0 commit comments

Comments
 (0)