minimindslab-env-file-diff 0.1.0__py3-none-any.whl

minimindslab_env_file_diff/__init__.py

@@ -0,0 +1,10 @@
+"""MiniMindsLab Env File Diff."""
+
+from .core import compare_env_files, compare_env_mappings, parse_env_file, render_report
+
+__all__ = [
+    "parse_env_file",
+    "compare_env_mappings",
+    "compare_env_files",
+    "render_report",
+]

minimindslab_env_file_diff/__main__.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from .core import compare_env_files, render_report
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="miniminds-env-diff",
+        description="Deterministically compare two .env-style files.",
+    )
+    parser.add_argument("old_file")
+    parser.add_argument("new_file")
+    args = parser.parse_args(argv)
+
+    old_label = Path(args.old_file).name
+    new_label = Path(args.new_file).name
+
+    try:
+        diff = compare_env_files(args.old_file, args.new_file)
+    except FileNotFoundError as exc:
+        print(str(exc), file=sys.stderr)
+        return 2
+
+    print(render_report(diff, old_label, new_label))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

minimindslab_env_file_diff/core.py

@@ -0,0 +1,110 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Dict, Tuple
+
+
+@dataclass(frozen=True)
+class ParseStats:
+    comments: int
+    blanks: int
+    invalid: int
+
+
+def parse_env_file(path: str | Path) -> Tuple[Dict[str, str], ParseStats]:
+    p = Path(path)
+    if not p.exists() or not p.is_file():
+        raise FileNotFoundError(f"File not found: {p}")
+
+    mapping: Dict[str, str] = {}
+    comments = 0
+    blanks = 0
+    invalid = 0
+
+    with p.open("r", encoding="utf-8") as f:
+        for raw in f:
+            line = raw.strip()
+            if not line:
+                blanks += 1
+                continue
+            if line.startswith("#"):
+                comments += 1
+                continue
+            if "=" not in line:
+                invalid += 1
+                continue
+            key, value = line.split("=", 1)
+            key = key.strip()
+            value = value.strip()
+            if not key:
+                invalid += 1
+                continue
+            mapping[key] = value
+
+    return mapping, ParseStats(comments=comments, blanks=blanks, invalid=invalid)
+
+
+def compare_env_mappings(old: Dict[str, str], new: Dict[str, str]) -> dict:
+    old_keys = set(old)
+    new_keys = set(new)
+
+    added_keys = sorted(new_keys - old_keys)
+    removed_keys = sorted(old_keys - new_keys)
+    common = sorted(old_keys & new_keys)
+    changed_keys = [k for k in common if old[k] != new[k]]
+
+    return {
+        "added": {k: new[k] for k in added_keys},
+        "removed": {k: old[k] for k in removed_keys},
+        "changed": {k: {"old": old[k], "new": new[k]} for k in changed_keys},
+    }
+
+
+def compare_env_files(old_path: str | Path, new_path: str | Path) -> dict:
+    old_map, old_stats = parse_env_file(old_path)
+    new_map, new_stats = parse_env_file(new_path)
+    diff = compare_env_mappings(old_map, new_map)
+    diff["ignored"] = {
+        str(Path(old_path).name): {
+            "comments": old_stats.comments,
+            "blanks": old_stats.blanks,
+            "invalid": old_stats.invalid,
+        },
+        str(Path(new_path).name): {
+            "comments": new_stats.comments,
+            "blanks": new_stats.blanks,
+            "invalid": new_stats.invalid,
+        },
+    }
+    return diff
+
+
+def render_report(diff: dict, old_label: str, new_label: str) -> str:
+    lines: list[str] = []
+
+    added = diff["added"]
+    removed = diff["removed"]
+    changed = diff["changed"]
+
+    lines.append(f"ADDED ({len(added)})")
+    for k in sorted(added):
+        lines.append(f"  + {k}={added[k]}")
+
+    lines.append(f"REMOVED ({len(removed)})")
+    for k in sorted(removed):
+        lines.append(f"  - {k}={removed[k]}")
+
+    lines.append(f"CHANGED ({len(changed)})")
+    for k in sorted(changed):
+        lines.append(f"  ~ {k}: {changed[k]['old']} -> {changed[k]['new']}")
+
+    ignored = diff.get("ignored", {})
+    lines.append("IGNORED")
+    for label in (old_label, new_label):
+        stats = ignored.get(label, {"comments": 0, "blanks": 0, "invalid": 0})
+        lines.append(
+            f"  {label}: comments={stats['comments']} blanks={stats['blanks']} invalid={stats['invalid']}"
+        )
+
+    return "\n".join(lines)

minimindslab_env_file_diff-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: minimindslab-env-file-diff
+Version: 0.1.0
+Summary: Deterministically compare two .env-style files and report added, removed, changed, and ignored keys with stable ordering.
+Author: MiniMindsLab
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# MiniMindsLab Env File Diff
+
+Deterministically compare two `.env`-style files and report:
+
+- Added keys
+- Removed keys
+- Changed keys
+- Ignored lines (comments/blank/invalid)
+
+## Features
+
+- Stable ordering (sorted keys in output)
+- Whitespace-tolerant parsing
+- `#` comments and blank lines are ignored
+- Duplicate keys resolve by **last occurrence wins**
+- Pure Python standard library only
+
+## Installation
+
+```bash
+pip install minimindslab-env-file-diff
+```
+
+## CLI Usage
+
+```bash
+miniminds-env-diff path/to/old.env path/to/new.env
+```
+
+Example output:
+
+```text
+ADDED (1)
+  + NEW_KEY=new
+REMOVED (1)
+  - OLD_KEY=old
+CHANGED (1)
+  ~ SHARED_KEY: before -> after
+IGNORED
+  old.env: comments=1 blanks=1 invalid=0
+  new.env: comments=0 blanks=2 invalid=1
+```
+
+## Library Usage
+
+```python
+from minimindslab_env_file_diff import compare_env_files
+
+result = compare_env_files("old.env", "new.env")
+print(result["added"])
+print(result["removed"])
+print(result["changed"])
+```

minimindslab_env_file_diff-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+minimindslab_env_file_diff/__init__.py,sha256=Q-McO8sQ-qe_U0KpF2WF5BS94b9zs0rcuDkCSataJ8s,235
+minimindslab_env_file_diff/__main__.py,sha256=I3cGLcfVs-Lb7ejWtQlx16H3jqa_S6UPaUNnO1yFwHA,823
+minimindslab_env_file_diff/core.py,sha256=ukCitXNNarUThdDCsfjTlI0oYx9TB9TBkSTJOg1QFzU,3226
+minimindslab_env_file_diff-0.1.0.dist-info/licenses/LICENSE,sha256=9SsHAp-rmsco8evLbp-_802okWchTYdG-RZx5d3yddM,1069
+minimindslab_env_file_diff-0.1.0.dist-info/METADATA,sha256=R9TK0vJurNE9IDAhWN2Y6HvdtLiHlEi_a4LoW2KESzU,1316
+minimindslab_env_file_diff-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+minimindslab_env_file_diff-0.1.0.dist-info/entry_points.txt,sha256=Z_1b5-2u-ASyyVnMjjkxuKD1xJdQeqODCLhwg6YhYwU,80
+minimindslab_env_file_diff-0.1.0.dist-info/top_level.txt,sha256=nqplP7V34k8mCSAKFFA2ZBQe7-VbQCYf9MW2n5coq8A,27
+minimindslab_env_file_diff-0.1.0.dist-info/RECORD,,

minimindslab_env_file_diff-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

minimindslab_env_file_diff-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+miniminds-env-diff = minimindslab_env_file_diff.__main__:main

minimindslab_env_file_diff-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MiniMindsLab
+
+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.

minimindslab_env_file_diff-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+minimindslab_env_file_diff