adotenv 0.10.2

A tooling-grade .env parser: literal values (no variable expansion), exact byte spans, and edits that leave the rest of the file untouched.
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

# Roadmap

adotenv aims to be a precise `.env` toolkit for Rust: literal parsing, lossless
source, verified edits and explicit optional loading.

## Current scope

The current release provides:

- parsing and recovery for five syntax presets;
- typed positions, diagnostics and source maps;
- verified edits, formatting, sorting, comparison and examples;
- literal reference inspection and opt-in resolution;
- optional file loading with values, origins and reports;
- optional serde, process, CLI and `config`/Figment adapters.

## Near-term work

1. Complete the 1.0 evidence: sustained scheduled fuzz runs, a current
   performance record and at least one external project using a published crate.
2. Keep the public API stable. Additive changes use non-exhaustive types and
   builders.
3. Expand conformance cases only when a real upstream behavior is pinned and
   reproducible.
4. Keep the core dependency-free. New I/O, process or third-party behavior
   belongs in opt-in features or companion crates.

## 1.0 criteria

- The workspace release gate passes.
- The conformance corpus passes for every preset.
- Four consecutive scheduled fuzz runs pass for all five targets.
- A manual performance run is recorded and reviewed.
- At least one external project confirms use of a published crate.
- CLI schemas and library contracts are documented and frozen.

## Non-goals

- Implicit environment inheritance.
- Variable expansion during parsing.
- Command execution during parsing.
- A language server in the core crate.
- A WebAssembly playground in the core crate.

## Documentation

| Document | Content |
|---|---|
| [architecture.md](docs/design/architecture.md) | Document model, spans, diagnostics, edits |
| [dialects.md](docs/design/dialects.md) | Presets, policies, encoding, portability |
| [expansion.md](docs/design/expansion.md) | References, resolution, commands |
| [formatting.md](docs/design/formatting.md) | Formatting and group sorting |
| [comparison.md](docs/design/comparison.md) | Comparison and example generation |
| [loading.md](docs/design/loading.md) | Cascades, provenance, values-only loading |
| [serde.md](docs/design/serde.md) | Typed deserialization |
| [cli.md](docs/design/cli.md) | Command line tools and machine output |
| [integrations.md](docs/design/integrations.md) | `config` and Figment adapters |
| [quality.md](docs/design/quality.md) | Tests, fuzzing, conformance, MSRV |
| [performance.md](docs/design/performance.md) | Benchmarks and memory |
| [competitive-analysis.md](docs/design/competitive-analysis.md) | Competitor metrics and gaps |
| [1.0-readiness.md](docs/design/1.0-readiness.md) | Release evidence checklist |