3. Использование Python в Windows¶Using Python on Windows

3.1.1. Шаги установки¶Installation steps

Для загрузки доступны четыре установщика Python 3.7 – по два для 32-разрядной и 64-разрядной версий интерпретатора. Веб-установщик – это небольшой первоначальный загрузчик, который при необходимости автоматически загружает требуемые компоненты. Автономный установщик включает компоненты, необходимые для стандартной установки, и требует подключения к интернету только для дополнительных возможностей. Другие способы избежать загрузки во время установки см. в Установка без загрузки.

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

Если вы выберете «Установить сейчас»:

• Вам не потребуются права администратора (если только не требуется системное обновление библиотеки времени выполнения C или вы не устанавливаете Запускатель Python для Windows для всех пользователей).

• Python будет установлен в ваш пользовательский каталог

• Запускатель Python для Windows будет установлен в соответствии с опцией в нижней части первой страницы.

• Стандартная библиотека, тестовый набор, средство запуска и pip будут установлены

• Если выбрано, каталог установки будет добавлен в ваши PATH

• Ярлыки будут видны только текущему пользователю

Выбор «Настраиваемая установка» позволит выбрать компоненты для установки, расположение установки и другие параметры или действия после установки. Чтобы установить отладочные символы или двоичные файлы, нужно использовать этот вариант.

Для установки для всех пользователей следует выбрать «Настраиваемая установка». В этом случае:

• Может потребоваться предоставить учетные данные администратора или одобрение

• Python будет установлен в каталог Program Files

• Запускатель Python для Windows будет установлен в каталог Windows.

• Дополнительные компоненты можно выбрать во время установки

• Стандартная библиотека может быть предварительно скомпилирована в байт-код

• Если выбрано, каталог установки будет добавлен в системные PATH

• Ярлыки доступны для всех пользователей

3.1.2. Удаление ограничения MAX_PATH¶Removing the MAX_PATH Limitation

Исторически сложилось так, что в Windows длина пути была ограничена 260 символами. Это означало, что пути длиннее этого значения не распознавались и приводили к ошибкам.

В последних версиях Windows это ограничение можно увеличить примерно до 32 000 символов. Администратору необходимо активировать групповую политику «Включить длинные пути Win32» или установить значение реестра HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem@LongPathsEnabled равным 1.

Это позволяет функции open(), модулю os и большинству других функций работы с путями принимать и возвращать пути длиннее 260 символов.

После изменения указанного параметра никаких дополнительных настроек не требуется.

3.1.3. Установка без интерфейса¶Installing Without UI

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

Чтобы полностью скрыть интерфейс установщика и установить Python в тихом режиме, укажите параметр /quiet. Чтобы пропустить взаимодействие с пользователем, но при этом отображать ход выполнения и ошибки, укажите параметр /passive. Параметр /uninstall можно указать для немедленного начала удаления Python – приглашение отображаться не будет.

Все остальные параметры передаются в виде name=value, где значение обычно 0 для отключения функции, 1 для включения функции или путь. Полный список доступных параметров приведён ниже.

Например, для автоматической установки Python по умолчанию в общесистемном режиме можно использовать следующую команду (из командной строки с правами администратора):

python-3.7.0.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0

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

python-3.7.0.exe InstallAllUsers=0 Include_launcher=0 Include_test=0
    SimpleInstall=1 SimpleInstallDescription="Just for me, no test suite."

(Обратите внимание: отказ от лаунчера также отключает ассоциации файлов, и это рекомендуется только для установок для одного пользователя при наличии общесистемной установки, включающей лаунчер.)

Перечисленные выше параметры также можно указать в файле с именем unattend.xml, расположенном рядом с исполняемым файлом. Этот файл задаёт список параметров и значений. Если значение указано как атрибут, оно будет преобразовано в число, если это возможно. Значения, указанные как текст элемента, всегда остаются строками. В этом примере файл задаёт те же параметры, что и в предыдущем примере:

<Options>
    <Option Name="InstallAllUsers" Value="no" />
    <Option Name="Include_launcher" Value="0" />
    <Option Name="Include_test" Value="no" />
    <Option Name="SimpleInstall" Value="yes" />
    <Option Name="SimpleInstallDescription">Just for me, no test suite</Option>
</Options>

3.1.4. Установка без загрузки¶Installing Without Downloading

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

Выполните следующую команду в командной строке, чтобы загрузить все возможные необходимые файлы. Не забудьте заменить python-3.7.0.exe на фактическое имя вашего установщика и создавать сборки в отдельных каталогах, чтобы избежать конфликтов между файлами с одинаковыми именами.

python-3.7.0.exe /layout [optional target directory]

Также можно указать параметр /quiet, чтобы скрыть индикатор выполнения.

3.1.5. Изменение установки¶Modifying an install

После установки Python можно добавлять или удалять компоненты через средство «Программы и компоненты», входящее в состав Windows. Выберите запись Python и выберите «Удаление/Изменение», чтобы открыть установщик в режиме обслуживания.

«Изменить» позволяет добавлять или удалять компоненты, изменяя флажки – неизменённые флажки ничего не устанавливают и не удаляют. Некоторые параметры нельзя изменить в этом режиме, например, каталог установки; чтобы изменить их, потребуется полностью удалить и затем переустановить Python.

«Восстановить» проверяет все файлы, которые должны быть установлены в соответствии с текущими настройками, и заменяет те, которые были удалены или изменены.

«Удаление» полностью удалит Python, за исключением средства запуска Python для Windows, которое имеет собственную запись в разделе «Программы и компоненты».

3.2.1. Известные проблемы¶Known Issues

В настоящее время программа запуска py.exe не может использоваться для запуска Python, если он установлен из Microsoft Store.

Из-за ограничений приложений Microsoft Store скрипты Python могут не иметь полного доступа на запись к общим расположениям, таким как TEMP и реестр. Вместо этого запись будет выполняться в личную копию. Если вашим скриптам необходимо изменять общие расположения, потребуется установить полный установщик.

3.4.1. Приложение Python¶Python Application

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

Использование специализированного исполняемого файла в качестве загрузчика требует некоторого программирования, но обеспечивает наиболее прозрачный интерфейс для пользователей. При использовании настраиваемого загрузчика нет явных признаков того, что программа работает на Python: значки можно настраивать, можно указать информацию о компании и версии, а ассоциации файлов работают правильно. В большинстве случаев настраиваемый загрузчик должен просто вызывать Py_Main с жестко заданной командной строкой.

Более простой подход – предоставить пакетный файл или созданный ярлык, который напрямую вызывает python.exe или pythonw.exe с необходимыми аргументами командной строки. В этом случае приложение будет отображаться как Python, а не под своим реальным именем, и у пользователей могут возникнуть трудности с его отличием от других запущенных процессов Python или ассоциаций файлов.

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

3.4.2. Встраивание Python¶Embedding Python

Приложения, написанные на нативном коде, часто требуют какую-либо форму языка сценариев, и для этой цели может быть использовано встраиваемое распространение Python. В общем случае большая часть приложения написана на нативном коде, и некоторая часть будет либо вызывать python.exe, либо напрямую использовать python3.dll. В любом случае, извлечение встраиваемого распространения в подкаталог установки приложения достаточно для обеспечения загружаемого интерпретатора Python.

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

3.6.1. Отступление: установка переменных окружения¶Excursus: Setting environment variables

Windows позволяет настраивать переменные окружения постоянно как на уровне пользователя, так и на уровне системы, или временно в командной строке.

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

C:\>set PATH=C:\Program Files\Python 3.7;%PATH%
C:\>set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib
C:\>python

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

Заключение имени переменной в знаки процента приведёт к подстановке существующего значения, что позволяет добавить новое значение как в начало, так и в конец. Изменение PATH путём добавления каталога, содержащего python.exe, в начало является распространённым способом обеспечить запуск нужной версии Python.

Чтобы постоянно изменить переменные окружения по умолчанию, нажмите Пуск и найдите «изменение переменных среды» или откройте свойства системы, Дополнительные параметры системы и нажмите кнопку Переменные среды. В этом диалоге вы можете добавить или изменить переменные пользователя и системы. Для изменения системных переменных требуется неограниченный доступ к компьютеру (то есть права администратора).

3.6.2. Поиск исполняемого файла Python¶Finding the Python executable

Помимо использования автоматически созданного пункта меню «Пуск» для интерпретатора Python, вы можете запускать Python из командной строки. В установщике есть опция, которая настроит это для вас.

На первой странице установщика можно выбрать опцию «Add Python to PATH», чтобы установщик добавил путь установки в переменную PATH. Также добавляется расположение папки Scripts\. Это позволяет вводить python для запуска интерпретатора и pip для работы с пакетным менеджером. Таким образом, вы также можете выполнять свои скрипты с параметрами командной строки – см. документацию Command line.

Если вы не включили эту опцию при установке, вы всегда можете повторно запустить установщик, выбрать «Modify» и включить её. Или же вы можете вручную изменить переменные PATH, следуя инструкциям в разделе Excursus: Setting environment variables. Вам нужно добавить каталог вашей установки Python в переменную среды PATH, разделив его точкой с запятой от других записей. Пример переменной может выглядеть так (предполагая, что первые две записи уже существовали):

C:\WINDOWS\system32;C:\WINDOWS;C:\Program Files\Python 3.7

3.8.1. Начало работы¶Getting started

py

py -2.7

py -2

'py' is not recognized as an internal or external command,
operable program or batch file.

#! python
import sys
sys.stdout.write("hello from Python %s\n" % (sys.version,))

py hello.py

#! python3

3.8.2. Shebang-строки¶Shebang Lines

Если первая строка файла сценария начинается с #!, она называется «shebang»-строкой. Linux и другие Unix-подобные операционные системы имеют встроенную поддержку таких строк, и они обычно используются в этих системах для указания того, как следует выполнять сценарий. Данный загрузчик позволяет использовать те же возможности для сценариев Python в Windows, и примеры выше демонстрируют их применение.

Чтобы обеспечить переносимость shebang-строк в сценариях Python между Unix и Windows, этот загрузчик поддерживает ряд «виртуальных» команд для указания того, какой интерпретатор использовать. Поддерживаемые виртуальные команды:

• /usr/bin/env python

• /usr/bin/python

• /usr/local/bin/python

• python

Например, если первая строка вашего сценария начинается с

#! /usr/bin/python

Будет найдена и использована версия Python по умолчанию. Поскольку многие сценарии Python, написанные для работы в Unix, уже содержат эту строку, такие сценарии могут использоваться программой запуска без изменений. Если вы пишете новый сценарий в Windows, который, как вы надеетесь, будет полезен в Unix, следует использовать одну из строк shebang, начинающуюся с /usr.

Любую из перечисленных виртуальных команд можно дополнить явной версией (только старшая или старшая и младшая версия). Кроме того, можно запросить 32-разрядную версию, добавив «-32» после младшей версии. Например, /usr/bin/python2.7-32 запросит использование 32-разрядного Python 2.7.

Форма /usr/bin/env шебанг-строки обладает одним дополнительным свойством. Прежде чем искать установленные интерпретаторы Python, эта форма выполняет поиск исполняемого файла Python в PATH. Это соответствует поведению программы env в Unix, которая выполняет поиск PATH.

3.8.3. Аргументы в shebang-строках¶Arguments in shebang lines

Shebang-строки также могут указывать дополнительные параметры, передаваемые интерпретатору Python. Например, если у вас есть shebang-строка:

#! /usr/bin/python -v

Тогда Python будет запущен с опцией -v

3.8.4. Настройка¶Customization

[defaults]
python=3.1

[defaults]
python=3
python3=3.1

3.8.5. Диагностика¶Diagnostics

Если установлена переменная окружения PYLAUNCH_DEBUG (с любым значением), средство запуска выводит диагностическую информацию в stderr (т.е. на консоль). Эта информация одновременно является многословной и краткой, но она позволяет увидеть, какие версии Python были найдены, почему выбрана конкретная версия и точная командная строка, использованная для запуска целевого Python.

3.10.1. PyWin32¶

Модуль PyWin32 от Марка Хаммонда – это набор модулей для расширенной поддержки Windows. Он включает утилиты для:

• Component Object Model (COM)

• Вызовы Win32 API

• Реестр

• Журнал событий

• Microsoft Foundation Classes (MFC) пользовательские интерфейсы

PythonWin – это пример MFC-приложения, поставляемого с PyWin32. Это встраиваемая среда разработки со встроенным отладчиком.

3.10.2. cx_Freeze¶

cx_Freeze – это расширение distutils (см. Расширение Distutils), которое упаковывает скрипты Python в исполняемые программы Windows (файлы *.exe). Когда это сделано, вы можете распространять своё приложение, не требуя от пользователей установки Python.

3.10.3. WConio¶

Поскольку расширенный уровень работы с терминалом Python, curses, ограничен Unix-подобными системами, существует библиотека, эксклюзивная для Windows: Windows Console I/O for Python.

WConio – это обёртка для CONIO.H от Turbo-C, используемая для создания текстовых пользовательских интерфейсов.