fastapi 0.142.2__tar.gz → 0.142.4__tar.gz

{fastapi-0.142.2 → fastapi-0.142.4}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: fastapi
-Version: 0.142.2
+Version: 0.142.4
 Summary: FastAPI framework, high performance, easy to learn, fast to code, ready for production
-Author-Email: =?utf-8?q?Sebasti=C3=A1n_Ram=C3=ADrez?= <tiangolo@gmail.com>
+Author-Email: Sebastián Ramírez <tiangolo@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
 Classifier: Intended Audience :: Information Technology
@@ -139,7 +139,6 @@ The key features are:
 
 <a href="https://blockbee.io?ref=fastapi" target="_blank" title="BlockBee Cryptocurrency Payment Gateway"><img src="https://fastapi.tiangolo.com/img/sponsors/blockbee.png"></a>
 <a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
-<a href="https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi" target="_blank" title="Deploy & scale any full-stack web app on Render. Focus on building apps, not infra."><img src="https://fastapi.tiangolo.com/img/sponsors/render.svg"></a>
 <a href="https://www.coderabbit.ai/?utm_source=fastapi&utm_medium=badge&utm_campaign=fastapi" target="_blank" title="Cut Code Review Time & Bugs in Half with CodeRabbit"><img src="https://fastapi.tiangolo.com/img/sponsors/coderabbit.png"></a>
 <a href="https://subtotal.com/?utm_source=fastapi&utm_medium=sponsorship&utm_campaign=open-source" target="_blank" title="The Gold Standard in Retail Account Linking"><img src="https://fastapi.tiangolo.com/img/sponsors/subtotal.svg"></a>
 <a href="https://docs.railway.com/guides/fastapi?utm_medium=integration&utm_source=docs&utm_campaign=fastapi" target="_blank" title="Deploy enterprise applications at startup speed"><img src="https://fastapi.tiangolo.com/img/sponsors/railway.png"></a>

{fastapi-0.142.2 → fastapi-0.142.4}/README.md

@@ -53,7 +53,6 @@ The key features are:
 
 <a href="https://blockbee.io?ref=fastapi" target="_blank" title="BlockBee Cryptocurrency Payment Gateway"><img src="https://fastapi.tiangolo.com/img/sponsors/blockbee.png"></a>
 <a href="https://www.propelauth.com/?utm_source=fastapi&utm_campaign=1223&utm_medium=mainbadge" target="_blank" title="Auth, user management and more for your B2B product"><img src="https://fastapi.tiangolo.com/img/sponsors/propelauth.png"></a>
-<a href="https://docs.render.com/deploy-fastapi?utm_source=deploydoc&utm_medium=referral&utm_campaign=fastapi" target="_blank" title="Deploy & scale any full-stack web app on Render. Focus on building apps, not infra."><img src="https://fastapi.tiangolo.com/img/sponsors/render.svg"></a>
 <a href="https://www.coderabbit.ai/?utm_source=fastapi&utm_medium=badge&utm_campaign=fastapi" target="_blank" title="Cut Code Review Time & Bugs in Half with CodeRabbit"><img src="https://fastapi.tiangolo.com/img/sponsors/coderabbit.png"></a>
 <a href="https://subtotal.com/?utm_source=fastapi&utm_medium=sponsorship&utm_campaign=open-source" target="_blank" title="The Gold Standard in Retail Account Linking"><img src="https://fastapi.tiangolo.com/img/sponsors/subtotal.svg"></a>
 <a href="https://docs.railway.com/guides/fastapi?utm_medium=integration&utm_source=docs&utm_campaign=fastapi" target="_blank" title="Deploy enterprise applications at startup speed"><img src="https://fastapi.tiangolo.com/img/sponsors/railway.png"></a>

{fastapi-0.142.2 → fastapi-0.142.4}/fastapi/.agents/skills/fastapi/references/dependencies.md

@@ -55,6 +55,7 @@ def get_username():
     finally:
         print("Clean up before response is sent")
 
+
 UserNameDep = Annotated[str, Depends(get_username, scope="function")]
 
 @app.get("/users/me")

{fastapi-0.142.2 → fastapi-0.142.4}/fastapi/.agents/skills/fastapi/references/other-tools.md

@@ -18,6 +18,8 @@ When needing to run blocking code inside of async functions, or async code insid
 
 Prefer it over AnyIO or asyncio.
 
+Prefer it over `run_in_threadpool()`.
+
 Install:
 
 ```bash

{fastapi-0.142.2 → fastapi-0.142.4}/fastapi/.agents/skills/fastapi/references/streaming.md

@@ -76,6 +76,7 @@ app = FastAPI()
 class PNGStreamingResponse(StreamingResponse):
     media_type = "image/png"
 
+
 @app.get("/image", response_class=PNGStreamingResponse)
 def stream_image_no_async_no_annotation():
     with read_image() as image_file:

{fastapi-0.142.2 → fastapi-0.142.4}/fastapi/__init__.py

@@ -1,6 +1,6 @@
 """FastAPI framework, high performance, easy to learn, fast to code, ready for production"""
 
-__version__ = "0.142.2"
+__version__ = "0.142.4"
 
 from starlette import status as status
 

{fastapi-0.142.2 → fastapi-0.142.4}/fastapi/telemetry/_asgi.py

@@ -168,6 +168,8 @@ class NativeTelemetry:
         self._provider: metrics.MeterProvider | None = None
         self._duration: Histogram | None = None
         self._active: UpDownCounter | None = None
+        self._tracer_provider: trace.TracerProvider | None = None
+        self._tracer: trace.Tracer | None = None
 
     def enabled(self) -> bool:
         config = self.config
@@ -214,6 +216,15 @@ class NativeTelemetry:
         assert self._duration is not None and self._active is not None
         return self._duration, self._active
 
+    def _get_tracer(self, *, provider: trace.TracerProvider) -> trace.Tracer:
+        if provider is not self._tracer_provider:
+            self._tracer = provider.get_tracer(
+                "fastapi", __version__, schema_url=_SCHEMA_URL
+            )
+            self._tracer_provider = provider
+        assert self._tracer is not None
+        return self._tracer
+
     async def __call__(
         self,
         *,
@@ -227,9 +238,14 @@ class NativeTelemetry:
         if config["exclude"] is not None and config["exclude"](scope):
             # Keep mounted FastAPI apps from observing this excluded request.
             scope["fastapi.telemetry"] = None
+            # An in-process request can inherit another request's telemetry.
+            token = otel_context.attach(
+                otel_context.set_value(_REQUEST_TELEMETRY_KEY, None)
+            )
             try:
                 await app(scope, receive, send)
             finally:
+                otel_context.detach(token)
                 scope.pop("fastapi.telemetry", None)
             return
         tracing = config["tracing"] and not legacy_otel
@@ -282,12 +298,7 @@ class NativeTelemetry:
         if tracing:
             parent = propagate.extract(Headers(scope=scope), getter=_HEADERS_GETTER)
             parent_token = otel_context.attach(parent)
-            tracer = trace.get_tracer(
-                "fastapi",
-                __version__,
-                config["tracer_provider"],
-                schema_url=_SCHEMA_URL,
-            )
+            tracer = self._get_tracer(provider=provider)
             span_attributes = {**attributes, **_server_attributes(scope)}
             if not is_websocket:
                 span_attributes["url.path"] = scope["path"]

{fastapi-0.142.2 → fastapi-0.142.4}/pyproject.toml

@@ -53,7 +53,7 @@ dependencies = [
     "annotated-doc>=0.0.2",
     "opentelemetry-api>=1.44.0",
 ]
-version = "0.142.2"
+version = "0.142.4"
 
 [project.urls]
 Homepage = "https://github.com/fastapi/fastapi"
@@ -138,7 +138,7 @@ docs = [
 docs-tests = [
     "httpx >=0.23.0,<1.0.0",
     "httpx2>=2.0.0",
-    "ruff >=0.14.14,<0.16.0",
+    "ruff>=0.14.14,<0.17.0",
 ]
 github-actions = [
     "httpx >=0.27.0,<1.0.0",

{fastapi-0.142.2 → fastapi-0.142.4}/scripts/translate.py

@@ -1,4 +1,5 @@
 import json
+import os
 import secrets
 from collections.abc import Iterable
 from functools import lru_cache
@@ -37,6 +38,8 @@ general_prompt = general_prompt_path.read_text(encoding="utf-8")
 app = typer.Typer()
 repository_path = Path(__file__).absolute().parent.parent
 
+os.environ["PYDANTIC_AI_NO_BANNER"] = "1"
+
 
 @lru_cache
 def get_langs() -> dict[str, str]:
@@ -137,7 +140,7 @@ def translate_page(
         print(f"Found existing translation: {out_path}")
         old_translation = out_path.read_text(encoding="utf-8")
     print(f"Translating {en_path} to {language} ({language_name})")
-    agent = Agent("openai-chat:gpt-5.5")
+    agent = Agent("openai-chat:gpt-6-astra")
 
     MAX_ATTEMPTS = 3
     additional_instructions = ""

{fastapi-0.142.2 → fastapi-0.142.4}/tests/test_telemetry/test_data.py

@@ -1,3 +1,4 @@
+import asyncio
 import gc
 import weakref
 
@@ -7,7 +8,7 @@ from fastapi import Depends, FastAPI, HTTPException, Request, WebSocket
 from fastapi.telemetry import get_telemetry_data
 from fastapi.testclient import TestClient
 from httpx import ASGITransport, AsyncClient
-from opentelemetry import context
+from opentelemetry import baggage, context
 from opentelemetry._logs import SeverityNumber
 from opentelemetry.sdk._logs import LoggerProvider, LogRecordProcessor
 from opentelemetry.sdk._logs.export import (
@@ -18,6 +19,7 @@ from pydantic import BaseModel
 from starlette.websockets import WebSocketDisconnect
 
 from ._otlp import otlp_collector
+from .conftest import metric_points, server_spans
 
 
 @pytest.mark.anyio
@@ -86,6 +88,145 @@ async def test_data_is_local_to_each_request_and_cleared_afterwards(telemetry):
     assert get_telemetry_data() is None
 
 
+@pytest.mark.anyio
+@pytest.mark.parametrize("invalid", [False, True])
+async def test_excluded_request_does_not_use_outer_telemetry(telemetry, logs, invalid):
+    config, exporter, reader = telemetry
+    app = FastAPI(
+        telemetry={**config, "exclude": lambda scope: scope["path"] == "/inner"}
+    )
+    tracer = config["tracer_provider"].get_tracer("test")
+
+    @app.get("/inner")
+    def inner(value: int):
+        assert get_telemetry_data() is None
+        assert baggage.get_baggage("example") == "value"
+        with tracer.start_as_current_span("inner.work"):
+            return value
+
+    @app.get("/outer")
+    async def outer(request: Request):
+        data = get_telemetry_data()
+        assert data is not None
+        values, errors = data.values, data.errors
+        outer_context = context.get_current()
+        async with AsyncClient(
+            transport=ASGITransport(app=app), base_url="http://internal"
+        ) as client:
+            response = await client.get(
+                "/inner", params={"value": "invalid" if invalid else "1"}
+            )
+        assert response.status_code == (422 if invalid else 200)
+        assert context.get_current() is outer_context
+        assert get_telemetry_data() is data
+        assert data.request is request
+        assert data.values is values
+        assert data.errors is errors
+        return "ok"
+
+    async with AsyncClient(
+        transport=ASGITransport(app=app), base_url="http://test"
+    ) as client:
+        response = await client.get("/outer", headers={"baggage": "example=value"})
+    assert response.json() == "ok"
+    spans = exporter.get_finished_spans()
+    expected = [
+        "GET /outer",
+        "fastapi.dependencies",
+        "fastapi.endpoint",
+        "fastapi.serialization",
+    ]
+    if not invalid:
+        expected.append("inner.work")
+        operation = next(span for span in spans if span.name == "fastapi.endpoint")
+        work = next(span for span in spans if span.name == "inner.work")
+        assert work.parent.span_id == operation.context.span_id
+        assert work.context.trace_id == operation.context.trace_id
+    assert sorted(span.name for span in spans) == sorted(expected)
+    (point,) = metric_points(reader=reader)
+    assert point.attributes["http.route"] == "/outer"
+    assert point.count == 1
+    assert not logs.get_finished_logs()
+    assert get_telemetry_data() is None
+
+
+@pytest.mark.anyio
+@pytest.mark.parametrize("error_type", [ValueError, asyncio.CancelledError])
+async def test_excluded_request_restores_context_after_error(
+    telemetry, logs, error_type
+):
+    config, exporter, _ = telemetry
+    app = FastAPI(
+        telemetry={**config, "exclude": lambda scope: scope["path"] == "/inner"}
+    )
+    error = error_type()
+
+    @app.get("/inner")
+    async def inner():
+        assert get_telemetry_data() is None
+        raise error
+
+    @app.get("/outer")
+    async def outer(request: Request):
+        outer_context = context.get_current()
+        async with AsyncClient(
+            transport=ASGITransport(app=app), base_url="http://internal"
+        ) as client:
+            with pytest.raises(error_type) as caught:
+                await client.get("/inner")
+        assert caught.value is error
+        assert context.get_current() is outer_context
+        data = get_telemetry_data()
+        assert data is not None
+        assert data.request is request
+        return "ok"
+
+    async with AsyncClient(
+        transport=ASGITransport(app=app), base_url="http://test"
+    ) as client:
+        assert (await client.get("/outer")).json() == "ok"
+    (span,) = server_spans(exporter)
+    assert span.name == "GET /outer"
+    assert not logs.get_finished_logs()
+
+
+@pytest.mark.anyio
+async def test_included_request_inside_excluded_request(telemetry):
+    config, exporter, reader = telemetry
+    app = FastAPI(
+        telemetry={**config, "exclude": lambda scope: scope["path"] == "/excluded"}
+    )
+
+    @app.get("/included")
+    async def included(request: Request):
+        data = get_telemetry_data()
+        assert data is not None
+        assert data.request is request
+        return "ok"
+
+    @app.get("/excluded")
+    async def excluded():
+        assert get_telemetry_data() is None
+        excluded_context = context.get_current()
+        async with AsyncClient(
+            transport=ASGITransport(app=app), base_url="http://internal"
+        ) as client:
+            assert (await client.get("/included")).json() == "ok"
+        assert context.get_current() is excluded_context
+        assert get_telemetry_data() is None
+        return "ok"
+
+    async with AsyncClient(
+        transport=ASGITransport(app=app), base_url="http://test"
+    ) as client:
+        assert (await client.get("/excluded")).json() == "ok"
+    (span,) = server_spans(exporter)
+    assert span.name == "GET /included"
+    (point,) = metric_points(reader=reader)
+    assert point.attributes["http.route"] == "/included"
+    assert point.count == 1
+
+
 def test_retained_context_does_not_keep_failed_request_alive(telemetry):
     config, _, _ = telemetry
     app = FastAPI(telemetry={**config, "tracing": False, "logs": False})

fastapi-0.142.4/tests/test_telemetry/test_tracer.py

@@ -0,0 +1,77 @@
+import warnings
+from unittest.mock import Mock
+
+import pytest
+from fastapi import FastAPI, WebSocket
+from fastapi.testclient import TestClient
+from opentelemetry import trace
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import SimpleSpanProcessor
+from opentelemetry.sdk.trace.export.in_memory_span_exporter import InMemorySpanExporter
+
+from .conftest import server_spans
+
+
+@pytest.mark.parametrize("global_provider", [False, True])
+@pytest.mark.parametrize("protocol", ["http", "websocket"])
+def test_tracer_lookup_preserves_warning_deduplication(
+    telemetry, monkeypatch, global_provider, protocol
+):
+    config, exporter, _ = telemetry
+    provider = config["tracer_provider"]
+    get_tracer = Mock(wraps=provider.get_tracer)
+    monkeypatch.setattr(provider, "get_tracer", get_tracer)
+    if global_provider:
+        monkeypatch.setattr(trace, "get_tracer_provider", lambda: provider)
+        config["tracer_provider"] = None
+    app = FastAPI(telemetry=config)
+
+    @app.get("/")
+    def endpoint():
+        warnings.warn("Repeated endpoint warning", UserWarning, stacklevel=1)
+        return "ok"
+
+    @app.websocket("/ws")
+    async def websocket_endpoint(websocket: WebSocket):
+        await websocket.accept()
+        warnings.warn("Repeated endpoint warning", UserWarning, stacklevel=1)
+        await websocket.close()
+
+    get_tracer.assert_not_called()
+    with warnings.catch_warnings(record=True) as caught:
+        warnings.simplefilter("default")
+        with TestClient(app) as client:
+            for _ in range(5):
+                if protocol == "http":
+                    assert client.get("/").json() == "ok"
+                else:
+                    with client.websocket_connect("/ws") as websocket:
+                        assert websocket.receive()["type"] == "websocket.close"
+    assert [str(warning.message) for warning in caught] == ["Repeated endpoint warning"]
+    get_tracer.assert_called_once()
+    spans = server_spans(exporter)
+    assert len(spans) == 5
+    assert len({span.context.trace_id for span in spans}) == 5
+
+
+def test_cached_tracer_follows_provider_changes(telemetry, monkeypatch):
+    config, exporter, _ = telemetry
+    provider = config["tracer_provider"]
+    monkeypatch.setattr(trace, "get_tracer_provider", lambda: provider)
+    app = FastAPI()
+    client = TestClient(app)
+    for _ in range(2):
+        assert client.get("/").status_code == 404
+    assert len(server_spans(exporter)) == 2
+
+    other_exporter = InMemorySpanExporter()
+    other_provider = TracerProvider(shutdown_on_exit=False)
+    other_provider.add_span_processor(SimpleSpanProcessor(other_exporter))
+    monkeypatch.setattr(trace, "get_tracer_provider", lambda: other_provider)
+    try:
+        for _ in range(2):
+            assert client.get("/").status_code == 404
+        assert len(server_spans(other_exporter)) == 2
+        assert len(server_spans(exporter)) == 2
+    finally:
+        other_provider.shutdown()