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.terminals: controls launching virtual terminals, and connecting them to Tornado's event loop.terminado.websocket: Provides a websocket handler for communicating with a terminal.terminado.uimodule: Provides aTerminalTornado 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.