plain 0.56.0__py3-none-any.whl → 0.57.0__py3-none-any.whl

plain/CHANGELOG.md

@@ -1,5 +1,30 @@
 # plain changelog
 
+## [0.57.0](https://github.com/dropseed/plain/releases/plain@0.57.0) (2025-08-15)
+
+### What's changed
+
+- The `ResponsePermanentRedirect` class has been removed; use `ResponseRedirect` with `status_code=301` instead ([d5735ea](https://github.com/dropseed/plain/commit/d5735ea4f8))
+- The `RedirectView.permanent` attribute has been replaced with `status_code` for more flexible redirect status codes ([12dda16](https://github.com/dropseed/plain/commit/12dda16731))
+- Updated `RedirectView` initialization parameters: `url_name` replaces `pattern_name`, `preserve_query_params` replaces `query_string`, and removed 410 Gone functionality ([3b9ca71](https://github.com/dropseed/plain/commit/3b9ca713bf))
+
+### Upgrade instructions
+
+- Replace `ResponsePermanentRedirect` imports with `ResponseRedirect` and pass `status_code=301` to the constructor
+- Update `RedirectView` subclasses to use `status_code=301` instead of `permanent=True`
+- Replace `pattern_name` with `url_name` in RedirectView usage
+- Replace `query_string=True` with `preserve_query_params=True` in RedirectView usage
+
+## [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

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/install.py

@@ -64,14 +64,15 @@ def install(
         "## Instructions",
         "",
         "For each package:",
-        "1. Run `uv run plain docs <package>` and follow any setup instructions",
-        "2. If the docs point out that it is a --dev tool, move it to dev dependencies: `uv remove <package> && uv add <package> --dev`",
+        "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 still need to be completed",
+        "- Any manual steps that the user will need to complete",
         "- Any issues or errors encountered",
     ]
 

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/exceptions.py

@@ -53,12 +53,6 @@ class DisallowedHost(SuspiciousOperation):
     pass
 
 
-class DisallowedRedirect(SuspiciousOperation):
-    """Redirect to scheme not in allowed list"""
-
-    pass
-
-
 class TooManyFieldsSent(SuspiciousOperation):
     """
     The number of fields in a GET or POST request exceeded

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/http/__init__.py

@@ -19,7 +19,6 @@ from plain.http.response import (
     ResponseNotAllowed,
     ResponseNotFound,
     ResponseNotModified,
-    ResponsePermanentRedirect,
     ResponseRedirect,
     ResponseServerError,
     StreamingResponse,
@@ -36,7 +35,6 @@ __all__ = [
     "ResponseBase",
     "StreamingResponse",
     "ResponseRedirect",
-    "ResponsePermanentRedirect",
     "ResponseNotModified",
     "ResponseBadRequest",
     "ResponseForbidden",

plain/http/response.py

@@ -10,10 +10,8 @@ from email.header import Header
 from functools import cached_property
 from http.client import responses
 from http.cookies import SimpleCookie
-from urllib.parse import urlparse
 
 from plain import signals
-from plain.exceptions import DisallowedRedirect
 from plain.http.cookie import sign_cookie_value
 from plain.json import PlainJSONEncoder
 from plain.runtime import settings
@@ -566,19 +564,18 @@ class FileResponse(StreamingResponse):
             self.headers["Content-Disposition"] = content_disposition
 
 
-class ResponseRedirectBase(Response):
-    allowed_schemes = ["http", "https", "ftp"]
+class ResponseRedirect(Response):
+    """HTTP redirect response"""
+
+    status_code = 302
 
     def __init__(self, redirect_to, **kwargs):
         super().__init__(**kwargs)
         self.headers["Location"] = iri_to_uri(redirect_to)
-        parsed = urlparse(str(redirect_to))
-        if parsed.scheme and parsed.scheme not in self.allowed_schemes:
-            raise DisallowedRedirect(
-                f"Unsafe redirect to URL with protocol '{parsed.scheme}'"
-            )
 
-    url = property(lambda self: self.headers["Location"])
+    @property
+    def url(self):
+        return self.headers["Location"]
 
     def __repr__(self):
         return (
@@ -592,18 +589,6 @@ class ResponseRedirectBase(Response):
         )
 
 
-class ResponseRedirect(ResponseRedirectBase):
-    """HTTP 302 response"""
-
-    status_code = 302
-
-
-class ResponsePermanentRedirect(ResponseRedirectBase):
-    """HTTP 301 response"""
-
-    status_code = 301
-
-
 class ResponseNotModified(Response):
     """HTTP 304 response"""
 

plain/internal/middleware/https.py

@@ -1,6 +1,6 @@
 import re
 
-from plain.http import ResponsePermanentRedirect
+from plain.http import ResponseRedirect
 from plain.runtime import settings
 
 
@@ -33,4 +33,6 @@ class HttpsRedirectMiddleware:
             and not any(pattern.search(path) for pattern in self.https_redirect_exempt)
         ):
             host = self.https_redirect_host or request.get_host()
-            return ResponsePermanentRedirect(f"https://{host}{request.get_full_path()}")
+            return ResponseRedirect(
+                f"https://{host}{request.get_full_path()}", status_code=301
+            )

plain/internal/middleware/slash.py

@@ -1,4 +1,4 @@
-from plain.http import ResponsePermanentRedirect
+from plain.http import ResponseRedirect
 from plain.runtime import settings
 from plain.urls import Resolver404, get_resolver
 from plain.utils.http import escape_leading_slashes
@@ -22,7 +22,9 @@ class RedirectSlashMiddleware:
         # If the given URL is "Not Found", then check if we should redirect to
         # a path with a slash appended.
         if response.status_code == 404 and self.should_redirect_with_slash(request):
-            return ResponsePermanentRedirect(self.get_full_path_with_slash(request))
+            return ResponseRedirect(
+                self.get_full_path_with_slash(request), status_code=301
+            )
 
         return response
 

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/views/redirect.py

@@ -1,29 +1,29 @@
-import logging
-
-from plain.http import (
-    ResponseGone,
-    ResponsePermanentRedirect,
-    ResponseRedirect,
-)
+from plain.http import ResponseRedirect
 from plain.urls import reverse
 
 from .base import View
 
-logger = logging.getLogger("plain.request")
-
 
 class RedirectView(View):
     """Provide a redirect on any GET request."""
 
-    permanent = False
+    status_code = 302
     url: str | None = None
-    pattern_name: str | None = None
-    query_string = False
+    url_name: str | None = None
+    preserve_query_params = False
 
-    def __init__(self, url=None, permanent=None):
-        # Allow url and permanent to be set in RedirectView.as_view(url="...", permanent=True)
+    def __init__(
+        self, url=None, status_code=None, url_name=None, preserve_query_params=None
+    ):
+        # Allow attributes to be set in RedirectView.as_view(url="...", status_code=301, etc.)
         self.url = url or self.url
-        self.permanent = permanent if permanent is not None else self.permanent
+        self.status_code = status_code if status_code is not None else self.status_code
+        self.url_name = url_name or self.url_name
+        self.preserve_query_params = (
+            preserve_query_params
+            if preserve_query_params is not None
+            else self.preserve_query_params
+        )
 
     def get_redirect_url(self):
         """
@@ -33,30 +33,19 @@ class RedirectView(View):
         """
         if self.url:
             url = self.url % self.url_kwargs
-        elif self.pattern_name:
-            url = reverse(self.pattern_name, *self.url_args, **self.url_kwargs)
+        elif self.url_name:
+            url = reverse(self.url_name, *self.url_args, **self.url_kwargs)
         else:
-            return None
+            raise ValueError("RedirectView requires either url or url_name to be set")
 
         args = self.request.meta.get("QUERY_STRING", "")
-        if args and self.query_string:
+        if args and self.preserve_query_params:
             url = f"{url}?{args}"
         return url
 
     def get(self):
         url = self.get_redirect_url()
-        if url:
-            if self.permanent:
-                return ResponsePermanentRedirect(url)
-            else:
-                return ResponseRedirect(url)
-        else:
-            logger.warning(
-                "Gone: %s",
-                self.request.path,
-                extra={"status_code": 410, "request": self.request},
-            )
-            return ResponseGone()
+        return ResponseRedirect(url, status_code=self.status_code)
 
     def head(self):
         return self.get()

{plain-0.56.0.dist-info → plain-0.57.0.dist-info}/METADATA

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

{plain-0.56.0.dist-info → plain-0.57.0.dist-info}/RECORD

@@ -1,24 +1,24 @@
-plain/CHANGELOG.md,sha256=dmnqSRfQaYy37mP_cro0A_Z0FFT8XFwk441-ufnNqSk,6813
+plain/CHANGELOG.md,sha256=S6LqQuC4QwAYLG_Txkz7OyIT8FgyIFXD_3fX6WP7w3I,8219
 plain/README.md,sha256=5BJyKhf0TDanWVbOQyZ3zsi5Lov9xk-LlJYCDWofM6Y,4078
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
 plain/debug.py,sha256=XdjnXcbPGsi0J2SpHGaLthhYU5AjhBlkHdemaP4sbYY,758
-plain/exceptions.py,sha256=Z9cbPE5im_Y-bjVq8cqC85gBoqOr80rLFG5wTKixrwE,5894
+plain/exceptions.py,sha256=bx2_d1udQrGfw-F_k5GmXatgW1ecWSsWnX6jBoD0CH8,5786
 plain/json.py,sha256=McJdsbMT1sYwkGRG--f2NSZz0hVXPMix9x3nKaaak2o,1262
 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
@@ -28,7 +28,7 @@ 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=k-iR093N_jOKZdWW0qhcb_NAjQUxKdjajlZ2XBIRwM8,2646
+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
@@ -40,21 +40,21 @@ 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/__init__.py,sha256=DIsDRbBsCGa4qZgq-fUuQS0kkxfbTU_3KpIM9VvH04w,1067
+plain/http/README.md,sha256=hkjTJJ2_WEGm7vaIxjjNHrzD6EN5VI6pjDJPIR9l1jo,760
+plain/http/__init__.py,sha256=PfmXBIq7onLO_bbOrVdj5rJeHxqJMYqrIobVKupUzUA,1003
 plain/http/cookie.py,sha256=THd7nOl-2ugeBPKgOhbD87aM2oxUbNH8HWrarUn0fpM,1955
 plain/http/multipartparser.py,sha256=Z1dFJNAd8N5RHUuF67jh1jBfZOFepORsre_3ee6CgOQ,27266
 plain/http/request.py,sha256=93b2gqkfEsBczUyP_9vlueVoxyzzfbnJ423PDAk8aHc,26103
-plain/http/response.py,sha256=0xUhkTiT6JwohdwA7ymY2vpdCQVl4hnEExjk01LrJbg,23734
+plain/http/response.py,sha256=FM3otFkKEEkAaV_pVB3JUSMhMk7x_zf5JcDWKhOKviM,23223
 plain/internal/__init__.py,sha256=fVBaYLCXEQc-7riHMSlw3vMTTuF7-0Bj2I8aGzv0o0w,171
 plain/internal/files/__init__.py,sha256=VctFgox4Q1AWF3klPaoCC5GIw5KeLafYjY5JmN8mAVw,63
 plain/internal/files/base.py,sha256=2z19tik2_xgXlI6nfVZ4woSF9WB0RSUzsvOfi1Bz8Wg,4113
@@ -70,34 +70,34 @@ plain/internal/handlers/exception.py,sha256=vfha_6-fz6S6VYCP1PMBfue2Gw-_th6jqaTE
 plain/internal/handlers/wsgi.py,sha256=dgPT29t_F9llB-c5RYU3SHxGuZNaZ83xRjOfuOmtOl8,8209
 plain/internal/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 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/internal/middleware/https.py,sha256=HcOEWOpoblrFGbrsNOtAj8aEK1sgWbKcPqwEJoDw0no,1232
+plain/internal/middleware/slash.py,sha256=JWcIfGbXEKH00I7STq1AMdHhFGmQHC8lkKENa6280ko,2846
+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
@@ -105,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
@@ -118,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
@@ -142,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
@@ -150,10 +150,10 @@ plain/views/errors.py,sha256=jbNCJIzowwCsEvqyJ3opMeZpPDqTyhtrbqb0VnAm2HE,1263
 plain/views/exceptions.py,sha256=b4euI49ZUKS9O8AGAcFfiDpstzkRAuuj_uYQXzWNHME,138
 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/redirect.py,sha256=Xpb3cB7nZYvKgkNqcAxf9Jwm2SWcQ0u2xz4oO5M3vP8,1909
 plain/views/templates.py,sha256=ivkI7LU7BXDQ0d4Geab96Is4-Cp03KbIntXRT1J8e6I,2139
-plain-0.56.0.dist-info/METADATA,sha256=OwAwfG-QBAodVhao1ISXlTC1d-mpaCfrNXPJ05X8qcE,4488
-plain-0.56.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain-0.56.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
-plain-0.56.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain-0.56.0.dist-info/RECORD,,
+plain-0.57.0.dist-info/METADATA,sha256=9lvnS7TXZ1hqmYFkuMUTtafl0v4nmaTTdI0zh9-4kPU,4488
+plain-0.57.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.57.0.dist-info/entry_points.txt,sha256=nn4uKTRRZuEKOJv3810s3jtSMW0Gew7XDYiKIvBRR6M,93
+plain-0.57.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.57.0.dist-info/RECORD,,