xppl/README.md

# Varia's XPPL

The [XPUB] library living at [Varia].

> https://books.vvvvvvaria.org/

[XPUB]: http://xpub.nl/
[Varia]: https://varia.zone/

# Hack It

You'll need to run an [RQLite] database first:

```
$ apt update && apt install -y make
$ make install-rqlite
$ make rqlited
```

Then get [Pipenv] and run the development server with:

```bash
$ pipenv install --dev --three
$ pipenv run devserver
```

If you need to check the database contents, run:

```bash
$ make rqlite
```

And then run `.help` for which commands are available.

[Pipenv]: https://pipenv.readthedocs.io/en/latest/install/#pragmatic-installation-of-pipenv
[RQLite]: https://github.com/rqlite/rqlite

# Test It

```bash
$ pipenv run tox
```

Refer to the [tox.ini](tox.ini) for configuration options.

# Deploy It

See [ansible/README.md](ansible/README.md) for this.