Skip to main content

Amazes your friends by running Python doctests in a fake interactive shell.

Project description

PlayerPiano amazes your friends by running Python doctests in a fake interactive shell.

See the PlayerPiano PyPI page for more info, or this blog post for a demo.

playerpiano plays back a recorded shell session in a terminal.

recorderpiano can be used to record a shell session for later playback.

Usage

Run playerpiano <options> <FILE>, where FILE is a file containing doctests or the name of a module. Do not pass mymodule.py directly, it will confuse the doctest parser. Use mymodule instead.

Pressing any keys will type source lines, stop at the end of each source block.

Press enter to show the results block.

EOF (^D) will exit the program at the end.

Break (^C) will interrrupt the program immediately.

Options

The --color option will syntax-highlight source lines. It is currently hard-coded for a black background terminal.

The --no-terminal option will disable output on the main terminal. This is less than useful at present.

The --fifo option takes the name of a fifo to duplicate output to. After starting playerpiano with this option, you must run cat name_of_fifo in another terminal before any output will be displayed. This is useful when presenting using a projector. Start a second xterm & run cat, then put it on the overhead (with the main terminal on your laptop). This allows you to see what you’re doing.

Limitations

PlayerPiano only works on Unix-y operating systems, and requires a terminal that speaks VT100. If it works on Windows, please let the author know!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

PlayerPiano-0.1.2.tar.gz (7.1 kB view details)

Uploaded Source

File details

Details for the file PlayerPiano-0.1.2.tar.gz.

File metadata

File hashes

Hashes for PlayerPiano-0.1.2.tar.gz
Algorithm Hash digest
SHA256 7ccf484cee1c74a91da54ccf7befa52ab8e4e8d1ae1b42d89cdd5f44c6961151
MD5 831e0f18335fb431b8bd63173bc5d6a5
BLAKE2b-256 826bd5d99a447527c80864a5ab79c467cafb881b4be734bf78ee1d3b24547ea0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page