envwarden 0.1.0

Compare .env against .env.example and find missing or undocumented variables

env-guard

Compare .env against .env.example and find missing or undocumented variables — great for CI and onboarding.

Install

pip install env-guard

Usage

# Auto-detect .env and .env.example in current directory
env-guard

# Scan a specific project directory
env-guard /path/to/project

# Ignore undocumented keys (don't flag .env-only vars)
env-guard --allow-extra

# Don't warn about empty values
env-guard --no-warn-empty

# CI-friendly: only print issues, exit 0/1
env-guard --quiet

Example output

env:     .env
example: .env.example

✗ Missing (2) — required by .env.example but not in .env:
    DATABASE_URL
    REDIS_URL

⚠ Undocumented (1) — in .env but not in .env.example:
    MY_LOCAL_DEBUG_FLAG

⚠ Empty (1) — keys with no value set:
    SECRET_KEY

Exits with code 1 when missing or extra keys are found, 0 when all clear.

Supported example file names

• .env.example
• .env.sample
• .env.template

CI integration

- name: Verify .env matches .env.example
  run: env-guard --quiet

License

MIT