Как деактивировать виртуальное окружение в python

Виртуальные окружения — Python: Настройка окружения

Вы уже знаете, что pip устанавливает пакеты в одно из двух окружений — в общесистемное или пользовательское. Интерпретатор Python при импорте модуля или пакета ищет его сначала в пользовательском окружении, затем — в общесистемном. Такая последовательность позволяет пользователю иметь нужные именно ему версии библиотек и Python-программ.

Но даже двух окружений недостаточно, когда программист начинает работать с несколькими проектами, ведь разные проекты могут иметь разные наборы зависимостей. Еще более тяжелый случай: разные проекты могут зависеть от общей библиотеки, но требовать разные ее версии — тогда происходит конфликт версий.

Очевидно, что разработчику на Python нужен какой-то механизм, позволяющий содержать разные проекты в изолированных песочницах. Такой механизм существует. Он называется виртуальные окружения.

Устройство виртуальных окружений

Каждое виртуальное окружение представляет собой директорию. Ее содержимое структурно напоминает общесистемное окружение — поддиректории соответственно названы и наполнены. Давайте рассмотрим пример:

env env ├── bin │ ├── activate │ … │ ├── pip │ … │ └── python3 -> …/python3 ├── lib │ └── python3.6 │ └── site-packages │ ├── pip │ │ ├── … │ … │ └── setuptools-40.6.2.dist-info │ ├── … … 

В директории виртуального окружения находится директория bin/ , внутри которой расположены:

• Копия интерпретатора под именем python3 (символическая ссылка на оригинал)
• Копия исполняемого файла pip

В соседней директории по пути lib/python3.6/site-packages есть библиотеки, уже установленные в окружение. Как правило, только что созданное окружение имеет:

• Установленный пакет pip (исполняемый файл bin/pip — его точка входа)
• Пакет Setuptools

Эти два пакета составляют необходимый минимум для разработки проекта на Python.

При работе в окружении нужно запускать не системные Python и pip, а исполняемые файлы из директории bin . Когда интерпретатор Python находится в окружении, он знает, где находятся все доступные пакеты. Интерпретатор находит их по относительному пути ../lib/python3.6 . В таком случае копия pip из директории bin/ устанавливает пакеты в это же окружение, не затрагивая систему. Получается та самая изоляция, о которой мы говорили в начале урока.

Создание виртуального окружения

Вручную создавать всю описанную иерархию директорий и файлов не нужно — для этого есть специальный модуль venv .

В macOS и Windows этот модуль входит в поставку Python. На Ubuntu его нужно установить отдельно командой:

sudo apt install python3-venv 

Проверим, что модуль установился и готов к использованию:

-m venv --help usage: venv [-h] [--system-site-packages] [--symlinks | --copies] [--clear] [--upgrade] [--without-pip] [--prompt PROMPT] ENV_DIR [ENV_DIR . ] 

Обычно окружение создается командой python3 -m venv имя_окружения . Давайте попробуем создать виртуальное окружение и установить туда пакет cowsay :

Вы можете видеть, что пакет устанавливается вместе с точкой входа, которую можно вызвать командой first_venv/bin/cowsay . Также сам пакет становится доступен интерпретатору, но только тому, что был запущен из окружения.

В таком виде виртуальное окружение уже можно использовать полноценно. Но постоянно вводить команды с префиксом first_venv/bin/ не очень удобно. Есть способ упростить вызов команд, доступных в окружении — это активация.

Активация окружения

При создании окружения в поддиректорию bin помещается сценарий оболочки, который на macOS и Ubuntu называется activate , а на Windows — activate.bat . Чтобы выполнить этот сценарий, нужно вызвать команду:

• на macOS и Ubuntu:

source first_venv/bin/activate 

• на Windows:

\> first_venv\Scripts\activate.bat 

В команде выше обратите внимание, что в Windows поддиректория с исполняемыми файлами называется не bin , а Scripts .

На Ubuntu активация выглядит следующим образом:

После активации отпала необходимость указывать путь до вызываемого исполняемого файла. Теперь cowsay и python вызываются без префикса, но это все те же команды из окружения.

Еще изменилось приглашение оболочки: в нем стало отображаться имя окружения. Это работает на macOS и Ubuntu и всегда напоминает, что мы находимся в виртуальном окружении.

Деактивация окружения делается командой deactivate , которая становится доступна после активации.

Активация и деактивация окружения влияют только на текущую сессию — то есть заметны только в этом конкретном терминале. Это удобно, потому что так можно иметь несколько окружений и активировать их одновременно в разных окнах терминала.

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно

• 130 курсов, 2000+ часов теории
• 1000 практических заданий в браузере
• 360 000 студентов

Наши выпускники работают в компаниях:

Установка и использование virtualenv в Python

virtualenv — это инструмент для создания изолированной среды Python. У такой среды есть отдельна установка python, при ее использовании загруженные библиотеки недоступны другим. Можно сделать так, чтобы у этой среды не было доступа к глобальным библиотекам.

Virtualenv — простой и рекомендованный способ настройки среды Python.

Отличия virtualenv и venv

Venv — это пакет, который идет по умолчанию с Python 3.3+. В версии Python 2 его нет.

Virtualenv — более продвинутая библиотека. По ссылке можно ознакомиться с основными отличиями.

Виртуальную среду можно создать и с помощью venv, но все-таки рекомендуется установить и использовать virtualenv для полноценной работы.

Установка virtualenv с помощью pip

Для установки virtualenv с Python нужно использовать pip. Желательно предварительно обновить этот инструмент.

python -m pip install --upgrade pip

Или используйте python3 , если python ссылается на 2 версию.

После обновления можно установить и virtualenv:

pip install virtualenv # или pip3

Создание виртуальной среды

1. Перейдите в директорию, в которой вы хотите создать виртуальную среду(например папка проекта).

~$ cd test ~/test$

2. Создайте виртуальную среду, при необходимости указав конкретную версию Python. Следующая команда создает virtualenv с именем venv_name и использует флаг -p , чтобы указать полный путь к версии Python:

virtualenv -p /usr/bin/python venv_name # или virtualenv venv_name

Назвать среду можно как угодно

После выполнения команды вы увидите логи:

Running virtualenv with interpreter /usr/bin/python Already using interpreter /usr/bin/python Using base prefix '/usr' New python executable in /home/username/test/venv_name/bin/python Installing setuptools, pip, wheel. done.

Эта команда создает локальную копию среды. Работая с ней, важно не забывать об активации, чтобы использовались нужные версии конкретных инструментов и пакетов.

Если при установке возникла ошибка setuptools pip failed with error code 1` error , используйте следующую команду, чтобы решить проблему:

pip install --upgrade setuptools # или pip3

3. Для активации новой виртуальной среды используйте команду:

source venv_name/bin/activate

После этого название текущей среды отобразится слева от символа ввода: (venv_name) username@desctop:~/test$

Теперь при установке любого пакета с помощью pip он будет размещаться в папках этой среды, изолированно от глобальной установки.

Деактивации virtualenv

После завершения работы деактивировать виртуальную среду можно с помощью команды deactivate .

Введите ее и приставка venv_name пропадет. Вы вернетесь к использованию глобально версии python.

Удаление виртуальной среды

Для удаления виртуальной среды достаточно просто удалить папку проекта. Для этого используется следующая команда:

rm -rf venv_name

Решение популярных ошибок

Ошибки при создании virtualenv. При попытке создать virtualenv с Python 3.7 могут возникнуть следующие ошибки.

AttributeError: module 'importlib._bootstrap' has no attribute 'SourceFileLoader' OSError: Command /home/username/venv/bin/python3 -c "import sys, pip; sys. d\"] + sys.argv[1:]))" setuptools pip failed with error code 1

Для их исправления нужно добавить следующую строку в .bash_profile.

export LC_ALL="en_US.UTF-8"

Использование полного пути к виртуальной среде. Может быть такое, что при использовании команды virtualenv будет использована не та версия. Для решения проблемы нужно лишь задать полные пути как к virtualenv, так и к Python в системе.

А получить их можно с помощью этой команды:

/home/username/opt/python-3.8.0/bin/virtualenv -p /home/username/opt/python-3.8.0/bin/python3 venv

Python. Урок 17. Виртуальные окружения

Продолжаем серию “ Python .Уроки”. На этот раз мы изучим, что такое виртуальные окружения в Python , зачем они нужны и как их использовать. Познакомимся с инструментами virtualenv и venv для создания виртуальных окружений.

• Что такое виртуальное окружение и зачем оно нужно?
• ПО позволяющее создавать виртуальное окружение в Python
• virtualenv
  • Установка virtualenv
  • Создание виртуального окружения
  • Активация виртуального окружения
  • Деактивация виртуального окружения
  • Создание виртуального окружения
  • Активация виртуального окружения
  • Деактивация виртуального окружения

  Что такое виртуальное окружение и зачем оно нужно?

  При разработке Python- приложений или использовании решений на Python , созданных другими разработчиками, может возникнуть ряд проблем, связанных с использованием библиотек различных версий. Рассмотрим их более подробно.

  Во-первых : различные приложения могут использовать одну и туже библиотеку, но при этом требуемые версии могут отличаться.

  Во-вторых : может возникнуть необходимость в том, чтобы запретить вносить изменения в приложение на уровне библиотек, т.е. вы установили приложение и хотите, чтобы оно работало независимо от того обновляются у вас библиотеки или нет. Как вы понимаете, если оно будет использовать библиотеки из глобального хранилища ( /usr/lib/pythonXX/site-packages ), то, со временем, могут возникнуть проблемы.

  В-третьих : у вас просто может не быть доступа к каталогу /usr/lib/pythonXX/site-packages .

  Для решения данных вопросов используется подход, основанный на построении виртуальных окружений – своего рода песочниц, в рамках которых запускается приложение со своими библиотеками, обновление и изменение которых не затронет другие приложение, использующие те же библиотеки.

  ПО позволяющее создавать виртуальное окружение в Python

  Программное обеспечение, которое позволяет создавать виртуальные окружения в Python можно разделить на те, что входят в стандартную библиотеку Python и не входят в нее. Сделаем краткий обзор доступных инструментов (хороший пост на эту тем есть на stackoverflow ).

  Начнем с инструментов, которые входят в PyPI . Если кто не знает PyPI – это Python Package Index ( PyPI ) – репозиторий пакетов Python , доступный для любого разработчика и пользователя Python ( ).

  Это, наверное, одни из самых популярных инструментов, позволяющих создавать виртуальные окружения. Он прост в установке и использовании. В сети довольно много руководств по virtualenv , самые интересные, на наш взгляд, будут собраны в конце урока в разделе “Полезные ссылки”. В общем, этот инструмент нужно обязательно освоить, как минимум, потому что описание развертывания и использования многих систем, созданных с использованием Python , включает в себя процесс создания виртуального окружения с помощью virtualenv .

  Инструмент для изоляции версий Python . Чаще всего применяется, когда на одной машине вам нужно иметь несколько версий интерпретатора для тестирования на них разрабатываемого вами ПО.

  virtualenvwrapper

  Virtualenvwrapper – это обертка для virtualenv позволяющая хранить все изолированные окружения в одном месте, создавать их, копировать и удалять. Предоставляет удобный способ переключения между окружениями и возможность расширять функционал за счет plug-in ’ов.

  Существуют ещё инструменты и plug-in ’ы, выполняющие работу по изоляции частей системы Python , но мы их не будем рассматривать.

  Инструменты, входящие в стандартную библиотеку Python .

  Этот модуль появился в Python3 и не может быть использован для решения задачи изоляции в Python2 . По своему функционалу очень похож на virtualenv . Если вы работаете с третьим Python , то можете смело использовать данный инструмент.

  virtualenv

  Будем рассматривать работу с virtualenv в рамках операционной системы Linux . Для Windows все будет очень похоже, за исключением моментов, связанных со спецификой этой ОС: названия и расположение каталогов, запуск скриптов оболочки и т.п.

  Установка virtualenv

  Virtualenv можно установить с использованием менеджера pip (ссылка на статью), либо скачать исходные коды проекта и установить приложение вручную.

  Установка с использованием pip.

  Для установки virtualenv откройте консоль и введите следующую команду:

  > pip install virtualenv

  Установка из исходного кода проекта.

  В этом случае, вам нужно будет выполнить чуть большее количество действий.

  Введите в консоли следующий набор команд:

  > curl -O https://pypi.python.org/packages/source/v/virtualenv/virtualenv-X.X.tar.gz > tar xvfz virtualenv-X.X.tar.gz > cd virtualenv-X.X > [sudo] python setup.py install

  X.X – это версия приложения, ее вам нужно знать заранее.

  Если использовать ключевое слово sudo , инструмент будет установлен глобально, в противном случае – локально.

  Мы рекомендуем вам использовать pip для установки virtualenv .

  Создание виртуального окружения

  Виртуальное окружение создается следующей командой:

  > virtualenv PRG1

  PRG1 в данном случае – это имя окружения.

  После выполнения данной команды, в текущем каталоге будет создан новый каталог с именем PRG1 . Разберем более подробно его содержимое.

  RPG1/bin/ – содержит скрипты для активации/деактивации окружения, интерпретатор Python , используемый в рамках данного окружения, менеджер pip и ещё несколько инструментов, обеспечивающих работу с пакетами Python . В Windows, это каталог PRG1\Scripts

  PRG1/include/ и PRG1/lib/ – каталоги, содержащие библиотечные файлы окружения. Новые пакеты будут установлены в каталог PRG1/lib/pythonX.X/site-packages/ .

  Активация виртуального окружения

  Для активации виртуального окружения воспользуйтесь командой (для Linux ):

  > source PRG1/bin/activate

  для Windows команда будет выглядеть так:

  > PRG1\Scripts\activate.bat

  Команда source выполняет bash- скрипт без запуска второго bash- процесса.

  Если команда выполнилась успешно, то вы увидите, что перед приглашением в командной строке появилась дополнительная надпись, совпадающая с именем виртуального окружения.

  

  При этом в переменную окружения PATH , в самое начало, будет добавлен путь до директории bin , созданного каталога RPG1 .

  Если вы создадите виртуальное окружение с ключем –system-site-packages :

  > virtualenv --system-site-packages PRG1

  то в рамках окружения PRG1 вы будите иметь доступ к глобальному хранилищу пакетов:

  • • в Linux : /usr/lib/pythonX.X/site-packages
    • в Windows : \PythonXX\Lib\site-packages

    Деактивация виртуального окружения

    Для деактивации виртуального окружения (выхода из него), введите команду deactivate для Linux или deactivate.bat , если вы работаете в Windows .

    > deactivate

    

    venv

    Устанавливать venv не нужно, т.к. он входит в стандартную библиотеку Python . Т.е. если вы установили себе Python , то venv у вас уже есть. Помните, что venv работает только в Python3 !

    Создание виртуального окружения

    Для создания виртуального окружения с именем PRG2 с помощью venv выполните следующую команду:

    > python -m venv PRG2

    В результате будет создан каталог PRG2 со структурой похожей на ту, что была описана для virtualenv . Функциональное назначение каталогов тоже самое.

    Активация виртуального окружения

    Активация виртуального окружения в Linux выполняется командой:

    >source PRG2/bin/activate

    >PRG2\Scripts\activate.bat

    Деактивация виртуального окружения

    Деактивация выполняется командой deactivate (работает как в Windows, так и в Linux )

    >deactivate

    Полезные ссылки

    Ниже приведен список полезных ссылок, для того, чтобы более глубоко изучить тему создания виртуальных окружений в Python .

    P.S.

    Если вам интересна тема анализа данных, то мы рекомендуем ознакомиться с библиотекой Pandas. На нашем сайте вы можете найти вводные уроки по этой теме. Все уроки по библиотеке Pandas собраны в книге “Pandas. Работа с данными”.

    Виртуальное окружение Python (venv)

    Все сторонние пакеты устанавливаются менеджером PIP глобально. Проверить это можно просто командой pip show .

    root@purplegate:~# pip3 show pytest Name: pytest Version: 5.3.2 Summary: pytest: simple powerful testing with Python Home-page: https://docs.pytest.org/en/latest/ Author: Holger Krekel, Bruno Oliveira, Ronny Pfannschmidt, . License: MIT license Location: /usr/local/lib/python3.8/site-packages Requires: more-itertools, pluggy, py, wcwidth, attrs, packaging Required-by:

    Location — путь до ваших глобальных пакетов.

    В большинстве случаев, устанавливать пакеты глобально — плохая идея ��‍♂️ Почему? Рассмотрим простой пример:

    Допустим у нас есть два проекта: » Project A» и » Project B» . Оба проекта зависят от библиотеки Simplejson . Проблема возникает, когда для «Project A» нужна версия Simplejson 3.0.0, а для проекта «Project B» — 3.17.0. Python не может различить версии в глобальном каталоге site-packages — в нем останется только та версия пакета, которая была установлена последней.

    Решение данной проблемы — создание виртуального окружения (virtual environment).

    Основная цель виртуального окружения Python — создание изолированной среды для python-проектов

    Это означает, что каждый проект может иметь свои собственные зависимости, независимо от других проектов.

    Настройка виртуального окружения

    Один из самых популярных инструментов для создания виртуального окружения — virtualenv . Однако в данной статье мы будем рассматривать более свежий инструмент venv .

    Устанавливать venv не нужно — он входит в стандартную библиотеку Python

    Создание

    Для создания виртуального окружения, перейдите в директорию своего проекта и выполните:

    python -m venv venv

    -m — флаг для запуска venv как исполняемого модуля. venv — название виртуального окружения (где будут храниться ваши библиотеки).

    В результате будет создан каталог venv/ содержащий копию интерпретатора Python, стандартную библиотеку и другие вспомогательные файлы. Все новые пакеты будут устанавливаться в venv/lib/python3.x/site-packages/ .

    Виртуальное окружение также можно создать в IDE PyCharm, для этого:

    1. Зайдите в настройки интерпретатора (» Settings » → » Project: » → » Project Interpreter «);
    2. Нажмите на шестеренку в верхнем правом углу, выберите » Add.. «;
    3. Выберите » Virual Enviroment » и задайте параметры.

    Активация

    Чтобы начать пользоваться виртуальным окружением, необходимо его активировать:

    • venv\Scripts\activate.bat — для Windows;
    • source venv/bin/activate — для Linux и MacOS.

    source выполняет bash-скрипт без запуска дополнительного bash-процесса.

    Проверить успешность активации можно по приглашению оболочки. Она будет выглядеть так:

    Также новый путь до библиотек можно увидеть выполнив команду:

    python -c «import site; print(site.getsitepackages())»

    Если вы используете IDE PyCharm, то при открытии проекта он автоматически найдет созданное виртуальное окружение и уведомит о его использовании. Проверить настройки виртуального окружения можно в » Settings » → » Project: » → » Project Interpreter » (путь до интерпретатора должен быть вида [путь до проекта]/venv/Scripts/python.exe) .

    Интересный факт: в виртуальном окружении вместо команды python3 и pip3, можно использовать python и pip

    Автоматическая активация

    В некоторых случаях, процесс активации виртуального окружения может показаться неудобным (про него можно банально забыть ��‍♀️).

    На практике, для автоматической активации перед запуском скрипта, создают скрипт-обертку на bash :

    #!/usr/bin/env bash source $BASEDIR/venv/bin/activate python $BASEDIR/my_app.py

    Теперь можно установить права на исполнение и запустить нашу обертку:

    chmod +x myapp/run.sh ./myapp/run.sh

    Деактивация

    Закончив работу в виртуальной среде, вы можете отключить ее, выполнив консольную команду:

    Альтернативы venv

    На данный момент существует несколько альтернатив для venv:

    • pipenv — это pipfile, pip и virtualenv в одном флаконе;
    • pyenv — простой контроль версий Питона;
    • poetry — новый менеджер для управления зависимостями;
    • autoenv — среды на основе каталогов;
    • pew — инструмент для управления несколькими виртуальными средами, написанными на чистом Python;
    • rez — интегрированная система конфигурирования, сборки и развертывания пакетов для программного обеспечения.

    Стоит ли использовать виртуальное окружение в своей работе — однозначно да. Это мощный и удобный инструмент изоляции проектов друг от друга и от системы. С помощью виртуального окружения можно использовать даже разные версии Python!

    Однако рекомендуем присмотреться к более продвинутым вариантам, например к pipenv или poetry .

    Читать:

    Почему не активируется а1469 тв apple