venv.md
1> **Источник:** https://python-all.ru/3.5/tutorial/venv.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 12. Виртуальные окружения и пакеты89## 12.1. Введение1011Приложения на Python часто используют пакеты и модули, не входящие в стандартную библиотеку. Иногда приложению требуется конкретная версия библиотеки, потому что оно может зависеть от исправления определённой ошибки или быть написано с использованием устаревшей версии интерфейса библиотеки.1213Это означает, что одна установка Python может не удовлетворять требованиям всех приложений. Если приложению A нужна версия 1.0 определённого модуля, а приложению B – версия 2.0, то требования противоречат друг другу, и установка либо версии 1.0, либо 2.0 оставит одно из приложений неработоспособным.1415Решение этой проблемы – создать [виртуальное окружение](https://python-all.ru/3.5/glossary.html#term-virtual-environment) (часто сокращённо «virtualenv»), отдельное дерево каталогов, которое содержит установку Python для конкретной версии Python, а также ряд дополнительных пакетов.1617Разные приложения могут использовать разные виртуальные окружения. Чтобы решить описанный ранее пример конфликтующих требований, приложение A может иметь собственное виртуальное окружение с установленной версией 1.0, в то время как приложение B – другое виртуальное окружение с версией 2.0. Если приложению B потребуется обновить библиотеку до версии 3.0, это не повлияет на окружение приложения A.1819## 12.2. Создание виртуальных окружений2021Сценарий, используемый для создания и управления виртуальными окружениями, называется **pyvenv**. Обычно **pyvenv** устанавливает самую последнюю из доступных версий Python; кроме того, сценарий устанавливается с номером версии, поэтому при наличии нескольких версий Python в системе можно выбрать конкретную версию, запустив `pyvenv-3.4` или любую другую.2223Чтобы создать виртуальное окружение, следует выбрать каталог, в который его поместить, и запустить **pyvenv**, указав путь к этому каталогу:2425```python26pyvenv tutorial-env27```2829Это создаст каталог `tutorial-env`, если его не существует, а также создаст внутри него каталоги, содержащие копию интерпретатора Python, стандартной библиотеки и различных вспомогательных файлов.3031После создания виртуального окружения его необходимо активировать.3233В Windows выполните:3435```python36tutorial-env/Scripts/activate37```3839В Unix или macOS выполните:4041```python42source tutorial-env/bin/activate43```4445(Этот скрипт написан для оболочки bash. Если вы используете оболочки **csh** или **fish**, существуют альтернативные скрипты `activate.csh` и `activate.fish`, которые следует использовать вместо него.)4647Активация виртуального окружения изменит приглашение оболочки, чтобы показать, какое виртуальное окружение используется, и изменит окружение так, что при запуске `python` будет задействована эта конкретная версия и установка Python. Например:4849```python50-> source ~/envs/tutorial-env/bin/activate51(tutorial-env) -> python52Python 3.4.3+ (3.4:c7b9645a6f35+, May 22 2015, 09:31:25)53 ...54>>> import sys55>>> sys.path56['', '/usr/local/lib/python34.zip', ...,57'~/envs/tutorial-env/lib/python3.4/site-packages']58>>>59```6061## 12.3. Управление пакетами с помощью pip6263После активации виртуального окружения можно устанавливать, обновлять и удалять пакеты с помощью программы **pip**. По умолчанию `pip` устанавливает пакеты из Python Package Index, \<[https://pypi.python.org/pypi](https://python-all.ru/3.5/tutorial/venv.html)\>. Python Package Index можно просмотреть, перейдя на него в веб-браузере, или воспользоваться ограниченной функцией поиска `pip`:6465```python66(tutorial-env) -> pip search astronomy67skyfield - Elegant astronomy for Python68gary - Galactic astronomy and gravitational dynamics.69novas - The United States Naval Observatory NOVAS astronomy library70astroobs - Provides astronomy ephemeris to plan telescope observations71PyAstronomy - A collection of astronomy related tools for Python.72...73```7475`pip` имеет ряд подкоманд: «search», «install», «uninstall», «freeze» и т.д. (Обратитесь к руководству [Установка модулей Python](https://python-all.ru/3.5/installing/index.html#installing-index) за полной документацией для `pip`.)7677Вы можете установить последнюю версию пакета, указав его имя:7879```python80-> pip install novas81Collecting novas82 Downloading novas-3.1.1.3.tar.gz (136kB)83Installing collected packages: novas84 Running setup.py install for novas85Successfully installed novas-3.1.1.386```8788Вы также можете установить конкретную версию пакета, указав имя пакета, затем `==` и номер версии:8990```python91-> pip install requests==2.6.092Collecting requests==2.6.093 Using cached requests-2.6.0-py2.py3-none-any.whl94Installing collected packages: requests95Successfully installed requests-2.6.096```9798Если вы повторно выполните эту команду, `pip` заметит, что запрошенная версия уже установлена, и ничего не сделает. Вы можете указать другой номер версии, чтобы получить её, или выполнить `pip install --upgrade` для обновления пакета до последней версии:99100```python101-> pip install --upgrade requests102Collecting requests103Installing collected packages: requests104 Found existing installation: requests 2.6.0105 Uninstalling requests-2.6.0:106 Successfully uninstalled requests-2.6.0107Successfully installed requests-2.7.0108```109110`pip uninstall`, за которым следует одно или несколько названий пакетов, удаляет пакеты из виртуального окружения.111112`pip show` отобразит информацию о конкретном пакете:113114```python115(tutorial-env) -> pip show requests116---117Metadata-Version: 2.0118Name: requests119Version: 2.7.0120Summary: Python HTTP for Humans.121Home-page: http://python-requests.org122Author: Kenneth Reitz123Author-email: me@kennethreitz.com124License: Apache 2.0125Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages126Requires:127```128129`pip list` отображает все пакеты, установленные в виртуальном окружении:130131```python132(tutorial-env) -> pip list133novas (3.1.1.3)134numpy (1.9.2)135pip (7.0.3)136requests (2.7.0)137setuptools (16.0)138```139140`pip freeze` создаст аналогичный список установленных пакетов, но вывод использует формат, который ожидает `pip install`. Общепринятая практика – помещать этот список в файл `requirements.txt`:141142```python143(tutorial-env) -> pip freeze > requirements.txt144(tutorial-env) -> cat requirements.txt145novas==3.1.1.3146numpy==1.9.2147requests==2.7.0148```149150Затем файл `requirements.txt` можно зафиксировать в системе контроля версий и распространять как часть приложения. Пользователи затем могут установить все необходимые пакеты с помощью `install -r`:151152```python153-> pip install -r requirements.txt154Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))155 ...156Collecting numpy==1.9.2 (from -r requirements.txt (line 2))157 ...158Collecting requests==2.7.0 (from -r requirements.txt (line 3))159 ...160Installing collected packages: novas, numpy, requests161 Running setup.py install for novas162Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0163```164165`pip` имеет множество других опций. Обратитесь к руководству [Установка модулей Python](https://python-all.ru/3.5/installing/index.html#installing-index) за полной документацией по `pip`. Когда вы написали пакет и хотите сделать его доступным в Python Package Index, обратитесь к руководству [Распространение модулей Python](https://python-all.ru/3.5/distributing/index.html#distributing-index).166