From 7ee2a8b4944fc15afd8a6c40cc399974fe89f80e Mon Sep 17 00:00:00 2001 From: Peter Date: Mon, 26 Jun 2023 02:21:47 +1000 Subject: [PATCH] Add warning about pip ignoring lock files (#8117) --- docs/basic-usage.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/basic-usage.md b/docs/basic-usage.md index a22d5280f71..dd872f4a1c5 100644 --- a/docs/basic-usage.md +++ b/docs/basic-usage.md @@ -234,6 +234,10 @@ Even if you develop alone, in six months when reinstalling the project you can f the dependencies installed are still working even if your dependencies released many new versions since then. (See note below about using the update command.) +{{% warning %}} If you have added the recommended [`[build-system]`]({{< relref "pyproject#poetry-and-pep-517" >}}) section to your project's pyproject.toml then you _can_ successfully install your project and its dependencies into a virtual environment using a command like `pip install -e .`. However, pip will not use the lock file to determine dependency versions as the poetry-core build system is intended for library developers (see next section). +{{% /warning %}} + + #### As a library developer Library developers have more to consider. Your users are application developers, and your library will run in a Python environment you don't control.