termios — Управление терминалом в стиле POSIX
Этот модуль предоставляет интерфейс к вызовам POSIX для управления вводом-выводом терминала. Для полного описания этих вызовов см. страницу руководства Unix termios(3). Он доступен только для тех версий Unix, которые поддерживают управление вводом-выводом терминала в стиле 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) -
Устанавливает атрибуты терминала для дескриптора файла fd из attributes, который является списком, подобным тому, который возвращает
tcgetattr(). Аргумент when определяет, когда атрибуты изменяются:TCSANOWдля изменения немедленно,TCSADRAINдля изменения после передачи всех очереди выходных данных, илиTCSAFLUSHдля изменения после передачи всех очереди выходных данных и удаления всех очереди входных данных.
-
termios.tcsendbreak(fd, duration) -
Отправить разрыв на дескрипторе файла fd. Ноль duration отправляет разрыв на 0,25–0,5 секунды; ненулевое duration имеет зависимое от системы значение.
-
termios.tcdrain(fd) -
Ожидать, пока все выходные данные, записанные в дескриптор файла fd, не будут переданы.
-
termios.tcflush(fd, queue) -
Очистить данные в очереди на дескрипторе файла fd. Выбор queue определяет, какая очередь:
TCIFLUSHдля очереди ввода,TCOFLUSHдля очереди вывода илиTCIOFLUSHдля обеих очередей.
-
termios.tcflow(fd, action) -
Приостановить или возобновить ввод или вывод на дескрипторе файла fd. Аргумент action может быть
TCOOFFдля приостановки вывода,TCOONдля возобновления вывода,TCIOFFдля приостановки ввода илиTCIONдля возобновления ввода.
См. также
-
Moduletty -
Функции удобства для выполнения общих операций управления терминалом.
Пример
Вот функция, которая запрашивает пароль с отключенным отображением. Обратите внимание на технику использования отдельного вызова 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 # lflags
try:
termios.tcsetattr(fd, termios.TCSADRAIN, new)
passwd = input(prompt)
finally:
termios.tcsetattr(fd, termios.TCSADRAIN, old)
return passwd
© 2001–2022 Python Software Foundation
Licensed under the PSF License.
https://docs.python.org/3.8/library/termios.html