Metadata-Version: 2.4
Name: envfile-checker
Version: 0.1.0
Summary: Check .env files for missing variables, placeholders, and sensitive data
Project-URL: Homepage, https://indiekit.ai
Project-URL: Repository, https://github.com/indiekitai/env-checker
Project-URL: Issues, https://github.com/indiekitai/env-checker/issues
Author-email: IndieKit <hello@indiekit.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: check,dotenv,env,environment,validate,variables
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# env-checker 🔍

检查 `.env` 文件的健康状态：缺失变量、占位符、敏感信息、格式问题。

## 痛点

- 部署时忘记更新 `.env`，服务挂了
- `.env.example` 和 `.env` 不同步，新成员 onboard 出问题
- 敏感信息误提交到 git
- 占位符忘记替换

## 安装

```bash
pip install env-checker
```

## 使用

```bash
# 分析单个文件
env-checker .env

# 比较两个文件（检查缺失变量）
env-checker .env .env.example

# 检查目录中所有 .env 文件
env-checker --dir ./myproject

# JSON 格式输出（方便脚本处理）
env-checker .env --json
```

## 示例输出

```
📊 分析: .env
============================================================
📝 总变量数: 12

⚠️  空值变量 (2):
   • DATABASE_URL
   • REDIS_URL

📌 占位符变量 (1):
   • API_KEY (your-api-key-here)

🔐 敏感变量 (3):
   • SECRET_KEY: a1b2c3d4e5f6...
   • AWS_SECRET_ACCESS_KEY: AKIA...
   • JWT_SECRET: eyJhbGciOi...

✅ 格式检查通过
```

## 比较模式

```
📊 比较: .env.example vs .env
============================================================

❌ .env 中缺失的变量:
   • NEW_FEATURE_FLAG
   • ANALYTICS_KEY

⚠️  .env.example 中缺失的变量:
   • DEBUG_MODE

🔄 值不同的变量:
   • NODE_ENV
```

## 功能

| 功能 | 说明 |
|------|------|
| 缺失检测 | 比较两个文件，找出缺失的变量 |
| 占位符检测 | 找出 `your-xxx`、`changeme`、`TODO` 等占位符 |
| 敏感信息检测 | 找出 password、secret、token 等敏感变量 |
| 空值检测 | 找出没有赋值的变量 |
| 格式检查 | 检查变量名格式、特殊字符转义 |

## CI/CD 集成

```yaml
# GitHub Actions
- name: Check env files
  run: |
    pip install env-checker
    env-checker .env.example .env.production --json > env-report.json
```

## License

MIT - Built by [IndieKit](https://indiekit.ai)
