#!/usr/bin/env python
"""
Example application for the 'blessed' Terminal library for python.

Window size changes are caught by the 'on_resize' function using a traditional signal handler.
Meanwhile, blocking keyboard input is displayed to stdout. If a resize event is discovered, an empty
string is returned by term.inkey().
"""
from __future__ import print_function

# std imports
import signal

# local
from blessed import Terminal


def main():
    """Program entry point."""
    term = Terminal()

    def on_resize(*args):
        # pylint: disable=unused-argument
        #         Unused argument 'args'

        # Its generally not a good idea to put blocking functions (such as
        # print) within a signal handler -- if another SIGWINCH is received
        # while this function blocks, an error will occur.

        # In most programs, you'll want to set some kind of 'dirty' flag,
        # perhaps by a Semaphore like threading.Event or (thanks to the GIL)
        # a simple global variable will suffice.
        print('height={t.height}, width={t.width}\r'.format(t=term))

    signal.signal(signal.SIGWINCH, on_resize)

    # display initial size
    on_resize(term)

    with term.cbreak():
        print("press 'X' to stop.")
        inp = None
        while inp != 'X':
            inp = term.inkey()
            print(repr(inp))


if __name__ == '__main__':
    main()