dotenv-diff 0.1.0__tar.gz

dotenv_diff-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Bringsken
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dotenv_diff-0.1.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: dotenv-diff
+Version: 0.1.0
+Summary: Lightweight tool for quickly spotting missing keys and differing values in .env files
+Author: Lucas Bringsken
+Author-email: Lucas Bringsken <kontakt@lucasbringsken.de>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: pandas>=3.0.0
+Requires-Dist: rich>=14.3.2
+Requires-Dist: typer>=0.21.1
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# [dotenv-diff](https://github.com/LucasBringsken/dotenv-diff)
+
+[![PyPI](https://img.shields.io/pypi/v/dotenv-diff)](https://pypi.org/project/dotenv-diff/)
+![Python](https://img.shields.io/pypi/pyversions/dotenv-diff)
+![License](https://img.shields.io/github/license/LucasBringsken/dotenv-diff)
+![Build](https://github.com/LucasBringsken/dotenv-diff/actions/workflows/release.yml/badge.svg)
+
+
+**Lightweight tool for quickly spotting missing keys and differing values in .env files**
+
+`dotenv-diff` helps compare multiple `.env` files and immediately see:
+
+- Which variables are missing in which files
+- Which values differ between environments
+- A clear matrix overview of all keys and files
+
+It is designed as a simple developer utility for projects that maintain multiple environment configurations (local, staging, production, etc.).
+
+---
+
+## Features
+
+- Compare any number of `.env` files at once
+- Detect missing keys across environments
+- Detect diverging values
+- Show results in human‑friendly tables
+- Three different views: summary, values, and presence
+- Works with individual files, directories, and glob patterns
+
+---
+
+## Installation
+
+```bash
+pip install dotenv-diff
+```
+
+---
+
+## Usage
+
+All functionality is available through the command line interface.
+
+You can pass:
+
+- Individual `.env` files
+- Directories containing `.env*` files
+- Glob patterns like `.env.*`
+
+### Commands
+
+#### summary
+
+Show a high‑level overview of differences.
+
+```bash
+dotenv-diff summary /path/to/.env.*
+```
+
+```
+╭─ SUMMARY ───────────────────╮
+│ Total Files:           3    │
+│ Unique Keys:          12    │
+│ Incomplete Keys:       3    │
+│ Diverging Values:      4    │
+╰─────────────────────────────╯
+Incomplete Key Details
+• REDIS_HOST is missing in:
+  ↳ .env.production
+  ↳ .env.staging
+
+Diverging Value Details
+• APP_ENV
+  ↳ .env.local: development
+  ↳ .env.production: production
+  ↳ .env.staging: staging
+```
+
+#### values
+
+Show a matrix of actual values for each key and file.
+
+```bash
+dotenv-diff values /path/to/.env.*
+```
+
+```
+╭───────────────────────────────────────────────────────────────╮
+│ VARIABLE        │ .env.local │ .env.staging │ .env.production │
+├─────────────────┼────────────┼──────────────┼─────────────────┤
+│ APP_ENV         │ development│ staging      │ production      │
+│ DEBUG           │ true       │ true         │ false           │
+│ LOG_LEVEL       │ DEBUG      │ —            │ INFO            │
+│ DATABASE_USER   │ dev_user   │ prod_user    │ prod_user       │
+│ DATABASE_PASS   │ dev_pass   │ prod_pass    │ prod_pass       │
+│ PORT            │ 8000       │ 8000         │ —               │
+╰───────────────────────────────────────────────────────────────╯
+```
+
+#### presence
+
+Show only whether a variable exists in each file.
+
+```bash
+dotenv-diff presence /path/to/.env.*
+```
+
+```
+╭───────────────────────────────────────────────────────────────╮
+│ VARIABLE        │ .env.local │ .env.staging │ .env.production │
+├─────────────────┼────────────┼──────────────┼─────────────────┤
+│ APP_ENV         │     ✅     │      ✅     │       ✅       │
+│ DEBUG           │     ✅     │      ✅     │       ✅       │
+│ LOG_LEVEL       │     ✅     │      ❌     │       ✅       │
+│ DATABASE_USER   │     ✅     │      ✅     │       ✅       │
+│ DATABASE_PASS   │     ✅     │      ✅     │       ✅       │
+│ PORT            │     ✅     │      ✅     │       ❌       │
+╰───────────────────────────────────────────────────────────────╯
+```

dotenv_diff-0.1.0/README.md

@@ -0,0 +1,119 @@
+# [dotenv-diff](https://github.com/LucasBringsken/dotenv-diff)
+
+[![PyPI](https://img.shields.io/pypi/v/dotenv-diff)](https://pypi.org/project/dotenv-diff/)
+![Python](https://img.shields.io/pypi/pyversions/dotenv-diff)
+![License](https://img.shields.io/github/license/LucasBringsken/dotenv-diff)
+![Build](https://github.com/LucasBringsken/dotenv-diff/actions/workflows/release.yml/badge.svg)
+
+
+**Lightweight tool for quickly spotting missing keys and differing values in .env files**
+
+`dotenv-diff` helps compare multiple `.env` files and immediately see:
+
+- Which variables are missing in which files
+- Which values differ between environments
+- A clear matrix overview of all keys and files
+
+It is designed as a simple developer utility for projects that maintain multiple environment configurations (local, staging, production, etc.).
+
+---
+
+## Features
+
+- Compare any number of `.env` files at once
+- Detect missing keys across environments
+- Detect diverging values
+- Show results in human‑friendly tables
+- Three different views: summary, values, and presence
+- Works with individual files, directories, and glob patterns
+
+---
+
+## Installation
+
+```bash
+pip install dotenv-diff
+```
+
+---
+
+## Usage
+
+All functionality is available through the command line interface.
+
+You can pass:
+
+- Individual `.env` files
+- Directories containing `.env*` files
+- Glob patterns like `.env.*`
+
+### Commands
+
+#### summary
+
+Show a high‑level overview of differences.
+
+```bash
+dotenv-diff summary /path/to/.env.*
+```
+
+```
+╭─ SUMMARY ───────────────────╮
+│ Total Files:           3    │
+│ Unique Keys:          12    │
+│ Incomplete Keys:       3    │
+│ Diverging Values:      4    │
+╰─────────────────────────────╯
+Incomplete Key Details
+• REDIS_HOST is missing in:
+  ↳ .env.production
+  ↳ .env.staging
+
+Diverging Value Details
+• APP_ENV
+  ↳ .env.local: development
+  ↳ .env.production: production
+  ↳ .env.staging: staging
+```
+
+#### values
+
+Show a matrix of actual values for each key and file.
+
+```bash
+dotenv-diff values /path/to/.env.*
+```
+
+```
+╭───────────────────────────────────────────────────────────────╮
+│ VARIABLE        │ .env.local │ .env.staging │ .env.production │
+├─────────────────┼────────────┼──────────────┼─────────────────┤
+│ APP_ENV         │ development│ staging      │ production      │
+│ DEBUG           │ true       │ true         │ false           │
+│ LOG_LEVEL       │ DEBUG      │ —            │ INFO            │
+│ DATABASE_USER   │ dev_user   │ prod_user    │ prod_user       │
+│ DATABASE_PASS   │ dev_pass   │ prod_pass    │ prod_pass       │
+│ PORT            │ 8000       │ 8000         │ —               │
+╰───────────────────────────────────────────────────────────────╯
+```
+
+#### presence
+
+Show only whether a variable exists in each file.
+
+```bash
+dotenv-diff presence /path/to/.env.*
+```
+
+```
+╭───────────────────────────────────────────────────────────────╮
+│ VARIABLE        │ .env.local │ .env.staging │ .env.production │
+├─────────────────┼────────────┼──────────────┼─────────────────┤
+│ APP_ENV         │     ✅     │      ✅     │       ✅       │
+│ DEBUG           │     ✅     │      ✅     │       ✅       │
+│ LOG_LEVEL       │     ✅     │      ❌     │       ✅       │
+│ DATABASE_USER   │     ✅     │      ✅     │       ✅       │
+│ DATABASE_PASS   │     ✅     │      ✅     │       ✅       │
+│ PORT            │     ✅     │      ✅     │       ❌       │
+╰───────────────────────────────────────────────────────────────╯
+```

dotenv_diff-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "dotenv-diff"
+version = "0.1.0"
+authors = [{ name = "Lucas Bringsken", email = "kontakt@lucasbringsken.de" }]
+description = "Lightweight tool for quickly spotting missing keys and differing values in .env files"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = ["pandas>=3.0.0", "rich>=14.3.2", "typer>=0.21.1"]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.scripts]
+dotenv-diff = "dotenv_diff.cli:app"
+
+[build-system]
+requires = ["uv_build >= 0.9.28, <0.10.0"]
+build-backend = "uv_build"
+
+
+[dependency-groups]
+dev = ["black>=26.1.0", "ruff>=0.15.0"]

dotenv_diff-0.1.0/src/dotenv_diff/__main__.py

@@ -0,0 +1,5 @@
+from .cli import app
+
+
+if __name__ == "__main__":
+    app()

dotenv_diff-0.1.0/src/dotenv_diff/cli.py

@@ -0,0 +1,53 @@
+from pathlib import Path
+from .core import compare
+from .utils import expand_paths
+from .output import print_summary, print_value_matrix, print_presence_matrix
+import typer
+from typing import List
+
+app = typer.Typer(
+    help="Lightweight tool for quickly spotting missing keys and differing values in .env files",
+    add_completion=False,
+)
+
+
+@app.callback(invoke_without_command=True)
+def _app_callback(
+    ctx: typer.Context,
+):
+    if ctx.obj is None:
+        ctx.obj = {}
+
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=1)
+
+
+@app.command()
+def summary(
+    file_paths: List[Path] = typer.Argument(..., help="Paths to .env files"),
+):
+    """Show a diff summary for the provided files."""
+    file_paths = expand_paths(list(file_paths))
+    variable_map = compare(file_paths)
+    print_summary(variable_map)
+
+
+@app.command()
+def values(
+    file_paths: List[Path] = typer.Argument(..., help="Paths to .env files"),
+):
+    """Show value diffs as a matrix."""
+    file_paths = expand_paths(list(file_paths))
+    variable_map = compare(file_paths)
+    print_value_matrix(variable_map)
+
+
+@app.command()
+def presence(
+    file_paths: List[Path] = typer.Argument(..., help="Paths to .env files"),
+):
+    """Show presence diffs as a matrix."""
+    file_paths = expand_paths(list(file_paths))
+    variable_map = compare(file_paths)
+    print_presence_matrix(variable_map)

dotenv_diff-0.1.0/src/dotenv_diff/core.py

@@ -0,0 +1,24 @@
+from collections import defaultdict
+from pathlib import Path
+from rich import print as pprint
+import typer
+
+
+def compare(file_paths: list[Path]) -> defaultdict:
+    variable_map = defaultdict(dict)
+    for path in file_paths:
+        file_content = path.read_text()
+        file_lines = file_content.splitlines()
+
+        for line in file_lines:
+            if not line.strip() or "=" not in line:
+                continue
+
+            key, value = line.split("=", 1)
+            variable_map[key.strip()][str(path)] = value.strip()
+
+    if len(variable_map) == 0:
+        pprint("[yellow bold]No variables found in provided files.[/yellow bold]")
+        raise typer.Exit(code=1)
+
+    return variable_map

dotenv_diff-0.1.0/src/dotenv_diff/output.py

@@ -0,0 +1,118 @@
+from pandas import DataFrame
+from rich.console import Console, Group
+from rich.panel import Panel
+from rich.rule import Rule
+from rich.table import Table
+from rich import box
+
+console = Console()
+
+
+def print_summary(map: dict):
+    df = DataFrame.from_dict(map, orient="index")
+    num_files = len(df.columns)
+    num_vars = len(df.index)
+
+    incomplete_mask = df.isna().any(axis=1)
+    diverging_mask = df.nunique(axis=1) > 1
+
+    missing_count = int(incomplete_mask.sum())
+    modified_count = int(diverging_mask.sum())
+
+    summary_content = Group(
+        "[bold cyan]SUMMARY[/bold cyan]",
+        Rule(style="bright_black"),
+        f"[bold]Total Files:[/bold]         [green]{num_files}[/green]",
+        f"[bold]Unique Keys:[/bold]         [blue]{num_vars}[/blue]",
+        f"[bold]Incomplete Keys:[/bold]     [red]{missing_count}[/red]",
+        f"[bold]Diverging Values:[/bold]    [yellow]{modified_count}[/yellow]",
+    )
+    console.print(
+        Panel(
+            summary_content, expand=False, border_style="bright_black", padding=(1, 2)
+        )
+    )
+
+    if missing_count > 0:
+        incomplete_details = []
+        for key, row in df[incomplete_mask].iterrows():
+            missing_in = row.index[row.isna()].tolist()
+
+            incomplete_details.append(f"• [bold red]{key}[/bold red] is missing in:")
+
+            for file in missing_in:
+                incomplete_details.append(f"  [dim]↳ {file}[/dim]")
+
+            incomplete_details.append("")
+
+        console.print(
+            Panel(
+                Group(*incomplete_details[:-1]),
+                title="[red]Incomplete Key Details[/red]",
+                title_align="left",
+                border_style="red",
+                padding=(1, 2),
+            )
+        )
+
+    if modified_count > 0:
+        diverging_details = []
+        for key, row in df[diverging_mask].iterrows():
+            values = row.dropna()
+
+            diverging_details.append(f"• [bold yellow]{key}[/bold yellow]")
+
+            for file, val in values.items():
+                diverging_details.append(f"  [dim]↳ {file}:[/dim] [cyan]{val}[/cyan]")
+
+            diverging_details.append("")
+
+        console.print(
+            Panel(
+                Group(*diverging_details[:-1]),
+                title="[yellow]Diverging Value Details[/yellow]",
+                title_align="left",
+                border_style="yellow",
+                padding=(1, 2),
+            )
+        )
+
+
+def print_value_matrix(map: dict):
+    df, table = build_matrix(map)
+
+    for idx, row in df.iterrows():
+        table.add_row(
+            str(idx),
+            *[str(v) if v == v else "[red bold]—[/red bold]" for v in row],
+        )
+
+    console.print(table)
+
+
+def print_presence_matrix(map: dict):
+    df, table = build_matrix(map, center_values=True)
+
+    for idx, row in df.iterrows():
+        table.add_row(str(idx), *["✅" if v == v else "❌" for v in row])
+
+    console.print(table)
+
+
+def build_matrix(map: dict, center_values: bool = False) -> tuple[DataFrame, Table]:
+    df = DataFrame.from_dict(map, orient="index")
+
+    table = Table(
+        show_header=True,
+        header_style="bold magenta",
+        box=box.ROUNDED,
+        border_style="bright_black",
+    )
+    table.add_column("VARIABLE", style="bold")
+
+    for col in df.columns:
+        table.add_column(
+            col, style="cyan", justify="center" if center_values else "default"
+        )
+
+    return (df, table)

dotenv_diff-0.1.0/src/dotenv_diff/utils.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+from rich import print as pprint
+import typer
+
+def expand_paths(raw_paths: list[Path]) -> list[Path]:
+    expanded: list[Path] = []
+
+    for path in raw_paths:
+        if path.is_dir():
+            expanded.extend(path.glob(".env*"))
+            continue
+        if "*" in path.name:
+            expanded.extend(path.parent.glob(path.name))
+            continue
+        if path.exists():
+            expanded.append(path)
+        else:
+            pprint(f"[red bold]File not found:[/red bold] {path}")
+            raise typer.Exit(code=1)
+    return expanded