Содержание страницы
36.7. termios – управление терминалом в стиле POSIX¶termios – POSIX style tty control
Этот модуль предоставляет интерфейс к системным вызовам POSIX для управления вводом/выводом tty. Полное описание этих вызовов можно найти на странице руководства Unix termios(2). Он доступен только для тех версий Unix, которые поддерживают управление tty в стиле POSIX termios, настроенное во время установки.
Все функции в этом модуле принимают файловый дескриптор fd в качестве первого аргумента. Это может быть целочисленный файловый дескриптор, например возвращаемый sys.stdin.fileno(), или файловый объект, например сам sys.stdin.
Этот модуль также определяет все константы, необходимые для работы с предоставленными функциями; их имена совпадают с соответствующими константами в C. За дополнительной информацией по использованию этих интерфейсов управления терминалом обратитесь к системной документации.
Модуль определяет следующие функции:
-
termios.tcgetattr(fd)¶ Возвращает список, содержащий атрибуты терминала для файлового дескриптора fd, в следующем виде:
[iflag, oflag, cflag, lflag, ispeed, ospeed, cc], где cc – это список специальных символов терминала (каждый – строка длиной 1, за исключением элементов с индексамиVMINиVTIME, которые являются целыми числами, если эти поля определены). Интерпретация флагов и скоростей, а также индексация массива cc должны выполняться с помощью символьных констант, определённых в модулеtermios.
-
termios.tcsetattr(fd, when, attributes)¶ Устанавливает атрибуты tty для файлового дескриптора fd из attributes, который представляет собой список, аналогичный возвращаемому
tcgetattr(). Аргумент when определяет, когда изменять атрибуты:TCSANOW– изменить немедленно,TCSADRAIN– изменить после передачи всего вывода из очереди, илиTCSAFLUSH– изменить после передачи всего вывода из очереди и отбрасывания всего ввода из очереди.
-
termios.tcsendbreak(fd, duration)¶ Посылает сигнал break на файловый дескриптор fd. Нулевое значение duration посылает break длительностью 0,25–0,5 секунды; ненулевое duration имеет системно-зависимое значение.
-
termios.tcdrain(fd)¶ Ожидать, пока весь вывод, записанный в файловый дескриптор fd, не будет передан.
-
termios.tcflush(fd, queue)¶ Отбрасывает поставленные в очередь данные на файловом дескрипторе fd. Селектор очередь указывает, какая очередь:
TCIFLUSH– очередь ввода,TCOFLUSH– очередь вывода, илиTCIOFLUSH– обе очереди.
-
termios.tcflow(fd, action)¶ Приостанавливает или возобновляет ввод или вывод на файловом дескрипторе fd. Аргумент action может принимать значения:
TCOOFF– приостановить вывод,TCOON– возобновить вывод,TCIOFF– приостановить ввод,TCION– возобновить ввод.
См. также
- Модуль
tty Вспомогательные функции для типовых операций управления терминалом.
36.7.1. Пример¶Example
Ниже приведена функция, которая запрашивает пароль с отключённым эхом. Обратите внимание на технику с отдельным вызовом tcgetattr() и инструкцией try … finally, чтобы гарантировать точное восстановление старых атрибутов терминала независимо от возникших ситуаций:
def getpass(prompt="Password: "):
import termios, sys
fd = sys.stdin.fileno()
old = termios.tcgetattr(fd)
new = termios.tcgetattr(fd)
new[3] = new[3] & ~termios.ECHO # локальные флаги
try:
termios.tcsetattr(fd, termios.TCSADRAIN, new)
passwd = raw_input(prompt)
finally:
termios.tcsetattr(fd, termios.TCSADRAIN, old)
return passwd