Metadata-Version: 2.0
Name: demoshell
Version: 0.1.0
Summary: Simplified Shell for Live Demos
Home-page: https://pypi.python.org/pypi/demoshell
Author: Doug Hellmann
Author-email: doug@doughellmann.com
License: UNKNOWN
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Dist: urwid (>=2.0.1)

============
 Demo Shell
============

``demoshell`` is a simplified shell for live demonstrations. It always
shows the command prompt at the top of the screen and pushes command
output down instead of letting iscroll up.

Huh?
====

POSIX shells print their output in such a way that it scrolls up and
off the top of the screen because they are using tty semantics, which
are based on hardware that used to literally print everything on a
roll of paper that moved up through the machine and over the top.

It's the 21st century. We don't use paper-based terminals any
more. While continuing to pretend we do is fine for day-to-day work,
when we are giving live presentations it is not ideal because the most
interesting thing you are doing is probably at the bottom of your
screen during a live demo. That is the hardest part of the screen for
people at the back of the room to see, because it is often blocked by
other people's heads.

``demoshell`` avoids this problem by always keeping the command prompt
at the top of the screen and showing the output of commands below,
pushing older commands off of the bottom of the screen to make space
for newer text.

Using demoshell
===============

Install the shell with ``pip3`` (it works best under Python 3)::

  $ pip3 install demoshell

Run ``demoshell``::

  $ demoshell

Run any shell command at the prompt::

  $ ls

  ls
  AUTHORS
  ChangeLog
  LICENSE
  README.rst
  demoshell
  demoshell.egg-info
  dist
  requirements.txt
  setup.cfg
  setup.py
  test

Use ``exit`` or ``Ctrl-D`` to leave the shell.

Use ``clear`` to clear the screen.

Resources
=========

* GitHub: https://github.com/dhellmann/demoshell
* Bugs: https://github.com/dhellmann/demoshell/issues
* Documentation: *Help wanted!*



