示例

Inject context variables into structlog loggers with merge_contextvars, scoped lifecycles, and asynchronous task isolation

sha256:6dec637d6343afe74048a5fc63a4dfef59e139a0fac7ba3e70880f3c05d653fa

案例

目标

Inject context variables into structlog loggers with merge_contextvars, scoped lifecycles, and asynchronous task isolation HOW

包

structlog 26.1.0

环境

python

创建时间

2026-08-17T19:44:47Z

常见的想当然

Calling bind_contextvars automatically propagates context variables to all structlog loggers without requiring merge_contextvars in the processor chain.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• Calling bind_contextvars has no effect on log output unless merge_contextvars is explicitly present in the processor chain, and bound logger fields override conflicting context variables.
• bound_contextvars restores previous context values upon block exit or exception while preserving unrelated keys.
• reset_contextvars with tokens returned by bind_contextvars restores previous variable bindings.
• unbind_contextvars deletes specified keys and clear_contextvars removes all context variables.
• get_merged_contextvars returns current contextvars merged with bound logger context without mutating either.
• Concurrent asyncio tasks inherit parent contextvars but mutate their context in complete isolation without leaking to siblings or the parent.

文件

• NOTES.md
• csx.json
• pyproject.toml
• requirements.lock
• requirements.txt
• test/contract.py

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• python 3.12 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · python@1 · 2026-08-17 · ed25519:d91480838ac982c9