Приложение A

Параметры командной строки интерпретатора и переменные окружения

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

python [options] [-c command file -] [arguments]

Где python - путь к исполняемому файлу интерпретатора (или просто имя, если каталог, в котором он находится, включен в пути поиска), options - опции, command - команда на языке Python, file - файл с программой на языке Python и arguments - список аргументов, передаваемых в sys.argv[1:].

Интерпретатор поддерживает следующие опции:

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

После выполнения программы перейти в интерактивный режим с выводом приглашения, даже если стандартный поток ввода интерпретатора не является терминалом. Этот режим может быть также включен с помощью переменной окружения PYTHONINSPECT (см. ниже).

Выполнять оптимизацию генерируемого байт-кода. Оптимизация может быть также включена с помощью переменной окружения PYTHONOPTIMIZE (см. ниже).

Помимо оптимизации (опция -o) удалить из байт-кода строки документации.

Не импортировать модуль site при инициализации.

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

426 Приложение A. Параметры командной строки интерпретатора

Генерировать исключение TabError при обнаружении непоследовательного использования символов табуляции в исходном коде.

Отключить буферизацию для стандартных потоков вывода и ошибок. Этот режим может быть также включен с помощью переменной окружения PYTHONUNBUFFERED (см. ниже). Отключение буферизации может быть необходимо для CGI-программ.

Считать все строковые литеральные выражения строками Unicode, то есть воспринимать как u.... Импортируемые модули, байт-код которых был получен без использования этой опции, будут откомпилированы заново. Возможность задания этой опции присутствует, начиная с версии 1.6.

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

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

UNIX.

Использовать строки вместо классов для стандартных исключений. Начиная с версии 1.6, эта опция не поддерживается.

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

Вывести номер версии интерпретатора и завершить выполнение. Возможность задания этой опции присутствует, начиная с версии 2.0.

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

PYTHONDEBUG

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

PYTHONINSPECT

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

PYTHONOPTIMIZE

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

PYTHONUNBUFFERED

Если эта переменная имеет непустое значение, буферизация стандартных потоков вывода и ошибок будет отключена. Отключение буферизации может быть необходимо для CGI-программ.

PYTHONVERBOSE

Если эта переменная имеет непустое значение, интерпретатор будет выводить отладочную информацию при импортировании модулей.

PYTHONSTARTUP

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

PYTHONPATH

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

PYTHONHOME

Устанавливает альтернативное значение sys.prefix и, возможно, sys.exec prefix. Значение переменной окружения должно иметь вид prefix[; exec prefix] (см. описание модуля sys).