Модуль sys

Модуль sys обеспечивает доступ к некоторым переменным и функциям, взаимодействующим с интерпретатором python.

sys.argv — список аргументов командной строки, передаваемых сценарию Python. sys.argv[0] является именем скрипта (пустой строкой в интерактивной оболочке).

sys.byteorder — порядок байтов. Будет иметь значение ‘big’ при порядке следования битов от старшего к младшему, и ‘little’, если наоборот (младший байт первый).

sys.builtin_module_names — кортеж строк, содержащий имена всех доступных модулей.

sys.call_tracing(функция, аргументы) — вызывает функцию с аргументами и включенной трассировкой, в то время как трассировка включена.

sys.copyright — строка, содержащая авторские права, относящиеся к интерпретатору Python.

sys._clear_type_cache() — очищает внутренний кэш типа.

sys._current_frames() — возвращает словарь-отображение идентификатора для каждого потока в верхнем кадре стека в настоящее время в этом потоке в момент вызова функции.

sys.dllhandle — целое число, определяющее дескриптор DLL Python (Windows).

sys.exc_info() — возвращает кортеж из трех значений, которые дают информацию об исключениях, обрабатывающихся в данный момент.

sys.exec_prefix — каталог установки Python.

sys.executable — путь к интерпретатору Python.

sys.exit([arg]) — выход из Python. Возбуждает исключение SystemExit, которое может быть перехвачено.

sys.flags — флаги командной строки. Атрибуты только для чтения.

sys.float_info — информация о типе данных float.

sys.float_repr_style — информация о применении встроенной функции repr() для типа float.

sys.getdefaultencoding() — возвращает используемую кодировку.

sys.getdlopenflags() — значения флагов для вызовов dlopen().

sys.getfilesystemencoding() — возвращает кодировку файловой системы.

sys.getrefcount(object) — возвращает количество ссылок на объект. Аргумент функции getrefcount — еще одна ссылка на объект.

sys.getrecursionlimit() — возвращает лимит рекурсии.

sys.getsizeof(object[, default]) — возвращает размер объекта (в байтах).

sys.getswitchinterval() — интервал переключения потоков.

sys.getwindowsversion() — возвращает кортеж, описывающий версию Windows.

sys.hash_info — информация о параметрах хэширования.

sys.hexversion — версия python как шестнадцатеричное число (для 3.2.2 final это будет 30202f0).

sys.implementation — объект, содержащий информацию о запущенном интерпретаторе python.

sys.int_info — информация о типе int.

sys.intern(строка) — возвращает интернированную строку.

sys.last_type, sys.last_value, sys.last_traceback — информация об обрабатываемых исключениях. По смыслу похоже на sys.exc_info().

sys.maxsize — максимальное значение числа типа Py_ssize_t (2 31 на 32-битных и 2 63 на 64-битных платформах).

sys.maxunicode — максимальное число бит для хранения символа Unicode.

sys.modules — словарь имен загруженных модулей. Изменяем, поэтому можно позабавиться 🙂

sys.path — список путей поиска модулей.

sys.path_importer_cache — словарь-кэш для поиска объектов.

sys.platform — информация об операционной системе.

Linux (2.x and 3.x)	‘linux’
Windows	‘win32’
Windows/Cygwin	‘cygwin’
Mac OS X	‘darwin’
OS/2	‘os2’
OS/2 EMX	‘os2emx’

sys.prefix — папка установки интерпретатора python.

sys.ps1, sys.ps2 — первичное и вторичное приглашение интерпретатора (определены только если интерпретатор находится в интерактивном режиме). По умолчанию sys.ps1 == «>>> «, а sys.ps2 == «. «.

sys.dont_write_bytecode — если true, python не будет писать .pyc файлы.

sys.setdlopenflags(flags) — установить значения флагов для вызовов dlopen().

sys.setrecursionlimit(предел) — установить максимальную глубину рекурсии.

sys.setswitchinterval(интервал) — установить интервал переключения потоков.

sys.settrace(tracefunc) — установить «след» функции.

sys.stdin — стандартный ввод.

sys.stdout — стандартный вывод.

sys.stderr — стандартный поток ошибок.

sys.__stdin__, sys.__stdout__, sys.__stderr__ — исходные значения потоков ввода, вывода и ошибок.

sys.tracebacklimit — максимальное число уровней отслеживания.

sys.version — версия python.

sys.api_version — версия C API.

sys.version_info — Кортеж, содержащий пять компонентов номера версии.

sys.warnoptions — реализация предупреждений.

sys.winver — номер версии python, использующийся для формирования реестра Windows.

Если что-то пропустил (а я вполне мог это сделать), прошу в комментарии 🙂

Модуль sys в Python

• 
• 
• 

Модуль sys предлагает методы, которые позволяют работать с разными элементами среды выполнения Python. С его помощью можно взаимодействовать с интерпретатором, используя разные функции. Но для начала его нужно импортировать.

В этом материале речь пойдет о следующих возможностях модуля sys :

sys.argv

Метод argv возвращает аргументы командной строки, переданные скрипту Python, в виде списка. Важно отметить, что первый аргумент (с индексом 0 ) в списке — это название самого скрипта. Остальные представлены в виде последовательности.

В следующем примере файл с кодом называется test.py .

Время для примера:

Сохраните этот код в файле test.py и запустите его в командной строке вместе со следующими аргументами:

Перед этим необходимо перейти в директорию с файлом или ввести полный абсолютный путь к нему.

В указанной выше команде первым аргументом функции argv является элемент Студенты . sys и PythonRu — второй и третий аргументы.

• 
• 
• 
• 
• 
• 
• 

Нулевым параметром является название самого скрипта, которое командная строка определяет автоматически.

Вывод:

sys.maxsize

Эта функция возвращает целое число, которое обозначает, какое максимально значение может иметь переменная типа Py_ssize_t в программе Python. Это значение зависит от платформы, где программа была запущена. Если это 32-битная платформа, значение обычно 2*33 — 1 (2147483647), а в 64-битной — 2**63 — 1 (9223372036854775807).

Пример (обновите код в test.py ):

Вывод:

sys.path

Метод path из модуля sys возвращает все пути для поиска модулей Python. Формат вывода — список строк.

Ту же операцию можно выполнить обратившись к переменным среды в панели управления и найдя в ней PYTHONPATH . Первый элемент вывода — расположение исполняемого скрипта. Если же эта директория недоступна, то первый элемент будет пустой.

Такое может произойти в том случае, если скрипт был вызван интерактивно (с помощью IDLE, интегрированной среды разработки и обучения на языке Python) или же из стандартного ввода (с помощью инструкции exec ). В дальнейшем список может быть изменен в соответствии с требованиями. В него можно добавлять только строки и байты (другие типы будут игнорироваться).

Вывод:
[‘C:\\Users\\user_name, ‘C:\\Users\\ user_name \\Anaconda3\\pkgs\\nb_anacondacloud-1.2.0-py35_0\\Lib\\site-packages\\nb_anacondacloud-1.2.0-py3.5.egg-info’, ‘C:\\Users\\ user_name \\AppData\\Local\\Programs\\Python\\Python36\\python.exe’, ‘C:\\ProgramData\\Anaconda3\\DLLs’, ‘C:\\ProgramData\\Anaconda3\\lib’, ‘C:\\ProgramData\\Anaconda3’, », ‘C:\\ProgramData\\Anaconda3\\lib\\site-packages’, ‘C:\\ProgramData\\Anaconda3\\lib\\site-packages\\win32’, ‘C:\\ProgramData\\Anaconda3\\lib\\site-packages\\win32\\lib’, ‘C:\\ProgramData\\Anaconda3\\lib\\site-packages\\Pythonwin’, ‘C:\\ProgramData\\Anaconda3\\lib\\site-packages\\IPython\\extensions’, ‘C:\\Users\\ user_name \\.ipython’]

sys.version

Этот метод показывает версию интерпретатора Python. Он также предоставляет информацию о номере сборки и компиляторе. Информация отображается в виде строки. Рекомендуется использовать метод version_info для получения информации о версии, а не извлекать ее из вывода sys.version .

• 
• 
• 
• 
• 
• 
• 

Вывод:

sys.exit

Метод exit выходит из программы Python или завершает конкретный процесс. Он используется для безопасного завершения программы в случае исключения. Под капотом sys.exit вызывает исключение SystemExit . Это то же самое, что exit или quit в Python.

При вызове SystemExit также исполняются функции блока finally из инструкции try .

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

Выводы:

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

Подписывайтесь на канал в Дзене

Полезный контент для начинающих и опытных программистов в канале Лента Python разработчика — Как успевать больше, делать лучше и не потерять мотивацию.

Разбираем модуль sys

Модуль sys предоставляет системе особые параметры и функции. В данном разделе мы рассмотрим следующее:

• sys.argv
• sys.executable
• sys.exit
• sys.modules
• sys.path
• sys.platform
• sys.stdin/stdout/stderr

sys.argv

Значение sys.argv – это список аргументов командной строки, которые причастны к скрипту Python. Первый аргумент, argv[0], имеет аналогичное скрипту Python наименование. В зависимости от платформы, на которой вы работаете, первый аргумент может содержать полный путь к скрипту или к названию файла. Для дополнительных деталей обратитесь к документации. А тем временем, попробуем поработать с парочкой примеров, чтобы познакомиться с этим инструментом:

Если вы запустите это в интерпретаторе, вы получите список с пустой строкой. Давайте создадим файл под названием sysargv.py, со следующим содержимым:

Теперь запустите код в IDLE. Вы увидите список с одним элементом, который содержит путь к вашему скрипту. Попробуем передать скрипту несколько аргументов. Откройте окно терминала \ консоли и при помощи команды cd измените каталоги на тот, в котором находится скрипт. После этого, запустите что-то наподобие этого:

sys.argv

Обратите внимание на то, что будет выведено на экран:

Первый аргумент – это название файла нашего скрипта. Следующие два аргумента в списке – это те, что мы передали нашему скрипту в командной строке.

sys.executable

Значение sys.executable – это полный путь к интерпретатору Python. Это очень полезно, когда вы используете чей-то компьютер, и вам нужно узнать, где установлен Python. В некоторых системах, данная команда не сработает, и выдаст пустую строку с надписью None. Посмотрим, как пользоваться этой функцией:

sys.exit

Данная функция позволяет разработчику выйти из Python. Функция exit принимает необязательный аргумент, обычно целое число, которое дает статус выхода. Ноль считается как успешное завершение. Обязательно проверьте, имеет ли ваша операционная система какие-либо особые значения для своих статусов выхода, чтобы вы могли следить за ними в своем собственном приложении. Обратите внимание на то, что когда вы вызываете exit, это вызовет исключение SystemExit, которое позволяет функциям очистки работать в конечных пунктах блоков try / except. Давайте взглянем на то, как вызывается данная функция:

» , line 1 , in module >

Запустив данный код в IDLE, вы увидите возникшую ошибку SystemExit. Давайте создадим несколько скриптов для теста. Для начала вам нужно создать основной скрипт, программу, которая будет вызывать другой скрипт Python. Давайте назовем его “call_exit.py”. Скрипт должен содержать следующее:

Теперь создайте скрипт Python под названием“exit.py” и сохраните его в той же папке. Вставьте в него следующий код:

Теперь давайте запустим его:

sys.exit

Как вы могли заметить, написанный нами скрипт exit вернул ноль, так что он успешно заработал. Получается, мы заодно научились вызывать разные скрипты Python изнутри самого Python!

Есть вопросы по Python?

На нашем форуме вы можете задать любой вопрос и получить ответ от всего нашего сообщества!

Telegram Чат & Канал

Вступите в наш дружный чат по Python и начните общение с единомышленниками! Станьте частью большого сообщества!

Паблик VK

Одно из самых больших сообществ по Python в социальной сети ВК. Видео уроки и книги для вас!

sys.path

Значение функции path модуля sys – это список строк, которые указывают путь поиска для модулей. Как правило, данная функция указывает Python, в каких локациях смотреть, когда он пытается импортировать модуль. В соответствии с документацией Python, sys.path инициализируется из переменной окружения PYTHONPATH, плюс зависимое от установки значение, указанное по умолчанию. Давайте взглянем на пример:

Данная функция может быть весьма полезной во время отладки причины, по которой модуль не импортируется. Вы также можете изменить путь. Так как данная функция является путем, мы можем добавлять или удалять путь из неё. Давайте взглянем на то, как добавлять путь:

Удаление пути я оставлю как задание для читателя

sys.platform

Значение sys.platform – идентификатор платформы. Вы можете использовать sys.platform чтобы добавлять модули к sys.path, импортировать разные модули, в зависимости от платформы, или запускать разные части кода. Давайте взглянем:

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

Данный код показывает способы проверки того, используем ли мы определенную операционную систему. Если мы используем Windows, мы получим определенную информацию из реестра Windows, при помощи модуля Python под названием _winreg. Если мы используем Linux, мы можем выполнить команду ls, чтобы получить информацию о каталоге, в котором мы находимся.

sys.stdin / stdout / stderr

Stdin, stdout и stderr сопоставляются с файловыми объектами, которые соответствуют стандартным входам, выходам и потокам ошибок интерпретатора соответственно. Функция stdin используется для всех входов, используемых интерпретатором, за исключением скриптов, тогда как stdout используется для выходов операторов print и expression. Главная причина, по которой я акцентирую на этом внимание, заключается в том, что в какой-то момент вам нужно будет перенаправить stdout или stderr, или обе функции к файлу, такому как log, либо же какой-либо дисплей в пользовательском графическом интерфейсе, созданным вами. Вы также можете перенаправить stdin, но с такими случаями я практически не сталкивался.

Подведем итоги

Существует много других значений и методов в модуле sys. Обратитесь к документации Python, а именно к секции 27.1, если вам нужно углубиться в данный вопрос. Мы многому научились из данной статьи, поздравляю. Теперь вы знаете, как выйти из программы Python, как получить информацию о платформе, работать с аргументами, переданными командной строке, и многому другому.

Являюсь администратором нескольких порталов по обучению языков программирования Python, Golang и Kotlin. В составе небольшой команды единомышленников, мы занимаемся популяризацией языков программирования на русскоязычную аудиторию. Большая часть статей была адаптирована нами на русский язык и распространяется бесплатно.

E-mail: vasile.buldumac@ati.utm.md

Образование
Universitatea Tehnică a Moldovei (utm.md)

• 2014 — 2018 Технический Университет Молдовы, ИТ-Инженер. Тема дипломной работы «Автоматизация покупки и продажи криптовалюты используя технический анализ»
• 2018 — 2020 Технический Университет Молдовы, Магистр, Магистерская диссертация «Идентификация человека в киберпространстве по фотографии лица»