Contributing guide

Thank you for investing your time in contributing to pimalaya-config.

Whether you are a human or an AI agent, read these in order before touching the code:

1. the Pimalaya README for what the project is and how its repositories stack;
2. the Pimalaya CONTRIBUTING guide, which chains to the shared architecture and guidelines;
3. the inline header documentation, starting with src/lib.rs: it is the architecture document of this crate;
4. this guide, for what differs from the Pimalaya standards.

Everything below documents only the differences.

Deliberately std

pimalaya-config loads files, spawns commands and expands environment variables, so it exposes no I/O-free coroutines and the no_std layer checks of the org guide do not apply: there is no coroutine core to keep std-free. The layers to build against are the two feature-gated modules:

cargo build --no-default-features                          # nothing, empty crate
cargo build --no-default-features --features toml          # TOML loader + shell expansion
cargo build --no-default-features --features secret        # secret resolution + command adapter
cargo build                                                # toml + secret (default)