stratify 1.1.0

Layered configuration and structured logging for Rust services: pluggable sources, priority merging, typed access, and a tracing facade
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

[package]
name = "stratify"
version = "1.1.0"
edition = "2021"
rust-version = "1.88.0"
description = "Layered configuration and structured logging for Rust services: pluggable sources, priority merging, typed access, and a tracing facade"
license = "MIT"
repository = "https://github.com/LogicOcean/stratify"
documentation = "https://docs.rs/stratify"
readme = "README.md"
keywords = ["config", "configuration", "logging", "layered", "tracing"]
categories = ["config", "development-tools::debugging"]

[dependencies]
serde = { version = "1", features = ["derive"] }
serde_json = "1"
serde_norway = "0.9"
toml = "1"
dotenvy = "0.15"
thiserror = "2"
tracing = "0.1"
async-trait = "0.1"

# Optional, enabled by the `azure` feature.
azure_core = { version = "1", optional = true }
reqwest = { version = "0.13", default-features = false, features = ["json", "rustls"], optional = true }

# Optional, enabled by the `logging` feature.
tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt", "json", "time"], optional = true }
tracing-appender = { version = "0.2", optional = true }
time = { version = "0.3", features = ["formatting", "local-offset", "macros"], optional = true }

# Optional, enabled by the `compression` feature.
flate2 = { version = "1", optional = true }

# Optional, enabled by the `appinsights` feature. There is no official Azure
# Monitor SDK for Rust, so export goes through OpenTelemetry.
opentelemetry = { version = "0.32", optional = true }
opentelemetry_sdk = { version = "0.32", optional = true }
opentelemetry-application-insights = { version = "0.45", default-features = false, features = ["logs", "trace"], optional = true }
opentelemetry-appender-tracing = { version = "0.32", optional = true }
tracing-opentelemetry = { version = "0.33", optional = true }
opentelemetry-http = { version = "0.32", features = ["reqwest-blocking"], optional = true }

[dev-dependencies]
tempfile = "3"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }
azure_identity = "1"
# Sets file mtimes in the log-retention tests.
filetime = "0.2"

[features]
default = []

# Azure App Configuration source. The caller supplies the credential, so
# azure_identity is their dependency rather than ours.
azure = ["dep:azure_core", "dep:reqwest"]

# The logging half: `stratify::logging`, a non-blocking tracing facade with
# console, JSON, file and syslog sinks. Configuration stays the base crate —
# this feature only ever adds.
logging = ["dep:tracing-subscriber", "dep:tracing-appender", "dep:time"]

# Gzip retired log files. Accepted and ignored by the API without the feature,
# so enabling it later needs no code change.
compression = ["logging", "dep:flate2"]

# Export to Azure Application Insights, with trace correlation.
appinsights = [
    "logging",
    "dep:opentelemetry",
    "dep:opentelemetry_sdk",
    "dep:opentelemetry-application-insights",
    "dep:opentelemetry-appender-tracing",
    "dep:tracing-opentelemetry",
    "dep:opentelemetry-http",
    "reqwest/blocking",
    "dep:reqwest",
]

# The Azure example needs the feature and the credential crate, so it must not
# be built by a default `cargo build --examples`.
[[example]]
name = "azure"
required-features = ["azure"]

# The logging examples exercise the logging half.
[[example]]
name = "logging_basic"
required-features = ["logging"]

[[example]]
name = "file_rotation"
required-features = ["logging"]

[[example]]
name = "filter_reload"
required-features = ["logging"]

[package.metadata.docs.rs]
all-features = true

# Debug info across the appinsights dependency tree overflows a 32-bit
# relocation and the link fails outright:
#   relocation R_X86_64_32 out of range ... consider recompiling with
#   -fdebug-types-section
# `split-debuginfo = "unpacked"` leaves DWARF in separate object files instead
# of copying it into the linked binary, which is what keeps the link inside the
# limit; line tables are all a backtrace needs and shrink it further. Both
# profiles are set because cargo builds the test binaries under `test` and the
# dependencies they link under `dev`, so either one alone still fails.
[profile.dev]
debug = "line-tables-only"
split-debuginfo = "unpacked"

[profile.test]
debug = "line-tables-only"
split-debuginfo = "unpacked"