envdrift 0.0.1__py3-none-any.whl

envdrift/__init__.py

@@ -0,0 +1,16 @@
+"""Prevent environment variable drift with Pydantic schema validation.
+
+envdrift helps you:
+- Validate .env files against Pydantic schemas
+- Detect drift between environments (dev, staging, prod)
+- Integrate with pre-commit hooks and CI/CD pipelines
+- Support dotenvx encryption for secure .env files
+"""
+
+__version__ = "0.0.1"
+__author__ = "Jainal Gosaliya"
+__email__ = "gosaliya.jainal@gmail.com"
+
+from envdrift.core import validate, diff, init
+
+__all__ = ["validate", "diff", "init", "__version__"]

envdrift/cli.py

@@ -0,0 +1,107 @@
+"""Command-line interface for envdrift."""
+
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+app = typer.Typer(
+    name="envdrift",
+    help="Prevent environment variable drift with Pydantic schema validation.",
+    no_args_is_help=True,
+)
+console = Console()
+
+
+@app.command()
+def validate(
+    env_file: Annotated[
+        Path, typer.Argument(help="Path to .env file to validate")
+    ] = Path(".env"),
+    schema: Annotated[
+        Optional[str],
+        typer.Option("--schema", "-s", help="Dotted path to Settings class"),
+    ] = None,
+    ci: Annotated[
+        bool, typer.Option("--ci", help="CI mode: exit with code 1 on failure")
+    ] = False,
+) -> None:
+    """Validate an .env file against a Pydantic schema."""
+    console.print(
+        Panel(
+            "[yellow]Coming soon in v0.1.0[/yellow]\n\n"
+            "This command will validate your .env file against a Pydantic Settings schema.",
+            title="envdrift validate",
+        )
+    )
+    if ci:
+        raise typer.Exit(code=1)
+
+
+@app.command()
+def diff(
+    env1: Annotated[Path, typer.Argument(help="First .env file (e.g., .env.dev)")],
+    env2: Annotated[Path, typer.Argument(help="Second .env file (e.g., .env.prod)")],
+) -> None:
+    """Compare two .env files and show differences."""
+    console.print(
+        Panel(
+            "[yellow]Coming soon in v0.1.0[/yellow]\n\n"
+            f"This command will compare [bold]{env1}[/bold] and [bold]{env2}[/bold]\n"
+            "and show missing, extra, and differing variables.",
+            title="envdrift diff",
+        )
+    )
+
+
+@app.command()
+def init(
+    env_file: Annotated[
+        Path, typer.Argument(help="Path to .env file to generate schema from")
+    ] = Path(".env"),
+    output: Annotated[
+        Path, typer.Option("--output", "-o", help="Output file for Settings class")
+    ] = Path("settings.py"),
+) -> None:
+    """Generate a Pydantic Settings class from an existing .env file."""
+    console.print(
+        Panel(
+            "[yellow]Coming soon in v0.1.0[/yellow]\n\n"
+            f"This command will generate a Pydantic Settings class\n"
+            f"from [bold]{env_file}[/bold] and write it to [bold]{output}[/bold].",
+            title="envdrift init",
+        )
+    )
+
+
+@app.command()
+def hook(
+    install: Annotated[
+        bool, typer.Option("--install", "-i", help="Install pre-commit hook")
+    ] = False,
+) -> None:
+    """Manage pre-commit hook integration."""
+    if install:
+        console.print(
+            Panel(
+                "[yellow]Coming soon in v0.1.0[/yellow]\n\n"
+                "This command will add envdrift to your .pre-commit-config.yaml",
+                title="envdrift hook",
+            )
+        )
+    else:
+        console.print("Use --install to add envdrift pre-commit hook")
+
+
+@app.command()
+def version() -> None:
+    """Show envdrift version."""
+    from envdrift import __version__
+
+    console.print(f"envdrift [bold green]{__version__}[/bold green]")
+
+
+if __name__ == "__main__":
+    app()

envdrift/core.py

@@ -0,0 +1,47 @@
+"""Core functionality for envdrift."""
+
+from pathlib import Path
+
+
+def validate(env_file: Path | str = ".env", schema: str | None = None) -> bool:
+    """Validate an .env file against a Pydantic schema.
+
+    Args:
+        env_file: Path to the .env file to validate
+        schema: Dotted path to the Pydantic Settings class (e.g., 'app.config:Settings')
+
+    Returns:
+        True if validation passes, False otherwise
+
+    Raises:
+        NotImplementedError: This feature is coming soon
+    """
+    raise NotImplementedError("Coming soon in v0.1.0")
+
+
+def diff(env1: Path | str, env2: Path | str) -> dict[str, tuple[str | None, str | None]]:
+    """Compare two .env files and return differences.
+
+    Args:
+        env1: Path to first .env file
+        env2: Path to second .env file
+
+    Returns:
+        Dictionary of differences: {key: (value_in_env1, value_in_env2)}
+
+    Raises:
+        NotImplementedError: This feature is coming soon
+    """
+    raise NotImplementedError("Coming soon in v0.1.0")
+
+
+def init(output: Path | str = "settings.py") -> None:
+    """Generate a Pydantic Settings class from an existing .env file.
+
+    Args:
+        output: Path where to write the generated Settings class
+
+    Raises:
+        NotImplementedError: This feature is coming soon
+    """
+    raise NotImplementedError("Coming soon in v0.1.0")

envdrift-0.0.1.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: envdrift
+Version: 0.0.1
+Summary: Prevent environment variable drift with Pydantic schema validation, pre-commit hooks, and dotenvx encryption
+Project-URL: Homepage, https://github.com/jainal09/envdrift
+Project-URL: Documentation, https://github.com/jainal09/envdrift#readme
+Project-URL: Repository, https://github.com/jainal09/envdrift
+Project-URL: Issues, https://github.com/jainal09/envdrift/issues
+Author-email: Jainal Gosaliya <gosaliya.jainal@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: config,dotenv,drift,environment,pre-commit,pydantic,schema,secrets,validation,variables
+Classifier: Development Status :: 1 - Planning
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.9
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.0; extra == 'dev'
+Requires-Dist: pyrefly>=0.2.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# envdrift
+
+[![PyPI version](https://badge.fury.io/py/envdrift.svg)](https://badge.fury.io/py/envdrift)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Prevent environment variable drift between dev, staging, and production.**
+
+> 🚧 **Under Active Development** - Core features coming in v0.1.0
+
+## The Problem
+
+Environment variable drift is a silent killer of deployments:
+
+- A missing `DATABASE_URL` in production causes a 3am outage
+- Staging has `NEW_FEATURE_FLAG=true` but production doesn't
+- Someone copies the wrong `.env` file and chaos ensues
+- "It works on my machine!" becomes your team's motto
+
+**In 2024 alone, 24 million secrets were leaked on GitHub.** Knight Capital lost **$460 million in 45 minutes** due to a configuration deployment error.
+
+## The Solution
+
+`envdrift` treats your environment variables with the same rigor as your code:
+
+- **Schema Validation**: Define expected variables with Pydantic, catch mismatches at startup
+- **Drift Detection**: Compare `.env.dev` vs `.env.prod` and see exactly what differs
+- **Pre-commit Hooks**: Block commits if your `.env` doesn't match your schema
+- **CI/CD Integration**: Fail fast in pipelines before bad config reaches production
+- **Encryption Support**: Works with dotenvx for secure, committable `.env` files
+
+## Installation
+
+```bash
+pip install envdrift
+# or
+uv add envdrift
+```
+
+## Quick Start
+
+### Validate your .env against a schema
+
+```bash
+envdrift validate .env --schema myapp.config:Settings
+```
+
+### Compare environments
+
+```bash
+envdrift diff .env.dev .env.prod
+```
+
+### Generate a Settings class from existing .env
+
+```bash
+envdrift init .env --output settings.py
+```
+
+### Install pre-commit hook
+
+```bash
+envdrift hook --install
+```
+
+## Planned Features (v0.1.0)
+
+- [ ] `envdrift validate` - Validate .env against Pydantic schema
+- [ ] `envdrift diff` - Compare two .env files
+- [ ] `envdrift init` - Generate Settings class from .env
+- [ ] `envdrift hook` - Pre-commit hook integration
+- [ ] Rich terminal output with clear error messages
+- [ ] dotenvx encryption detection and support
+- [ ] CI mode with proper exit codes
+
+## Why envdrift?
+
+| Feature | python-dotenv | dynaconf | pydantic-settings | **envdrift** |
+|---------|---------------|----------|-------------------|--------------|
+| Load .env | ✅ | ✅ | ✅ | ✅ |
+| Type validation | ❌ | ⚠️ | ✅ | ✅ |
+| Schema enforcement | ❌ | ⚠️ | ✅ | ✅ |
+| Cross-env diff | ❌ | ❌ | ❌ | ✅ |
+| Pre-commit hook | ❌ | ❌ | ❌ | ✅ |
+| Encryption support | ❌ | ❌ | ❌ | ✅ |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/jainal09/envdrift.git
+cd envdrift
+
+# Install dev dependencies
+make dev
+
+# Run checks
+make check
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Author
+
+**Jainal Gosaliya** - [gosaliya.jainal@gmail.com](mailto:gosaliya.jainal@gmail.com)

envdrift-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+envdrift/__init__.py,sha256=ZUscFngMxW1DbYNUrDRO34GqfE7od57Yh-YK1pALb2A,502
+envdrift/cli.py,sha256=DzhRpLecdY_0V92BdfNLYR0yZKUT8d9yhJKAmwfmnnA,3095
+envdrift/core.py,sha256=dkFn6bkJNXPdVr8AGHicHwB36wE_uNgf1YN2uCnHlAM,1342
+envdrift/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+envdrift-0.0.1.dist-info/METADATA,sha256=K3aK7sOYrxv1EVhEPDzObwDFqC8nr9Mx217YT0NfRi8,4773
+envdrift-0.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+envdrift-0.0.1.dist-info/entry_points.txt,sha256=njqKNXn7qzidlqaoWgy8_Cwc8F_Sc2Jle2tyPUsMJDU,46
+envdrift-0.0.1.dist-info/licenses/LICENSE,sha256=alWX8zV_Hd76Ze1Wasp1gVkcYypBD9VY5S8uqQhStQw,1072
+envdrift-0.0.1.dist-info/RECORD,,

envdrift-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

envdrift-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+envdrift = envdrift.cli:app

envdrift-0.0.1.dist-info/licenses/LICENSE

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