logbrew-fastapi 0.1.6__tar.gz → 0.1.8__tar.gz

{logbrew_fastapi-0.1.6/src/logbrew_fastapi.egg-info → logbrew_fastapi-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logbrew-fastapi
-Version: 0.1.6
+Version: 0.1.8
 Summary: FastAPI integration for capturing LogBrew request spans and exceptions.
 Author: LogBrew
 License-Expression: MIT
@@ -11,14 +11,17 @@ Classifier: Framework :: FastAPI
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: fastapi>=0.111.1
-Requires-Dist: logbrew-sdk<0.2.0,>=0.1.5
+Requires-Dist: logbrew-sdk<0.2.0,>=0.1.7
+Provides-Extra: celery
+Requires-Dist: logbrew-sdk[celery]<0.2.0,>=0.1.7; extra == "celery"
 
 # logbrew-fastapi
 
@@ -34,6 +37,8 @@ FastAPI integration for capturing LogBrew request spans and exceptions with the
 python3 -m pip install logbrew-fastapi
 ```
 
+`logbrew-fastapi` requires Python 3.10 or newer.
+
 The package is typed, ships `py.typed`, and installs the compatible core `logbrew-sdk`. It supports FastAPI 0.111.1 and later. It does not install or replace application-owned HTTP clients such as `httpx` or `httpx2`. Keep the real project key in application configuration rather than source control.
 
 ## Production setup
@@ -183,6 +188,30 @@ def checkout(order_id: str) -> dict[str, object]:
 
 Run `python -m logbrew_fastapi.examples dependency-spans` to see a local request span parenting SQLite, cache, and queue child spans from an installed package. LogBrew does not patch database drivers, cache clients, queue frameworks, or broker metadata globally, and the helpers avoid SQL values, cache keys/values, queue bodies, headers, baggage, and tracestate.
 
+## Celery background jobs
+
+Install the optional Celery path when a FastAPI service publishes or processes Celery jobs:
+
+```bash
+python3 -m pip install "logbrew-fastapi[celery]"
+```
+
+The base FastAPI install stays Celery-free. The extra installs the compatible core Celery integration, which you attach only to the Celery app your service owns:
+
+```python
+from celery import Celery
+from logbrew_sdk import instrument_celery_app_with_logbrew_spans
+
+celery_app = Celery("checkout")
+celery_telemetry = instrument_celery_app_with_logbrew_spans(
+    celery_app,
+    client=client,
+    metadata={"service": "checkout-worker"},
+)
+```
+
+Producer and worker spans share W3C trace context. An unexpected final task failure emits one trace-correlated issue with task name and exception type only; retries and exception types declared through `task.throws` stay span-only. Task IDs, arguments, results, headers, exception messages, and stack traces are excluded. Uninstall direct instrumentation after tasks drain and before shutting down its client. Separate prefork workers need child-owned clients; follow the [core Celery lifecycle and encrypted persistence setup](https://github.com/LogBrewCo/sdk/tree/main/python/logbrew_py#automatic-celery-spans) instead of sharing the FastAPI process client across forks.
+
 Request duration metrics are opt-in. Set `capture_request_metrics=True` to emit an explicit `http.server.duration` histogram for completed requests:
 
 ```python

logbrew_fastapi-0.1.6/PKG-INFO → logbrew_fastapi-0.1.8/README.md

@@ -1,25 +1,3 @@
-Metadata-Version: 2.4
-Name: logbrew-fastapi
-Version: 0.1.6
-Summary: FastAPI integration for capturing LogBrew request spans and exceptions.
-Author: LogBrew
-License-Expression: MIT
-Project-URL: Repository, https://github.com/LogBrewCo/sdk
-Keywords: logbrew,observability,fastapi,asgi,logs
-Classifier: Development Status :: 3 - Alpha
-Classifier: Framework :: FastAPI
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: fastapi>=0.111.1
-Requires-Dist: logbrew-sdk<0.2.0,>=0.1.5
-
 # logbrew-fastapi
 
 <p align="center">
@@ -34,6 +12,8 @@ FastAPI integration for capturing LogBrew request spans and exceptions with the
 python3 -m pip install logbrew-fastapi
 ```
 
+`logbrew-fastapi` requires Python 3.10 or newer.
+
 The package is typed, ships `py.typed`, and installs the compatible core `logbrew-sdk`. It supports FastAPI 0.111.1 and later. It does not install or replace application-owned HTTP clients such as `httpx` or `httpx2`. Keep the real project key in application configuration rather than source control.
 
 ## Production setup
@@ -183,6 +163,30 @@ def checkout(order_id: str) -> dict[str, object]:
 
 Run `python -m logbrew_fastapi.examples dependency-spans` to see a local request span parenting SQLite, cache, and queue child spans from an installed package. LogBrew does not patch database drivers, cache clients, queue frameworks, or broker metadata globally, and the helpers avoid SQL values, cache keys/values, queue bodies, headers, baggage, and tracestate.
 
+## Celery background jobs
+
+Install the optional Celery path when a FastAPI service publishes or processes Celery jobs:
+
+```bash
+python3 -m pip install "logbrew-fastapi[celery]"
+```
+
+The base FastAPI install stays Celery-free. The extra installs the compatible core Celery integration, which you attach only to the Celery app your service owns:
+
+```python
+from celery import Celery
+from logbrew_sdk import instrument_celery_app_with_logbrew_spans
+
+celery_app = Celery("checkout")
+celery_telemetry = instrument_celery_app_with_logbrew_spans(
+    celery_app,
+    client=client,
+    metadata={"service": "checkout-worker"},
+)
+```
+
+Producer and worker spans share W3C trace context. An unexpected final task failure emits one trace-correlated issue with task name and exception type only; retries and exception types declared through `task.throws` stay span-only. Task IDs, arguments, results, headers, exception messages, and stack traces are excluded. Uninstall direct instrumentation after tasks drain and before shutting down its client. Separate prefork workers need child-owned clients; follow the [core Celery lifecycle and encrypted persistence setup](https://github.com/LogBrewCo/sdk/tree/main/python/logbrew_py#automatic-celery-spans) instead of sharing the FastAPI process client across forks.
+
 Request duration metrics are opt-in. Set `capture_request_metrics=True` to emit an explicit `http.server.duration` histogram for completed requests:
 
 ```python

{logbrew_fastapi-0.1.6 → logbrew_fastapi-0.1.8}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logbrew-fastapi"
-version = "0.1.6"
+version = "0.1.8"
 description = "FastAPI integration for capturing LogBrew request spans and exceptions."
 readme = "README.md"
 license = "MIT"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 authors = [
   { name = "LogBrew" }
 ]
@@ -19,6 +19,7 @@ classifiers = [
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
@@ -26,9 +27,12 @@ classifiers = [
 ]
 dependencies = [
   "fastapi>=0.111.1",
-  "logbrew-sdk>=0.1.5,<0.2.0"
+  "logbrew-sdk>=0.1.7,<0.2.0"
 ]
 
+[project.optional-dependencies]
+celery = ["logbrew-sdk[celery]>=0.1.7,<0.2.0"]
+
 [project.urls]
 Repository = "https://github.com/LogBrewCo/sdk"
 

{logbrew_fastapi-0.1.6 → logbrew_fastapi-0.1.8}/src/logbrew_fastapi/__init__.py

@@ -6,7 +6,7 @@ import time
 import uuid
 from collections.abc import Callable
 from dataclasses import dataclass
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from importlib.metadata import PackageNotFoundError
 from importlib.metadata import version as distribution_version
 from typing import Any
@@ -244,7 +244,7 @@ def _delivery_error_code(error: Exception) -> str:
 def utc_timestamp() -> str:
     """Return a LogBrew-compatible UTC timestamp."""
 
-    return datetime.now(UTC).isoformat(timespec="milliseconds").replace("+00:00", "Z")
+    return datetime.now(timezone.utc).isoformat(timespec="milliseconds").replace("+00:00", "Z")
 
 
 def request_name(request: Request) -> str:

logbrew_fastapi-0.1.6/README.md → logbrew_fastapi-0.1.8/src/logbrew_fastapi.egg-info/PKG-INFO

@@ -1,3 +1,28 @@
+Metadata-Version: 2.4
+Name: logbrew-fastapi
+Version: 0.1.8
+Summary: FastAPI integration for capturing LogBrew request spans and exceptions.
+Author: LogBrew
+License-Expression: MIT
+Project-URL: Repository, https://github.com/LogBrewCo/sdk
+Keywords: logbrew,observability,fastapi,asgi,logs
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.111.1
+Requires-Dist: logbrew-sdk<0.2.0,>=0.1.7
+Provides-Extra: celery
+Requires-Dist: logbrew-sdk[celery]<0.2.0,>=0.1.7; extra == "celery"
+
 # logbrew-fastapi
 
 <p align="center">
@@ -12,6 +37,8 @@ FastAPI integration for capturing LogBrew request spans and exceptions with the
 python3 -m pip install logbrew-fastapi
 ```
 
+`logbrew-fastapi` requires Python 3.10 or newer.
+
 The package is typed, ships `py.typed`, and installs the compatible core `logbrew-sdk`. It supports FastAPI 0.111.1 and later. It does not install or replace application-owned HTTP clients such as `httpx` or `httpx2`. Keep the real project key in application configuration rather than source control.
 
 ## Production setup
@@ -161,6 +188,30 @@ def checkout(order_id: str) -> dict[str, object]:
 
 Run `python -m logbrew_fastapi.examples dependency-spans` to see a local request span parenting SQLite, cache, and queue child spans from an installed package. LogBrew does not patch database drivers, cache clients, queue frameworks, or broker metadata globally, and the helpers avoid SQL values, cache keys/values, queue bodies, headers, baggage, and tracestate.
 
+## Celery background jobs
+
+Install the optional Celery path when a FastAPI service publishes or processes Celery jobs:
+
+```bash
+python3 -m pip install "logbrew-fastapi[celery]"
+```
+
+The base FastAPI install stays Celery-free. The extra installs the compatible core Celery integration, which you attach only to the Celery app your service owns:
+
+```python
+from celery import Celery
+from logbrew_sdk import instrument_celery_app_with_logbrew_spans
+
+celery_app = Celery("checkout")
+celery_telemetry = instrument_celery_app_with_logbrew_spans(
+    celery_app,
+    client=client,
+    metadata={"service": "checkout-worker"},
+)
+```
+
+Producer and worker spans share W3C trace context. An unexpected final task failure emits one trace-correlated issue with task name and exception type only; retries and exception types declared through `task.throws` stay span-only. Task IDs, arguments, results, headers, exception messages, and stack traces are excluded. Uninstall direct instrumentation after tasks drain and before shutting down its client. Separate prefork workers need child-owned clients; follow the [core Celery lifecycle and encrypted persistence setup](https://github.com/LogBrewCo/sdk/tree/main/python/logbrew_py#automatic-celery-spans) instead of sharing the FastAPI process client across forks.
+
 Request duration metrics are opt-in. Set `capture_request_metrics=True` to emit an explicit `http.server.duration` histogram for completed requests:
 
 ```python

logbrew_fastapi-0.1.8/src/logbrew_fastapi.egg-info/requires.txt

@@ -0,0 +1,5 @@
+fastapi>=0.111.1
+logbrew-sdk<0.2.0,>=0.1.7
+
+[celery]
+logbrew-sdk[celery]<0.2.0,>=0.1.7

logbrew_fastapi-0.1.6/src/logbrew_fastapi.egg-info/requires.txt

@@ -1,2 +0,0 @@
-fastapi>=0.111.1
-logbrew-sdk<0.2.0,>=0.1.5