python - интерпретируемый, интерактивный, объектно-ориентированный язык программирования
СИНТАКСИС
python [ -B ] [ -b ] [ -d ] [ -E ] [ -h ] [ -i ] [ -I ]
[ -m module-name ] [ -q ] [ -R ] [ -O ] [ -OO ] [ -P ] [ -s ] [ -S ] [ -u ]
[ -v ] [ -V ] [ -W argument ] [ -x ] [ -X option ] [ -? ]
[ --check-hash-based-pycs default | always | never ]
[ --help ] [ --help-env ] [ --help-xoptions ] [ --help-all ]
[ -c command | script | - ] [ arguments ]
ОПИСАНИЕ
Python — это интерпретируемый, интерактивный, объектно-ориентированный язык программирования, сочетающий в себе замечательную мощность и очень понятный синтаксис. Для ознакомления с программированием на Python см. учебник по Python. В справочнике по библиотеке Python документированы встроенные и стандартные типы, константы, функции и модули. Наконец, в справочнике по Python описывается синтаксис и семантика основного языка (возможно, слишком) подробно. (Эти документы можно найти в ИНТЕРНЕТ-РЕСУРСАХ ниже; они также могут быть установлены в вашей системе).
Базовые возможности Python можно расширить с помощью собственных модулей, написанных на C или C++. В большинстве систем такие модули можно динамически загружать. Python также можно адаптировать в качестве расширяющего языка для существующих приложений. См. внутреннюю документацию для получения дополнительных сведений.
Документацию для установленных модулей и пакетов Python можно просмотреть, запустив программу pydoc.
ПАРАМЕТРЫ КОМАНДНОЙ СТРОКИ
-B Не записывать файлы .pyc при импорте. См. также PYTHONDONTWRITEBYTECODE.
-b Выводить предупреждения о str(bytes_instance), str(bytearray_instance) и сравнении bytes/bytearray со str. (-bb: выдавать ошибки).
-c command
Указывает команду для выполнения (см. следующий раздел). Это завершает список параметров (последующие параметры передаются в качестве аргументов команде).
--check-hash-based-pycs mode
Настройка того, как Python оценивает актуальность файлов .pyc на основе хеша.
-d Включить отладочный вывод парсера (только для экспертов, в зависимости от параметров компиляции).
-E Игнорировать переменные среды, такие как PYTHONPATH и PYTHONHOME, которые изменяют поведение интерпретатора.
-h , -? , --help
Выводит использование для исполняемого файла интерпретатора и завершает работу.
--help-env
Выводит справку о переменных среды, специфичных для Python, и завершает работу.
--help-xoptions
Выводит справку о параметрах -X, специфичных для реализации, и завершает работу.
--help-all
Выводит полную информацию об использовании и завершает работу.
-i При передаче скрипта в качестве первого аргумента или при использовании параметра -c, после выполнения скрипта или команды переходит в интерактивный режим. Он не читает файл $PYTHONSTARTUP. Это может быть полезно для проверки глобальных переменных или трассировки стека, когда скрипт вызывает исключение.
-I Запускает Python в изолированном режиме. Это также подразумевает -E, -P и -s. В изолированном режиме sys.path не содержит ни директорию скрипта, ни директорию пользовательских пакетов. Все переменные окружения PYTHON* также игнорируются. Кроме того, могут быть введены дополнительные ограничения для предотвращения внедрения пользователем вредоносного кода.
-m имя_модуля
Ищет в sys.path указанный модуль и запускает соответствующий .py файл как скрипт. Это прекращает список опций (последующие опции передаются в качестве аргументов модулю).
-O Удаляет операторы assert и любой код, зависящий от значения __debug__; добавляет к имени файла для скомпилированных (байтовых) файлов расширение .opt-1 перед расширением .pyc.
-OO Выполняет -O и также удаляет строки документации; изменяет имя файла для скомпилированных (байтовых) файлов, добавляя расширение .opt-2 перед расширением .pyc.
-P Не добавляет автоматически в sys.path потенциально небезопасный путь, такой как текущий каталог, каталог скрипта или пустую строку. См. также переменную окружения PYTHONSAFEPATH.
-q Не выводит сообщения о версии и авторских правах. Эти сообщения также подавляются в неинтерактивном режиме.
-R Включает рандомизацию хешей. Эта опция имеет эффект только в том случае, если переменная окружения PYTHONHASHSEED установлена в 0, поскольку рандомизация хешей включена по умолчанию.
-s Не добавляет пользовательский каталог сайтов в sys.path.
-S Отключает импорт модуля site и манипуляции с sys.path, зависящие от сайта, которые он выполняет. Также отключает эти манипуляции, если site явно импортируется позже.
-u Принудительно включает небуферизованные потоки stdout и stderr. Эта опция не влияет на поток stdin.
-v Выводит сообщение каждый раз, когда модуль инициализируется, показывая место (имя файла или встроенный модуль), из которого он загружается. При указании дважды выводит сообщение для каждого файла, который проверяется при поиске модуля. Также предоставляет информацию об очистке модуля при выходе.
-V , --version
Выводит номер версии Python для исполняемого файла и завершает работу. При указании дважды выводит дополнительную информацию о сборке.
-W аргумент
Управление предупреждениями. По умолчанию механизм предупреждений Python выводит сообщения о предупреждениях в sys.stderr.
Простейшие настройки применяют определенное действие безусловно ко всем предупреждениям, выдаваемым процессом (даже к тем, которые в противном случае игнорируются по умолчанию):
-Wdefault # Предупреждает один раз для каждого места вызова
-Werror # Преобразует в исключения
-Walways # Предупреждает каждый раз
-Wall # То же, что и -Walways
-Wmodule # Предупреждает один раз для вызывающего модуля
-Wonce # Предупреждает один раз для процесса Python
-Wignore # Никогда не предупреждает
Имена действий можно сокращать по желанию, и интерпретатор разрешит их в соответствующее имя действия. Например, -Wi то же самое, что и -Wignore.
Полная форма аргумента: действие:сообщение:категория:модуль:номер_строки
Пустые поля соответствуют всем значениям; завершающие пустые поля могут быть опущены. Например, -W ignore::DeprecationWarning игнорирует все предупреждения типа DeprecationWarning.
Поле «действие» имеет значение, указанное выше, но применяется только к предупреждениям, которые соответствуют остальным полям.
Поле «сообщение» должно точно соответствовать всему тексту выводимого предупреждения; соответствие не учитывает регистр.
Поле «категория» соответствует категории предупреждения (например, «DeprecationWarning»). Это должно быть имя класса; проверка соответствия определяет, является ли фактическая категория предупреждения подклассом указанной категории предупреждения.
Поле «модуль» соответствует (полностью определенному) имени модуля; соответствие учитывает регистр.
Поле «номер_строки» соответствует номеру строки, где 0 соответствует всем номерам строк и, следовательно, эквивалентно опущенному номеру строки.
Можно указать несколько опций -W; если предупреждение соответствует более чем одной опции, применяется действие последней совпадающей опции. Неверные опции -W игнорируются (однако, сообщение о неверных опциях выводится при появлении первого предупреждения).
Предупреждения также можно контролировать с помощью переменной среды PYTHONWARNINGS и из программы Python с помощью модуля warnings. Например, функцию warnings.filterwarnings() можно использовать для применения регулярного выражения к сообщению о предупреждении.
^ X опция
Устанавливает специфичную для реализации опцию. Доступны следующие опции:
^ X cpu_count=N: переопределяет возвращаемое значение os.cpu_count();
^ X cpu_count=default: отменяет переопределение; также PYTHON_CPU_COUNT
^ X dev: включает «режим разработки» CPython, вводя дополнительные проверки во время выполнения, которые слишком дороги для включения по умолчанию. Если код правильный, она не будет более многословной, чем по умолчанию: новые предупреждения выдаются только при обнаружении проблемы. Эффект режима разработчика:
* Добавляет фильтр предупреждений по умолчанию, как в -W default.
* Устанавливает отладочные хуки для выделения памяти: см. функцию C PyMem_SetupDebugHooks().
* Включает модуль faulthandler для вывода трассировки Python при сбое.
* Включает режим отладки asyncio.
* Устанавливает атрибут dev_mode в sys.flags в значение True.
* Деструктор io.IOBase записывает исключения, возникающие при вызове close().
^ X importtime: показывает, сколько времени занимает каждый импорт. Он показывает имя модуля, общее время (включая вложенные импорты) и собственное время (исключая вложенные импорты). Обратите внимание, что его вывод может быть некорректным в многопоточном приложении. Типичное использование:
^ ython3 -X importtime -c 'import asyncio'
^ X faulthandler: включает faulthandler.
^ X frozen_modules=[on|off]: определяет, следует ли использовать замороженные модули.
По умолчанию on (или off, если вы запускаете локальную сборку).
^ X gil=[0|1]: включает (1) или отключает (0) GIL; также PYTHON_GIL.
Доступно только в сборках, сконфигурированных с помощью --disable-gil.
^ X int_max_str_digits=number: ограничивает размер преобразований int<->str.
Это помогает предотвратить атаки типа «отказ в обслуживании» при анализе ненадежных данных. Значение по умолчанию — sys.int_info.default_max_str_digits. 0 отключает ограничение.
-X no_debug_ranges: отключает включение таблиц, сопоставляющих дополнительную
информацию о местоположении (номер конечной строки, смещение начальной колонки и смещение конечной колонки) для каждой инструкции в объектах кода. Это полезно, когда требуются более компактные объекты кода и файлы .pyc, а также для подавления дополнительных визуальных индикаторов местоположения при отображении трассировок отладчиком.
-X perf: поддержка Linux-профайлера «perf»; также PYTHONPERFSUPPORT=1
-X perf_jit: поддержка Linux-профайлера «perf» с поддержкой DWARF;
также PYTHON_PERF_JIT_SUPPORT=1
-X presite=MOD: импортирует этот модуль перед импортом site; также PYTHON_PRESITE
Это работает только в отладочных сборках.
-X pycache_prefix=PATH: включает запись файлов .pyc в параллельную
структуру каталогов, начинающуюся с указанного каталога, вместо записи в структуру каталогов с кодом.
-X showrefcount: выводит общее количество ссылок и количество используемых
блоков памяти после завершения программы или после каждого оператора в
интерактивном интерпретаторе. Это работает только в отладочных сборках.
-X tracemalloc: запускает трассировку выделения памяти Python с помощью
модуля tracemalloc. По умолчанию в трассировке стека хранится только последний кадр. Используйте -X tracemalloc=NFRAME, чтобы начать трассировку с ограничением глубины стека в NFRAME кадров.
-X utf8: включает режим UTF-8 для взаимодействия с операционной системой,
переопределяя режим, учитывающий локаль, по умолчанию. -X utf8=0 явно
отключает режим UTF-8 (даже если он должен был быть активирован
автоматически). Подробности см. в PYTHONUTF8.
-X warn_default_encoding: включает предупреждение EncodingWarning для 'encoding=None'.
-x Пропускает первую строку исходного кода. Предназначено только для DOS-специфичного хака. Внимание: номера строк в сообщениях об ошибках будут сдвинуты на единицу!
ИНТЕРФЕЙС ИНТЕРПРЕТАТОРА
Интерфейс интерпретатора похож на интерфейс UNIX-оболочки: при вызове с подключенным к tty стандартным вводом он запрашивает команды и выполняет их до тех пор, пока не будет прочитан EOF; при вызове с аргументом имени файла или с файлом в качестве стандартного ввода он считывает и выполняет скрипт из этого файла; при вызове с параметром -c command он выполняет Python-инструкции, заданные в command. Command может содержать несколько инструкций, разделенных символами новой строки. Отступы в начале строки важны для инструкций Python! В неинтерактивном режиме весь ввод сначала анализируется, прежде чем он будет выполнен.
Если доступно, имя скрипта и дополнительные аргументы передаются скрипту в переменной Python sys.argv, которая является списком строк (сначала необходимо импортировать sys, чтобы получить к ней доступ). Если имя скрипта не указано, sys.argv[0] — пустая строка; при использовании -c sys.argv[0] содержит строку '-c'. Обратите внимание, что параметры, интерпретируемые самим интерпретатором Python, не помещаются в sys.argv.
В интерактивном режиме основной запрос — это >>>; второй запрос (который появляется, когда команда не завершена) — это .... Запросы можно изменить, присвоив значения sys.ps1 или sys.ps2. Интерпретатор завершает работу при чтении EOF в запросе. При возникновении необработанного исключения выводится трассировка стека, и управление возвращается к основному запросу; в неинтерактивном режиме интерпретатор завершает работу после вывода трассировки стека. Сигнал прерывания вызывает исключение KeyboardInterrupt; другие сигналы UNIX не перехватываются (за исключением того, что SIGPIPE иногда игнорируется в пользу исключения IOError). Сообщения об ошибках записываются в stderr.
ФАЙЛЫ И ДИРЕКТОРИИ
Эти параметры могут отличаться в зависимости от локальных соглашений об установке; ${prefix} и ${exec_prefix} зависят от установки и должны интерпретироваться так же, как и для программного обеспечения GNU; они могут быть одинаковыми. В Debian GNU/{Hurd,Linux} значение по умолчанию для обоих — /usr.
${exec_prefix}/bin/python
Рекомендуемое местоположение интерпретатора.
${prefix}/lib/python<version>
${exec_prefix}/lib/python<version>
Рекомендуемые местоположения директорий, содержащих стандартные модули.
${prefix}/include/python<version>
${exec_prefix}/include/python<version>
Рекомендуемые местоположения директорий, содержащих файлы заголовков, необходимые для разработки расширений Python и встраивания интерпретатора.
ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ
PYTHONASYNCIODEBUG
Если эта переменная окружения установлена в непустую строку, включается режим отладки модуля asyncio.
PYTHON_BASIC_REPL
Если эта переменная установлена в любое значение, интерпретатор не будет пытаться загрузить REPL на основе Python, требующую curses и readline, и вместо этого будет использовать традиционный REPL на основе парсера.
PYTHONBREAKPOINT
Если эта переменная окружения установлена в 0, отключается отладчик по умолчанию. Ее можно установить в вызываемый объект выбранного вами отладчика.
PYTHONCOERCECLOCALE
Если установлено значение 0, основное приложение Python в командной строке пропускает принудительное преобразование устаревших локалей ASCII в C и POSIX в более функциональную альтернативу на основе UTF-8.
PYTHON_COLORS
Если эта переменная установлена в 1, интерпретатор будет выделять цветом различные типы вывода. Установка в 0 отключает это поведение.
PYTHON_CPU_COUNT
Если эта переменная установлена в положительное целое число, она переопределяет возвращаемые значения os.cpu_count и os.process_cpu_count.
См. также опцию -X cpu_count.
PYTHONDEBUG
Если она установлена в непустую строку, это эквивалентно указанию опции -d. Если установлено в целое число, это эквивалентно указанию опции -d несколько раз.
PYTHONEXECUTABLE
Если эта переменная окружения установлена, sys.argv[0] будет установлено в ее значение вместо значения, полученного из среды выполнения C. Работает только на Mac OS X.
PYTHONFAULTHANDLER
Если эта переменная окружения установлена в непустую строку, при запуске вызывается faulthandler.enable(): устанавливается обработчик сигналов SIGSEGV, SIGFPE, SIGABRT, SIGBUS и SIGILL для дампа трассировки Python.
Это эквивалентно опции -X faulthandler.
PYTHON_FROZEN_MODULES
Если эта переменная установлена в значение «on» или «off», она определяет, следует ли игнорировать замороженные модули механизмом импорта. Значение «on» означает, что они импортируются, а «off» — что они игнорируются. По умолчанию для не-отладочных сборок (обычный случай) установлено значение «on», а для отладочных сборок — «off».
См. также опцию -X frozen_modules.
PYTHON_GIL
Если эта переменная установлена в 1, глобальная блокировка интерпретатора (GIL) будет принудительно включена. Установка значения 0 принудительно отключает GIL. Доступно только в сборках, сконфигурированных с помощью --disable-gil.
Это эквивалентно опции -X gil.
PYTHON_HISTORY
Эта переменная окружения может использоваться для указания расположения файла истории (в Unix по умолчанию это ~/.python_history).
PYTHONNODEBUGRANGES
Если эта переменная установлена, отключается включение таблиц, сопоставляющих дополнительную информацию о местоположении (номер строки окончания, смещение столбца начала и смещение столбца окончания) с каждой инструкцией в объектах кода. Это полезно, когда требуются более компактные объекты кода и файлы .pyc, а также для подавления дополнительных визуальных индикаторов местоположения при отображении трассировок стека интерпретатором.
PYTHONDONTWRITEBYTECODE
Если она установлена в непустую строку, это эквивалентно указанию опции -B (не пытаться записывать файлы .pyc).
PYTHONDEVMODE
Если эта переменная окружения установлена в непустую строку, включается «режим разработчика» Python, который вводит дополнительные проверки во время выполнения, которые слишком дороги для включения по умолчанию.
Это эквивалентно опции -X dev.
PYTHONHASHSEED
Если эта переменная установлена в «random», для инициализации хешей объектов str и bytes используется случайное значение.
Если PYTHONHASHSEED установлено в целочисленное значение, оно используется в качестве фиксированного значения для генерации хеша() типов, охватываемых случайностью хеша. Его цель — обеспечить воспроизводимость хеширования, например, для самотестов самого интерпретатора или для обеспечения возможности обмена значениями хеша кластером процессов Python.
Целое число должно быть десятичным числом в диапазоне [0, 4294967295]. Указание значения 0 отключит случайность хеша.
PYTHONHOME
Измените расположение стандартных библиотек Python. По умолчанию библиотеки ищутся в каталогах ${prefix}/lib/python
PYTHONINSPECT
Если это установлено в непустую строку, это эквивалентно указанию опции -i.
PYTHONINTMAXSTRDIGITS
Ограничьте максимальное количество цифр в целочисленном значении при преобразовании из строки и при преобразовании целого числа обратно в строку. Значение 0 отключает ограничение. Преобразования в базы 2, 4, 8, 16 и 32 никогда не ограничиваются.
Это эквивалентно опции -X int_max_str_digits=NUMBER.
PYTHONIOENCODING
Если эта переменная установлена перед запуском интерпретатора, она переопределяет кодировку, используемую для stdin/stdout/stderr, в синтаксисе encodingname:errorhandler. Часть errorhandler является необязательной и имеет то же значение, что и в str.encode. Для stderr часть errorhandler игнорируется; обработчик всегда будет ´backslashreplace´.
PYTHONMALLOC
Устанавливает аллокаторы памяти Python и/или устанавливает отладочные хуки. Доступные аллокаторы памяти — malloc и pymalloc. Доступные отладочные хуки — debug, malloc_debug и pymalloc_debug.
Когда Python скомпилирован в отладочном режиме, по умолчанию используется pymalloc_debug, и отладочные хуки используются автоматически. В противном случае по умолчанию используется pymalloc.
PYTHONMALLOCSTATS
Если установлено значение, отличное от пустой строки, Python будет выводить статистику аллокатора памяти pymalloc каждый раз, когда создается новая арена объектов pymalloc, и при завершении работы.
Эта переменная игнорируется, если используется переменная среды $PYTHONMALLOC, чтобы принудительно использовать аллокатор malloc(3) библиотеки C, или если Python сконфигурирован без поддержки pymalloc.
PYTHONNOUSERSITE
Если эта переменная установлена в непустую строку, это эквивалентно указанию опции -s (не добавлять каталог пользовательского сайта в sys.path).
PYTHONOPTIMIZE
Если эта переменная установлена в непустую строку, это эквивалентно указанию опции -O. Если установлено значение — целое число, это эквивалентно указанию -O несколько раз.
PYTHONPATH
Расширяет путь поиска файлов модулей по умолчанию. Формат такой же, как и в переменной $PATH оболочки: одна или несколько путей к каталогам, разделенных двоеточиями. Несуществующие каталоги игнорируются. Путь поиска по умолчанию зависит от установки, но обычно начинается с ${prefix}/lib/python
PYTHON_PERF_JIT_SUPPORT
Если эта переменная установлена в ненулевое значение, она включает поддержку профилировщика Linux perf, чтобы Python мог обнаруживать вызовы с помощью информации DWARF. Установка в 0 отключает.
См. также опцию -X perf_jit.
PYTHONPERFSUPPORT
Если эта переменная установлена в ненулевое значение, она включает поддержку профилировщика Linux perf, чтобы Python мог обнаруживать вызовы. Установка в 0 отключает.
См. также опцию -X perf.
PYTHONPLATLIBDIR
Переопределяет sys.platlibdir.
PYTHONPROFILEIMPORTTIME
Если эта переменная среды установлена в непустую строку, Python будет отображать, сколько времени занимает каждый импорт. Это точно эквивалентно указанию -X importtime в командной строке.
PYTHONPYCACHEPREFIX
Если это установлено, Python будет записывать файлы .pyc в зеркальной структуре каталогов по этому пути, а не в каталогах __pycache__ в исходном дереве.
Это эквивалентно указанию опции -X pycache_prefix=PATH.
PYTHONSAFEPATH
Если этой переменной присвоено непустое значение, то потенциально небезопасный путь не будет автоматически добавлен в sys.path, например, текущий каталог, каталог скрипта или пустая строка. См. также опцию -P.
PYTHONSTARTUP
Если это имя читаемого файла, то команды Python в этом файле будут выполнены перед отображением первого приглашения в интерактивном режиме. Файл выполняется в том же пространстве имен, в котором выполняются интерактивные команды, поэтому объекты, определенные или импортированные в нем, могут использоваться без дополнительных квалификаторов в интерактивной сессии. Также в этом файле можно изменить приглашения sys.ps1 и sys.ps2.
PYTHONTRACEMALLOC
Если этой переменной присвоено непустое значение, запускается отслеживание выделения памяти Python с помощью модуля tracemalloc.
Значение переменной — максимальное количество кадров, хранящихся в трассировке стека. Например, `PYTHONTRACEMALLOC=1` хранит только последний кадр.
PYTHONUNBUFFERED
Если этой переменной присвоено непустое значение, это эквивалентно указанию опции -u.
PYTHONUSERBASE
Определяет пользовательский базовый каталог, который используется для вычисления пути к каталогу пользовательских пакетов и путей установки для python -m pip install --user.
PYTHONUTF8
Если установлено значение 1, включается режим «UTF-8» Python. Установка в 0 отключает его.
PYTHONVERBOSE
Если этой переменной присвоено непустое значение, это эквивалентно указанию опции -v. Если присвоено целое число, это эквивалентно указанию опции -v несколько раз.
PYTHONWARNDEFAULTENCODING
Если этой переменной присвоено непустое значение, выдается предупреждение EncodingWarning, когда используется кодировка по умолчанию, зависящая от локали.
PYTHONWARNINGS
Если этой переменной присвоена строка, разделенная запятыми, это эквивалентно указанию опции -W для каждого отдельного значения.
Переменные для отладочного режима
Установка этих переменных оказывает влияние только в отладочной сборке Python, то есть, если Python был сконфигурирован с помощью опции сборки --with-pydebug.
PYTHONDUMPREFS
Если эта переменная окружения установлена, Python выведет объекты и счетчики ссылок, которые остаются в памяти после завершения работы интерпретатора.
PYTHONDUMPREFSFILE
Если установлено, Python выведет объекты и счетчики ссылок, которые остаются в памяти после завершения работы интерпретатора, в файл, расположенный по пути, указанному в качестве значения этой переменной.
PYTHON_PRESITE
Если этой переменной присвоен модуль, этот модуль будет импортирован в начале жизненного цикла интерпретатора, до выполнения модуля site и до создания модуля __main__. Это работает только в отладочных сборках.
Это эквивалентно опции -X presite=module.
АВТОР
The Python Software Foundation: https://www.python.org/psf/
ИНТЕРНЕТ-РЕСУРСЫ
Основной веб-сайт: https://www.python.org/ Документация: https://docs.python.org/ Ресурсы для разработчиков: https://devguide.python.org/ Загрузки: https://www.python.org/downloads/ Репозиторий модулей: https://pypi.org/ Группы новостей: comp.lang.python, comp.lang.python.announce
ЛИЦЕНЗИЯ
Python распространяется под лицензией с открытым исходным кодом. Информацию об условиях доступа и использования Python, а также ОТКАЗ ОТ ВСЕХ ГАРАНТИЙ, можно найти в файле "LICENSE", который входит в состав исходного кода Python.