|
|
|
# Spiel
|
|
|
|
|
|
|
|
[![PyPI](https://img.shields.io/pypi/v/spiel)](https://pypi.org/project/spiel/)
|
|
|
|
[![PyPI - License](https://img.shields.io/pypi/l/spiel)](https://pypi.org/project/spiel/)
|
|
|
|
|
|
|
|
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/JoshKarpel/spiel/main.svg)](https://results.pre-commit.ci/latest/github/JoshKarpel/spiel/main)
|
|
|
|
[![codecov](https://codecov.io/gh/JoshKarpel/spiel/branch/main/graph/badge.svg?token=2sjP4V0AfY)](https://codecov.io/gh/JoshKarpel/spiel)
|
|
|
|
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
|
|
|
|
|
|
|
|
[![GitHub issues](https://img.shields.io/github/issues/JoshKarpel/spiel)](https://github.com/JoshKarpel/spiel/issues)
|
|
|
|
[![GitHub pull requests](https://img.shields.io/github/issues-pr/JoshKarpel/spiel)](https://github.com/JoshKarpel/spiel/pulls)
|
|
|
|
|
|
|
|
Spiel is a framework for building and presenting [richly-styled](https://github.com/Textualize/rich) presentations in your terminal using Python.
|
|
|
|
|
|
|
|
To see what Spiel can do without installing it, you can view the demonstration deck in a container:
|
|
|
|
```bash
|
|
|
|
$ docker run -it --rm ghcr.io/joshkarpel/spiel
|
|
|
|
```
|
|
|
|
Alternatively, install Spiel (`pip install spiel`) and run this command to view the demonstration deck:
|
|
|
|
```bash
|
|
|
|
$ spiel demo present
|
|
|
|
```
|
|
|
|
|
|
|
|
![The first slide of the demo deck](./docs/assets/demo.svg)
|
|
|
|
![The demo deck in "deck view"](./docs/assets/deck.svg)
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
To learn more about Spiel, take a look at the [documentation](https://www.spiel.how).
|