scripts.md
1> **Источник:** https://python-all.ru/3.3/using/scripts.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 5. Дополнительные инструменты и скрипты89## 5.1. pyvenv – Создание виртуальных окружений1011Создание [*виртуальных окружений*](https://python-all.ru/3.3/library/venv.html#venv-def) производится выполнением скрипта `pyvenv`:1213```python14pyvenv /path/to/new/virtual/environment15```1617Выполнение этой команды создает целевой каталог (создавая все родительские каталоги, которых еще нет) и помещает в него файл `pyvenv.cfg` с ключом `home`, указывающим на установку Python, из которой была запущена команда. Она также создает подкаталог `bin` (или `Scripts` в Windows), содержащий копию двоичного файла `python` (или нескольких файлов в случае Windows). Также создается (изначально пустой) подкаталог `lib/pythonX.Y/site-packages` (в Windows это `Lib\site-packages`).1819В Windows может потребоваться запускать скрипт `pyvenv` следующим образом, если не заданы соответствующие переменные PATH и PATHEXT:2021```text22c:\Temp>c:\Python33\python c:\Python33\Tools\Scripts\pyvenv.py myenv23```2425или, что то же самое:2627```text28c:\Temp>c:\Python33\python -m venv myenv29```3031Команда, запущенная с `-h`, покажет доступные параметры:3233```text34usage: pyvenv [-h] [--system-site-packages] [--symlinks] [--clear]35 [--upgrade] ENV_DIR [ENV_DIR ...]3637Creates virtual Python environments in one or more target directories.3839positional arguments:40 ENV_DIR A directory to create the environment in.4142optional arguments:43 -h, --help show this help message and exit44 --system-site-packages Give access to the global site-packages dir to the45 virtual environment.46 --symlinks Try to use symlinks rather than copies, when symlinks47 are not the default for the platform.48 --clear Delete the environment directory if it already exists.49 If not specified and the directory exists, an error is50 raised.51 --upgrade Upgrade the environment directory to use this version52 of Python, assuming Python has been upgraded in-place.53```5455Если целевой каталог уже существует, будет вызвано исключение, если только не указан параметр `--clear` или `--upgrade`.5657Созданный файл `pyvenv.cfg` также содержит ключ `include-system-site-packages`, установленный в `true`, если `venv` был запущен с параметром `--system-site-packages`, и в `false` в противном случае.5859Можно указать несколько путей для `pyvenv`; в этом случае идентичное виртуальное окружение будет создано в соответствии с заданными параметрами по каждому указанному пути.6061После создания venv его можно «активировать» с помощью скрипта в каталоге bin виртуального окружения. Вызов скрипта зависит от платформы: на платформе Posix обычно используется:6263```text64$ source <venv>/bin/activate65```6667тогда как в Windows обычно используется:6869```text70C:\> <venv>/Scripts/activate71```7273если используется оболочка `cmd.exe`, или:7475```text76PS C:\> <venv>/Scripts/Activate.ps177```7879если используется PowerShell.8081Строго говоря, *нет необходимости* активировать окружение; активация просто добавляет каталог с исполняемыми файлами venv в начало пути, так что «python» вызывает интерпретатор Python из venv, и можно запускать установленные скрипты без указания полного пути. Однако все скрипты, установленные в venv, должны быть работоспособны и без активации, и автоматически использовать Python из venv.8283Деактивировать venv можно, набрав «deactivate» в оболочке. Точный механизм зависит от платформы: например, скрипт активации Bash определяет функцию «deactivate», тогда как в Windows есть отдельные скрипты `deactivate.bat` и `Deactivate.ps1`, которые устанавливаются при создании venv.84