Metadata-Version: 2.1
Name: term
Version: 2.4
Summary: An enhanced version of the tty module
Home-page: https://github.com/stefanholek/term
Author: Stefan H. Holek
Author-email: stefan@epy.co.at
License: PSF-2.0
Project-URL: Documentation, https://term.readthedocs.io/en/stable/
Keywords: terminal,tty,setraw,setcbreak,opentty,readto,getyx,cursor position,escape sequence,lightmode,darkmode
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Python Software Foundation License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7
Description-Content-Type: text/x-rst
Provides-Extra: docs
License-File: LICENSE

=====
term
=====
--------------------------------------
An enhanced version of the tty module
--------------------------------------

Overview
========

The **term** package is an enhanced version of the standard library's
tty_ module. It provides context managers for opening a terminal stream, and
for temporarily switching the terminal to raw or cbreak mode.

.. _tty: https://docs.python.org/3/library/tty.html

Package Contents
================

Terminal Control
----------------

setraw(fd, when=TCSAFLUSH, min=1, time=0)
    Put the terminal in raw mode.

setcbreak(fd, when=TCSAFLUSH, min=1, time=0)
    Put the terminal in cbreak mode.

rawmode(fd, when=TCSAFLUSH, min=1, time=0)
    Context manager to put the terminal in raw mode.

cbreakmode(fd, when=TCSAFLUSH, min=1, time=0)
    Context manager to put the terminal in cbreak mode.

Terminal I/O
------------

opentty(bufsize=-1, mode='r+b')
    Context manager returning a new rw stream connected to /dev/tty.
    The stream is None if the device cannot be opened.

readto(stream, endswith):
    Read bytes or characters from stream until buffer.endswith(endswith)
    is true.

High-level Functions
--------------------

getyx()
    Return the cursor position as 1-based (line, col) tuple.
    Line and col are 0 if the device cannot be opened or the terminal
    does not support DSR 6.

getfgcolor()
    Return the terminal foregound color as (r, g, b) tuple.
    All values are -1 if the device cannot be opened or does not supports
    OSC 10.

getbgcolor()
    Return the terminal background color as (r, g, b) tuple.
    All values are -1 if the device cannot be opened or does not supports
    OSC 11.

islightmode()
    Return true if the background color is lighter than the foreground color.
    May return None if the terminal does not support OSC color queries.

isdarkmode()
    Return true if the background color is darker than the foreground color.
    May return None if the terminal does not support OSC color queries.

Documentation
=============

Please see the `API Documentation`_ for more.

.. _`API Documentation`: https://term.readthedocs.io/en/stable/


Changelog
=========

2.4 - 2022-03-07
----------------

- Add Python 3.8-3.10 to tox.ini. Remove old Python versions.
  [stefan]

- Replace deprecated ``python setup.py test`` in tox.ini.
  [stefan]

- Remove deprecated ``test_suite`` from setup.py.
  [stefan]

- Move metadata to setup.cfg and add a pyproject.toml file.
  [stefan]

- Include tests in sdist but not in wheel.
  [stefan]

- Fix escape sequence warning in byte string literal.
  [stefan]

- Open /dev/tty in binary mode under both Python 2 and 3.
  [stefan]

- Officially change opentty's bufsize argument default from 1 to -1.
  Under Python 3, 1 has effectively meant -1 all along but Python 3.8
  now issues a warning.
  [stefan]

- Add readto, getfgcolor, getbgcolor, islightmode, and isdarkmode.
  [stefan]

2.3 - 2019-02-08
----------------

- Add MANIFEST.in.
  [stefan]

- Release as wheel.
  [stefan]

- Drop explicit GPL because the PSF license is GPL-compatible anyway.
  [stefan]

2.2 - 2017-02-05
----------------

- Support Python 2.6-3.6 without 2to3.
  [stefan]

2.1 - 2014-04-19
----------------

- Remove setuptools from install_requires because it isn't.
  [stefan]

2.0 - 2012-04-27
----------------

- Open /dev/tty in binary mode under Python 3.
  [stefan]

- Disable buffering if the device is not seekable.
  [stefan]

- Remove getmaxyx since it cannot be implemented reliably.
  [stefan]

- Support Python 2.5.
  [stefan]

- Change license to GPL or PSF to avoid relicensing of PSF code.
  [stefan]

1.0 - 2012-04-11
----------------

- Initial release.
  [stefan]


