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

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

В Windows есть встроенный диалог для изменения переменных среды (следующее руководство применимо к классическому виду XP): щёлкните правой кнопкой мыши значок вашего компьютера (обычно находится на рабочем столе и называется «Мой компьютер») и выберите Свойства. Затем откройте вкладку Дополнительно и нажмите кнопку Переменные среды.

Кратко, ваш путь:

Мой компьютер ‣ Свойства ‣ Дополнительно ‣ Переменные среды

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

Ещё один способ добавить переменные в окружение – использовать команду set:

set PYTHONPATH=%PYTHONPATH%;C:\My_python_lib

Чтобы сделать эту настройку постоянной, можно добавить соответствующую команду в autoexec.bat. msconfig – это графический интерфейс к этому файлу.

Просмотреть переменные окружения можно и проще: командная строка автоматически раскрывает строки, заключённые в знаки процента:

echo %PATH%

Подробнее об этом поведении см. set /?.

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

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

На экране «Customize Python 3.3» можно включить опцию «Add python.exe to search path», чтобы установщик поместил вашу установку в %PATH%. Это позволит набирать python для запуска интерпретатора. Таким образом, вы также сможете выполнять сценарии с параметрами командной строки; см. документацию Командная строка.

Если вы не включили эту опцию при установке, всегда можно повторно запустить установщик и выбрать её.

Альтернатива – вручную изменить %PATH%, следуя указаниям в разделе Экскурс: Настройка переменных среды. Необходимо задать переменную окружения %PATH%, включив в неё каталог вашего дистрибутива Python, отделяя точкой с запятой от других записей. Пример переменной может выглядеть так (предполагая, что первые две записи – стандартные для Windows):

C:\WINDOWS\system32;C:\WINDOWS;C:\Python33

3.3.3. Поиск модулей¶Finding modules

Python обычно хранит свою библиотеку (и, соответственно, папку site-packages) в каталоге установки. Так, если вы установили Python в C:\Python\, библиотека по умолчанию будет находиться в C:\Python\Lib\, а сторонние модули должны храниться в C:\Python\Lib\site-packages\.

Вот как формируется sys.path в Windows:

• В начале добавляется пустая запись, соответствующая текущей директории.
• Если существует переменная окружения PYTHONPATH, как описано в Переменные среды, её записи добавляются следующими. Обратите внимание: в Windows пути в этой переменной должны разделяться точкой с запятой, чтобы отличать их от двоеточия, используемого в идентификаторах дисков (C:\ и т.д.).
• Дополнительные «пути приложений» можно добавить в реестр как подразделы \SOFTWARE\Python\PythonCore\version\PythonPath как в ветке HKEY_CURRENT_USER, так и HKEY_LOCAL_MACHINE. Подразделы, значением которых по умолчанию являются строки путей, разделённые точкой с запятой, приведут к добавлению каждого пути в sys.path. (Обратите внимание, что все известные установщики используют только HKLM, поэтому HKCU обычно пуста.)
• Если задана переменная окружения PYTHONHOME, она считается «домашним каталогом Python». В противном случае путь к основному исполняемому файлу Python используется для поиска «опознавательного файла» (Lib\os.py), чтобы определить «домашний каталог Python». Если домашний каталог найден, соответствующие подкаталоги добавляются в sys.path (Lib, plat-win и т.д.) на основе этой папки. В противном случае основной путь Python строится из PythonPath, хранящегося в реестре.
• Если не удаётся найти домашний каталог Python, не указана PYTHONPATH в окружении и не найдены записи в реестре, используется путь по умолчанию с относительными записями (например, .\Lib;.\plat-win и т.д.).

Конечный результат всего этого:

• При запуске python.exe или любого другого .exe в главном каталоге Python (установленной версии или непосредственно из каталога PCbuild) основной путь определяется, а основные пути в реестре игнорируются. Другие «пути приложений» в реестре всегда считываются.
• Когда Python размещается в другом .exe (другая директория, встраивание через COM и т.д.), «домашний каталог Python» не определяется, поэтому используется основной путь из реестра. Другие «пути приложений» в реестре всегда считываются.
• Если Python не может найти свой домашний каталог и нет реестра (например, замороженный .exe, какая-то очень странная установка), вы получаете путь с некоторыми путями по умолчанию, но относительными.

3.3.4. Выполнение скриптов¶Executing scripts

Начиная с Python 3.3, в состав Python входит программа-загрузчик, которая упрощает запуск скриптов Python. Дополнительную информацию см. в разделе Python Launcher for Windows.

3.3.5. Запуск скриптов без программы-загрузчика Python¶Executing scripts without the Python launcher

Если программа-загрузчик Python не установлена, скрипты Python (файлы с расширением .py) по умолчанию выполняются с помощью python.exe. Этот исполняемый файл открывает окно терминала, которое остаётся открытым, даже если программа использует графический интерфейс. Если этого не требуется, используйте расширение .pyw, которое приведёт к выполнению скрипта с помощью pythonw.exe по умолчанию (оба исполняемых файла находятся в корневом каталоге установки Python). Это подавляет появление окна терминала при запуске.

Можно также настроить выполнение всех скриптов .py с помощью pythonw.exe, используя стандартные средства, например (может потребоваться права администратора):

1. Откройте командную строку.

2. Свяжите правильную группу файлов со скриптами .py:

   assoc .py=Python.File
   

3. Перенаправьте все файлы Python на новый исполняемый файл:

   ftype Python.File=C:\Path\to\pythonw.exe "%1" %*
   

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

py

py -2.6

py -3

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

py hello.py

#! python3

3.4.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.

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

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

#! /usr/bin/python -v

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

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

[defaults]
python=3.1

[defaults]
python=3
python3=3.1

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

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

3.5.1. PyWin32¶

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

• Компонентная объектная модель (COM)
• Вызовы Win32 API
• Реестр
• Журнал событий
• Microsoft Foundation Classes (MFC) пользовательские интерфейсы

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

3.5.2. cx_Freeze¶

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

3.5.3. WConio¶

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

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