Framework for interactive slide decks in the terminal
Project description
slideception
A Python library for creating interactive presentations in Linux terminals.
Requirements
- Python 3.8 or newer
- Linux (unless you avoid the Linux-specific stuff)
Usage
Here's a quick example:
#!/usr/bin/env python3 from slideception import display_slides, ipython, slide @slide def context_managers(): """Context Managers A **context manager** is a thing that can be used in a `with` block. ```python3 with record_time() as timer: stuff() print(f"stuff took {timer.elapsed} seconds") ``` It lets you factor out pieces of code that *surround* other code. """ # Now jump into an intepreter for a quick demo ipython() display_slides()
Presentation Boilerplate
At a minimum, you'll need to import display_slides
and slide
and call
display_slides()
at the bottom of your script.
#!/usr/bin/env python3 from slideception import display_slides, slide … display_slides()
Defining Slides
@slide
This decorator registers a function as a slide. The docstring of the function becomes the slide's content, and the body of the function is executed after the content is displayed. The docstring is parsed as CommonMark and then rendered for display in a terminal.
Helpers
-
bash(history=None, init=None)
This function starts a Bash shell which can be used to demo shell scripting and command-line programs.
The
history
parameter accepts a list of commands which will be preloaded into the shell's history; this lets you simply press Up to recall those commands instead of typing them from scratch.The
init
parameter accepts a list of commands which will be executed after the shell loads your.bashrc
file. This can be used tocd
to a specific directory, create files, etc. -
ipython()
This function starts an iPython interpreter which can be used to demo Python code.
-
python()
This function starts a Python interpreter which can be used to demo Python code. You should definitely prefer to use
ipython()
if possible.
Project details
Release history Release notifications
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size slideception-0.1.0-py3-none-any.whl (5.3 kB) | File type Wheel | Python version py3 | Upload date | Hashes View hashes |
Filename, size slideception-0.1.0.tar.gz (4.5 kB) | File type Source | Python version None | Upload date | Hashes View hashes |
Hashes for slideception-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a4d08c16643d45c096aa8e1fb6d0790da6e69593a5ee3c776f9fe47d1233e1f |
|
MD5 | 1292b09a8276198425d05e2918ad5134 |
|
BLAKE2-256 | 48855443a359aff115ba2f2ca35931a0a239e170b73683646b8bd0735c4c2c1d |