feat(lilya): Add Lilya integration

Add first-class Lilya framework instrumentation for route transaction names, request data, handled HTTP exceptions, authenticated users, and middleware spans.

Add end-to-end Lilya integration tests plus generated tox and CI matrix entries.

Author: tarsil

.github/workflows/test-integrations-web-2.yml

@@ -53,6 +53,10 @@ jobs:
         run: |
           set -x # print commands that are executed
           ./scripts/runtox.sh "py${{ matrix.python-version }}-falcon"
+      - name: Test lilya
+        run: |
+          set -x # print commands that are executed
+          ./scripts/runtox.sh "py${{ matrix.python-version }}-lilya"
       - name: Test litestar
         run: |
           set -x # print commands that are executed

CHANGELOG.md

@@ -6,6 +6,10 @@ The SDK now extracts all `gen_ai` spans out of a transaction and sends them as v
 
 Self-hosted Sentry users should opt out with `stream_gen_ai_spans=False`, since streamed `gen_ai` spans may not be ingested by their Sentry instance.
 
+### Features
+
+- Add first-class Lilya framework integration.
+
 ### Bug Fixes 🐛
 
 - (asyncpg) Use distinct span ops for cursor iteration and fetch to prevent N+1 false positives by @ericapisani in [#6609](https://github.com/getsentry/sentry-python/pull/6609)

docs/integrations.rst

@@ -4,6 +4,11 @@ Integrations
 
 TBD
 
+Lilya
+=====
+
+.. autoclass:: sentry_sdk.integrations.lilya.LilyaIntegration
+
 Logging
 =======
 

pyproject.toml

@@ -70,6 +70,7 @@ typing = [
     "mcp>=2.0.0b1",
     "starlette>=1.3.1",
     "python-multipart>=0.0.32",
+    "lilya>=0.27.0",
     "pydantic>=2.13.4",
 ]
 test = [
@@ -197,6 +198,10 @@ ignore_missing_imports = true
 module = "google.genai.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "lilya.*"
+ignore_missing_imports = true
+
 [[tool.mypy.overrides]]
 module = "executing.*"
 ignore_missing_imports = true

scripts/populate_tox/config.py

@@ -276,6 +276,17 @@
         "package": "launchdarkly-server-sdk",
         "num_versions": 2,
     },
+    "lilya": {
+        "package": "lilya",
+        "deps": {
+            "*": [
+                "httpx",
+                "pytest-asyncio",
+                "anyio>=3,<5",
+            ],
+        },
+        "python": ">=3.10",
+    },
     "litellm": {
         "package": "litellm",
         "deps": {

scripts/split_tox_gh_actions/split_tox_gh_actions.py

@@ -154,6 +154,7 @@
         "asgi",
         "bottle",
         "falcon",
+        "lilya",
         "litestar",
         "pyramid",
         "quart",

sentry_sdk/consts.py

@@ -1222,6 +1222,9 @@ class OP:
     HTTP_CLIENT_STREAM = "http.client.stream"
     HTTP_SERVER = "http.server"
     MIDDLEWARE_DJANGO = "middleware.django"
+    MIDDLEWARE_LILYA = "middleware.lilya"
+    MIDDLEWARE_LILYA_RECEIVE = "middleware.lilya.receive"
+    MIDDLEWARE_LILYA_SEND = "middleware.lilya.send"
     MIDDLEWARE_LITESTAR = "middleware.litestar"
     MIDDLEWARE_LITESTAR_RECEIVE = "middleware.litestar.receive"
     MIDDLEWARE_LITESTAR_SEND = "middleware.litestar.send"

sentry_sdk/integrations/__init__.py

@@ -89,6 +89,7 @@ def iter_default_integrations(
     "sentry_sdk.integrations.huggingface_hub.HuggingfaceHubIntegration",
     "sentry_sdk.integrations.langchain.LangchainIntegration",
     "sentry_sdk.integrations.langgraph.LanggraphIntegration",
+    "sentry_sdk.integrations.lilya.LilyaIntegration",
     "sentry_sdk.integrations.litestar.LitestarIntegration",
     "sentry_sdk.integrations.loguru.LoguruIntegration",
     "sentry_sdk.integrations.mcp.MCPIntegration",
@@ -145,6 +146,7 @@ def iter_default_integrations(
     "langchain": (0, 1, 0),
     "langgraph": (0, 6, 6),
     "launchdarkly": (9, 8, 0),
+    "lilya": (0, 27, 0),
     "litellm": (1, 77, 5),
     "loguru": (0, 7, 0),
     "mcp": (1, 15, 0),

sentry_sdk/integrations/asgi.py

@@ -474,6 +474,10 @@ def _get_transaction_name_and_source(
                 if path is not None:
                     name = path
             else:
+                route_path_template = asgi_scope.get("route_path_template")
+                if route_path_template is not None:
+                    name = route_path_template
+            if name is None:
                 name = _get_url(
                     asgi_scope,
                     "http" if ty == "http" else "ws",
@@ -525,6 +529,10 @@ def _get_segment_name_and_source(
                 if path is not None:
                     name = path
             else:
+                route_path_template = asgi_scope.get("route_path_template")
+                if route_path_template is not None:
+                    name = route_path_template
+            if name is None:
                 name = _get_url(
                     asgi_scope,
                     "http" if ty == "http" else "ws",