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

{logbrew_fastapi-0.1.7/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.7
+Version: 0.1.8
 Summary: FastAPI integration for capturing LogBrew request spans and exceptions.
 Author: LogBrew
 License-Expression: MIT
@@ -19,7 +19,9 @@ 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.6
+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
 
@@ -186,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.7/PKG-INFO → logbrew_fastapi-0.1.8/README.md

@@ -1,26 +1,3 @@
-Metadata-Version: 2.4
-Name: logbrew-fastapi
-Version: 0.1.7
-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.6
-
 # logbrew-fastapi
 
 <p align="center">
@@ -186,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.7 → logbrew_fastapi-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logbrew-fastapi"
-version = "0.1.7"
+version = "0.1.8"
 description = "FastAPI integration for capturing LogBrew request spans and exceptions."
 readme = "README.md"
 license = "MIT"
@@ -27,9 +27,12 @@ classifiers = [
 ]
 dependencies = [
   "fastapi>=0.111.1",
-  "logbrew-sdk>=0.1.6,<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.7/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">
@@ -163,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.7/src/logbrew_fastapi.egg-info/requires.txt

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