plain 0.55.0__py3-none-any.whl → 0.56.1__py3-none-any.whl

plain/CHANGELOG.md

@@ -1,5 +1,28 @@
 # plain changelog
 
+## [0.56.1](https://github.com/dropseed/plain/releases/plain@0.56.1) (2025-07-30)
+
+### What's changed
+
+- Improved `plain install` command instructions to be more explicit about completing code modifications ([83292225db](https://github.com/dropseed/plain/commit/83292225db))
+
+### Upgrade instructions
+
+- No changes required
+
+## [0.56.0](https://github.com/dropseed/plain/releases/plain@0.56.0) (2025-07-25)
+
+### What's changed
+
+- Added `plain install` command to install Plain packages with agent-assisted setup ([bf1873e](https://github.com/dropseed/plain/commit/bf1873eb81))
+- Added `--print` option to agent commands (`plain install` and `plain upgrade`) to print prompts without running the agent ([9721331](https://github.com/dropseed/plain/commit/9721331e40))
+- The `plain docs` command now automatically converts hyphens to dots in package names (e.g., `plain-models` → `plain.models`) ([1e3edc1](https://github.com/dropseed/plain/commit/1e3edc10f7))
+- Moved `plain-upgrade` functionality into plain core, eliminating the need for a separate package ([473f9bb](https://github.com/dropseed/plain/commit/473f9bb718))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.55.0](https://github.com/dropseed/plain/releases/plain@0.55.0) (2025-07-22)
 
 ### What's changed

plain/assets/README.md

@@ -2,7 +2,13 @@
 
 **Serve static assets (CSS, JS, images, etc.) directly or from a CDN.**
 
-## Usage
+- [Overview](#overview)
+- [Local development](#local-development)
+- [Production deployment](#production-deployment)
+- [Using `AssetView` directly](#using-assetview-directly)
+- [FAQs](#faqs)
+
+## Overview
 
 To serve assets, put them in `app/assets` or `app/{package}/assets`.
 
@@ -62,7 +68,7 @@ class AppRouter(Router):
 
 ## FAQs
 
-### How do you reference assets in Python code?
+#### How do you reference assets in Python code?
 
 There is a [`get_asset_url`](./urls.py#get_asset_url) function that you can use to get the URL of an asset in Python code. This is useful if you need to reference an asset in a non-template context, such as in a redirect or an API response.
 
@@ -72,7 +78,7 @@ from plain.assets.urls import get_asset_url
 url = get_asset_url("css/style.css")
 ```
 
-### What if I need the files in a different location?
+#### What if I need the files in a different location?
 
 The generated/copied files are stored in `{repo}/.plain/assets/compiled`. If you need them to be somewhere else, try simply moving them after compilation.
 
@@ -81,7 +87,7 @@ plain build
 mv .plain/assets/compiled /path/to/your/static
 ```
 
-### How do I upload the assets to a CDN?
+#### How do I upload the assets to a CDN?
 
 The steps for this will vary, but the general idea is to compile them, and then upload the compiled assets from their [compiled location](compile.py#get_compiled_path).
 
@@ -103,7 +109,7 @@ Use the [`ASSETS_BASE_URL`](../runtime/global_settings.py#ASSETS_BASE_URL) setti
 ASSETS_BASE_URL = "https://cdn.example.com/"
 ```
 
-### Why aren't the originals copied to the compiled directory?
+#### Why aren't the originals copied to the compiled directory?
 
 The default behavior is to fingerprint assets, which is an exact copy of the original file but with a different filename. The originals aren't copied over because you should generally always use this fingerprinted path (that automatically uses longer-lived caching).
 

plain/chores/README.md

@@ -2,6 +2,12 @@
 
 **Routine maintenance tasks.**
 
+- [Overview](#overview)
+- [Running chores](#running-chores)
+- [Writing chores](#writing-chores)
+
+## Overview
+
 Chores are registered functions that can be run at any time to keep an app in a desirable state.
 
 ![](https://assets.plainframework.com/docs/plain-chores-run.png)

plain/cli/README.md

@@ -2,67 +2,18 @@
 
 **The `plain` CLI and how to add your own commands to it.**
 
+- [Overview](#overview)
+- [Adding commands](#adding-commands)
+
+## Overview
+
 Commands are written using [Click](https://click.palletsprojects.com/en/8.1.x/)
 (one of Plain's few dependencies),
 which has been one of those most popular CLI frameworks in Python for a long time.
 
-## Built-in commands
-
-### `plain build`
-
-Compile static assets (used in the deploy/production process).
-
-Automatically runs `plain tailwind build` if [plain.tailwind](/plain-tailwind/) is installed.
-
-### `plain create`
-
-Create a new local package.
-
-### `plain preflight`
-
-Run preflight checks to ensure your app is ready to run.
-
-### `plain run`
-
-Run a Python script in the context of your app.
-
-### `plain setting`
-
-View the runtime value of a named setting.
-
-### `plain help`
-
-Print help for all available commands and subcommands.
-Each command's help output is prefixed with the full command name for
-readability.
-
-### `plain shell`
-
-Open a Python shell with the Plain loaded.
-
-To auto-load models or run other code at shell launch,
-create an `app/shell.py` and it will be imported automatically.
-
-```python
-# app/shell.py
-from app.organizations.models import Organization
-
-__all__ = [
-    "Organization",
-]
-```
-
-### `plain urls list`
-
-List all the URL patterns in your app.
-
-### `plain utils generate-secret-key`
-
-Generate a new secret key for your app, to be used in `settings.SECRET_KEY`.
-
 ## Adding commands
 
-The `register_cli` decorator can be used to add your own commands to the `plain` CLI.
+The [`register_cli`](./registry.py#register_cli) decorator can be used to add your own commands to the `plain` CLI.
 
 ```python
 import click

plain/cli/agent.py

@@ -0,0 +1,44 @@
+import shlex
+import subprocess
+
+import click
+
+
+def prompt_agent(
+    prompt: str, agent_command: str | None = None, print_only: bool = False
+) -> bool:
+    """
+    Run an agent command with the given prompt, or display the prompt for manual copying.
+
+    Args:
+        prompt: The prompt to send to the agent
+        agent_command: Optional command to run (e.g., "claude code"). If not provided,
+                      will check the PLAIN_AGENT_COMMAND environment variable.
+        print_only: If True, always print the prompt instead of running the agent
+
+    Returns:
+        True if the agent command succeeded (or no agent command was provided),
+        False if the agent command failed.
+    """
+    if print_only or not agent_command:
+        click.echo(prompt)
+        if not print_only:
+            click.secho(
+                "\nCopy the prompt above to a coding agent. To run an agent automatically, use --agent-command or set the PLAIN_AGENT_COMMAND environment variable.",
+                dim=True,
+                italic=True,
+                err=True,
+            )
+        return True
+    else:
+        cmd = shlex.split(agent_command)
+        cmd.append(prompt)
+        result = subprocess.run(cmd, check=False)
+        if result.returncode != 0:
+            click.secho(
+                f"Agent command failed with exit code {result.returncode}",
+                fg="red",
+                err=True,
+            )
+            return False
+        return True

plain/cli/core.py

@@ -12,11 +12,13 @@ from .chores import chores
 from .docs import docs
 from .formatting import PlainContext
 from .help import help_cmd
+from .install import install
 from .preflight import preflight_checks
 from .registry import cli_registry
 from .scaffold import create
 from .settings import setting
 from .shell import run, shell
+from .upgrade import upgrade
 from .urls import urls
 from .utils import utils
 
@@ -37,6 +39,8 @@ plain_cli.add_command(changelog)
 plain_cli.add_command(setting)
 plain_cli.add_command(shell)
 plain_cli.add_command(run)
+plain_cli.add_command(install)
+plain_cli.add_command(upgrade)
 plain_cli.add_command(help_cmd)
 
 

plain/cli/docs.py

@@ -40,6 +40,9 @@ def docs(module, llm, open):
         return
 
     if module:
+        # Convert hyphens to dots (e.g., plain-models -> plain.models)
+        module = module.replace("-", ".")
+
         # Automatically prefix if we need to
         if not module.startswith("plain"):
             module = f"plain.{module}"

plain/cli/install.py

@@ -0,0 +1,82 @@
+import subprocess
+import sys
+
+import click
+
+from .agent import prompt_agent
+
+
+@click.command()
+@click.argument("packages", nargs=-1, required=True)
+@click.option(
+    "--agent-command",
+    envvar="PLAIN_AGENT_COMMAND",
+    help="Run command with generated prompt",
+)
+@click.option(
+    "--print",
+    "print_only",
+    is_flag=True,
+    help="Print the prompt without running the agent",
+)
+def install(
+    packages: tuple[str, ...],
+    agent_command: str | None = None,
+    print_only: bool = False,
+) -> None:
+    """Install Plain packages with the help of an agent."""
+    # Validate all package names
+    invalid_packages = [pkg for pkg in packages if not pkg.startswith("plain")]
+    if invalid_packages:
+        raise click.UsageError(
+            f"The following packages do not start with 'plain': {', '.join(invalid_packages)}\n"
+            "This command is only for Plain framework packages."
+        )
+
+    # Install all packages first
+    if len(packages) == 1:
+        click.secho(f"Installing {packages[0]}...", bold=True, err=True)
+    else:
+        click.secho(f"Installing {len(packages)} packages...", bold=True, err=True)
+        for pkg in packages:
+            click.secho(f"  - {pkg}", err=True)
+        click.echo(err=True)
+
+    install_cmd = ["uv", "add"] + list(packages)
+    result = subprocess.run(install_cmd, check=False, stderr=sys.stderr)
+
+    if result.returncode != 0:
+        raise click.ClickException("Failed to install packages")
+
+    click.echo(err=True)
+    if len(packages) == 1:
+        click.secho(f"✓ {packages[0]} installed successfully", fg="green", err=True)
+    else:
+        click.secho(
+            f"✓ {len(packages)} packages installed successfully", fg="green", err=True
+        )
+    click.echo(err=True)
+
+    # Build the prompt for the agent to complete setup
+    lines = [
+        f"Complete the setup for the following Plain packages that were just installed: {', '.join(packages)}",
+        "",
+        "## Instructions",
+        "",
+        "For each package:",
+        "1. Run `uv run plain docs <package>` and read the installation instructions",
+        "2. If the docs point out that it is a --dev tool, move it to the dev dependencies in pyproject.toml: `uv remove <package> && uv add <package> --dev`",
+        "3. Go through the installation instructions and complete any code modifications that are needed",
+        "",
+        "DO NOT commit any changes",
+        "",
+        "Report back with:",
+        "- Whether the setup completed successfully",
+        "- Any manual steps that the user will need to complete",
+        "- Any issues or errors encountered",
+    ]
+
+    prompt = "\n".join(lines)
+    success = prompt_agent(prompt, agent_command, print_only)
+    if not success:
+        raise click.Abort()

plain/cli/upgrade.py

@@ -0,0 +1,168 @@
+import subprocess
+import sys
+import tomllib
+from pathlib import Path
+
+import click
+
+from .agent import prompt_agent
+
+LOCK_FILE = Path("uv.lock")
+
+
+@click.command()
+@click.argument("packages", nargs=-1)
+@click.option(
+    "--diff", is_flag=True, help="Read versions from unstaged uv.lock changes"
+)
+@click.option(
+    "--agent-command",
+    envvar="PLAIN_AGENT_COMMAND",
+    help="Run command with generated prompt",
+)
+@click.option(
+    "--print",
+    "print_only",
+    is_flag=True,
+    help="Print the prompt without running the agent",
+)
+def upgrade(
+    packages: tuple[str, ...],
+    diff: bool,
+    agent_command: str | None = None,
+    print_only: bool = False,
+) -> None:
+    """Upgrade Plain packages with the help of an agent."""
+    if not packages:
+        click.secho("Getting installed packages...", bold=True, err=True)
+        packages = tuple(sorted(get_installed_plain_packages()))
+        for pkg in packages:
+            click.secho(f"- {click.style(pkg, fg='yellow')}", err=True)
+        click.echo(err=True)
+
+    if not packages:
+        raise click.UsageError("No plain packages found or specified.")
+
+    if diff:
+        before_after = versions_from_diff(packages)
+    else:
+        before_after = upgrade_packages(packages)
+
+    # Remove all packages that were not upgraded
+    before_after = {
+        pkg: versions
+        for pkg, versions in before_after.items()
+        if versions[0] != versions[1]
+    }
+
+    if not before_after:
+        click.secho(
+            "No packages were upgraded. If uv.lock has already been updated, use --diff instead.",
+            fg="green",
+            err=True,
+        )
+        return
+
+    prompt = build_prompt(before_after)
+    success = prompt_agent(prompt, agent_command, print_only)
+    if not success:
+        raise click.Abort()
+
+
+def get_installed_plain_packages() -> list[str]:
+    lock_text = LOCK_FILE.read_text()
+    data = tomllib.loads(lock_text)
+    names: list[str] = []
+    for pkg in data.get("package", []):
+        name = pkg.get("name", "")
+        if name.startswith("plain") and name != "plain-upgrade":
+            names.append(name)
+    return names
+
+
+def parse_lock_versions(lock_text: str, packages: set[str]) -> dict[str, str]:
+    data = tomllib.loads(lock_text)
+    versions: dict[str, str] = {}
+    for pkg in data.get("package", []):
+        name = pkg.get("name")
+        if name in packages:
+            versions[name] = pkg.get("version")
+    return versions
+
+
+def versions_from_diff(
+    packages: tuple[str, ...],
+) -> dict[str, tuple[str | None, str | None]]:
+    result = subprocess.run(
+        ["git", "status", "--porcelain", str(LOCK_FILE)], capture_output=True, text=True
+    )
+    if not result.stdout.strip():
+        raise click.UsageError(
+            "--diff specified but uv.lock has no uncommitted changes"
+        )
+
+    prev_text = subprocess.run(
+        ["git", "show", f"HEAD:{LOCK_FILE}"], capture_output=True, text=True, check=True
+    ).stdout
+    current_text = LOCK_FILE.read_text()
+
+    packages_set = set(packages)
+    before = parse_lock_versions(prev_text, packages_set)
+    after = parse_lock_versions(current_text, packages_set)
+
+    return {pkg: (before.get(pkg), after.get(pkg)) for pkg in packages}
+
+
+def upgrade_packages(
+    packages: tuple[str, ...],
+) -> dict[str, tuple[str | None, str | None]]:
+    before = parse_lock_versions(LOCK_FILE.read_text(), set(packages))
+
+    upgrade_args = ["uv", "sync"]
+    for pkg in packages:
+        upgrade_args.extend(["--upgrade-package", pkg])
+
+    click.secho("Upgrading with uv sync...", bold=True, err=True)
+    subprocess.run(upgrade_args, check=True, stdout=sys.stderr)
+    click.echo(err=True)
+
+    after = parse_lock_versions(LOCK_FILE.read_text(), set(packages))
+    return {pkg: (before.get(pkg), after.get(pkg)) for pkg in packages}
+
+
+def build_prompt(before_after: dict[str, tuple[str | None, str | None]]) -> str:
+    lines = [
+        "These packages have been updated and may require additional changes to the code:",
+        "",
+    ]
+    for pkg, (before, after) in before_after.items():
+        lines.append(f"- {pkg}: {before} -> {after}")
+
+    lines.extend(
+        [
+            "",
+            "## Instructions",
+            "",
+            "1. **Process each package systematically:**",
+            "   - For each package, run: `uv run plain-changelog {package} --from {before} --to {after}`",
+            "   - Read the 'Upgrade instructions' section carefully",
+            "   - If it says 'No changes required', skip to the next package",
+            "   - Apply any required code changes as specified",
+            "",
+            "2. **Important guidelines:**",
+            "   - Process ALL packages before testing or validation",
+            "   - After all packages are updated, run `uv run plain fix --unsafe-fixes` and `uv run plain pre-commit` to check results",
+            "   - DO NOT commit any changes",
+            "   - DO NOT run `plain migrate` with the `--no-backup` option",
+            "   - Keep code changes minimal and focused - avoid unnecessary comments",
+            "",
+            "3. **Available tools:**",
+            "   - Python shell: `uv run python`",
+            "",
+            "4. **Workflow:**",
+            "   - Review changelog for each package → Apply changes → Move to next package",
+            "   - Only after all packages: run pre-commit checks",
+            "   - Report any issues or conflicts encountered",
+        ]
+    )
+    return "\n".join(lines)

plain/csrf/README.md

@@ -2,7 +2,12 @@
 
 **Cross-Site Request Forgery (CSRF) protection.**
 
-Plain protects against [CSRF attacks](https://en.wikipedia.org/wiki/Cross-site_request_forgery) through a [middleware](middleware.py) that compares the generated `csrftoken` cookie with the CSRF token from the request (either `_csrftoken` in form data or the `CSRF-Token` header).
+- [Overview](#overview)
+- [Usage](#usage)
+
+## Overview
+
+Plain protects against [CSRF attacks](https://en.wikipedia.org/wiki/Cross-site_request_forgery) through a [middleware](./middleware.py#CsrfViewMiddleware) that compares the generated `csrftoken` cookie with the CSRF token from the request (either `_csrftoken` in form data or the `CSRF-Token` header).
 
 ## Usage
 

plain/forms/README.md

@@ -2,6 +2,10 @@
 
 **HTML form handling and validation.**
 
+- [Overview](#overview)
+
+## Overview
+
 The `Form` and `Field` classes help output, parse, and validate form data from an HTTP request. Unlike other frameworks, the HTML inputs are not rendered automatically, though there are some helpers for you to do your own rendering.
 
 With forms, you will typically use one of the built-in view classes to tie everything together.

plain/http/README.md

@@ -2,6 +2,10 @@
 
 **HTTP request and response handling.**
 
+- [Overview](#overview)
+
+## Overview
+
 Typically you will interact with [request](request.py#HttpRequest) and [response](response.py#ResponseBase) objects in your views and middleware.
 
 ```python

plain/logs/README.md

@@ -2,6 +2,13 @@
 
 **Logging configuration and utilities.**
 
+- [Overview](#overview)
+- [`app_logger`](#app_logger)
+- [`app_logger.kv`](#app_loggerkv)
+- [Logging settings](#logging-settings)
+
+## Overview
+
 In Python, configuring logging can be surprisingly complex. For most use cases, Plain provides a [default configuration](./configure.py) that "just works".
 
 By default, both the `plain` and `app` loggers are set to the `INFO` level. You can quickly change this by using the `PLAIN_LOG_LEVEL` and `APP_LOG_LEVEL` environment variables.

plain/packages/README.md

@@ -2,6 +2,13 @@
 
 **Install Python modules as Plain packages.**
 
+- [Overview](#overview)
+- [Creating app packages](#creating-app-packages)
+- [Package settings](#package-settings)
+- [Package `ready()` method](#package-ready-method)
+
+## Overview
+
 Most Python modules that you use with Plain will need to be installed via `settings.INSTALLED_PACKAGES`. This is what enables template detection, per-package settings, database models, and other features.
 
 A package can either be a local module inside of your `app`, or a third-party package from PyPI.

plain/preflight/README.md

@@ -2,6 +2,14 @@
 
 **System checks for Plain applications.**
 
+- [Overview](#overview)
+- [Development](#development)
+- [Deployment](#deployment)
+- [Custom preflight checks](#custom-preflight-checks)
+- [Silencing preflight checks](#silencing-preflight-checks)
+
+## Overview
+
 Preflight checks help identify issues with your settings or environment before running your application.
 
 ```bash

plain/runtime/README.md

@@ -2,6 +2,15 @@
 
 **Access app and package settings at runtime.**
 
+- [Overview](#overview)
+- [Environment variables](#environment-variables)
+    - [.env files](#env-files)
+- [Package settings](#package-settings)
+- [Custom app-wide settings](#custom-app-wide-settings)
+- [Using Plain in other environments](#using-plain-in-other-environments)
+
+## Overview
+
 Plain is configured by "settings", which are ultimately just Python variables. Most settings have default values which can be overidden either by your `app/settings.py` file or by environment variables.
 
 ```python

plain/signals/README.md

@@ -2,6 +2,10 @@
 
 **Run code when certain events happen.**
 
+- [Overview](#overview)
+
+## Overview
+
 ```python
 from plain.signals import request_finished
 

plain/templates/README.md

@@ -2,6 +2,13 @@
 
 **Render HTML templates using Jinja.**
 
+- [Overview](#overview)
+- [Template files](#template-files)
+- [Extending Jinja](#extending-jinja)
+- [Rendering templates manually](#rendering-templates-manually)
+
+## Overview
+
 Plain uses Jinja2 for template rendering. You can refer to the [Jinja documentation](https://jinja.palletsprojects.com/en/stable/api/) for all of the features available.
 
 In general, templates are used in combination with `TemplateView` or a more specific subclass of it.
@@ -37,7 +44,7 @@ All template directories are "merged" together, allowing you to override templat
 
 ## Extending Jinja
 
-Plain includes a set of default [global variables](jinja/globals.py) and [filters](jinja/filters.py). You can register additional extensions, globals, or filters either in a package or in your app. Typically this will be in `app/templates.py` or `<pkg>/templates.py`, which are automatically imported.
+Plain includes a set of default [global variables](./jinja/globals.py) and [filters](./jinja/filters.py). You can register additional extensions, globals, or filters either in a package or in your app. Typically this will be in `app/templates.py` or `<pkg>/templates.py`, which are automatically imported.
 
 ```python
 # app/templates.py
@@ -71,7 +78,7 @@ class HTMXJSExtension(InclusionTagExtension):
 
 ## Rendering templates manually
 
-Templates can also be rendered manually using the [`Template` class](core.py#Template).
+Templates can also be rendered manually using the [`Template` class](./core.py#Template).
 
 ```python
 from plain.templates import Template

plain/test/README.md

@@ -2,7 +2,11 @@
 
 **Testing utilities for Plain.**
 
-This module provides a the [`Client`](client.py#Client) and [`RequestFactory`](client.py#RequestFactory) classes to facilitate testing requests and responses.
+- [Overview](#overview)
+
+## Overview
+
+This module provides the [`Client`](client.py#Client) and [`RequestFactory`](client.py#RequestFactory) classes to facilitate testing requests and responses.
 
 ```python
 from plain.test import Client

plain/urls/README.md

@@ -2,6 +2,13 @@
 
 **Route requests to views.**
 
+- [Overview](#overview)
+- [Reversing URLs](#reversing-urls)
+- [URL args and kwargs](#url-args-and-kwargs)
+- [Package routers](#package-routers)
+
+## Overview
+
 URLs are typically the "entrypoint" to your app. Virtually all request handling up to this point happens behind the scenes, and then you decide how to route specific URL patterns to your views.
 
 The `URLS_ROUTER` is the primary router that handles all incoming requests. It is defined in your `app/settings.py` file. This will typically point to a `Router` class in your `app.urls` module.

plain/utils/README.md

@@ -1,5 +1,9 @@
-# Utilities
+# Utils
 
 **Various utilities for text manipulation, parsing, dates, and more.**
 
+- [Overview](#overview)
+
+## Overview
+
 The utilities aren't going to be documented in detail here. Take a look at the source code for more information.

plain/views/README.md

@@ -2,6 +2,19 @@
 
 **Take a request, return a response.**
 
+- [Overview](#overview)
+- [HTTP methods -> class methods](#http-methods---class-methods)
+- [Return types](#return-types)
+- [Template views](#template-views)
+- [Form views](#form-views)
+- [Object views](#object-views)
+- [Response exceptions](#response-exceptions)
+- [Error views](#error-views)
+- [Redirect views](#redirect-views)
+- [CSRF exempt views](#csrf-exempt-views)
+
+## Overview
+
 Plain views are written as classes,
 with a straightforward API that keeps simple views simple,
 but gives you the power of a full class to handle more complex cases.
@@ -17,7 +30,7 @@ class ExampleView(View):
 
 ## HTTP methods -> class methods
 
-The HTTP methd of the request will map to a class method of the same name on the view.
+The HTTP method of the request will map to a class method of the same name on the view.
 
 If a request comes in and there isn't a matching method on the view,
 Plain will return a `405 Method Not Allowed` response.
@@ -46,7 +59,7 @@ class ExampleView(View):
         pass
 ```
 
-The [base `View` class](./base.py) defines default `options` and `head` behavior,
+The [base `View` class](./base.py#View) defines default `options` and `head` behavior,
 but you can override these too.
 
 ## Return types
@@ -87,9 +100,9 @@ class ExampleView(TemplateView):
         return context
 ```
 
-The `TemplateView` is also the base class for _most_ of the other built-in view classes.
+The [`TemplateView`](./templates.py#TemplateView) is also the base class for _most_ of the other built-in view classes.
 
-Template views that don't need any custom context can use `TemplateView.as_view()` direcly in the URL route.
+Template views that don't need any custom context can use `TemplateView.as_view()` directly in the URL route.
 
 ```python
 from plain.views import TemplateView
@@ -104,7 +117,7 @@ class AppRouter(Router):
 
 ## Form views
 
-Standard [forms](../forms) can be rendered and processed by a `FormView`.
+Standard [forms](../forms) can be rendered and processed by a [`FormView`](./forms.py#FormView).
 
 ```python
 from plain.views import FormView
@@ -218,7 +231,7 @@ class ExampleListView(ListView):
 ## Response exceptions
 
 At any point in the request handling,
-a view can raise a `ResponseException` to immediately exit and return the wrapped response.
+a view can raise a [`ResponseException`](./exceptions.py#ResponseException) to immediately exit and return the wrapped response.
 
 This isn't always necessary, but can be useful for raising rate limits or authorization errors when you're a couple layers deep in the view handling or helper functions.
 

{plain-0.55.0.dist-info → plain-0.56.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.55.0
+Version: 0.56.1
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE

{plain-0.55.0.dist-info → plain-0.56.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-plain/CHANGELOG.md,sha256=oujiZ46-0jKAXDWTLLOvkKo5VP84iyJWoCgc1jVNjSs,5964
+plain/CHANGELOG.md,sha256=O3trliUx5vgGnIBDCSGO1laXxkCb7BXBIR61ZuXvP2M,7138
 plain/README.md,sha256=5BJyKhf0TDanWVbOQyZ3zsi5Lov9xk-LlJYCDWofM6Y,4078
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
 plain/debug.py,sha256=XdjnXcbPGsi0J2SpHGaLthhYU5AjhBlkHdemaP4sbYY,758
@@ -8,25 +8,27 @@ plain/paginator.py,sha256=iXiOyt2r_YwNrkqCRlaU7V-M_BKaaQ8XZElUBVa6yeU,5844
 plain/signing.py,sha256=r2KvCOxkrSWCULFxYa9BHYx3L3a2oLq8RDnq_92inTw,8207
 plain/validators.py,sha256=TePzFHzwR4JXUAZ_Y2vC6mkKgVxHX3QBXI6Oex0rV8c,19236
 plain/wsgi.py,sha256=R6k5FiAElvGDApEbMPTT0MPqSD7n2e2Az5chQqJZU0I,236
-plain/assets/README.md,sha256=8OW6y4rs0PqGvcbrndPJjOndcDUQUAgnO-Hj_PDHpWI,4151
+plain/assets/README.md,sha256=iRZHHoXZCEFooXoDYSomF12XTcDFl7oNbRHpAFwxTM8,4349
 plain/assets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/assets/compile.py,sha256=DT85ygnNcY2_7VeozdsQlBvA-DzV7enUIMO_igJ1PjY,3296
 plain/assets/finders.py,sha256=2k8QZAbfUbc1LykxbzdazTSB6xNxJZnsZaGhWbSFZZs,1452
 plain/assets/fingerprints.py,sha256=D-x0o49sUuWfx86BssDyo87yJCjWrV0go6JGPagvMAE,1365
 plain/assets/urls.py,sha256=zQUA8bAlh9qVqskPJJrqWd9DjvetOi5jPSqy4vUX0J4,1161
 plain/assets/views.py,sha256=T_0Qh6v9qBerEBYbhToigwOzsij-x1z_R-1zETQcIh0,9447
-plain/chores/README.md,sha256=Da8Nw8ZF7PlAE_iVb0AqJGbLOu0F6HC0cj1K451KBak,1946
+plain/chores/README.md,sha256=5tIKRLg2I4P-jnfoizRn4fxtqQrjFEimkJ2ckddiGRQ,2056
 plain/chores/__init__.py,sha256=r9TXtQCH-VbvfnIJ5F8FxgQC35GRWFOfmMZN3q9niLg,67
 plain/chores/registry.py,sha256=V3WjuekRI22LFvJbqSkUXQtiOtuE2ZK8gKV1TRvxRUI,1866
-plain/cli/README.md,sha256=GzBry6mEilhM80SfVUg02ydGwAk0m-s6FAqQR1nRsMM,2022
+plain/cli/README.md,sha256=5C7vsH0ISxu7q5H6buC25MBOILkI_rzdySitswpQgJw,1032
 plain/cli/__init__.py,sha256=6w9T7K2WrPwh6DcaMb2oNt_CWU6Bc57nUTO2Bt1p38Y,63
+plain/cli/agent.py,sha256=T3jG9hpbndiBsRYf_MhT3GvHrnpLjCh3tgi4pR6Ipmg,1477
 plain/cli/build.py,sha256=Lo6AYghJz0DM9fIVUSiBSOKa5vR0XCOxZWEjza6sc8Q,3172
 plain/cli/changelog.py,sha256=j-k1yZk9mpm-fLZgeWastiyIisxNSuAJfXTQ2B6WQmk,3457
 plain/cli/chores.py,sha256=xXSSFvr8T5jWfLWqe6E8YVMw1BkQxyOHHVuY0x9RH0A,2412
-plain/cli/core.py,sha256=D3t83ujjjHayblM-RuttrGoNf8hMV9-l3zQsbhVAjWU,2991
-plain/cli/docs.py,sha256=5-2_nQnInZAzHu3VnMW88gZyrhukhdjrkMKTMt0RRpI,7367
+plain/cli/core.py,sha256=HZZcDVNEMAhantDM4Hnug-SrwU3YgAq1-KDa3_a9-K0,3111
+plain/cli/docs.py,sha256=MjFIpNc0FsHACi_spPVumXM-oPCi__3U0Jqf41lqjQM,7481
 plain/cli/formatting.py,sha256=1hZH13y1qwHcU2K2_Na388nw9uvoeQH8LrWL-O9h8Yc,2207
 plain/cli/help.py,sha256=NefZSEIixrX_WELVSnJDHRpLDWf7_4PXmkkMm3Q2mzo,787
+plain/cli/install.py,sha256=wvEc3gLP5tvSb1Xwm2467DCXqCPTWxuzktGnlK94SGg,2784
 plain/cli/output.py,sha256=Fe3xS6Va4Bi1ZNrqi0nh09THTsdCyMW2b9SPY5I4n-o,1318
 plain/cli/preflight.py,sha256=8tHBD4L4nPLUKThfaYx3SUZSJzC48oV2m_Hbn6W4ODc,4124
 plain/cli/print.py,sha256=XraUYrgODOJquIiEv78wSCYGRBplHXtXSS9QtFG5hqY,217
@@ -35,18 +37,19 @@ plain/cli/scaffold.py,sha256=mcywA9DzfwoBSqWl5-Zpgcy1mTNUGEgdvoxXUrGcEVk,1351
 plain/cli/settings.py,sha256=9cx4bue664I2P7kUedlf4YhCPB0tSKSE4Q8mGyzEv2o,1995
 plain/cli/shell.py,sha256=iIwvlTdTBjLBBUdXMAmIRWSoynszOZI79-mrBg4RegU,1373
 plain/cli/startup.py,sha256=wLaFuyUb4ewWhtehBCGicrRCXIIGCRbeCT3ce9hUv-A,1022
+plain/cli/upgrade.py,sha256=f1rL9M285i4D5UKlEk4ijmAUN3mAMfHCrbDPwBf1ePo,5514
 plain/cli/urls.py,sha256=ghCW36aRszxmTo06A50FIvYopb6kQ07QekkDzM6_A1o,3824
 plain/cli/utils.py,sha256=VwlIh0z7XxzVV8I3qM2kZo07fkJFPoeeVZa1ODG616k,258
-plain/csrf/README.md,sha256=nxCpPk1HF5eAM-7paxg9D-9RVCU9jXsSPAVHkJvA_DU,717
+plain/csrf/README.md,sha256=cTqQ9oOa3BcMRhMPzqhI2wat1ZOS7aQwJTIFArdMTsk,794
 plain/csrf/middleware.py,sha256=U3B9R7ciO_UAf7O3jdNtVu6QZ_3Yrm8isRdnW6bVKX4,17401
 plain/csrf/views.py,sha256=HwQqfI6KPelHP9gSXhjfZaTLQic71PKsoZ6DPhr1rKI,572
-plain/forms/README.md,sha256=TawBdy1jP0-8HUsfUzd7vvgkwl3EJGejDxFhWR8F-80,2242
+plain/forms/README.md,sha256=SeqRBAPynu-aNR8FPXesOIjPuUi4X1pT_ZlDK4bD7UA,2280
 plain/forms/__init__.py,sha256=UxqPwB8CiYPCQdHmUc59jadqaXqDmXBH8y4bt9vTPms,226
 plain/forms/boundfield.py,sha256=LhydhCVR0okrli0-QBMjGjAJ8-06gTCXVEaBZhBouQk,1741
 plain/forms/exceptions.py,sha256=NYk1wjYDkk-lA_XMJQDItOebQcL_m_r2eNRc2mkLQkg,315
 plain/forms/fields.py,sha256=OyL4eZIgJ_XMLPHGar17hLepFmwHV-hSnb_n7s18yUU,34709
 plain/forms/forms.py,sha256=hF7Dl8rEaiBTZhFQyfbh1Zf54BSEka8RYpBiGqkTa8I,10441
-plain/http/README.md,sha256=F9wbahgSU3jIDEG14gJjdPJRem4weUNvwnwhb7o3cu0,722
+plain/http/README.md,sha256=hkjTJJ2_WEGm7vaIxjjNHrzD6EN5VI6pjDJPIR9l1jo,760
 plain/http/__init__.py,sha256=DIsDRbBsCGa4qZgq-fUuQS0kkxfbTU_3KpIM9VvH04w,1067
 plain/http/cookie.py,sha256=THd7nOl-2ugeBPKgOhbD87aM2oxUbNH8HWrarUn0fpM,1955
 plain/http/multipartparser.py,sha256=Z1dFJNAd8N5RHUuF67jh1jBfZOFepORsre_3ee6CgOQ,27266
@@ -69,32 +72,32 @@ plain/internal/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 plain/internal/middleware/headers.py,sha256=ENIW1Gwat54hv-ejgp2R8QTZm-PlaI7k44WU01YQrNk,964
 plain/internal/middleware/https.py,sha256=XpuQK8HicYX1jNanQHqNgyQ9rqe4NLUOZO3ZzKdsP8k,1203
 plain/internal/middleware/slash.py,sha256=FMU8b9w0NSx4eJs9Y7Ew6RAoSTbUqe2oOM68kg3wOng,2817
-plain/logs/README.md,sha256=wXqqAQym4g6hUiJOothj-t0RacZLf2-o9JskoZhsehA,1276
+plain/logs/README.md,sha256=ON6Zylg_WA_V7QiIbRY7sgsl2nfG7KFzIbxK2x3rPuc,1419
 plain/logs/__init__.py,sha256=rASvo4qFBDIHfkACmGLNGa6lRGbG9PbNjW6FmBt95ys,168
 plain/logs/configure.py,sha256=2kDJ-WPv3PV4H46mz5tTfzIa2kvN6cjVlb3t-AEbMyk,1307
 plain/logs/loggers.py,sha256=iz9SYcwP9w5QAuwpULl48SFkVyJuuMoQ_fdLgdCHpNg,2121
 plain/logs/utils.py,sha256=9UzdCCQXJinGDs71Ngw297mlWkhgZStSd67ya4NOW98,1257
-plain/packages/README.md,sha256=nU2GcoCGmzmVOYRIeF8hp40aza0FF1ckvGqD5jIxocs,2494
+plain/packages/README.md,sha256=iNqMtwFDVNf2TqKUzLKQW5Y4_GsssmdB4cVerzu27Ro,2674
 plain/packages/__init__.py,sha256=OpQny0xLplPdPpozVUUkrW2gB-IIYyDT1b4zMzOcCC4,160
 plain/packages/config.py,sha256=2U7b1cp_kqIuLdSeHGCLrSUV77TdfGRsww3PcXOazaA,2910
 plain/packages/registry.py,sha256=6ogeHZ8t3kBSoLoI7998r0kIbkEPhLGn-7yi-1qVjVo,7969
-plain/preflight/README.md,sha256=9fE0Ql2JNd3CI420eg1sP_xmaim-6Ejlzi_hfk3tVS0,1511
+plain/preflight/README.md,sha256=Ae7ujHmsJhTpRGX0pghBwGD2CG7SIxngenyb5CSbc2M,1721
 plain/preflight/__init__.py,sha256=j4-yPnrM5hmjumrdkBLOQjFHzRHpA6wCjiFpMNBjIqY,619
 plain/preflight/files.py,sha256=D_pBSwRXpXy2-3FWywweozuxrhIaR8w5hpPA2d6XMPs,522
 plain/preflight/messages.py,sha256=B6VyXzu7HTJHaPVK4G1L_1HVHG87CT7JPtcDk8QYSeE,2322
 plain/preflight/registry.py,sha256=vcqzaE1MIneNL_ydKPy_1zrSThnzsrWARSClLCJ-4b8,2331
 plain/preflight/security.py,sha256=oxUZBp2M0bpBfUoLYepIxoex2Y90nyjlrL8XU8UTHYY,2438
 plain/preflight/urls.py,sha256=cQ-WnFa_5oztpKdtwhuIGb7pXEml__bHsjs1SWO2YNI,1468
-plain/runtime/README.md,sha256=1h30eRTg5-lY-G7GF_4TdUiUcOLVzKR15mSrmyeU8eI,4584
+plain/runtime/README.md,sha256=sTqXXJkckwqkk9O06XMMSNRokAYjrZBnB50JD36BsYI,4873
 plain/runtime/__init__.py,sha256=8GtvKROf3HUCtneDYXTbEioPcCtwnV76dP57n2PnjuE,2343
 plain/runtime/global_settings.py,sha256=MpJ6vtBMO2EYALaKXrtgcGoxLh9Y549zwwErC5D5K7I,5343
 plain/runtime/user_settings.py,sha256=OzMiEkE6ZQ50nxd1WIqirXPiNuMAQULklYHEzgzLWgA,11027
-plain/signals/README.md,sha256=FInfJXdVQkb7u93PvD8XgPbz_f6m0l2xIu_4PyttV1E,234
+plain/signals/README.md,sha256=XefXqROlDhzw7Z5l_nx6Mhq6n9jjQ-ECGbH0vvhKWYg,272
 plain/signals/__init__.py,sha256=eAs0kLqptuP6I31dWXeAqRNji3svplpAV4Ez6ktjwXM,131
 plain/signals/dispatch/__init__.py,sha256=FzEygqV9HsM6gopio7O2Oh_X230nA4d5Q9s0sUjMq0E,292
 plain/signals/dispatch/dispatcher.py,sha256=VxSlqn9PCOTghPPJLOqZPs6FNQZfV2BJpMfFMSg6Dtc,11531
 plain/signals/dispatch/license.txt,sha256=o9EhDhsC4Q5HbmD-IfNGVTEkXtNE33r5rIt3lleJ8gc,1727
-plain/templates/README.md,sha256=G43IdTRJX6mfxsExUTQf9QAwPeHLsDgY7PvKXdx4l6g,2432
+plain/templates/README.md,sha256=3eCnQvgLNAnbJENxCWevtiwVpop3_sfJMBWUVGQP2qQ,2614
 plain/templates/__init__.py,sha256=bX76FakE9T7mfK3N0deN85HlwHNQpeigytSC9Z8LcOs,451
 plain/templates/core.py,sha256=mbcH0yTeFOI3XOg9dYSroXRIcdv9sETEy4HzY-ugwco,1258
 plain/templates/jinja/__init__.py,sha256=xvYif0feMYR9pWjN0czthq2dk3qI4D5UQjgj9yp4dNA,2776
@@ -102,12 +105,12 @@ plain/templates/jinja/environments.py,sha256=9plifzvQj--aTN1cCpJ2WdzQxZJpzB8S_4h
 plain/templates/jinja/extensions.py,sha256=AEmmmHDbdRW8fhjYDzq9eSSNbp9WHsXenD8tPthjc0s,1351
 plain/templates/jinja/filters.py,sha256=ft5XUr4OLeQayn-MSxrycpFLyyN_yEo7j5WhWMwpTOs,1445
 plain/templates/jinja/globals.py,sha256=VMpuMZvwWOmb5MbzKK-ox-QEX_WSsXFxq0mm8biJgaU,558
-plain/test/README.md,sha256=fv4YzziU2QxgcNHSgv7aDUO45sDOofVuCNrV1NPbWzo,1106
+plain/test/README.md,sha256=wem0myAd-ij74nNV1MB9g4iH6FZUgii7-_euRq45oHs,1142
 plain/test/__init__.py,sha256=MhNHtp7MYBl9kq-pMRGY11kJ6kU1I6vOkjNkit1TYRg,94
 plain/test/client.py,sha256=XjLjkeDl1rQRaFoeiCvvD5GXfxIxpuic2OnxjoX05tA,25573
 plain/test/encoding.py,sha256=YJBOIE-BQRA5yl4zHnQy-9l67mJDTFmfy1DQXK0Wk-Q,3199
 plain/test/exceptions.py,sha256=b-GHicg87Gh73W3g8QGWuSHi9PrQFVsxgWvEXDLt8gQ,290
-plain/urls/README.md,sha256=ijFGmrkUY9buBqO_i1GZaN3V55vl9xwEADtHOx_ZHPY,3724
+plain/urls/README.md,sha256=026RkCK6I0GdqK3RE2QBLcCLIsiwtyKxgI2F0KBX95E,3882
 plain/urls/__init__.py,sha256=DFO2OL1IllHW5USPIb5uYvvzf_G-Bl0Qu1zrRLHmWyM,542
 plain/urls/converters.py,sha256=s2JZVOdzZC16lgobsI93hygcdH5L0Kj4742WEkXsVcs,1193
 plain/urls/exceptions.py,sha256=q4iPh3Aa-zHbA-tw8v6WyX1J1n5WdAady2xvxFuyXB0,114
@@ -115,7 +118,7 @@ plain/urls/patterns.py,sha256=FPWzh2vStzrCqQDkXxjbA58_OMbomOIuYgEOKaEW924,8259
 plain/urls/resolvers.py,sha256=sZsFQRPlPkogXIVSctZBXJaG0spJzuoJBmtOEZwIXXY,12630
 plain/urls/routers.py,sha256=B1fX-FQTxmr-b_YeHQUMPuilLVqOi6-RqgPgu6MtFDY,2831
 plain/urls/utils.py,sha256=lKxTX_A3XJpIH7FjlNYju108stY6-8Sw2uVdiSsxOKQ,1249
-plain/utils/README.md,sha256=hRRkcg4CxMX-zz8d4Bn6V2uJr_VKgTLurc1jY7QlEx8,198
+plain/utils/README.md,sha256=3RTH9t4SBLkYLMlnhpWwp72IjgQhOjYYxpT1gHwRUdE,232
 plain/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/utils/cache.py,sha256=iuvOTIfI1s857iVOAPNLK5lkzlrl0fIiBYaiUXWQu40,5303
 plain/utils/crypto.py,sha256=zFDydnaqNMGYFHUc-CAn8f93685a17BhGusAcITH1lI,2662
@@ -139,7 +142,7 @@ plain/utils/text.py,sha256=42hJv06sadbWfsaAHNhqCQaP1W9qZ69trWDTS-Xva7k,9496
 plain/utils/timesince.py,sha256=a_-ZoPK_s3Pt998CW4rWp0clZ1XyK2x04hCqak2giII,5928
 plain/utils/timezone.py,sha256=6u0sE-9RVp0_OCe0Y1KiYYQoq5THWLokZFQYY8jf78g,6221
 plain/utils/tree.py,sha256=wdWzmfsgc26YDF2wxhAY3yVxXTixQYqYDKE9mL3L3ZY,4383
-plain/views/README.md,sha256=iMr_rvag63L0M6rDDHzXEF1dGl5eUQj_0vHwrsgKwgU,6762
+plain/views/README.md,sha256=wKwC6pgxUyIZdCZq5roPpzbGa0Y-tR7mPifr5z659Uk,7245
 plain/views/__init__.py,sha256=a-N1nkklVohJTtz0yD1MMaS0g66HviEjsKydNVVjvVc,392
 plain/views/base.py,sha256=CC9UvMZeAjVvi90vGjoZzsQ0jnhbg3-7qCKQ8-Pb6cg,4184
 plain/views/csrf.py,sha256=7q6l5xzLWhRnMY64aNj0hR6G-3pxI2yhRwG6k_5j00E,144
@@ -149,8 +152,8 @@ plain/views/forms.py,sha256=ESZOXuo6IeYixp1RZvPb94KplkowRiwO2eGJCM6zJI0,2400
 plain/views/objects.py,sha256=GGbcfg_9fPZ-PiaBwIHG2e__8GfWDR7JQtQ15wTyiHg,5970
 plain/views/redirect.py,sha256=daq2cQIkdDF78bt43sjuZxRAyJm_t_SKw6tyPmiXPIc,1985
 plain/views/templates.py,sha256=ivkI7LU7BXDQ0d4Geab96Is4-Cp03KbIntXRT1J8e6I,2139
-plain-0.55.0.dist-info/METADATA,sha256=oJV0didL8vjsiZzSYn0FYfA6XNxvyOSaUaL6JXCFujI,4488
-plain-0.55.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain-0.55.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
-plain-0.55.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain-0.55.0.dist-info/RECORD,,
+plain-0.56.1.dist-info/METADATA,sha256=TY8h0a3RgKZAXhZng4sMKuleTRc57MZopCufA_3wJOY,4488
+plain-0.56.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.56.1.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
+plain-0.56.1.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.56.1.dist-info/RECORD,,