mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Can Ibanoglu
47 lines
2.0 KiB
ReStructuredText
47 lines
2.0 KiB
ReStructuredText
.. _pip-virtualenv:
|
|
|
|
Further Configuration of Pip and Virtualenv
|
|
-------------------------------------------
|
|
|
|
By now it should be clear that using virtual envirtonments is a great way to keep
|
|
your development environment clean and keeping different projects' requirements
|
|
separate.
|
|
|
|
When you start working on many different projects, it can be hard to remember to
|
|
activate the related virtual environment when you come back to a specific project.
|
|
As a result of this, it is very easy to install packages globally while thinking
|
|
that you are actually installing the package for the virtual environment of the
|
|
project. Over time this can result in a messy global package list.
|
|
|
|
In order to make sure that you install packages to your active virtual environment
|
|
when you use ``pip install``, consider adding the following two lines to your
|
|
``~/.bashrc`` file:
|
|
|
|
.. code-block:: console
|
|
export PIP_REQUIRE_VIRTUALENV=true
|
|
|
|
After saving this change and sourcing the ``~/.bashrc`` file with ``source ~/.bashrc``,
|
|
pip will no longer let you install packages if you are not in a virtual environment.
|
|
If you try to use ``pip install`` outside of a virtual environment pip will gently
|
|
remind you that an activated virtual environment is needed to install packages.
|
|
|
|
.. code-block:: console
|
|
$ pip install requests
|
|
Could not find an activated virtualenv (required).
|
|
|
|
You will of course need to install some packages globally (usually ones that you
|
|
use across different projects consistenly) and this can be accomplished by adding
|
|
the following to your ``~/.bashrc`` file:
|
|
|
|
.. code-block:: console
|
|
gpip() {
|
|
PIP_REQUIRE_VIRTUALENV="" pip "$@"
|
|
}
|
|
|
|
After saving the changes and sourcing your ``~/.bashrc`` file you can now install
|
|
packages globally by running ``gpip install``. You can change the name of the
|
|
function to anything you like, just keep in mind that you will have to use that
|
|
name when trying to install packages globally with pip.
|
|
|
|
-----------------------------------------------------------
|