Documentation

Source code and markdown docs, combined.

All of Plain's docs are written directly in the source code. You're encouraged to read the source — either on this site, the GitHub repo, or in your local virtual environment for the version of Plain you're using.

Core

By itself, this is the bare minimum to get a Python web app up and running. It can respond to HTTP requests and render templates, but doesn't include a database. You can think of this as an alternative to Flask.

assets Serve static assets (CSS, JS, images, etc.) directly or from a CDN.

chores Routine maintenance tasks.

cli The `plain` CLI and how to add your own commands to it.

csrf Cross-Site Request Forgery (CSRF) protection using modern request headers.

forms HTML form handling and validation.

http HTTP request and response handling.

logs Logging configuration and utilities.

packages Install Python modules as Plain packages.

preflight System checks for Plain applications.

runtime Access app and package settings at runtime.

signals Run code when certain events happen.

templates Render HTML templates using Jinja.

test Testing utilities for Plain.

urls Route requests to views.

utils Various utilities for text manipulation, parsing, dates, and more.

views Take a request, return a response.

Packages

These packages are separate and can be installed individually. They're often included in the starters.