Plain

Plain is a web framework for building products with Python.

The core plain package provides the backbone of a Python web application (similar to Flask), while the additional first-party packages can power a more fully-featured database-backed app (similar to Django).

All Plain packages are designed to work together and use PEP 420 to share the plain namespace.

To quickly get started with Plain, visit plainframework.com/start/.

Core Modules

The plain package includes everything you need to start handling web requests with Python:

• assets - Serve static files and assets.
• cli - The plain CLI, powered by Click.
• csrf - Cross-Site Request Forgery protection.
• forms - HTML forms and form validation.
• http - HTTP request and response handling.
• logs - Logging configuration and utilities.
• preflight - Preflight checks for your app.
• runtime - Runtime settings and configuration.
• templates - Jinja2 templates and rendering.
• test - Test utilities and fixtures.
• urls - URL routing and request dispatching.
• views - Class-based views and request handlers.

Foundational Packages

• plain.models - Define and interact with your database models.
• plain.cache - A database-driven general purpose cache.
• plain.email - Send emails with SMTP or custom backends.
• plain.sessions - User sessions and cookies.
• plain.worker - Backgrounb jobs stored in the database.
• plain.api - Build APIs with Plain views.

Auth Packages

• plain.auth - User authentication and authorization.
• plain.oauth - OAuth authentication and API access.
• plain.passwords - Password-based login and registration.
• plain.loginlink - Login links for passwordless authentication.

Admin Packages

• plain.admin - An admin interface for back-office tasks.
• plain.flags - Feature flags.
• plain.support - Customer support forms.
• plain.redirection - Redirects managed in the database.
• plain.pageviews - Basic self-hosted page view tracking and reporting.

Dev Packages

• plain.dev - A single command for local development.
• plain.pytest - Pytest fixtures and helpers.
• plain.code - Code formatting and linting.
• plain.tunnel - Expose your local server to the internet.

Frontend Packages

• plain.tailwind - Tailwind CSS integration without Node.js.
• plain.htmx - HTMX integrated into views and templates.
• plain.elements - Server-side HTML components.
• plain.pages - Static pages with Markdown and Jinja2.
• plain.esbuild - Simple JavaScript bundling and minification.
• plain.vendor - Vendor JavaScript and CSS libraries.