log-foundry 0.5.1.dev11__tar.gz → 0.6.1.dev1__tar.gz

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: log-foundry
-Version: 0.5.1.dev11
+Version: 0.6.1.dev1
 Summary: Generate logs for your console and JSON events for downstream consumption.
 License-Expression: MIT
 License-File: LICENSE

log_foundry-0.6.1.dev1/pyproject.toml

@@ -0,0 +1,162 @@
+[project]
+# Distribution name on PyPI; the import name matches it (`log_foundry`, see src/).
+# The project was originally "log-forge", which PyPI rejects as too similar to the unrelated,
+# pre-existing "logforge" project — its similarity check collapses separators.
+name = "log-foundry"
+# The version is derived from Git tags at build time (poetry-dynamic-versioning).
+# Do not add a literal `version` key back here.
+dynamic = []
+description = "Generate logs for your console and JSON events for downstream consumption."
+authors = [
+    { name = "Andrew Griffith" }
+]
+license = "MIT"
+readme = "README.md"
+# 3.12 is the floor because that is the newest runtime a large class of deployed AWS Lambda
+# fleets is on, and nothing in the library needs 3.13 (SPEC-013 FR-001). CI runs the full gate
+# on 3.12 *and* 3.13 — the declaration follows the evidence.
+requires-python = ">=3.12"
+dependencies = [
+]
+
+# Optional features. Install with: pip install log-foundry[aws]
+version = "0.6.1.dev1"
+
+[project.optional-dependencies]
+aws = ["boto3>=1.34"]              # SQSSink, SNSSink, KinesisSink, FirehoseSink
+sentry = ["sentry-sdk>=2.0"]
+kafka = ["confluent-kafka>=2.0"]
+redis = ["redis>=5.0"]
+amqp = ["pika>=1.3"]
+nats = ["nats-py>=2.6"]
+gcp-pubsub = ["google-cloud-pubsub>=2.18"]
+azure-eventhubs = ["azure-eventhub>=5.11"]
+# clickhouse-connect caps at Python <3.15; marker scopes it so the unbounded project range resolves.
+clickhouse = ["clickhouse-connect>=0.7; python_version < '3.15'"]
+mongo = ["pymongo>=4.6"]
+postgres = ["psycopg[binary]>=3.1"]
+
+[tool.poetry]
+# Poetry still requires this field to exist; it is only a placeholder.
+# The real value is injected from Git tags during the build.
+
+# src layout: map the package from the src/ directory
+packages = [
+    { include = "log_foundry", from = "src" },
+]
+
+# Non-Python files to include in the package
+include = [
+    "src/log_foundry/py.typed",  # PEP 561 marker for typed packages
+]
+
+# Files to exclude from the package
+exclude = [
+    "tests/**/*",
+    "docs/**/*",
+]
+
+# Development-only dependencies (not shipped to consumers).
+# Install with: poetry install --with dev
+[tool.poetry.group.dev.dependencies]
+pytest = "^9.0"
+pytest-asyncio = "^1.4.0"        # for testing async @trace (guide Phase 8)
+pytest-cov = "^7.1.0"
+# Bounded to a minor, not left open. Ruff's DEFAULT rule set is not stable across minors —
+# 0.16.0 widened it from 59 rules to 413 — so an open constraint lets a release change what
+# CI enforces. `[tool.ruff.lint] select` below is the other half: the bound makes the change
+# deliberate, the select makes the set ours.
+ruff = ">=0.16,<0.17"
+mypy = "^1.10"
+
+
+[tool.poetry-dynamic-versioning]
+enable = false
+vcs = "git"
+style = "pep440"
+bump = true       # development builds sort after the last release (e.g. 0.0.2.devN)
+metadata = false  # drop the +<hash> local segment so PyPI accepts the upload
+
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0", "poetry-dynamic-versioning>=1.4.0,<2.0.0"]
+build-backend = "poetry_dynamic_versioning.backend"
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]             # src layout: make `import log_foundry` work without an install
+asyncio_mode = "auto"            # async test functions run without an explicit marker
+addopts = "--strict-markers"
+
+[tool.ruff]
+src = ["src", "tests"]
+line-length = 100
+# Deliberately no `target-version`: ruff infers it from `requires-python`, so the two can never
+# drift. If one is ever added it must match the floor above.
+
+[tool.ruff.lint]
+# THE RULE SET IS CHOSEN HERE, NOT INHERITED. Ruff's default set is not a stable contract:
+# 0.16.0 widened it from 59 rules to 413. Selecting explicitly means a ruff release can add
+# rules *inside* a family we asked for, but cannot decide which families CI enforces. The
+# `>=0.16,<0.17` bound on the dev dependency is the other half of that.
+select = [
+    "F",                    # pyflakes
+    "E4", "E7", "E9",       # pycodestyle errors. NOT E5: `line-length` above is advisory
+                            # today (it feeds `ruff format`, which this repo does not run) and
+                            # 52 lines in src+tests exceed it. Enforcing it is 52 reflows and
+                            # its own decision.
+    "W",
+    "I",                    # import sorting
+    "B",                    # bugbear
+    "UP",                   # pyupgrade — the floor is 3.12, keep the syntax current
+    "SIM", "C4", "PIE", "RET", "FURB", "PERF",
+    "RUF",
+    "S",                    # bandit
+    "BLE", "TRY",           # exception hygiene — the decorator's contract is about exceptions
+    "LOG", "G",
+    "DTZ",                  # naive datetimes: this library stamps every event's timestamp
+    "ASYNC",                # @trace is async-aware (SPEC-003)
+    "PYI", "YTT", "FLY", "INT", "TC", "FA", "PGH", "EXE", "ISC",
+]
+
+# Each entry is a decision with its reason, not a backlog.
+ignore = [
+    "BLE001",   # THE central one. `except Exception` in a sink is the architecture, not a
+                # slip: a broken destination must degrade logging and nothing more, and the
+                # decorator must never raise into the caller (arch §4). Eleven of these, all
+                # in sinks/ and worker.py, all load-bearing.
+    "TRY003",   # messages are written at the raise site; a class per message would add names
+                # nothing reads.
+    "TRY300",   # "return in else" reads worse than the early return this code uses.
+    "TRY400",   # this library IS the logger; it writes to stderr deliberately, and
+                # logger.exception is not available to it.
+    "S110",     # try/except/pass is the shape of "logging must never break the caller"
+                # (arch §4). Every occurrence carries a written reason.
+    "SIM105",   # same sites as S110: contextlib.suppress would hide the written reason
+                # behind an import.
+    "PERF203",  # try/except inside a loop is deliberate in the worker's drain: one bad batch
+                # must not abort the rest.
+    "S608",     # postgres.py and sqlite.py build INSERTs around a table name they validate
+                # themselves; the values are always parameterised.
+    "UP047",    # PEP 695 `def f[T](...)`. Valid on the 3.12 floor, but rewriting the public
+                # `@trace` decorator's generics is a change to the signature users read, and
+                # the TypeVar form is not deprecated. Its own PR if ever.
+    "RUF002", "RUF003",  # ambiguous-unicode in docstrings/comments: this codebase writes
+                # –, ×, → and — on purpose.
+]
+
+[tool.ruff.lint.per-file-ignores]
+# Asserts are the test framework; the rest are fixtures that only look like secrets, naive
+# datetimes under test on purpose, and raises inside a `try` that IS the thing under test.
+"tests/**/*.py" = ["S101", "S106", "DTZ001", "TRY301"]
+# FileSink and RotatingFileSink hold a handle open ACROSS calls by design — that is what makes
+# them a sink rather than a per-event open(). A context manager would close it after one emit.
+"src/log_foundry/sinks/file.py" = ["SIM115"]
+
+[tool.mypy]
+files = ["src"]
+# Must be the *lowest* supported version, not the newest: mypy checks against this, so a 3.13-only
+# API would type-check clean on a 3.12 floor and fail as an AttributeError in a consumer's runtime.
+python_version = "3.12"
+strict = true

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/context.py

@@ -24,21 +24,24 @@ if TYPE_CHECKING:
     from log_foundry.model import Span
 
 __all__ = [
+    "current_baggage_header",
     "current_span",
-    "push_span",
-    "pop_span",
+    "current_trace_context",
+    "current_traceparent",
     "get_baggage",
+    "pop_span",
+    "push_span",
     "set_baggage",
-    "current_traceparent",
-    "current_trace_context",
-    "current_baggage_header",
 ]
 
 _span_stack: contextvars.ContextVar[tuple[Span, ...]] = contextvars.ContextVar(
     "log_foundry_span_stack", default=()
 )
 _baggage: contextvars.ContextVar[dict[str, object]] = contextvars.ContextVar(
-    "log_foundry_baggage", default={}
+    "log_foundry_baggage",
+    default={},  # noqa: B039 - the never-mutate rule in this module's docstring is what
+    # makes the shared default safe: `set_baggage` replaces the dict, `get_baggage` is not
+    # exported, and both internal readers treat it read-only.
 )
 # An inbound trace context adopted via ``continue_trace`` (SPEC-014), applied by ``_open_span``
 # to the next *root* span. A ContextVar for the same reason as the two above: it is then correct

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/decorator.py

@@ -42,7 +42,7 @@ from log_foundry.ids import (
 from log_foundry.model import Span, backfill_baggage, end_event, start_event
 from log_foundry.worker import Health, Worker
 
-__all__ = ["trace", "continue_trace"]
+__all__ = ["continue_trace", "trace"]
 
 # Bound on how much of a rejected inbound value is echoed into a stderr warning.
 _MAX_REJECTED_ECHO = 64
@@ -70,7 +70,7 @@ def _open_span(name: str, defaults: dict[str, object] | None) -> Span:
         trace_id, parent_span_id = parent.trace_id, parent.span_id
     else:
         adopted = context.get_adopted_context()
-        trace_id, parent_span_id = adopted if adopted else (new_trace_id(), None)
+        trace_id, parent_span_id = adopted or (new_trace_id(), None)
     span = Span(
         trace_id=trace_id,
         span_id=new_span_id(),
@@ -229,7 +229,7 @@ def _flush_worker(timeout: float | None = 5.0) -> bool:
         return True
     try:
         return worker.flush(timeout)
-    except Exception:  # noqa: BLE001 — a flush is the call most likely to be made in a
+    except Exception:  # a flush is the call most likely to be made in a
         # `finally`, so the library must never be the reason a caller's function fails. Any
         # failure is reported by the return value instead (FR-003).
         return False
@@ -311,7 +311,7 @@ def trace(
                 finally:
                     context.pop_span(token)
 
-            return cast(F, async_wrapper)
+            return cast("F", async_wrapper)
 
         @functools.wraps(fn)
         def wrapper(*args: Any, **kwargs: Any) -> Any:
@@ -328,6 +328,6 @@ def trace(
             finally:
                 context.pop_span(token)
 
-        return cast(F, wrapper)
+        return cast("F", wrapper)
 
     return decorate(func) if func is not None else decorate

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/ids.py

@@ -17,13 +17,13 @@ import os
 import uuid
 
 __all__ = [
-    "new_trace_id",
-    "new_span_id",
-    "new_log_id",
-    "parse_traceparent",
     "format_traceparent",
-    "is_valid_trace_id",
     "is_valid_span_id",
+    "is_valid_trace_id",
+    "new_log_id",
+    "new_span_id",
+    "new_trace_id",
+    "parse_traceparent",
 ]
 
 _HEX = frozenset("0123456789abcdef")
@@ -91,7 +91,7 @@ def parse_traceparent(value: object) -> tuple[str, str] | None:
     version, trace_id, span_id, flags = parts[0], parts[1], parts[2], parts[3]
     if not _is_hex(version, 2) or version == _INVALID_VERSION:
         return None
-    if version == _VERSION:
+    if version == _VERSION:  # noqa: SIM102 - kept nested so the comment below stays attached
         # Version 00 is defined as exactly four fields; a trailing field is malformed, not a
         # forward-compatible extension.
         if len(parts) != 4 or not _is_hex(flags, 2):

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/model.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 import time
 import traceback
 from dataclasses import dataclass, field
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from typing import TYPE_CHECKING
 
 from log_foundry.sanitize import sanitize_fields, truncate_str, truncate_tail
@@ -19,7 +19,7 @@ from log_foundry.sanitize import sanitize_fields, truncate_str, truncate_tail
 if TYPE_CHECKING:
     from log_foundry.config import Config
 
-__all__ = ["Span", "build_event", "start_event", "end_event", "backfill_baggage"]
+__all__ = ["Span", "backfill_baggage", "build_event", "end_event", "start_event"]
 
 # Auto-generated span-boundary event messages. Tests assert on contract fields
 # (``status``, ``trace_id``), never on this text — rename freely.
@@ -52,7 +52,7 @@ class Span:
 
 def _iso_now() -> str:
     """Return the current UTC time as ISO-8601 with millisecond precision and a 'Z'."""
-    now = datetime.now(timezone.utc)
+    now = datetime.now(UTC)
     return f"{now:%Y-%m-%dT%H:%M:%S}.{now.microsecond // 1000:03d}Z"
 
 
@@ -121,7 +121,7 @@ def _exception_message(exc: BaseException) -> str:
     """
     try:
         return str(exc)
-    except Exception:  # noqa: BLE001 — see above; a hostile __str__ must not escape.
+    except Exception:  # see above; a hostile __str__ must not escape.
         return "<unprintable message>"
 
 
@@ -134,7 +134,7 @@ def _exception_stack(exc: BaseException) -> str:
     """
     try:
         return "".join(traceback.format_exception(type(exc), exc, exc.__traceback__))
-    except Exception:  # noqa: BLE001 — same reasoning as _exception_message.
+    except Exception:  # same reasoning as _exception_message.
         return f"<unformattable traceback: {type(exc).__name__}>"
 
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sanitize.py

@@ -137,7 +137,7 @@ class _Coercer:
         """Coerce one node. Total — never raises, whatever the value does."""
         try:
             return self._dispatch(value, depth)
-        except Exception:  # noqa: BLE001 — a hostile __iter__/__str__/__eq__ must not reach the
+        except Exception:  # a hostile __iter__/__str__/__eq__ must not reach the
             return self._placeholder(value)  # caller's stack; this is the whole point (FR-001).
 
     def _dispatch(self, value: object, depth: int) -> object:
@@ -246,7 +246,7 @@ class _Coercer:
         """Name the type that could not be coerced, without disclosing the value."""
         try:
             name = type(value).__name__
-        except Exception:  # noqa: BLE001 — a pathological metaclass is still not our problem.
+        except Exception:  # a pathological metaclass is still not our problem.
             name = "?"
         return f"<unserializable: {name}>"
 
@@ -277,7 +277,7 @@ def sanitize_fields(
         # would replace every field value with ``<depth limit>`` and emit a uniformly empty event,
         # which is exactly what FR-006's validation exists to prevent.
         result = coercer.mapping(fields, -1)
-    except Exception:  # noqa: BLE001 — belt and braces: `_Coercer.value` is already total, but
+    except Exception:  # belt and braces: `_Coercer.value` is already total, but
         return {}, True  # a hostile top-level mapping must not reach the caller either.
     if not isinstance(result, dict):
         # ``fields`` was itself circular — impossible from ``build_event``, which always passes a

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/_chunk.py

@@ -9,8 +9,10 @@ single request (callers drop oversized items first, counting ``dropped_oversized
 from __future__ import annotations
 
 import re
-from collections.abc import Callable, Iterator
-from typing import TypeVar
+from typing import TYPE_CHECKING, TypeVar
+
+if TYPE_CHECKING:
+    from collections.abc import Callable, Iterator
 
 __all__ = ["chunk_items", "chunk_list", "valid_identifier"]
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/_time.py

@@ -10,7 +10,7 @@ from __future__ import annotations
 import time
 from datetime import datetime
 
-__all__ = ["epoch_seconds", "epoch_nanos"]
+__all__ = ["epoch_nanos", "epoch_seconds"]
 
 
 def epoch_seconds(timestamp: object) -> float:

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/callback.py

@@ -7,7 +7,10 @@ and knows nothing about spans or context — that dumbness is what makes sinks s
 
 from __future__ import annotations
 
-from collections.abc import Callable
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
 
 __all__ = ["CallbackSink"]
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/file.py

@@ -147,9 +147,7 @@ class RotatingFileSink:
             and self._size + incoming > self._max_bytes
         ):
             return True
-        if self._next_rollover is not None and time.time() >= self._next_rollover:
-            return True
-        return False
+        return self._next_rollover is not None and time.time() >= self._next_rollover
 
     def _rotate(self) -> None:
         """Close the active file, shift/prune numbered backups, and open a fresh active file."""

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/filtering.py

@@ -8,9 +8,12 @@ time; this only reshapes an already-built batch on its way to a sink.
 
 from __future__ import annotations
 
-from collections.abc import Callable
+from typing import TYPE_CHECKING
 
-from log_foundry.sinks.base import Sink
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from log_foundry.sinks.base import Sink
 
 __all__ = ["FilteringSink"]
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/firehose.py

@@ -77,7 +77,9 @@ class FirehoseSink:
             results = response.get("RequestResponses", [])
             records = [
                 record
-                for record, result in zip(records, results)
+                # strict=False states today's behaviour. A short `results` would silently
+                # truncate this retry list — see the note in kinesis.py.
+                for record, result in zip(records, results, strict=False)
                 if result.get("ErrorCode")
             ]
             if not records:

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/http.py

@@ -20,7 +20,10 @@ import time
 import urllib.error
 import urllib.request
 from base64 import b64encode
-from typing import Any, Callable
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
 
 __all__ = ["HTTPSink", "merge_headers"]
 
@@ -109,7 +112,10 @@ class HTTPSink:
         """
         headers, data = self._prepare(body, content_type, extra_headers)
         for attempt in range(self.max_retries + 1):
-            request = urllib.request.Request(
+            # Opening `self.url` is this class's entire purpose. The URL is the application's
+            # own configured endpoint, never inbound data — an app that can set it can already
+            # read its own files.
+            request = urllib.request.Request(  # noqa: S310
                 self.url, data=data, method=self.method, headers=headers
             )
             try:

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/kinesis.py

@@ -85,7 +85,12 @@ class KinesisSink:
             results = response.get("Records", [])
             records = [
                 record
-                for record, result in zip(records, results)
+                # strict=False states today's behaviour rather than changing it. Note the
+                # latent case it preserves: if `results` came back shorter than `records`
+                # (or empty, via the `.get` default above), zip truncates, `records` empties
+                # and the batch reports success — the silent-loss shape SPEC-017 went after.
+                # Making that raise is a behaviour change, so it belongs in its own spec.
+                for record, result in zip(records, results, strict=False)
                 if result.get("ErrorCode")
             ]
             if not records:

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/logging_sink.py

@@ -96,7 +96,7 @@ class LoggingSink:
         fields = event.get("fields")
         if isinstance(fields, dict):
             # Nested payload is lossless even when a flat key collides and is skipped below.
-            setattr(record, "fields", fields)
+            record.fields = fields
             for key, value in fields.items():
                 # Skip reserved LogRecord attrs, identity keys, and "fields": the sink owns
                 # record.fields (the nested payload); a field named "fields" must not overwrite it.

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/logstash.py

@@ -54,7 +54,9 @@ class LogstashSink:
         if self._http is not None:
             self._http.emit(batch)
         else:
-            assert self._socket is not None
+            # Narrowing for mypy, not a runtime check: __init__ guarantees exactly one of
+            # _http/_socket is set, and the branch above covers the other.
+            assert self._socket is not None  # noqa: S101
             frames = [(json.dumps(event) + "\n").encode("utf-8") for event in batch]
             self._socket.send_all(frames)
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/multi.py

@@ -17,8 +17,10 @@ has nothing to retry.
 from __future__ import annotations
 
 import sys
+from typing import TYPE_CHECKING
 
-from log_foundry.sinks.base import Sink
+if TYPE_CHECKING:
+    from log_foundry.sinks.base import Sink
 
 __all__ = ["MultiSink"]
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/redis.py

@@ -15,7 +15,7 @@ import sys
 import time
 from typing import Any
 
-__all__ = ["RedisStreamsSink", "RedisListSink"]
+__all__ = ["RedisListSink", "RedisStreamsSink"]
 
 _BACKOFF_BASE = 0.1
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/sentry.py

@@ -102,7 +102,9 @@ class SentrySink:
         }
 
     def _post_envelope(self, event: dict[str, object]) -> None:
-        assert self._http is not None
+        # Narrowing for mypy, not a runtime check: _http is set in __init__ whenever the
+        # transport path that reaches here is in use.
+        assert self._http is not None  # noqa: S101
         header = {"event_id": uuid.uuid4().hex, "dsn": self._dsn}
         item_header = {"type": "event"}
         body = (

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/transform.py

@@ -9,9 +9,12 @@ example).
 
 from __future__ import annotations
 
-from collections.abc import Callable
+from typing import TYPE_CHECKING
 
-from log_foundry.sinks.base import Sink
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+    from log_foundry.sinks.base import Sink
 
 __all__ = ["TransformSink"]
 

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/sinks/util.py

@@ -13,7 +13,7 @@ from typing import TextIO
 
 from log_foundry.sinks.stdout import StdoutSink
 
-__all__ = ["StderrSink", "NullSink", "MemorySink"]
+__all__ = ["MemorySink", "NullSink", "StderrSink"]
 
 
 class StderrSink(StdoutSink):

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/worker.py

@@ -23,9 +23,10 @@ import queue
 import sys
 import threading
 import time
-from typing import NamedTuple, cast
+from typing import TYPE_CHECKING, NamedTuple, cast
 
-from log_foundry.sinks.base import Sink
+if TYPE_CHECKING:
+    from log_foundry.sinks.base import Sink
 
 __all__ = ["Health", "Worker"]
 
@@ -125,7 +126,7 @@ class Worker:
                     sys.stderr.write(
                         f"log-foundry: log queue full, dropped {total} submission(s) so far\n"
                     )
-                except Exception:  # noqa: BLE001 — submit() runs on the *caller's* thread, so an
+                except Exception:  # submit() runs on the *caller's* thread, so an
                     # unwritable stderr (closed fd, broken pipe, daemonized process) would raise
                     # straight into the app. A diagnostic about dropped logs must never itself be
                     # the reason a decorated function fails. The counter is already recorded.
@@ -267,7 +268,7 @@ class Worker:
             try:
                 self.sink.emit(batch)
                 return
-            except Exception:  # noqa: BLE001 — any sink failure must not kill the worker thread
+            except Exception:  # any sink failure must not kill the worker thread
                 if attempt >= self.max_retries:
                     # Under the lock so a concurrent health() sees a coherent snapshot rather
                     # than a half-updated pair. No deadlock: shutdown() releases before join().

log_foundry-0.5.1.dev11/pyproject.toml

@@ -1,99 +0,0 @@
-[project]
-# Distribution name on PyPI; the import name matches it (`log_foundry`, see src/).
-# The project was originally "log-forge", which PyPI rejects as too similar to the unrelated,
-# pre-existing "logforge" project — its similarity check collapses separators.
-name = "log-foundry"
-# The version is derived from Git tags at build time (poetry-dynamic-versioning).
-# Do not add a literal `version` key back here.
-dynamic = []
-description = "Generate logs for your console and JSON events for downstream consumption."
-authors = [
-    { name = "Andrew Griffith" }
-]
-license = "MIT"
-readme = "README.md"
-# 3.12 is the floor because that is the newest runtime a large class of deployed AWS Lambda
-# fleets is on, and nothing in the library needs 3.13 (SPEC-013 FR-001). CI runs the full gate
-# on 3.12 *and* 3.13 — the declaration follows the evidence.
-requires-python = ">=3.12"
-dependencies = [
-]
-
-# Optional features. Install with: pip install log-foundry[aws]
-version = "0.5.1.dev11"
-
-[project.optional-dependencies]
-aws = ["boto3>=1.34"]              # SQSSink, SNSSink, KinesisSink, FirehoseSink
-sentry = ["sentry-sdk>=2.0"]
-kafka = ["confluent-kafka>=2.0"]
-redis = ["redis>=5.0"]
-amqp = ["pika>=1.3"]
-nats = ["nats-py>=2.6"]
-gcp-pubsub = ["google-cloud-pubsub>=2.18"]
-azure-eventhubs = ["azure-eventhub>=5.11"]
-# clickhouse-connect caps at Python <3.15; marker scopes it so the unbounded project range resolves.
-clickhouse = ["clickhouse-connect>=0.7; python_version < '3.15'"]
-mongo = ["pymongo>=4.6"]
-postgres = ["psycopg[binary]>=3.1"]
-
-[tool.poetry]
-# Poetry still requires this field to exist; it is only a placeholder.
-# The real value is injected from Git tags during the build.
-
-# src layout: map the package from the src/ directory
-packages = [
-    { include = "log_foundry", from = "src" },
-]
-
-# Non-Python files to include in the package
-include = [
-    "src/log_foundry/py.typed",  # PEP 561 marker for typed packages
-]
-
-# Files to exclude from the package
-exclude = [
-    "tests/**/*",
-    "docs/**/*",
-]
-
-# Development-only dependencies (not shipped to consumers).
-# Install with: poetry install --with dev
-[tool.poetry.group.dev.dependencies]
-pytest = "^9.0"
-pytest-asyncio = "^1.4.0"        # for testing async @trace (guide Phase 8)
-pytest-cov = "^7.1.0"
-ruff = "^0.5"
-mypy = "^1.10"
-
-
-[tool.poetry-dynamic-versioning]
-enable = false
-vcs = "git"
-style = "pep440"
-bump = true       # development builds sort after the last release (e.g. 0.0.2.devN)
-metadata = false  # drop the +<hash> local segment so PyPI accepts the upload
-
-
-[build-system]
-requires = ["poetry-core>=2.0.0,<3.0.0", "poetry-dynamic-versioning>=1.4.0,<2.0.0"]
-build-backend = "poetry_dynamic_versioning.backend"
-
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-pythonpath = ["src"]             # src layout: make `import log_foundry` work without an install
-asyncio_mode = "auto"            # async test functions run without an explicit marker
-addopts = "--strict-markers"
-
-[tool.ruff]
-src = ["src", "tests"]
-line-length = 100
-# Deliberately no `target-version`: ruff infers it from `requires-python`, so the two can never
-# drift. If one is ever added it must match the floor above.
-
-[tool.mypy]
-files = ["src"]
-# Must be the *lowest* supported version, not the newest: mypy checks against this, so a 3.13-only
-# API would type-check clean on a 3.12 floor and fail as an AttributeError in a consumer's runtime.
-python_version = "3.12"
-strict = true

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/__init__.py

@@ -87,22 +87,22 @@ def shutdown() -> None:
 
 
 __all__ = [
+    "Health",
+    "__version__",
     "configure",
-    "get_config",
-    "trace",
-    "debug",
-    "info",
-    "warning",
-    "error",
-    "critical",
-    "set_baggage",
     "continue_trace",
-    "current_traceparent",
-    "current_trace_context",
+    "critical",
     "current_baggage_header",
+    "current_trace_context",
+    "current_traceparent",
+    "debug",
+    "error",
     "flush",
-    "shutdown",
+    "get_config",
     "health",
-    "Health",
-    "__version__",
+    "info",
+    "set_baggage",
+    "shutdown",
+    "trace",
+    "warning",
 ]

{log_foundry-0.5.1.dev11 → log_foundry-0.6.1.dev1}/src/log_foundry/api.py

@@ -20,12 +20,12 @@ from log_foundry.ids import new_span_id, new_trace_id
 from log_foundry.model import Span, build_event
 
 __all__ = [
+    "critical",
     "debug",
-    "info",
-    "warning",
     "error",
-    "critical",
+    "info",
     "set_baggage",
+    "warning",
 ]
 
 # One console writer per process (default stream sys.stderr). Configurable overrides are