From 5c8d061c29de17d37d7a7a8adf2506aa183fda47 Mon Sep 17 00:00:00 2001 From: Nick Coghlan Date: Thu, 28 Sep 2017 18:35:43 +1000 Subject: [PATCH 1/2] Issue #748: cover the --site-packages option Also mentions using `PIP_IGNORE_INSTALLED` to still install everything that's pip-installable into the virtual environment, even if a suitable version is already installed globally. --- docs/advanced.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/advanced.rst b/docs/advanced.rst index 39184518..7f82fb60 100644 --- a/docs/advanced.rst +++ b/docs/advanced.rst @@ -377,3 +377,21 @@ To enable completion in fish, add this to your config:: Magic shell completions are now enabled! ✨🍰✨ + +☤ Working with platform-provided Python components +-------------------------------------------------- + +It's reasonably common for platform specific Python bindings for +operating system interfaces to only be available through the system +package manager, and hence unavailable for installation into virtual +environments with `pip`. In these cases, the virtual environment can +be created with access to the system `site-packages` directory:: + + `$ pipenv --three --site-packages + +To ensure that all `pip`-installable components actually are installed +into the virtual environment and system pacakges are only used for +interfaces that don't participate in Python-level dependency resolution +at all, use the `PIP_IGNORE_INSTALLED` setting:: + + $ PIP_IGNORE_INSTALLED=1 pipenv install --dev From 62bfa1840569c70260765f30bfbc26612d6fee7f Mon Sep 17 00:00:00 2001 From: Nate Prewitt Date: Thu, 28 Sep 2017 03:52:45 -0700 Subject: [PATCH 2/2] minor doc fix --- docs/advanced.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/advanced.rst b/docs/advanced.rst index 7f82fb60..73fbd726 100644 --- a/docs/advanced.rst +++ b/docs/advanced.rst @@ -387,10 +387,10 @@ package manager, and hence unavailable for installation into virtual environments with `pip`. In these cases, the virtual environment can be created with access to the system `site-packages` directory:: - `$ pipenv --three --site-packages + $ pipenv --three --site-packages To ensure that all `pip`-installable components actually are installed -into the virtual environment and system pacakges are only used for +into the virtual environment and system packages are only used for interfaces that don't participate in Python-level dependency resolution at all, use the `PIP_IGNORE_INSTALLED` setting::