terminado

This is a Tornado websocket backend for the term.js Javascript terminal emulator library.

It evolved out of pyxterm, which was part of GraphTerm (as lineterm.py), v0.57.0 (2014-07-18), and ultimately derived from the public-domain Ajaxterm code, v0.11 (2008-11-13) (also on Github as part of QWeb).

Modules:

terminado.management: controls launching virtual terminals, connecting them to Tornado’s event loop, and closing them down.
terminado.websocket: Provides a websocket handler for communicating with a terminal.
terminado.uimodule: Provides a Terminal Tornado UI Module.

JS:

terminado/_static/terminado.js: A lightweight wrapper to set up a term.js terminal with a websocket.

Usage example:

import os.path
import tornado.web
import tornado.ioloop
# This demo requires tornado_xstatic and XStatic-term.js
import tornado_xstatic

import terminado
STATIC_DIR = os.path.join(os.path.dirname(terminado.__file__), "_static")

class TerminalPageHandler(tornado.web.RequestHandler):
    def get(self):
        return self.render("termpage.html", static=self.static_url,
                           xstatic=self.application.settings['xstatic_url'],
                           ws_url_path="/websocket")

if __name__ == '__main__':
    term_manager = terminado.SingleTermManager(shell_command=['bash'])
    handlers = [
                (r"/websocket", terminado.TermSocket,
                     {'term_manager': term_manager}),
                (r"/", TerminalPageHandler),
                (r"/xstatic/(.*)", tornado_xstatic.XStaticFileHandler,
                     {'allowed_modules': ['termjs']})
               ]
    app = tornado.web.Application(handlers, static_path=STATIC_DIR,
                      xstatic_url = tornado_xstatic.url_maker('/xstatic/'))
    app.listen(8765)  # Serve at http://localhost:8765/
    try:
        tornado.ioloop.IOLoop.instance().start()
    finally:
        term_manager.shutdown()

See the demos directory for more examples. This is a simplified version of the single.py demo.

Run the unit tests with:

$ nosetests

Release files for terminado 0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for terminado 0.4
File	Size	Uploaded
terminado-0.4.tar.gz	8.6 kB	Feb 3, 2015	Details

Release files / terminado-0.4.tar.gz

Download URL	terminado-0.4.tar.gz
Size	8.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`dc18e5ebfd8b5ec95f0ad5e5858c4bcf7e5b0b4db5c65ea33cd45087f4c5f69c`
BLAKE2b-256 checksum How to use checksums	`0af498c52734d005ca8186fca3ae4bcca2e806c2d133c077123f2f36648f35cc`
Upload date	Feb 3, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No