understory 0.0.64

The tools that power the canopy

██╗   ██╗███╗   ██╗██████╗ ███████╗██████╗ ███████╗████████╗ ██████╗ ██████╗ ██╗   ██╗
██║   ██║████╗  ██║██╔══██╗██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗╚██╗ ██╔╝
██║   ██║██╔██╗ ██║██║  ██║█████╗  ██████╔╝███████╗   ██║   ██║   ██║██████╔╝ ╚████╔╝
██║   ██║██║╚██╗██║██║  ██║██╔══╝  ██╔══██╗╚════██║   ██║   ██║   ██║██╔══██╗  ╚██╔╝
╚██████╔╝██║ ╚████║██████╔╝███████╗██║  ██║███████║   ██║   ╚██████╔╝██║  ██║   ██║
 ╚═════╝ ╚═╝  ╚═══╝╚═════╝ ╚══════╝╚═╝  ╚═╝╚══════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝   ╚═╝

An IndieWeb-compatible personal website

Install Poetry.

Clone your empty website repository and descend into it. If you use a private GitHub repository your changes will be deployed through GitHub. If you use a public repository your changes will be deployed through PyPI.

Initialize your project and add understory as a dependency.

poetry init
poetry add understory

Create a file site.py:

from understory import indieweb
app = indieweb.personal_site(__name__)

Serve your website locally in development mode:

poetry run web serve site:app

Open localhost:9000 in your browser.

Develop. For example, add a custom route:

import random

@app.route(r"hello")
class SayHello:
    return random.choice(["How you doin'?", "What's happening?", "What's up?"])

To publish:

poetry run pkg publish patch

To deploy:

poetry run gaea deploy site:app alice.anderson.example