# dotenv-fusion

> Compose, validate, encrypt, and deliver environment configuration from one readable source.

dotenv-fusion is a dependency-free Python CLI and library for composing dotenv files with imports, conditions, typed contracts, validation, and allowlisted secret sources. Prefer `exec` when an application can receive its environment directly; `fuse` deliberately writes a protected plaintext artifact for tools that require a file.

## Start

- [Overview](https://dotenv-fusion-988a9a.gitlab.io/): Choose between direct execution, shell loading, and generated dotenv files.
- [Installation](https://dotenv-fusion-988a9a.gitlab.io/installation/): Install the package, CLI, standalone script, and optional age support.
- [Quick Start](https://dotenv-fusion-988a9a.gitlab.io/getting-started/): Create a first configuration and resolve it with the CLI.

## Guides

- [Shared schema contracts](https://dotenv-fusion-988a9a.gitlab.io/schema/): Define reusable types, requirements, constraints, and secret selectors.
- [Run an application](https://dotenv-fusion-988a9a.gitlab.io/run/): Validate and inject configuration without an intermediate dotenv file.
- [Generate a dotenv file](https://dotenv-fusion-988a9a.gitlab.io/fuse/): Compile configuration for tools that require a flat file.
- [Docker and Compose](https://dotenv-fusion-988a9a.gitlab.io/containers/): Deliver configuration safely to containers.
- [Age-backed secrets](https://dotenv-fusion-988a9a.gitlab.io/secrets/): Configure encrypted bundles, identities, stores, and runtime resolution.
- [Secret migration](https://dotenv-fusion-988a9a.gitlab.io/migrate/): Move selected values from an existing dotenv file into an age bundle.
- [Secret security](https://dotenv-fusion-988a9a.gitlab.io/secret-security/): Understand plaintext boundaries, redaction, and backend limitations.

## Reference

- [Syntax and directives](https://dotenv-fusion-988a9a.gitlab.io/directives/): Dotenv syntax, imports, conditions, definitions, schemas, and processing modes.
- [Resolution and precedence](https://dotenv-fusion-988a9a.gitlab.io/resolution/): Input selection, expansion, imports, overrides, and environment precedence.
- [CLI commands](https://dotenv-fusion-988a9a.gitlab.io/reference/): Complete command and option reference.
- [Python API](https://dotenv-fusion-988a9a.gitlab.io/python-api/): Public loader functions, classes, and result objects.

## Project

- [Roadmap](https://dotenv-fusion-988a9a.gitlab.io/roadmap/): Current baseline, planned work, later ideas, and non-goals.
- [Source repository](https://gitlab.com/pytgaen-group/dotenv-fusion): Source code, issues, releases, and license.