# `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)

  Повертає список, що містить атрибути tty для файлового дескриптора fd, таким чином: `[iflag, oflag, cflag, lflag, ispeed, ospeed, cc]`, де cc — це список спеціальних символів tty (кожен рядок довжиною 1, за винятком елементів з індексами `VMIN` і `VTIME`, які є цілими числами, коли ці поля визначені). Інтерпретація прапорів і швидкостей, а також індексування в масиві cc мають виконуватися за допомогою символічних констант, визначених у модулі `termios`.

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