[Insei]

The env driver reads the .env files in Load, before every Parse, instead of only in New, and implements Watcher: the files are watched by tree.WatchFiles (#63), by the events of the file system and by polling, the interval is set by the new WithWatchInterval option. Default files that do not exist yet are watched too.

On reload the driver changes only the variables it exported itself: the new value replaces the exported one, the variable removed from the file is unset. Variables set by the process environment or changed by the application are not touched. With WithFilesIsolation the values are replaced in the driver only.

Changes of the behavior:

• Subscribe with the env driver no longer returns ErrNoWatchers, the .env files are watched;
• an absent file from WithFiles that is removed after New is an error of Parse.

Documentation: the env driver page, the table of watched sources, the skill for AI agents.

[github-actions]

Benchmark diff: 1fa3322 → 15c4b0b (10 runs)

goos: linux
goarch: amd64
pkg: github.com/insei/tinyconf/v2
cpu: AMD EPYC 9V45 96-Core Processor                
                    │  base.txt   │              head.txt              │
                    │   sec/op    │   sec/op     vs base               │
Parse-4               1.859µ ± 8%   1.845µ ± 3%       ~ (p=0.171 n=10)
Parse_SubConfig-4     822.4n ± 2%   811.6n ± 3%       ~ (p=0.247 n=10)
Current-4             45.30n ± 2%   44.84n ± 3%       ~ (p=0.631 n=10)
Current_SubConfig-4   63.82n ± 1%   64.80n ± 3%  +1.54% (p=0.000 n=10)
geomean               257.8n        256.8n       -0.38%

                    │    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   29.18µ ± 5%   29.99µ ± 3%  +2.77% (p=0.043 n=10)

                │   base.txt   │              head.txt               │
                │     B/op     │     B/op      vs base               │
Parse_Drivers-4   25.14Ki ± 0%   25.27Ki ± 0%  +0.50% (p=0.000 n=10)

                │  base.txt  │             head.txt              │
                │ allocs/op  │ allocs/op   vs base               │
Parse_Drivers-4   408.0 ± 0%   411.0 ± 0%  +0.74% (p=0.000 n=10)

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1fa3322) to head (1b316fa).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main       #64   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           32        32           
  Lines         2646      2693   +47     
=========================================
+ Hits          2646      2693   +47     

☔ 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.