From 6b256aad82cee0558684c8dd1b0189f9e9140f1a Mon Sep 17 00:00:00 2001 From: Brad Warren Date: Fri, 16 Jul 2021 16:32:14 -0700 Subject: [PATCH] try and clarify poetry behavior --- tools/pinning/DESIGN.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/tools/pinning/DESIGN.md b/tools/pinning/DESIGN.md index e8b2664bb..9ed94564f 100644 --- a/tools/pinning/DESIGN.md +++ b/tools/pinning/DESIGN.md @@ -72,9 +72,10 @@ declare additional dependencies. The reason we use Poetry is that it is somewhat unique among Python packaging tools in that when locking dependencies, it makes a best effort approach to do this for all environments rather than just the current environment. This -includes scanning the dependencies for all wheels and sdists of the package and -recursively resolving dependencies declared through environment markers that -are not relevant for the current platform. You can see this in action through +includes recursively resolving dependencies declared through environment +markers that are not relevant for the current platform. It also includes +checking all wheels and sdists of a package for dependencies when picking a +specific version of a package from PyPI. You can see this in action through the inclusion of dependencies like pywin32 which we only have a dependency on for Windows.