# `termios` — POSIX style tty control

Цей модуль надає інтерфейс для викликів POSIX для керування tty I/O. Щоб отримати повний опис цих викликів, перегляньте termios(3) сторінку посібника Unix. Він доступний лише для тих версій Unix, які підтримують POSIX termios стиль tty I/O control, налаштований під час встановлення.

Availability: Unix.

Усі функції в цьому модулі приймають файловий дескриптор fd як перший аргумент. Це може бути цілочисельний дескриптор файлу, наприклад, повернутий `sys.stdin.fileno()`, або file object, наприклад `sys.stdin`.

Цей модуль також визначає всі константи, необхідні для роботи з наданими тут функціями; вони мають ті самі назви, що й відповідники на C. Будь ласка, зверніться до системної документації, щоб дізнатися більше про використання цих інтерфейсів керування терміналами.

Модуль визначає такі функції:

termios.tcgetattr(fd)

  Return a list containing the tty attributes for file descriptor fd, as follows: `[iflag, oflag, cflag, lflag, ispeed, ospeed, cc]` where cc is a list of the tty special characters (each a string of length 1, except the items with indices `VMIN` and `VTIME`, which are integers when these fields are defined). The interpretation of the flags and the speeds as well as the indexing in the cc array must be done using the symbolic constants defined in the `termios` module.

termios.tcsetattr(fd, when, attributes)

  Set the tty attributes for file descriptor fd from the attributes, which is a list like the one returned by `tcgetattr()`. The when argument determines when the attributes are changed:

  termios.TCSANOW

    Change attributes immediately.

  termios.TCSADRAIN

    Change attributes after transmitting all queued output.

  termios.TCSAFLUSH

    Change attributes after transmitting all queued output and discarding all queued input.

termios.tcsendbreak(fd, duration)

  Надіслати перерву на файловий дескриптор fd. Нульова тривалість посилає перерву на 0,25–0,5 секунди; ненульова тривалість має системно-залежне значення.

termios.tcdrain(fd)

  Зачекайте, доки не буде передано весь вихід, записаний у файловий дескриптор fd.

termios.tcflush(fd, queue)

  Відкинути дані з черги на файловий дескриптор fd. Селектор queue вказує, яка черга: `TCIFLUSH` для черги введення, `TCOFLUSH` для черги виведення або `TCIOFLUSH` для обох черг.

termios.tcflow(fd, action)

  Призупинити або відновити введення або виведення на файловий дескриптор fd. Аргументом action може бути `TCOOFF`, щоб призупинити виведення, `TCOON`, щоб перезапустити виведення, `TCIOFF`, щоб призупинити введення, або `TCION`, щоб перезапустити введення.

termios.tcgetwinsize(fd)

  Return a tuple `(ws_row, ws_col)` containing the tty window size for file descriptor fd. Requires `termios.TIOCGWINSZ` or `termios.TIOCGSIZE`.

  Added in version 3.11.

termios.tcsetwinsize(fd, winsize)

  Set the tty window size for file descriptor fd from winsize, which is a two-item tuple `(ws_row, ws_col)` like the one returned by `tcgetwinsize()`. Requires at least one of the pairs (`termios.TIOCGWINSZ`, `termios.TIOCSWINSZ`); (`termios.TIOCGSIZE`, `termios.TIOCSSIZE`) to be defined.

  Added in version 3.11.

Дивись також

Модуль `tty`

  Функції зручності для звичайних операцій керування терміналом.

## приклад

Ось функція, яка запитує пароль із вимкненим відлунням. Зверніть увагу на техніку використання окремого виклику `tcgetattr()` і оператора `try` … `finally`, щоб переконатися, що старі атрибути tty точно відновлюються незалежно від того, що трапиться:

    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