plain 0.33.0__py3-none-any.whl → 0.34.1__py3-none-any.whl

plain/README.md

@@ -29,7 +29,7 @@ The `plain` package includes everything you need to start handling web requests
 
 - [plain.models](/plain-models/README.md) - Define and interact with your database models.
 - [plain.cache](/plain-cache/README.md) - A database-driven general purpose cache.
-- [plain.mail](/plain-mail/README.md) - Send emails with SMTP or custom backends.
+- [plain.email](/plain-email/README.md) - Send emails with SMTP or custom backends.
 - [plain.sessions](/plain-sessions/README.md) - User sessions and cookies.
 - [plain.worker](/plain-worker/README.md) - Backgrounb jobs stored in the database.
 - [plain.api](/plain-api/README.md) - Build APIs with Plain views.

plain/internal/handlers/exception.py

@@ -45,10 +45,14 @@ def convert_exception_to_response(get_response):
 
 def response_for_exception(request, exc):
     if isinstance(exc, Http404):
-        response = get_exception_response(request, 404)
+        response = get_exception_response(
+            request=request, status_code=404, exception=None
+        )
 
     elif isinstance(exc, PermissionDenied):
-        response = get_exception_response(request, 403)
+        response = get_exception_response(
+            request=request, status_code=403, exception=exc
+        )
         log_response(
             "Forbidden (Permission denied): %s",
             request.path,
@@ -58,7 +62,9 @@ def response_for_exception(request, exc):
         )
 
     elif isinstance(exc, MultiPartParserError):
-        response = get_exception_response(request, 400)
+        response = get_exception_response(
+            request=request, status_code=400, exception=None
+        )
         log_response(
             "Bad request (Unable to parse request body): %s",
             request.path,
@@ -68,7 +74,9 @@ def response_for_exception(request, exc):
         )
 
     elif isinstance(exc, BadRequest):
-        response = get_exception_response(request, 400)
+        response = get_exception_response(
+            request=request, status_code=400, exception=exc
+        )
         log_response(
             "%s: %s",
             str(exc),
@@ -91,11 +99,15 @@ def response_for_exception(request, exc):
             exc_info=exc,
             extra={"status_code": 400, "request": request},
         )
-        response = get_exception_response(request, 400)
+        response = get_exception_response(
+            request=request, status_code=400, exception=None
+        )
 
     else:
         signals.got_request_exception.send(sender=None, request=request)
-        response = get_exception_response(request, 500)
+        response = get_exception_response(
+            request=request, status_code=500, exception=None
+        )
         log_response(
             "%s: %s",
             response.reason_phrase,
@@ -105,34 +117,25 @@ def response_for_exception(request, exc):
             exception=exc,
         )
 
-    # Force a TemplateResponse to be rendered.
-    if not getattr(response, "is_rendered", True) and callable(
-        getattr(response, "render", None)
-    ):
-        response = response.render()
-
     return response
 
 
-def get_exception_response(request, status_code):
+def get_exception_response(*, request, status_code, exception):
     try:
-        return get_error_view(status_code)(request)
+        view_class = get_error_view(status_code=status_code, exception=exception)
+        return view_class(request)
     except Exception:
         signals.got_request_exception.send(sender=None, request=request)
-        return handle_uncaught_exception()
 
+        # In development mode, re-raise the exception to get a full stack trace
+        if settings.DEBUG:
+            raise
 
-def handle_uncaught_exception():
-    """
-    Processing for any otherwise uncaught exceptions (those that will
-    generate HTTP 500 responses).
-    """
-    if settings.DEBUG:
-        raise
-    return ResponseServerError()
+        # If we can't load the view, return a 500 response
+        return ResponseServerError()
 
 
-def get_error_view(status_code):
+def get_error_view(*, status_code, exception):
     views_by_status = settings.HTTP_ERROR_VIEWS
     if status_code in views_by_status:
         view = views_by_status[status_code]
@@ -142,4 +145,4 @@ def get_error_view(status_code):
         return view.as_view()
 
     # Create a standard view for any other status code
-    return ErrorView.as_view(status_code=status_code)
+    return ErrorView.as_view(status_code=status_code, exception=exception)

plain/packages/config.py

@@ -10,7 +10,9 @@ CONFIG_MODULE_NAME = "config"
 class PackageConfig:
     """Class representing a Plain application and its configuration."""
 
-    def __init__(self, name, *, label=""):
+    package_label: str
+
+    def __init__(self, name):
         # Full Python path to the application e.g. 'plain.admin.admin'.
         self.name = name
 
@@ -18,28 +20,18 @@ class PackageConfig:
         # registry when it registers the PackageConfig instance.
         self.packages_registry = None
 
-        # The following attributes could be defined at the class level in a
-        # subclass, hence the test-and-set pattern.
-        if label and hasattr(self, "label"):
-            raise ImproperlyConfigured(
-                "PackageConfig class should not define a class label attribute and an init label"
-            )
-
-        if label:
-            # Set the label explicitly from the init
-            self.label = label
-        elif not hasattr(self, "label"):
+        if not hasattr(self, "package_label"):
             # Last component of the Python path to the application e.g. 'admin'.
             # This value must be unique across a Plain project.
-            self.label = self.name.rpartition(".")[2]
+            self.package_label = self.name.rpartition(".")[2]
 
-        if not self.label.isidentifier():
+        if not self.package_label.isidentifier():
             raise ImproperlyConfigured(
-                f"The app label '{self.label}' is not a valid Python identifier."
+                f"The app label '{self.package_label}' is not a valid Python identifier."
             )
 
     def __repr__(self):
-        return f"<{self.__class__.__name__}: {self.label}>"
+        return f"<{self.__class__.__name__}: {self.package_label}>"
 
     @cached_property
     def path(self):

plain/packages/registry.py

@@ -146,7 +146,7 @@ class PackagesRegistry:
             message = f"No installed app with label '{package_label}'."
             for package_config in self.get_package_configs():
                 if package_config.name == package_label:
-                    message += f" Did you mean '{package_config.label}'?"
+                    message += f" Did you mean '{package_config.package_label}'?"
                     break
             raise LookupError(message)
 
@@ -179,11 +179,11 @@ class PackagesRegistry:
         class Config(PackageConfig):
             pass
         """
-        if package_config.label in self.package_configs:
+        if package_config.package_label in self.package_configs:
             raise ImproperlyConfigured(
-                f"Package labels aren't unique, duplicates: {package_config.label}"
+                f"Package labels aren't unique, duplicates: {package_config.package_label}"
             )
-        self.package_configs[package_config.label] = package_config
+        self.package_configs[package_config.package_label] = package_config
         package_config.packages = self
 
         return package_config

plain/utils/cache.py

@@ -15,13 +15,39 @@ An example: i18n middleware would need to distinguish caches by the
 "Accept-language" header.
 """
 
+import time
 from collections import defaultdict
 
-from plain.utils.regex_helper import _lazy_re_compile
+from .http import http_date
+from .regex_helper import _lazy_re_compile
 
 cc_delim_re = _lazy_re_compile(r"\s*,\s*")
 
 
+def patch_response_headers(response, cache_timeout):
+    """
+    Add HTTP caching headers to the given HttpResponse: Expires and
+    Cache-Control.
+
+    Each header is only added if it isn't already set.
+    """
+    if cache_timeout < 0:
+        cache_timeout = 0  # Can't have max-age negative
+    if "Expires" not in response.headers:
+        response.headers["Expires"] = http_date(time.time() + cache_timeout)
+    patch_cache_control(response, max_age=cache_timeout)
+
+
+def add_never_cache_headers(response):
+    """
+    Add headers to a response to indicate that a page should never be cached.
+    """
+    patch_response_headers(response, cache_timeout=-1)
+    patch_cache_control(
+        response, no_cache=True, no_store=True, must_revalidate=True, private=True
+    )
+
+
 def patch_cache_control(response, **kwargs):
     """
     Patch the Cache-Control header by adding all keyword arguments to it.

plain/views/base.py

@@ -20,6 +20,7 @@ class View:
     url_kwargs: dict
 
     # By default, any of these are allowed if a method is defined for it.
+    # To disallow a defined method, remove it from this list.
     allowed_http_methods = [
         "get",
         "post",
@@ -84,7 +85,7 @@ class View:
             return result
 
         if isinstance(result, str):
-            return Response(result)
+            return Response(result, content_type="text/plain")
 
         if isinstance(result, list):
             return JsonResponse(result, safe=False)

plain/views/errors.py

@@ -7,11 +7,19 @@ from .templates import TemplateView
 class ErrorView(TemplateView):
     status_code: int
 
-    def __init__(self, status_code=None) -> None:
+    def __init__(self, *, status_code=None, exception=None) -> None:
         # Allow creating an ErrorView with a status code
         # e.g. ErrorView.as_view(status_code=404)
-        if status_code is not None:
-            self.status_code = status_code
+        self.status_code = status_code or self.status_code
+
+        # Allow creating an ErrorView with an exception
+        self.exception = exception
+
+    def get_template_context(self):
+        context = super().get_template_context()
+        context["status_code"] = self.status_code
+        context["exception"] = self.exception
+        return context
 
     def get_template_names(self) -> list[str]:
         return [f"{self.status_code}.html", "error.html"]

plain/views/templates.py

@@ -27,6 +27,10 @@ class TemplateView(View):
 
     template_name: str | None = None
 
+    def __init__(self, template_name=None):
+        # Allow template_name to be passed in as_view()
+        self.template_name = template_name or self.template_name
+
     def get_template_context(self) -> dict:
         return {
             "request": self.request,

{plain-0.33.0.dist-info → plain-0.34.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.33.0
+Version: 0.34.1
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE
@@ -40,7 +40,7 @@ The `plain` package includes everything you need to start handling web requests
 
 - [plain.models](/plain-models/README.md) - Define and interact with your database models.
 - [plain.cache](/plain-cache/README.md) - A database-driven general purpose cache.
-- [plain.mail](/plain-mail/README.md) - Send emails with SMTP or custom backends.
+- [plain.email](/plain-email/README.md) - Send emails with SMTP or custom backends.
 - [plain.sessions](/plain-sessions/README.md) - User sessions and cookies.
 - [plain.worker](/plain-worker/README.md) - Backgrounb jobs stored in the database.
 - [plain.api](/plain-api/README.md) - Build APIs with Plain views.

{plain-0.33.0.dist-info → plain-0.34.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-plain/README.md,sha256=rG7ZDDSY8ExsqHvaytw5nC5_7HBwUhKuq_-Z3rdwRIs,3631
+plain/README.md,sha256=toa8J29dPjAU8pSLgvpmXZJ8Oloazs8RE7RNawiNWdk,3633
 plain/__main__.py,sha256=GK39854Lc_LO_JP8DzY9Y2MIQ4cQEl7SXFJy244-lC8,110
 plain/debug.py,sha256=abPkJY4aSbBYGEYSZST_ZY3ohXPGDdz9uWQBYRqfd3M,730
 plain/exceptions.py,sha256=Z9cbPE5im_Y-bjVq8cqC85gBoqOr80rLFG5wTKixrwE,5894
@@ -47,7 +47,7 @@ plain/internal/files/uploadhandler.py,sha256=eEnd5onstypjHYtg367PnVWwCaF1kAPlLPS
 plain/internal/files/utils.py,sha256=xN4HTJXDRdcoNyrL1dFd528MBwodRlHZM8DGTD_oBIg,2646
 plain/internal/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/internal/handlers/base.py,sha256=oRKni79ATI_u7sywGFExrzKvP5dpJTqIp1m521A90Ew,4169
-plain/internal/handlers/exception.py,sha256=rv8shMlTJdIhTm99VacILIiu5JRcmtumg8yWuy7GYto,4592
+plain/internal/handlers/exception.py,sha256=vfha_6-fz6S6VYCP1PMBfue2Gw-_th6jqaTE372fGlw,4809
 plain/internal/handlers/wsgi.py,sha256=aOGCd9hJEMTVMGfgIDlSFvevd8_XCzZa2dtlR4peqZg,8253
 plain/internal/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 plain/internal/middleware/headers.py,sha256=ENIW1Gwat54hv-ejgp2R8QTZm-PlaI7k44WU01YQrNk,964
@@ -60,8 +60,8 @@ plain/logs/loggers.py,sha256=iz9SYcwP9w5QAuwpULl48SFkVyJuuMoQ_fdLgdCHpNg,2121
 plain/logs/utils.py,sha256=9UzdCCQXJinGDs71Ngw297mlWkhgZStSd67ya4NOW98,1257
 plain/packages/README.md,sha256=nU2GcoCGmzmVOYRIeF8hp40aza0FF1ckvGqD5jIxocs,2494
 plain/packages/__init__.py,sha256=OpQny0xLplPdPpozVUUkrW2gB-IIYyDT1b4zMzOcCC4,160
-plain/packages/config.py,sha256=uOO7uE9jajqDhqFBafJQ3ZnfLmQiHikTzOSJ1AlP7ZM,3289
-plain/packages/registry.py,sha256=Aklno7y7UrBZlidtUR_YO3B5xqF46UbUtalReNcYHm8,7937
+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/__init__.py,sha256=j4-yPnrM5hmjumrdkBLOQjFHzRHpA6wCjiFpMNBjIqY,619
 plain/preflight/files.py,sha256=D_pBSwRXpXy2-3FWywweozuxrhIaR8w5hpPA2d6XMPs,522
@@ -101,7 +101,7 @@ plain/urls/routers.py,sha256=iEsQtTpPNDDVn7r_BQX84FESGSjOeD5qgyO_ep5rzaU,2819
 plain/urls/utils.py,sha256=WiGq6hHI-5DLFOxCQTAZ2qm0J-UdGosLcjuxlfK6_Tg,2137
 plain/utils/README.md,sha256=hRRkcg4CxMX-zz8d4Bn6V2uJr_VKgTLurc1jY7QlEx8,198
 plain/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-plain/utils/cache.py,sha256=0qziMJfzulWnNWlY4MBNfaYHIbKkAXRwy4QZNDr7s3o,4497
+plain/utils/cache.py,sha256=iuvOTIfI1s857iVOAPNLK5lkzlrl0fIiBYaiUXWQu40,5303
 plain/utils/connection.py,sha256=NN7xRhy6qIWuOOhi1x9YdGcFcYhKepTiMUETeEMS0vY,2501
 plain/utils/crypto.py,sha256=zFDydnaqNMGYFHUc-CAn8f93685a17BhGusAcITH1lI,2662
 plain/utils/datastructures.py,sha256=g4UYTbxIb_n8F9JWMP4dHPwUz71591fHreGATPO4qEc,10240
@@ -126,16 +126,16 @@ plain/utils/timezone.py,sha256=6u0sE-9RVp0_OCe0Y1KiYYQoq5THWLokZFQYY8jf78g,6221
 plain/utils/tree.py,sha256=wdWzmfsgc26YDF2wxhAY3yVxXTixQYqYDKE9mL3L3ZY,4383
 plain/views/README.md,sha256=JyqAWMXYdaVnRncmb12yvlBhC629zRtWR7uzkKFwc9Y,5998
 plain/views/__init__.py,sha256=a-N1nkklVohJTtz0yD1MMaS0g66HviEjsKydNVVjvVc,392
-plain/views/base.py,sha256=LTnr_JMvzfHPbjp8ynKVq2IwtqBBgZR3Ib2-jBL8K-I,3167
+plain/views/base.py,sha256=6Q67PEioF7b0OHqrYCu56KUCHqJ-Gr4vefMwuAXt38w,3256
 plain/views/csrf.py,sha256=7q6l5xzLWhRnMY64aNj0hR6G-3pxI2yhRwG6k_5j00E,144
-plain/views/errors.py,sha256=Y4oGX4Z6D2COKcDEfINvXE1acE8Ad15KwNNWPs5BCfc,967
+plain/views/errors.py,sha256=jbNCJIzowwCsEvqyJ3opMeZpPDqTyhtrbqb0VnAm2HE,1263
 plain/views/exceptions.py,sha256=b4euI49ZUKS9O8AGAcFfiDpstzkRAuuj_uYQXzWNHME,138
 plain/views/forms.py,sha256=5L6dYkwcZFMD3-w_QC2QDElo9hhSPrhVVFq9CB5yL9k,2692
 plain/views/objects.py,sha256=g5Lzno0Zsv0K449UpcCtxwCoO7WMRAWqKlxxV2V0_qg,8263
 plain/views/redirect.py,sha256=9zHZgKvtSkdrMX9KmsRM8hJTPmBktxhc4d8OitbuniI,1724
-plain/views/templates.py,sha256=cBkFNCSXgVi8cMqQbhsqJ4M_rIQYVl8cUvq9qu4YIes,1951
-plain-0.33.0.dist-info/METADATA,sha256=sz1vF6GknoRS8VOTLw_6nmRz-pfn_Ji2itKzURNo2LI,3942
-plain-0.33.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-plain-0.33.0.dist-info/entry_points.txt,sha256=1Ys2lsSeMepD1vz8RSrJopna0RQfUd951vYvCRsvl6A,45
-plain-0.33.0.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
-plain-0.33.0.dist-info/RECORD,,
+plain/views/templates.py,sha256=gwPqRki3SVcaTmtSCEp1MycUB-1saDYeYzmZZTQLxjE,2117
+plain-0.34.1.dist-info/METADATA,sha256=dLvkActYXqeXXsOPWzMPyteeRejGun_Zg77EY2UQRRI,3944
+plain-0.34.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+plain-0.34.1.dist-info/entry_points.txt,sha256=1Ys2lsSeMepD1vz8RSrJopna0RQfUd951vYvCRsvl6A,45
+plain-0.34.1.dist-info/licenses/LICENSE,sha256=m0D5O7QoH9l5Vz_rrX_9r-C8d9UNr_ciK6Qwac7o6yo,3175
+plain-0.34.1.dist-info/RECORD,,