plain 0.53.0__tar.gz → 0.54.0__tar.gz

{plain-0.53.0 → plain-0.54.0}/.gitignore

@@ -4,7 +4,6 @@
 *.py[co]
 __pycache__
 *.DS_Store
-.coverage
 
 # Test apps
 plain*/tests/.plain
@@ -17,5 +16,4 @@ plain*/tests/.plain
 # Plain temp dirs
 .plain
 
-coverage.xml
 .vscode

{plain-0.53.0 → plain-0.54.0}/PKG-INFO

@@ -1,12 +1,14 @@
 Metadata-Version: 2.4
 Name: plain
-Version: 0.53.0
+Version: 0.54.0
 Summary: A web framework for building products with Python.
 Author-email: Dave Gaeddert <dave.gaeddert@dropseed.dev>
 License-File: LICENSE
 Requires-Python: >=3.11
 Requires-Dist: click>=8.0.0
 Requires-Dist: jinja2>=3.1.2
+Requires-Dist: opentelemetry-api>=1.34.1
+Requires-Dist: opentelemetry-semantic-conventions>=0.55b1
 Description-Content-Type: text/markdown
 
 # Plain
@@ -59,6 +61,7 @@ The `plain` package includes everything you need to start handling web requests
 - [plain.support](/plain-support/plain/support/README.md) - Customer support forms.
 - [plain.redirection](/plain-redirection/plain/redirection/README.md) - Redirects managed in the database.
 - [plain.pageviews](/plain-pageviews/plain/pageviews/README.md) - Basic self-hosted page view tracking and reporting.
+- [plain.observer](/plain-observer/plain/observer/README.md) - On-page telemetry reporting.
 
 ## Dev Packages
 

{plain-0.53.0 → plain-0.54.0}/plain/CHANGELOG.md

@@ -1,5 +1,16 @@
 # plain changelog
 
+## [0.54.0](https://github.com/dropseed/plain/releases/plain@0.54.0) (2025-07-18)
+
+### What's changed
+
+- Added OpenTelemetry instrumentation for HTTP requests, views, and template rendering ([b0224d0418](https://github.com/dropseed/plain/commit/b0224d0418))
+- Added `plain-observer` package reference to plain README ([f29ff4dafe](https://github.com/dropseed/plain/commit/f29ff4dafe))
+
+### Upgrade instructions
+
+- No changes required
+
 ## [0.53.0](https://github.com/dropseed/plain/releases/plain@0.53.0) (2025-07-18)
 
 ### What's changed

{plain-0.53.0 → plain-0.54.0}/plain/README.md

@@ -48,6 +48,7 @@ The `plain` package includes everything you need to start handling web requests
 - [plain.support](/plain-support/plain/support/README.md) - Customer support forms.
 - [plain.redirection](/plain-redirection/plain/redirection/README.md) - Redirects managed in the database.
 - [plain.pageviews](/plain-pageviews/plain/pageviews/README.md) - Basic self-hosted page view tracking and reporting.
+- [plain.observer](/plain-observer/plain/observer/README.md) - On-page telemetry reporting.
 
 ## Dev Packages
 

{plain-0.53.0 → plain-0.54.0}/plain/internal/handlers/base.py

@@ -1,6 +1,9 @@
 import logging
 import types
 
+from opentelemetry import baggage, trace
+from opentelemetry.semconv.attributes import http_attributes, url_attributes
+
 from plain.exceptions import ImproperlyConfigured
 from plain.logs import log_response
 from plain.runtime import settings
@@ -26,6 +29,9 @@ BUILTIN_AFTER_MIDDLEWARE = [
 ]
 
 
+tracer = trace.get_tracer("plain")
+
+
 class BaseHandler:
     _middleware_chain = None
 
@@ -35,8 +41,7 @@ class BaseHandler:
 
         Must be called after the environment is fixed (see __call__ in subclasses).
         """
-        get_response = self._get_response
-        handler = convert_exception_to_response(get_response)
+        handler = convert_exception_to_response(self._get_response)
 
         middlewares = reversed(
             BUILTIN_BEFORE_MIDDLEWARE + settings.MIDDLEWARE + BUILTIN_AFTER_MIDDLEWARE
@@ -59,18 +64,55 @@ class BaseHandler:
 
     def get_response(self, request):
         """Return a Response object for the given HttpRequest."""
-        # Setup default url resolver for this thread
-        response = self._middleware_chain(request)
-        response._resource_closers.append(request.close)
-        if response.status_code >= 400:
-            log_response(
-                "%s: %s",
-                response.reason_phrase,
-                request.path,
-                response=response,
-                request=request,
+
+        span_attributes = {
+            "plain.request.id": request.unique_id,
+            http_attributes.HTTP_REQUEST_METHOD: request.method,
+            url_attributes.URL_PATH: request.path_info,
+            url_attributes.URL_SCHEME: request.scheme,
+        }
+
+        # Add full URL if we can build it (requires proper WSGI environment)
+        try:
+            span_attributes[url_attributes.URL_FULL] = request.build_absolute_uri()
+        except KeyError:
+            # Missing required WSGI environment variables (e.g. in tests)
+            pass
+
+        # Add query string if present
+        if query_string := request.meta.get("QUERY_STRING"):
+            span_attributes[url_attributes.URL_QUERY] = query_string
+
+        span_context = baggage.set_baggage("http.request.cookies", request.cookies)
+
+        with tracer.start_as_current_span(
+            f"{request.method} {request.path_info}",
+            context=span_context,
+            attributes=span_attributes,
+            kind=trace.SpanKind.SERVER,
+        ) as span:
+            response = self._middleware_chain(request)
+            response._resource_closers.append(request.close)
+
+            span.set_attribute(
+                http_attributes.HTTP_RESPONSE_STATUS_CODE, response.status_code
+            )
+
+            span.set_status(
+                trace.StatusCode.OK
+                if response.status_code < 400
+                else trace.StatusCode.ERROR
             )
-        return response
+
+            if response.status_code >= 400:
+                log_response(
+                    "%s: %s",
+                    response.reason_phrase,
+                    request.path,
+                    response=response,
+                    request=request,
+                )
+            return response
 
     def _get_response(self, request):
         """
@@ -94,9 +136,18 @@ class BaseHandler:
         Retrieve/set the urlrouter for the request. Return the view resolved,
         with its args and kwargs.
         """
+
         resolver = get_resolver()
         # Resolve the view, and assign the match object back to the request.
         resolver_match = resolver.resolve(request.path_info)
+
+        span = trace.get_current_span()
+        span.set_attribute(http_attributes.HTTP_ROUTE, resolver_match.route)
+
+        # Route makes a better name
+        if resolver_match.route:
+            span.update_name(f"{request.method} {resolver_match.route}")
+
         request.resolver_match = resolver_match
         return resolver_match
 

plain-0.54.0/plain/templates/core.py

@@ -0,0 +1,42 @@
+import jinja2
+from opentelemetry import trace
+from opentelemetry.semconv._incubating.attributes.code_attributes import (
+    CODE_FUNCTION_NAME,
+    CODE_NAMESPACE,
+)
+
+from .jinja import environment
+
+tracer = trace.get_tracer("plain")
+
+
+class TemplateFileMissing(Exception):
+    def __str__(self) -> str:
+        if self.args:
+            return f"Template file {self.args[0]} not found"
+        else:
+            return "Template file not found"
+
+
+class Template:
+    def __init__(self, filename: str) -> None:
+        self.filename = filename
+
+        try:
+            self._jinja_template = environment.get_template(filename)
+        except jinja2.TemplateNotFound:
+            raise TemplateFileMissing(filename)
+
+    def render(self, context: dict) -> str:
+        with tracer.start_as_current_span(
+            f"render {self.filename}",
+            kind=trace.SpanKind.INTERNAL,
+            attributes={
+                CODE_FUNCTION_NAME: "render",
+                CODE_NAMESPACE: f"{self.__class__.__module__}.{self.__class__.__qualname__}",
+                "template.filename": self.filename,
+                "template.engine": "jinja2",
+            },
+        ):
+            result = self._jinja_template.render(context)
+            return result

{plain-0.53.0 → plain-0.54.0}/plain/views/base.py

@@ -1,6 +1,12 @@
 import logging
 from http import HTTPMethod
 
+from opentelemetry import trace
+from opentelemetry.semconv._incubating.attributes.code_attributes import (
+    CODE_FUNCTION_NAME,
+    CODE_NAMESPACE,
+)
+
 from plain.http import (
     HttpRequest,
     JsonResponse,
@@ -16,6 +22,9 @@ from .exceptions import ResponseException
 logger = logging.getLogger("plain.request")
 
 
+tracer = trace.get_tracer("plain")
+
+
 class View:
     request: HttpRequest
     url_args: tuple
@@ -35,9 +44,23 @@ class View:
     @classonlymethod
     def as_view(cls, *init_args, **init_kwargs):
         def view(request, *url_args, **url_kwargs):
-            v = cls(*init_args, **init_kwargs)
-            v.setup(request, *url_args, **url_kwargs)
-            return v.get_response()
+            with tracer.start_as_current_span(
+                f"{cls.__name__}",
+                kind=trace.SpanKind.INTERNAL,
+                attributes={
+                    CODE_FUNCTION_NAME: "as_view",
+                    CODE_NAMESPACE: f"{cls.__module__}.{cls.__qualname__}",
+                },
+            ) as span:
+                v = cls(*init_args, **init_kwargs)
+                v.setup(request, *url_args, **url_kwargs)
+                response = v.get_response()
+                span.set_status(
+                    trace.StatusCode.OK
+                    if response.status_code < 400
+                    else trace.StatusCode.ERROR
+                )
+                return response
 
         view.view_class = cls
 

{plain-0.53.0 → plain-0.54.0}/pyproject.toml

@@ -1,12 +1,14 @@
 [project]
 name = "plain"
-version = "0.53.0"
+version = "0.54.0"
 description = "A web framework for building products with Python."
 authors = [{name = "Dave Gaeddert", email = "dave.gaeddert@dropseed.dev"}]
 readme = "README.md"
 dependencies = [
     "jinja2>=3.1.2",
     "click>=8.0.0",
+    "opentelemetry-api>=1.34.1",
+    "opentelemetry-semantic-conventions>=0.55b1",
 ]
 requires-python = ">=3.11"
 

plain-0.54.0/tests/.gitignore

@@ -0,0 +1 @@
+.plain

plain-0.53.0/plain/templates/core.py

@@ -1,24 +0,0 @@
-import jinja2
-
-from .jinja import environment
-
-
-class TemplateFileMissing(Exception):
-    def __str__(self) -> str:
-        if self.args:
-            return f"Template file {self.args[0]} not found"
-        else:
-            return "Template file not found"
-
-
-class Template:
-    def __init__(self, filename: str) -> None:
-        self.filename = filename
-
-        try:
-            self._jinja_template = environment.get_template(filename)
-        except jinja2.TemplateNotFound:
-            raise TemplateFileMissing(filename)
-
-    def render(self, context: dict) -> str:
-        return self._jinja_template.render(context)

plain-0.53.0/tests/.gitignore

@@ -1,3 +0,0 @@
-/.coverage
-/htmlcov
-.plain