Skip to content

Commit 97fb574

Browse files
committed
Explain resolver changes affecting constraints files
Related to pypa#8792, pypa#8076, pypa#9020.
1 parent 124b4a9 commit 97fb574

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

docs/html/user_guide.rst

+13-4
Original file line numberDiff line numberDiff line change
@@ -289,7 +289,10 @@ organisation and use that everywhere. If the thing being installed requires
289289
"helloworld" to be installed, your fixed version specified in your constraints
290290
file will be used.
291291

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

294297
.. _`Installing from Wheels`:
295298

@@ -1435,15 +1438,21 @@ install x y`` in a single command. We would like your thoughts on what
14351438
pip's behavior should be; please answer `our survey on upgrades that
14361439
create conflicts`_.
14371440

1438-
We are also changing our support for :ref:`Constraints Files` and related functionality:
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:
14391445

14401446
* Constraints don't override the existing requirements; they simply
14411447
constrain what versions are visible as input to the resolver (see
14421448
:issue:`9020`)
14431449

1450+
* Providing an editable requirement (``-e .``) does not cause pip to
1451+
ignore version specifiers or constraints (see :issue:`8076`)
1452+
14441453
* Hash-checking mode requires that all requirements are specified as a
1445-
`==` match on a version and may not work well in combination with
1446-
constraints (see :issue:`9020`)
1454+
`==` match on a version and may not work well in combination with
1455+
constraints (see :issue:`9020` and :issue:`8792`)
14471456

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

0 commit comments

Comments
 (0)