envdrift 3.1.3__tar.gz

envdrift-3.1.3/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    name: Tests & Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests with coverage
+        run: uv run pytest
+
+      - name: Lint markdown docs
+        run: make lint-docs
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml

envdrift-3.1.3/.github/workflows/docs.yml

@@ -0,0 +1,52 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs-material
+
+      - name: Build docs
+        run: mkdocs build --strict
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

envdrift-3.1.3/.github/workflows/publish.yml

@@ -0,0 +1,63 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  test:
+    name: Test matrix (3.11–3.13)
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0  # Fetch all history for hatch-vcs to determine version
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

envdrift-3.1.3/.gitignore

@@ -0,0 +1,84 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# hatch-vcs generated version file
+src/envdrift/_version.py
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.*
+!.env.example
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Ruff
+.ruff_cache/
+
+# macOS
+.DS_Store
+
+# UV
+.uv/
+.uv-cache/
+uv.lock
+site/

envdrift-3.1.3/.markdownlint.json

@@ -0,0 +1,16 @@
+{
+    "MD013": {
+        "line_length": 150
+    },
+    "MD024": false,
+    "MD033": {
+        "allowed_elements": [
+            "p",
+            "img",
+            "br",
+            "details",
+            "summary"
+        ]
+    },
+    "MD041": false
+}

envdrift-3.1.3/.pre-commit-config.yaml

@@ -0,0 +1,40 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.10
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml", "-r", "src"]
+        additional_dependencies: ["bandit[toml]"]
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-toml
+
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.17.2
+    hooks:
+      - id: markdownlint-cli2
+        args: ["**/*.md", "#node_modules", "#.venv", "#venv", "#.git", "#dist", "#build", "#site"]
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest
+        entry: uv run pytest -q
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]
+        timeout: 300  # 5 minutes; adjust based on typical test duration

envdrift-3.1.3/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.

envdrift-3.1.3/Makefile

@@ -0,0 +1,95 @@
+.PHONY: install dev lint format typecheck security test build clean publish docs docs-serve lint-docs help
+
+# Default target
+help:
+	@echo "envdrift - Prevent environment variable drift"
+	@echo ""
+	@echo "Usage: make [target]"
+	@echo ""
+	@echo "Targets:"
+	@echo "  install     Install production dependencies"
+	@echo "  dev         Install development dependencies"
+	@echo "  lint        Run linting with ruff"
+	@echo "  format      Format code with ruff"
+	@echo "  typecheck   Run type checking with pyrefly"
+	@echo "  security    Run security checks with bandit"
+	@echo "  test        Run tests with pytest"
+	@echo "  check       Run all checks (lint, typecheck, security, test)"
+	@echo "  docs        Build documentation"
+	@echo "  docs-serve  Serve documentation locally"
+	@echo "  lint-docs   Run markdown linting on docs"
+	@echo "  build       Build package for distribution"
+	@echo "  publish     Publish to PyPI"
+	@echo "  clean       Remove build artifacts"
+
+# Install production dependencies
+install:
+	uv sync
+
+# Install development dependencies
+dev:
+	uv sync --all-extras
+
+# Run linting
+lint:
+	uv run ruff check src tests
+
+# Format code
+format:
+	uv run ruff check --fix src tests
+	uv run ruff format src tests
+
+# Run type checking with pyrefly
+typecheck:
+	uv run pyrefly check src
+
+# Run security checks with bandit
+security:
+	uv run bandit -r src -c pyproject.toml
+
+# Run tests
+test:
+	uv run pytest
+
+# Run all checks
+check: lint typecheck security test
+
+# Build package
+build: clean
+	uv build
+
+# Publish to PyPI
+publish: build
+	uv publish
+
+# Publish to TestPyPI first (for testing)
+publish-test: build
+	uv publish --index-url https://test.pypi.org/simple/
+
+# Build documentation
+docs:
+	uv run mkdocs build --strict
+
+# Serve documentation locally
+docs-serve:
+	uv run mkdocs serve
+
+# Lint markdown documentation
+lint-docs:
+	@echo "Linting markdown files..."
+	npx markdownlint-cli2 "**/*.md" "#node_modules" "#.venv" "#venv" "#.git" "#dist" "#build" "#site" "#.pytest_cache" \
+	 "#.ruff_cache" "#.uv-cache"
+
+# Clean build artifacts
+clean:
+	rm -rf dist/
+	rm -rf build/
+	rm -rf site/
+	rm -rf *.egg-info/
+	rm -rf src/*.egg-info/
+	rm -rf .pytest_cache/
+	rm -rf .ruff_cache/
+	rm -rf .coverage
+	rm -rf htmlcov/
+	find . -type d -name "__pycache__" -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete 2>/dev/null || true

envdrift-3.1.3/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: envdrift
+Version: 3.1.3
+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://jainal09.github.io/envdrift
+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: aws,azure,config,dotenv,dotenvx,drift,encryption,environment,hashicorp,pre-commit,pydantic,schema,secrets,validation,variables,vault
+Classifier: Development Status :: 3 - Alpha
+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: all
+Requires-Dist: azure-identity>=1.15; extra == 'all'
+Requires-Dist: azure-keyvault-secrets>=4.8; extra == 'all'
+Requires-Dist: boto3>=1.34; extra == 'all'
+Requires-Dist: hvac>=2.0; extra == 'all'
+Requires-Dist: pyyaml>=6.0; extra == 'all'
+Provides-Extra: aws
+Requires-Dist: boto3>=1.34; extra == 'aws'
+Provides-Extra: azure
+Requires-Dist: azure-identity>=1.15; extra == 'azure'
+Requires-Dist: azure-keyvault-secrets>=4.8; extra == 'azure'
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5; 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-mock>=3.12; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Provides-Extra: hashicorp
+Requires-Dist: hvac>=2.0; extra == 'hashicorp'
+Provides-Extra: precommit
+Requires-Dist: pyyaml>=6.0; extra == 'precommit'
+Provides-Extra: vault
+Requires-Dist: azure-identity>=1.15; extra == 'vault'
+Requires-Dist: azure-keyvault-secrets>=4.8; extra == 'vault'
+Requires-Dist: boto3>=1.34; extra == 'vault'
+Requires-Dist: hvac>=2.0; extra == 'vault'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jainal09/envdrift/main/docs/assets/images/env-drift-logo.png" alt="envdrift logo" width="300">
+</p>
+
+# 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)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://jainal09.github.io/envdrift)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Pyrefly](https://img.shields.io/badge/types-pyrefly-blue)](https://github.com/facebook/pyrefly)
+[![codecov](https://codecov.io/gh/jainal09/envdrift/graph/badge.svg)](https://codecov.io/gh/jainal09/envdrift)
+[![SLOC](https://sloc.xyz/github/jainal09/envdrift)](https://sloc.xyz/github/jainal09/envdrift)
+
+**Prevent environment variable drift between dev, staging, and production.**
+
+## The Problem
+
+- A missing `DATABASE_URL` in production causes a 3am outage
+- Staging has `NEW_FEATURE_FLAG=true` but production doesn't
+- "It works on my machine!" becomes your team's motto
+
+## The Solution
+
+```bash
+# Validate .env against Pydantic schema
+envdrift validate .env --schema config.settings:Settings
+
+# Compare dev vs prod
+envdrift diff .env.development .env.production
+
+# Check encryption status
+envdrift encrypt .env.production --check
+```
+
+## Installation
+
+```bash
+pip install envdrift
+```
+
+## Quick Start
+
+**Define your schema:**
+
+```python
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(extra="forbid")
+
+    DATABASE_URL: str = Field(json_schema_extra={"sensitive": True})
+    API_KEY: str = Field(json_schema_extra={"sensitive": True})
+    DEBUG: bool = False
+```
+
+**Validate:**
+
+```bash
+envdrift validate .env --schema config.settings:Settings
+```
+
+## Features
+
+| Feature              | envdrift               |
+|----------------------|------------------------|
+| Schema validation    | Pydantic-based         |
+| Cross-env diff       | Yes                    |
+| Pre-commit hooks     | Yes                    |
+| Encryption (dotenvx) | Yes                    |
+| Vault integration    | Azure, AWS, HashiCorp  |
+| CI/CD mode           | Yes                    |
+
+## Documentation
+
+Full documentation: **[jainal09.github.io/envdrift](https://jainal09.github.io/envdrift)**
+
+## Development
+
+```bash
+git clone https://github.com/jainal09/envdrift.git
+cd envdrift
+make dev
+make test
+make docs-serve
+```
+
+## License
+
+MIT

envdrift-3.1.3/README.md

@@ -0,0 +1,92 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/jainal09/envdrift/main/docs/assets/images/env-drift-logo.png" alt="envdrift logo" width="300">
+</p>
+
+# 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)
+[![Docs](https://img.shields.io/badge/docs-mkdocs-blue)](https://jainal09.github.io/envdrift)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Pyrefly](https://img.shields.io/badge/types-pyrefly-blue)](https://github.com/facebook/pyrefly)
+[![codecov](https://codecov.io/gh/jainal09/envdrift/graph/badge.svg)](https://codecov.io/gh/jainal09/envdrift)
+[![SLOC](https://sloc.xyz/github/jainal09/envdrift)](https://sloc.xyz/github/jainal09/envdrift)
+
+**Prevent environment variable drift between dev, staging, and production.**
+
+## The Problem
+
+- A missing `DATABASE_URL` in production causes a 3am outage
+- Staging has `NEW_FEATURE_FLAG=true` but production doesn't
+- "It works on my machine!" becomes your team's motto
+
+## The Solution
+
+```bash
+# Validate .env against Pydantic schema
+envdrift validate .env --schema config.settings:Settings
+
+# Compare dev vs prod
+envdrift diff .env.development .env.production
+
+# Check encryption status
+envdrift encrypt .env.production --check
+```
+
+## Installation
+
+```bash
+pip install envdrift
+```
+
+## Quick Start
+
+**Define your schema:**
+
+```python
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(extra="forbid")
+
+    DATABASE_URL: str = Field(json_schema_extra={"sensitive": True})
+    API_KEY: str = Field(json_schema_extra={"sensitive": True})
+    DEBUG: bool = False
+```
+
+**Validate:**
+
+```bash
+envdrift validate .env --schema config.settings:Settings
+```
+
+## Features
+
+| Feature              | envdrift               |
+|----------------------|------------------------|
+| Schema validation    | Pydantic-based         |
+| Cross-env diff       | Yes                    |
+| Pre-commit hooks     | Yes                    |
+| Encryption (dotenvx) | Yes                    |
+| Vault integration    | Azure, AWS, HashiCorp  |
+| CI/CD mode           | Yes                    |
+
+## Documentation
+
+Full documentation: **[jainal09.github.io/envdrift](https://jainal09.github.io/envdrift)**
+
+## Development
+
+```bash
+git clone https://github.com/jainal09/envdrift.git
+cd envdrift
+make dev
+make test
+make docs-serve
+```
+
+## License
+
+MIT