amarao / vt102

Python based terminal emulation library with linux console_codes support (still named 'vt102', though)

vt102

«Chicks dig dudes with terminals» © @samfoo

About

What is vt102? It's an in memory VTXXX-compatible terminal emulator. XXX stands for a series video terminals, developed by DEC between 1970 and 1995. The first, and probably the most famous one, was VT100 terminal, which is now a de-facto standard for all virtual terminal emulators. vt102 follows the suit.

So, why would one need a terminal emulator library?

• To screen scrape terminal apps, for example htop or aptitude.
• To write cross platform terminal emulators; either with a graphical (xterm, rxvt) or a web interface, like AjaxTerm.
• To have fun, hacking on the ancient, poorly documented technologies.

Installation

If you have setuptools you can use easy_install -U vt102. Otherwise, you can download the source from GitHub and run python setup.py install.

Example

>>> import vt102 >>> screen = vt102.Screen(80, 24) >>> stream = vt102.Stream() >>> stream.attach(screen) >>> stream.feed(u"u001b7u001b[?47hu001b)0u001b[Hu001b[2Ju001b[H" u"u001b[2;1HNetHack, Copyright 1985-2003ru001b[3;1" u"H By Stichting Mathematisch Centrum and M. " u"Stephenson.ru001b[4;1H See license for de" u"tails.ru001b[5;1Hu001b[6;1Hu001b[7;1HShall I pi" u"ck a character's race, role, gender and alignment f" u"or you? [ynq] ") >>> screen.display [' ', 'NetHack, Copyright 1985-2003 ', ' By Stichting Mathematisch Centrum and M. Stephenson. ', ' See license for details. ', ' ', ' ', "Shall I pick a character's race, role, gender and alignment for you? [ynq] ", ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' ', ' '] >>>

Options?

vt102 is not alone in the weird world of terminal emulator libraries, here's a few other options worth checking out: Termemulator, pyqonsole, webtty AjaxTerm

vt102's Issues

Incorrect "reverse video" handling?

nano doesn't have inversed colors in the bottom panel.

Control characters inside ESC sequences

According to linux/drivers/tty/vt.c: «Control characters can be used in the _middle_of an escape sequence.» -- since we claim to support TERM=linux we should allow that as well.

Add support for escape sequence interrupts

From man console_codes:

CAN (0x18, ^X) and SUB (0x1A, ^Z) interrupt escape sequences;

Check boundaries after "Restore cursor"

... in case screen size changed after cursor was saved.

Implement soft reset

Only resets internals, i.e. modes, G0-1 states, SGR not the screen. See http://vt100.net/docs/vt220-rm/table4-10.html.

Fix autowrap handling

See 754ede3 for an incomplete implementation.

Initial G0 / G1 support

Add support for at leat VT100 graphics map (G1 that is), test with bastet.