context-logger 0.2.0

A small structured context propagation layer for the standard Rust log ecosystem.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.2.0] - 2026.07.29

- Updated terminology: renamed structured context records to fields to avoid
  confusion with `log::Record`.
- Introduced a new method `ContextLogger::with_default_field_fn` that allows
  injecting custom default fields based on log record metadata, enabling more
  flexible and dynamic logging contexts.
- _breaking_ Introduced inherited context fields
  - `LogContext` now stores two separate sets of fields (`local` and
    `inherited`), each with its own propagation semantics:
    - `with_local_field(key, value)` — field is visible only in the current
      scope; overrides inherited fields with the same key in child scopes
    - `with_inherited_field(key, value)` — field propagates to child scopes;
      child local fields take priority over inherited ones
  - Introduced `LogFields` as a dedicated key-value collection for structured
    log fields.
  - `LogContext::new` is no longer constant
- Added `LogScope::in_scope` — runs synchronous closures within a temporary
  logging scope and exits it automatically.
- Added `LogContextExt::in_scope` — ergonomic method-style API for running a
  closure in a `LogContext` scope.
- Added `LogScope::current_context` — captures and clones the currently active
  logging context so it can be propagated to spawned threads and async tasks.
  See the new example [`current_context`](examples/current_context.rs).
- _breaking_ Replaced `LogContext::enter` instance method with the
  `LogScope::enter(context)` static method; `LogScope` is now the explicit guard
  type that keeps the context active and removes it from the stack on drop
- _breaking_ Moved `LogContext::add_record` to `LogScope::add_local_field`;
  dynamic field insertion is now clearly associated with the active scope rather
  than the context builder
- _breaking_ Renamed `LogContextGuard` to `LogScope` in the public API
- _breaking_ Renamed `ContextValue` to `LogValue` to better reflect its role in
  structured logging

## [0.1.4] - 2026.02.28

- Implemented `Clone` for `ContextValue` and `LogContext`
- Added `From<f32>` conversion for `ContextValue`

## [0.1.3] - 2025.08.29

- Fixed a bug where default records weren't applied without an active context

## [0.1.2] - 2025.08.28

- Added `default_record` method to `ContextLogger` that allows setting default
  records which will be included in all log entries regardless of context

## [0.1.1] - 2025.05.14

- Fixed `ContextLogger::try_init` method where the wrong object was being passed
  to `log::set_boxed_logger` (issue #3)

## [0.1.0] - 2025.05.11

- Initial release of `context_logger` crate.