Skip to content

docs: rewrite Why tinyconf: for whom and for what - #58

Merged
Insei merged 2 commits into
mainfrom
why-tinyconf
Oct 19, 2026
Merged

Insei merged 2 commits into
mainfrom
why-tinyconf

Conversation

@Insei

@Insei Insei commented Oct 19, 2026

Copy link
Copy Markdown
Owner

"Why tinyconf?" is rewritten around for whom and for what tinyconf is.

  • For whom: modular services where every package owns its config, services that change config at runtime, services with many sources, teams that do not want to maintain config templates by hand.
  • What you get, with code: packages own their parts (Current, Subscribe per type), reloads that never modify the held version, one struct with one chain of drivers, the source of every value, templates from the code, light and tested, ready for AI agents.
  • The comparison table, "When another library fits better", the limitations and the migration are kept; the masking row of the table mentions the Secret type.
  • README and the description of the site say the same in two lines.

Insei added 2 commits October 19, 2026 06:56
Signed-off-by: Dmitriy Aleksandrov <goodmobiledevices@gmail.com>
… reloading, sources of values

Signed-off-by: Dmitriy Aleksandrov <goodmobiledevices@gmail.com>
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1314406) to head (736ef7b).

Additional details and impacted files
@@            Coverage Diff            @@
##              main       #58   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           32        32           
  Lines         2638      2638           
=========================================
  Hits          2638      2638           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions

Copy link
Copy Markdown
Contributor

Benchmark diff: 1314406 → eeeef47 (10 runs)

goos: linux
goarch: amd64
pkg: github.com/insei/tinyconf/v2
cpu: AMD EPYC 7763 64-Core Processor                
                    │  base.txt   │              head.txt              │
                    │   sec/op    │   sec/op     vs base               │
Parse-4               3.384µ ± 0%   3.404µ ± 3%  +0.58% (p=0.011 n=10)
Parse_SubConfig-4     1.565µ ± 0%   1.572µ ± 0%  +0.42% (p=0.014 n=10)
Current-4             55.45n ± 0%   55.44n ± 0%       ~ (p=0.303 n=10)
Current_SubConfig-4   99.12n ± 1%   99.25n ± 1%       ~ (p=0.239 n=10)
geomean               413.0n        414.2n       +0.28%

                    │    base.txt    │               head.txt                │
                    │      B/op      │     B/op      vs base                 │
Parse-4               1.344Ki ± 0%     1.344Ki ± 0%       ~ (p=1.000 n=10) ¹
Parse_SubConfig-4       392.0 ± 0%       392.0 ± 0%       ~ (p=1.000 n=10) ¹
Current-4               0.000 ± 0%       0.000 ± 0%       ~ (p=1.000 n=10) ¹
Current_SubConfig-4     0.000 ± 0%       0.000 ± 0%       ~ (p=1.000 n=10) ¹
geomean                            ²                 +0.00%                ²
¹ all samples are equal
² summaries must be >0 to compute geomean

                    │   base.txt   │              head.txt               │
                    │  allocs/op   │ allocs/op   vs base                 │
Parse-4               18.00 ± 0%     18.00 ± 0%       ~ (p=1.000 n=10) ¹
Parse_SubConfig-4     10.00 ± 0%     10.00 ± 0%       ~ (p=1.000 n=10) ¹
Current-4             0.000 ± 0%     0.000 ± 0%       ~ (p=1.000 n=10) ¹
Current_SubConfig-4   0.000 ± 0%     0.000 ± 0%       ~ (p=1.000 n=10) ¹
geomean                          ²               +0.00%                ²
¹ all samples are equal
² summaries must be >0 to compute geomean

pkg: github.com/insei/tinyconf/v2/drivers
                │  base.txt   │              head.txt              │
                │   sec/op    │   sec/op     vs base               │
Parse_Drivers-4   60.97µ ± 1%   60.30µ ± 1%  -1.09% (p=0.015 n=10)

                │   base.txt   │            head.txt            │
                │     B/op     │     B/op      vs base          │
Parse_Drivers-4   25.14Ki ± 0%   25.14Ki ± 0%  ~ (p=0.141 n=10)

                │  base.txt  │            head.txt            │
                │ allocs/op  │ allocs/op   vs base            │
Parse_Drivers-4   408.0 ± 0%   408.0 ± 0%  ~ (p=1.000 n=10) ¹
¹ all samples are equal

@Insei
Insei merged commit a66ecf8 into main Oct 19, 2026
4 checks passed
@Insei
Insei deleted the why-tinyconf branch October 19, 2026 04:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants