Metadata-Version: 2.4
Name: dotcompare
Version: 0.1.0
Summary: Compare .env files — find missing variables before they find you
License: MIT
Project-URL: Repository, https://github.com/shahabRDZ/dotcompare
Keywords: dotenv,env,compare,config,devops,ci
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

<h1 align="center">dotcompare</h1>
<p align="center"><strong>Compare .env files — find missing variables before they find you</strong></p>
<p align="center">
  <img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&logoColor=white" />
  <img src="https://img.shields.io/badge/dependencies-zero-brightgreen" />
  <img src="https://img.shields.io/badge/license-MIT-green" />
</p>

---

## Install

```bash
pip install dotcompare
```

## Usage

```python
from dotcompare import compare_env_files

diff = compare_env_files(".env.example", ".env")
print(diff.summary())
```

Output:
```
Missing in target (2):
  - DATABASE_URL
  - SECRET_KEY
Extra in target (1):
  + DEBUG_MODE
```

## Features

- Compare any two .env files
- Find missing, extra, and changed variables
- Colored terminal output
- Value comparison (optional)
- Handles comments, blank lines, quoted values
- Zero dependencies
- Use in CI to block deploys with missing env vars

## CI Integration

```yaml
- name: Check env vars
  run: python -c "
    from dotcompare import compare_env_files
    diff = compare_env_files('.env.example', '.env.production')
    if diff.has_issues:
      print(diff.summary())
      exit(1)
  "
```

## License

MIT
