Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Update venv docs. #11687

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 18, 2018
Merged

Update venv docs. #11687

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 13 additions & 16 deletions doc/faq/virtualenv_faq.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,13 @@ Otherwise, the situation (at the time of writing) is as follows:
framework bindings pip-installable? conda or conda-forge-installable?
========= ========= ================ =================================
Qt5 PyQt5 yes yes
Qt5 PySide2 yes [#]_ yes
Qt5 PySide2 yes yes
Qt4 PyQt4 no yes
Qt4 PySide OSX and Windows yes
GTK3 PyGObject yes [#]_ Linux and OSX
wxWidgets wxPython yes [#]_ yes
========= ========= ================ =================================

.. [#] See http://lists.qt-project.org/pipermail/pyside/2018-March/002537.html.

.. [#] No wheels available, see
https://pygobject.readthedocs.io/en/latest/devguide/dev_environ.html
for build instructions.
Expand All @@ -48,20 +46,19 @@ all cases, the system-wide Python and the venv Python must be of the same
version):

- `vext <https://pypi.python.org/pypi/vext>`_ allows controlled access
from within the virtualenv to specific system-wide packages without the
overall shadowing issue. A specific package needs to be installed for each
framework, e.g. `vext.pyqt5 <https://pypi.python.org/pypi/vext.pyqt5>`_, etc.
It is recommended to use ``vext>=0.7.0`` as earlier versions misconfigure the
logging system.
from within the venv to specific system-wide packages. A specific
package needs to be installed for each framework, e.g. `vext.pyqt5
<https://pypi.python.org/pypi/vext.pyqt5>`_, etc. It is recommended to use
``vext>=0.7.0`` as earlier versions misconfigure the logging system.

- When using `virtualenv <https://virtualenv.pypa.io/>` (rather than the
stdlib's ``venv``), using the ``--system-site-packages`` option when creating
an environment adds all system-wide packages to the virtual environment.
However, this breaks the isolation between the virtual environment and the
system install. Among other issues it results in hard to debug problems
with system packages shadowing the environment packages. If you use
`virtualenvwrapper <https://virtualenvwrapper.readthedocs.io/>`_, this can be
toggled with the ``toggleglobalsitepackages`` command.
- Using the ``--system-site-packages`` option when creating an environment
adds all system-wide packages to the virtual environment. However, this
breaks the isolation between the virtual environment and the system
install. Among other issues it results in hard to debug problems with
system packages shadowing the environment packages. If you use `virtualenv
<https://virtualenv.pypa.io/>` (rather than the stdlib's ``venv``) together
with `virtualenvwrapper <https://virtualenvwrapper.readthedocs.io/>`_, this
can be toggled with the ``toggleglobalsitepackages`` command.

If you are using Matplotlib on OSX, you may also want to consider the
:ref:`OSX framework FAQ <osxframework-faq>`.