envertor 0.1.0__tar.gz

envertor-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: envertor
+Version: 0.1.0
+Summary: Generate example .env files from existing .env files with placeholder detection.
+Author-email: Samin Yeasar <syeasar.kuet@gmail.com>
+Project-URL: Homepage, https://github.com/Y3454R/envertor
+Project-URL: Repository, https://github.com/Y3454R/envertor
+Keywords: dotenv,env,environment,cli,devtools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Envertor 🔍
+
+Envertor is a CLI tool that generates `.env.example` files by extracting environment variables from existing `.env` files or by scanning Python and JavaScript/TypeScript projects. It also helps keep your secrets safe with automatic `.gitignore` protection and CI/CD-ready parity checks.
+
+## Install
+
+```bash
+pip install envertor
+```
+
+**Development install:**
+```bash
+pip install -e .
+```
+
+---
+
+## Usage
+
+### Generate `.env.example` from an existing `.env`
+
+Strips real values and replaces them with type-appropriate placeholders:
+
+```bash
+envertor -i .env -o .env.example
+```
+
+| Original `.env` | Generated `.env.example` |
+|---|---|
+| `SECRET=mysecret` | `SECRET=''` |
+| `PORT=8080` | `PORT=0` |
+| `DEBUG=true` | `DEBUG=false` |
+| `RATE=3.14` | `RATE=0.0` |
+
+---
+
+### Scan a project for environment variables
+
+Detects env vars used in source code and generates `.env.example` from actual usage — no existing `.env` required:
+
+```bash
+envertor -p ./my-project -o .env.example
+```
+
+Limit scanning to a specific language:
+```bash
+envertor -p ./my-project --lang python
+envertor -p ./my-project --lang js
+```
+
+Supports:
+- **Python**: `os.getenv("VAR")`, `os.environ["VAR"]`, `os.environ.get("VAR")`
+- **JS/TS**: `process.env.VAR` (`.js`, `.ts`, `.jsx`, `.tsx`)
+
+---
+
+### Create `.env` from `.env.example`
+
+Bootstrap a local `.env` from the example file so teammates can fill in their own values:
+
+```bash
+envertor --create-env                        # reads .env.example by default
+envertor --create-env staging.env.example    # reads a custom file
+```
+
+If `.env` already exists, writes `.env.envertor` instead to avoid overwriting.
+
+---
+
+### Check parity between `.env` and `.env.example`
+
+Explicitly verify that both files have the same keys. Designed for CI/CD pipelines — exits `1` on mismatch:
+
+```bash
+envertor --check
+envertor --check --env-file /deploy/.env --example-file /repo/.env.example
+```
+
+Example output on failure:
+```
+[envertor] FAIL: Keys mismatch between .env and .env.example
+  Missing from .env:          NEW_KEY
+  Missing from .env.example:  OLD_KEY
+```
+
+Use in a pipeline:
+```yaml
+# GitHub Actions example
+- name: Check env parity
+  run: envertor --check --env-file .env --example-file .env.example
+```
+
+---
+
+### Show version
+
+```bash
+envertor -v
+```
+
+---
+
+## Automatic safety checks
+
+Every time envertor runs, it performs these checks automatically:
+
+**`.gitignore` protection** — ensures `.env` is listed in `.gitignore`. Creates the file if it doesn't exist:
+```
+[envertor] Created .gitignore with .env
+[envertor] Added .env to .gitignore
+```
+
+**Key parity warning** — warns if `.env` and `.env.example` have different keys:
+```
+[envertor] WARNING: Keys in .env not documented in .env.example: DB_URL
+[envertor] WARNING: Keys in .env.example not found in .env: NEW_KEY
+```
+
+**Leftover values warning** — warns if `.env.example` contains non-placeholder values (real secrets accidentally left behind):
+```
+[envertor] WARNING: .env.example has a real value set for API_KEY
+```
+
+---
+
+## Options
+
+| Flag | Description |
+|---|---|
+| `-i, --input FILE` | Path to input `.env` file |
+| `-o, --output FILE` | Path to output `.env.example` (default: `.env.example`) |
+| `-p, --project DIR` | Project folder to scan for env variable usage |
+| `--lang python\|js\|both` | Language filter for project scanning (default: `both`) |
+| `--create-env [FILE]` | Create `.env` from `FILE` (default: `.env.example`) |
+| `--check` | Check key parity and exit `1` on mismatch (CI/CD mode) |
+| `--env-file FILE` | `.env` path for `--check` (default: `.env`) |
+| `--example-file FILE` | `.env.example` path for `--check` (default: `.env.example`) |
+| `-v, --version` | Show version |
+
+---
+
+## Notes
+
+- Automatically skips `node_modules/`, `venv/`, `__pycache__/`, `.next/`, `.git/`, `.idea/`, `.vscode/`
+- Regex-based scanning catches the most common patterns (`os.getenv`, `os.environ`, `process.env`)
+- `.env.envertor` is a safe backup — rename it to `.env` or diff it against your existing one

envertor-0.1.0/README.md

@@ -0,0 +1,146 @@
+# Envertor 🔍
+
+Envertor is a CLI tool that generates `.env.example` files by extracting environment variables from existing `.env` files or by scanning Python and JavaScript/TypeScript projects. It also helps keep your secrets safe with automatic `.gitignore` protection and CI/CD-ready parity checks.
+
+## Install
+
+```bash
+pip install envertor
+```
+
+**Development install:**
+```bash
+pip install -e .
+```
+
+---
+
+## Usage
+
+### Generate `.env.example` from an existing `.env`
+
+Strips real values and replaces them with type-appropriate placeholders:
+
+```bash
+envertor -i .env -o .env.example
+```
+
+| Original `.env` | Generated `.env.example` |
+|---|---|
+| `SECRET=mysecret` | `SECRET=''` |
+| `PORT=8080` | `PORT=0` |
+| `DEBUG=true` | `DEBUG=false` |
+| `RATE=3.14` | `RATE=0.0` |
+
+---
+
+### Scan a project for environment variables
+
+Detects env vars used in source code and generates `.env.example` from actual usage — no existing `.env` required:
+
+```bash
+envertor -p ./my-project -o .env.example
+```
+
+Limit scanning to a specific language:
+```bash
+envertor -p ./my-project --lang python
+envertor -p ./my-project --lang js
+```
+
+Supports:
+- **Python**: `os.getenv("VAR")`, `os.environ["VAR"]`, `os.environ.get("VAR")`
+- **JS/TS**: `process.env.VAR` (`.js`, `.ts`, `.jsx`, `.tsx`)
+
+---
+
+### Create `.env` from `.env.example`
+
+Bootstrap a local `.env` from the example file so teammates can fill in their own values:
+
+```bash
+envertor --create-env                        # reads .env.example by default
+envertor --create-env staging.env.example    # reads a custom file
+```
+
+If `.env` already exists, writes `.env.envertor` instead to avoid overwriting.
+
+---
+
+### Check parity between `.env` and `.env.example`
+
+Explicitly verify that both files have the same keys. Designed for CI/CD pipelines — exits `1` on mismatch:
+
+```bash
+envertor --check
+envertor --check --env-file /deploy/.env --example-file /repo/.env.example
+```
+
+Example output on failure:
+```
+[envertor] FAIL: Keys mismatch between .env and .env.example
+  Missing from .env:          NEW_KEY
+  Missing from .env.example:  OLD_KEY
+```
+
+Use in a pipeline:
+```yaml
+# GitHub Actions example
+- name: Check env parity
+  run: envertor --check --env-file .env --example-file .env.example
+```
+
+---
+
+### Show version
+
+```bash
+envertor -v
+```
+
+---
+
+## Automatic safety checks
+
+Every time envertor runs, it performs these checks automatically:
+
+**`.gitignore` protection** — ensures `.env` is listed in `.gitignore`. Creates the file if it doesn't exist:
+```
+[envertor] Created .gitignore with .env
+[envertor] Added .env to .gitignore
+```
+
+**Key parity warning** — warns if `.env` and `.env.example` have different keys:
+```
+[envertor] WARNING: Keys in .env not documented in .env.example: DB_URL
+[envertor] WARNING: Keys in .env.example not found in .env: NEW_KEY
+```
+
+**Leftover values warning** — warns if `.env.example` contains non-placeholder values (real secrets accidentally left behind):
+```
+[envertor] WARNING: .env.example has a real value set for API_KEY
+```
+
+---
+
+## Options
+
+| Flag | Description |
+|---|---|
+| `-i, --input FILE` | Path to input `.env` file |
+| `-o, --output FILE` | Path to output `.env.example` (default: `.env.example`) |
+| `-p, --project DIR` | Project folder to scan for env variable usage |
+| `--lang python\|js\|both` | Language filter for project scanning (default: `both`) |
+| `--create-env [FILE]` | Create `.env` from `FILE` (default: `.env.example`) |
+| `--check` | Check key parity and exit `1` on mismatch (CI/CD mode) |
+| `--env-file FILE` | `.env` path for `--check` (default: `.env`) |
+| `--example-file FILE` | `.env.example` path for `--check` (default: `.env.example`) |
+| `-v, --version` | Show version |
+
+---
+
+## Notes
+
+- Automatically skips `node_modules/`, `venv/`, `__pycache__/`, `.next/`, `.git/`, `.idea/`, `.vscode/`
+- Regex-based scanning catches the most common patterns (`os.getenv`, `os.environ`, `process.env`)
+- `.env.envertor` is a safe backup — rename it to `.env` or diff it against your existing one

envertor-0.1.0/envertor/__init__.py

@@ -0,0 +1,3 @@
+from .core import generate_example_env
+from .version import __version__
+

envertor-0.1.0/envertor/checker.py

@@ -0,0 +1,64 @@
+import os
+
+SAFE_PLACEHOLDERS = {"", "''", '""', "0", "0.0", "false"}
+
+
+def _parse_keys(filepath: str) -> set:
+    keys = set()
+    with open(filepath, "r") as f:
+        for line in f:
+            stripped = line.strip()
+            if not stripped or stripped.startswith("#"):
+                continue
+            if "=" in stripped:
+                key = stripped.split("=", 1)[0].strip()
+                keys.add(key)
+    return keys
+
+
+def _is_safe_placeholder(value: str) -> bool:
+    value = value.strip()
+    if "#" in value:
+        value = value.split("#", 1)[0].strip()
+    return value.lower() in SAFE_PLACEHOLDERS
+
+
+def check_key_parity(env_path: str, example_path: str, strict: bool = False):
+    env_keys = _parse_keys(env_path)
+    example_keys = _parse_keys(example_path)
+
+    missing_from_env = example_keys - env_keys
+    missing_from_example = env_keys - example_keys
+
+    if not missing_from_env and not missing_from_example:
+        if strict:
+            print(f"[envertor] OK: {env_path} and {example_path} keys match.")
+            return True
+        return None
+
+    if strict:
+        print(f"[envertor] FAIL: Keys mismatch between {env_path} and {example_path}")
+        if missing_from_env:
+            print(f"  Missing from {env_path}:      {', '.join(sorted(missing_from_env))}")
+        if missing_from_example:
+            print(f"  Missing from {example_path}: {', '.join(sorted(missing_from_example))}")
+        return False
+
+    if missing_from_env:
+        print(f"[envertor] WARNING: Keys in {example_path} not found in {env_path}: {', '.join(sorted(missing_from_env))}")
+    if missing_from_example:
+        print(f"[envertor] WARNING: Keys in {env_path} not documented in {example_path}: {', '.join(sorted(missing_from_example))}")
+    return None
+
+
+def check_example_values(example_path: str) -> None:
+    with open(example_path, "r") as f:
+        for line in f:
+            stripped = line.strip()
+            if not stripped or stripped.startswith("#"):
+                continue
+            if "=" in stripped:
+                key, value = stripped.split("=", 1)
+                key = key.strip()
+                if not _is_safe_placeholder(value):
+                    print(f"[envertor] WARNING: {example_path} has a real value set for {key}")

envertor-0.1.0/envertor/cli.py

@@ -0,0 +1,113 @@
+import os
+import shutil
+import sys
+import argparse
+
+from .core import generate_example_env
+from .scanner import scan_project
+from .gitignore import ensure_env_in_gitignore
+from .checker import check_key_parity, check_example_values
+from .version import __version__
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Envertor: Generate example .env files from existing .env or project"
+    )
+
+    parser.add_argument(
+        "-i", "--input",
+        default=None,
+        help="Path to input .env file"
+    )
+    parser.add_argument(
+        "-o", "--output",
+        default=".env.example",
+        help="Path to output example .env file"
+    )
+    parser.add_argument(
+        "-p", "--project",
+        default=None,
+        help="Project folder to auto-scan for env variables"
+    )
+    parser.add_argument(
+        "--lang",
+        choices=["python", "js", "both"],
+        default="both",
+        help="Languages to scan in project (default: both)"
+    )
+    parser.add_argument(
+        "-v", "--version",
+        action="store_true",
+        help="Show envertor version"
+    )
+    parser.add_argument(
+        "--create-env",
+        nargs="?",
+        const=".env.example",
+        default=None,
+        metavar="FILE",
+        help="Create .env from FILE (default: .env.example). Writes .env.envertor if .env already exists."
+    )
+    parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Check that .env and .env.example have matching keys. Exits 1 on mismatch."
+    )
+    parser.add_argument(
+        "--env-file",
+        default=".env",
+        help="Path to .env file for --check (default: .env)"
+    )
+    parser.add_argument(
+        "--example-file",
+        default=".env.example",
+        help="Path to .env.example file for --check (default: .env.example)"
+    )
+
+    args = parser.parse_args()
+
+    if args.version:
+        print(f"envertor v{__version__}")
+        return
+
+    if args.check:
+        ok = check_key_parity(args.env_file, args.example_file, strict=True)
+        sys.exit(0 if ok else 1)
+
+    if args.create_env is not None:
+        source = args.create_env
+        if not os.path.exists(source):
+            print(f"[envertor] ERROR: Source file '{source}' not found.")
+            sys.exit(1)
+        dest = ".env" if not os.path.exists(".env") else ".env.envertor"
+        shutil.copy(source, dest)
+        print(f"[envertor] Created {dest} from {source}")
+        return
+
+    if args.project:
+        languages = ("python", "js") if args.lang == "both" else (args.lang,)
+        env_vars = scan_project(args.project, languages)
+        with open(args.output, "w") as f:
+            for key in sorted(env_vars):
+                f.write(f"{key}=\n")
+        print(f"Generated {args.output} from project scan.")
+        ensure_env_in_gitignore(args.project)
+        env_path = os.path.join(args.project, ".env")
+        if os.path.exists(env_path) and os.path.exists(args.output):
+            check_key_parity(env_path, args.output)
+        if os.path.exists(args.output):
+            check_example_values(args.output)
+
+    elif args.input:
+        generate_example_env(args.input, args.output)
+        print(f"Created {args.output} from {args.input}")
+        project_dir = os.path.dirname(os.path.abspath(args.input))
+        ensure_env_in_gitignore(project_dir)
+        if os.path.exists(args.input) and os.path.exists(args.output):
+            check_key_parity(args.input, args.output)
+        if os.path.exists(args.output):
+            check_example_values(args.output)
+
+    else:
+        print("Provide either --input or --project")

envertor-0.1.0/envertor/core.py

@@ -0,0 +1,62 @@
+# envertor/core.py
+
+def detect_placeholder(value):
+    value = value.strip()
+
+    if value.lower() in ["true", "false"]:
+        return "false"
+
+    try:
+        int(value)
+        return "0"
+    except ValueError:
+        pass
+
+    try:
+        float(value)
+        return "0.0"
+    except ValueError:
+        pass
+
+    return "''"
+
+
+def generate_example_env(input_file, output_file):
+    with open(input_file, "r") as f:
+        lines = f.readlines()
+
+    new_lines = []
+
+    for line in lines:
+        stripped = line.strip()
+
+        if stripped.startswith("#") or not stripped:
+            new_lines.append(line)
+            continue
+
+        if "=" in line:
+            key, value_part = line.split("=", 1)
+            key = key.strip()
+
+            if "#" in value_part:
+                value, inline_comment = value_part.split("#", 1)
+                value = value.strip()
+                inline_comment = "# " + inline_comment.strip()
+            else:
+                value = value_part.strip()
+                inline_comment = ""
+
+            placeholder = detect_placeholder(value)
+
+            if inline_comment:
+                new_line = f"{key}={placeholder} {inline_comment}\n"
+            else:
+                new_line = f"{key}={placeholder}\n"
+
+            new_lines.append(new_line)
+        else:
+            new_lines.append(line)
+
+    with open(output_file, "w") as f:
+        f.writelines(new_lines)
+

envertor-0.1.0/envertor/gitignore.py

@@ -0,0 +1,25 @@
+import os
+
+
+def ensure_env_in_gitignore(project_path: str) -> None:
+    gitignore_path = os.path.join(project_path, ".gitignore")
+
+    if not os.path.exists(gitignore_path):
+        with open(gitignore_path, "w") as f:
+            f.write(".env\n")
+        print("[envertor] Created .gitignore with .env")
+        return
+
+    with open(gitignore_path, "r") as f:
+        lines = f.readlines()
+
+    for line in lines:
+        stripped = line.strip()
+        if stripped in (".env", "*.env"):
+            return
+
+    with open(gitignore_path, "a") as f:
+        if lines and not lines[-1].endswith("\n"):
+            f.write("\n")
+        f.write(".env\n")
+    print("[envertor] Added .env to .gitignore")

envertor-0.1.0/envertor/scanner.py

@@ -0,0 +1,74 @@
+# envertor/scanner.py
+import os
+import re
+
+# Directories that should NEVER be scanned
+SKIP_DIRS = {
+    "node_modules",
+    "venv",
+    "__pycache__",
+    ".next",
+    ".git",
+    ".idea",
+    ".vscode"
+}
+
+# Regex patterns
+PY_GETENV_PATTERN = re.compile(r'os\.getenv\(\s*[\'"]([A-Z0-9_]+)[\'"]\s*\)')
+PY_ENVIRON_PATTERN = re.compile(
+    r'os\.environ(?:\.get|\[)\s*[\'"]([A-Z0-9_]+)[\'"]\s*[\]\)]'
+)
+JS_ENV_PATTERN = re.compile(r'process\.env\.([A-Z0-9_]+)')
+
+def scan_python_file(path: str) -> set[str]:
+    """Extract env vars from a Python file."""
+    env_vars = set()
+    try:
+        with open(path, "r", encoding="utf-8", errors="ignore") as f:
+            code = f.read()
+
+        env_vars.update(PY_GETENV_PATTERN.findall(code))
+        env_vars.update(PY_ENVIRON_PATTERN.findall(code))
+    except Exception:
+        pass
+
+    return env_vars
+
+def scan_js_file(path: str) -> set[str]:
+    """Extract env vars from a JS/TS file."""
+    env_vars = set()
+    try:
+        with open(path, "r", encoding="utf-8", errors="ignore") as f:
+            code = f.read()
+
+        env_vars.update(JS_ENV_PATTERN.findall(code))
+    except Exception:
+        pass
+
+    return env_vars
+
+def scan_project(project_path: str, languages=("python", "js")) -> set[str]:
+    """
+    Scan a project directory for environment variable usage.
+
+    :param project_path: Root directory of project
+    :param languages: ("python", "js") or ("python",) or ("js",)
+    :return: Set of environment variable names
+    """
+    env_vars = set()
+
+    for root, dirs, files in os.walk(project_path):
+        # 🚫 Skip unwanted directories
+        dirs[:] = [d for d in dirs if d not in SKIP_DIRS]
+
+        for file in files:
+            full_path = os.path.join(root, file)
+
+            if "python" in languages and file.endswith(".py"):
+                env_vars.update(scan_python_file(full_path))
+
+            if "js" in languages and file.endswith((".js", ".ts", ".jsx", ".tsx")):
+                env_vars.update(scan_js_file(full_path))
+
+    return env_vars
+

envertor-0.1.0/envertor/version.py

@@ -0,0 +1,2 @@
+__version__ = "0.1.0"
+

envertor-0.1.0/envertor.egg-info/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: envertor
+Version: 0.1.0
+Summary: Generate example .env files from existing .env files with placeholder detection.
+Author-email: Samin Yeasar <syeasar.kuet@gmail.com>
+Project-URL: Homepage, https://github.com/Y3454R/envertor
+Project-URL: Repository, https://github.com/Y3454R/envertor
+Keywords: dotenv,env,environment,cli,devtools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Envertor 🔍
+
+Envertor is a CLI tool that generates `.env.example` files by extracting environment variables from existing `.env` files or by scanning Python and JavaScript/TypeScript projects. It also helps keep your secrets safe with automatic `.gitignore` protection and CI/CD-ready parity checks.
+
+## Install
+
+```bash
+pip install envertor
+```
+
+**Development install:**
+```bash
+pip install -e .
+```
+
+---
+
+## Usage
+
+### Generate `.env.example` from an existing `.env`
+
+Strips real values and replaces them with type-appropriate placeholders:
+
+```bash
+envertor -i .env -o .env.example
+```
+
+| Original `.env` | Generated `.env.example` |
+|---|---|
+| `SECRET=mysecret` | `SECRET=''` |
+| `PORT=8080` | `PORT=0` |
+| `DEBUG=true` | `DEBUG=false` |
+| `RATE=3.14` | `RATE=0.0` |
+
+---
+
+### Scan a project for environment variables
+
+Detects env vars used in source code and generates `.env.example` from actual usage — no existing `.env` required:
+
+```bash
+envertor -p ./my-project -o .env.example
+```
+
+Limit scanning to a specific language:
+```bash
+envertor -p ./my-project --lang python
+envertor -p ./my-project --lang js
+```
+
+Supports:
+- **Python**: `os.getenv("VAR")`, `os.environ["VAR"]`, `os.environ.get("VAR")`
+- **JS/TS**: `process.env.VAR` (`.js`, `.ts`, `.jsx`, `.tsx`)
+
+---
+
+### Create `.env` from `.env.example`
+
+Bootstrap a local `.env` from the example file so teammates can fill in their own values:
+
+```bash
+envertor --create-env                        # reads .env.example by default
+envertor --create-env staging.env.example    # reads a custom file
+```
+
+If `.env` already exists, writes `.env.envertor` instead to avoid overwriting.
+
+---
+
+### Check parity between `.env` and `.env.example`
+
+Explicitly verify that both files have the same keys. Designed for CI/CD pipelines — exits `1` on mismatch:
+
+```bash
+envertor --check
+envertor --check --env-file /deploy/.env --example-file /repo/.env.example
+```
+
+Example output on failure:
+```
+[envertor] FAIL: Keys mismatch between .env and .env.example
+  Missing from .env:          NEW_KEY
+  Missing from .env.example:  OLD_KEY
+```
+
+Use in a pipeline:
+```yaml
+# GitHub Actions example
+- name: Check env parity
+  run: envertor --check --env-file .env --example-file .env.example
+```
+
+---
+
+### Show version
+
+```bash
+envertor -v
+```
+
+---
+
+## Automatic safety checks
+
+Every time envertor runs, it performs these checks automatically:
+
+**`.gitignore` protection** — ensures `.env` is listed in `.gitignore`. Creates the file if it doesn't exist:
+```
+[envertor] Created .gitignore with .env
+[envertor] Added .env to .gitignore
+```
+
+**Key parity warning** — warns if `.env` and `.env.example` have different keys:
+```
+[envertor] WARNING: Keys in .env not documented in .env.example: DB_URL
+[envertor] WARNING: Keys in .env.example not found in .env: NEW_KEY
+```
+
+**Leftover values warning** — warns if `.env.example` contains non-placeholder values (real secrets accidentally left behind):
+```
+[envertor] WARNING: .env.example has a real value set for API_KEY
+```
+
+---
+
+## Options
+
+| Flag | Description |
+|---|---|
+| `-i, --input FILE` | Path to input `.env` file |
+| `-o, --output FILE` | Path to output `.env.example` (default: `.env.example`) |
+| `-p, --project DIR` | Project folder to scan for env variable usage |
+| `--lang python\|js\|both` | Language filter for project scanning (default: `both`) |
+| `--create-env [FILE]` | Create `.env` from `FILE` (default: `.env.example`) |
+| `--check` | Check key parity and exit `1` on mismatch (CI/CD mode) |
+| `--env-file FILE` | `.env` path for `--check` (default: `.env`) |
+| `--example-file FILE` | `.env.example` path for `--check` (default: `.env.example`) |
+| `-v, --version` | Show version |
+
+---
+
+## Notes
+
+- Automatically skips `node_modules/`, `venv/`, `__pycache__/`, `.next/`, `.git/`, `.idea/`, `.vscode/`
+- Regex-based scanning catches the most common patterns (`os.getenv`, `os.environ`, `process.env`)
+- `.env.envertor` is a safe backup — rename it to `.env` or diff it against your existing one

envertor-0.1.0/envertor.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+envertor/__init__.py
+envertor/checker.py
+envertor/cli.py
+envertor/core.py
+envertor/gitignore.py
+envertor/scanner.py
+envertor/version.py
+envertor.egg-info/PKG-INFO
+envertor.egg-info/SOURCES.txt
+envertor.egg-info/dependency_links.txt
+envertor.egg-info/entry_points.txt
+envertor.egg-info/top_level.txt
+tests/test_basic.py

envertor-0.1.0/envertor.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

envertor-0.1.0/envertor.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+envertor = envertor.cli:main

envertor-0.1.0/envertor.egg-info/top_level.txt

@@ -0,0 +1 @@
+envertor

envertor-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "envertor"
+version = "0.1.0"
+description = "Generate example .env files from existing .env files with placeholder detection."
+authors = [
+    { name = "Samin Yeasar", email = "syeasar.kuet@gmail.com" }
+]
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.8"
+dependencies = []
+keywords = ["dotenv", "env", "environment", "cli", "devtools"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Environment :: Console",
+    "Topic :: Software Development :: Build Tools",
+]
+
+[project.urls]
+Homepage = "https://github.com/Y3454R/envertor"
+Repository = "https://github.com/Y3454R/envertor"
+
+[project.scripts]
+envertor = "envertor.cli:main"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+

envertor-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

envertor-0.1.0/tests/test_basic.py

@@ -0,0 +1,109 @@
+import os
+import tempfile
+import pytest
+
+from envertor.core import detect_placeholder
+from envertor.gitignore import ensure_env_in_gitignore
+from envertor.checker import check_key_parity, check_example_values
+
+
+def test_placeholder_detection():
+    assert detect_placeholder("123") == "0"
+    assert detect_placeholder("3.14") == "0.0"
+    assert detect_placeholder("true") == "false"
+    assert detect_placeholder("hello") == "''"
+
+
+# --- ensure_env_in_gitignore ---
+
+def test_gitignore_created_when_missing():
+    with tempfile.TemporaryDirectory() as d:
+        ensure_env_in_gitignore(d)
+        gitignore = os.path.join(d, ".gitignore")
+        assert os.path.exists(gitignore)
+        assert ".env" in open(gitignore).read()
+
+
+def test_gitignore_appended_when_env_missing():
+    with tempfile.TemporaryDirectory() as d:
+        gitignore = os.path.join(d, ".gitignore")
+        with open(gitignore, "w") as f:
+            f.write("node_modules/\n")
+        ensure_env_in_gitignore(d)
+        content = open(gitignore).read()
+        assert ".env" in content
+        assert "node_modules/" in content
+
+
+def test_gitignore_no_duplicate_when_env_present():
+    with tempfile.TemporaryDirectory() as d:
+        gitignore = os.path.join(d, ".gitignore")
+        with open(gitignore, "w") as f:
+            f.write(".env\nnode_modules/\n")
+        ensure_env_in_gitignore(d)
+        content = open(gitignore).read()
+        assert content.count(".env") == 1
+
+
+# --- check_key_parity ---
+
+def _write(path, content):
+    with open(path, "w") as f:
+        f.write(content)
+
+
+def test_parity_match(capsys):
+    with tempfile.TemporaryDirectory() as d:
+        env = os.path.join(d, ".env")
+        example = os.path.join(d, ".env.example")
+        _write(env, "KEY_A=secret\nKEY_B=123\n")
+        _write(example, "KEY_A=''\nKEY_B=0\n")
+        result = check_key_parity(env, example, strict=True)
+        assert result is True
+
+
+def test_parity_mismatch_strict(capsys):
+    with tempfile.TemporaryDirectory() as d:
+        env = os.path.join(d, ".env")
+        example = os.path.join(d, ".env.example")
+        _write(env, "KEY_A=secret\nKEY_C=extra\n")
+        _write(example, "KEY_A=''\nKEY_B=''\n")
+        result = check_key_parity(env, example, strict=True)
+        assert result is False
+        out = capsys.readouterr().out
+        assert "KEY_B" in out
+        assert "KEY_C" in out
+
+
+def test_parity_mismatch_warns(capsys):
+    with tempfile.TemporaryDirectory() as d:
+        env = os.path.join(d, ".env")
+        example = os.path.join(d, ".env.example")
+        _write(env, "KEY_A=secret\n")
+        _write(example, "KEY_A=''\nUNDOCUMENTED=''\n")
+        check_key_parity(env, example, strict=False)
+        out = capsys.readouterr().out
+        assert "WARNING" in out
+        assert "UNDOCUMENTED" in out
+
+
+# --- check_example_values ---
+
+def test_example_values_safe(capsys):
+    with tempfile.TemporaryDirectory() as d:
+        example = os.path.join(d, ".env.example")
+        _write(example, "KEY_A=''\nKEY_B=0\nKEY_C=false\nKEY_D=\n")
+        check_example_values(example)
+        out = capsys.readouterr().out
+        assert "WARNING" not in out
+
+
+def test_example_values_warns_on_real_value(capsys):
+    with tempfile.TemporaryDirectory() as d:
+        example = os.path.join(d, ".env.example")
+        _write(example, "KEY_A=real_secret\nKEY_B=''\n")
+        check_example_values(example)
+        out = capsys.readouterr().out
+        assert "WARNING" in out
+        assert "KEY_A" in out
+        assert "KEY_B" not in out