envproof 0.1.0__tar.gz → 0.2.0__tar.gz

envproof-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing to envproof
+
+Thanks for taking the time to contribute!
+
+## Getting started
+
+```bash
+git clone https://github.com/CoderSufiyan/envguard.git
+cd envguard
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Running tests
+
+```bash
+pytest
+```
+
+All tests must pass before submitting a PR.
+
+## How to contribute
+
+- **Bug fix** — open an issue first describing the bug, then submit a PR
+- **New feature** — open an issue first so we can discuss before you build it
+- **Docs improvement** — go ahead and submit a PR directly
+
+## What we welcome
+
+- New supported types (e.g. `dict`, `Path`, `Enum`)
+- Better error messages
+- Framework integrations (FastAPI, Flask, Django startup hooks)
+- Performance improvements
+- More test coverage
+
+## Pull request checklist
+
+- [ ] Tests added or updated
+- [ ] All 28+ tests pass (`pytest`)
+- [ ] Code follows existing style (no external formatter required)
+- [ ] PR description explains what and why
+
+## Code style
+
+- No external dependencies in `envguard/` — keep it zero-dep
+- One function does one thing
+- Clear variable names over comments

envproof-0.2.0/LICENSE

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

envproof-0.2.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: envproof
+Version: 0.2.0
+Summary: Validate environment variables at startup with typed, clear error messages. Zero dependencies.
+Project-URL: Homepage, https://github.com/CoderSufiyan/envguard
+Project-URL: Repository, https://github.com/CoderSufiyan/envguard
+Project-URL: Issues, https://github.com/CoderSufiyan/envguard/issues
+License: MIT
+License-File: LICENSE
+Keywords: config,dotenv,env,environment,settings,validation
+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.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# envproof
+
+> Validate environment variables at startup with typed, clear error messages. Zero dependencies. Production-ready.
+
+[![PyPI version](https://img.shields.io/pypi/v/envproof.svg)](https://pypi.org/project/envproof/)
+[![Python versions](https://img.shields.io/pypi/pyversions/envproof.svg)](https://pypi.org/project/envproof/)
+[![CI](https://github.com/CoderSufiyan/envguard/actions/workflows/ci.yml/badge.svg)](https://github.com/CoderSufiyan/envguard/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/CoderSufiyan/envguard/blob/main/LICENSE)
+[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/CoderSufiyan/envguard)
+
+---
+
+Every backend app reads environment variables. The standard way fails silently or crashes with a cryptic error deep inside your app at runtime:
+
+```python
+# Crashes 10 minutes in, on an obscure code path
+db = connect(os.environ["DATABASE_URL"])  # KeyError: DATABASE_URL
+
+# PORT is a string — breaks math silently
+port = os.environ["PORT"]  # "8080", not 8080
+```
+
+**envproof catches all of this at startup**, before your app serves a single request:
+
+```python
+from envproof import EnvGuard
+
+class Env(EnvGuard):
+    DATABASE_URL: str
+    PORT: int = 8080
+    DEBUG: bool = False
+    ALLOWED_HOSTS: list = []
+
+env = Env()
+print(env.PORT)  # 8080 — already an int
+```
+
+If anything is wrong, you get a clear error immediately:
+
+```
+EnvProofError:
+Missing required environment variables:
+  - DATABASE_URL (str): not set
+
+Invalid environment variable values:
+  - PORT: expected int, got 'abc'
+  - DEBUG: expected bool, got 'maybe'
+```
+
+All errors reported at once — not one at a time.
+
+---
+
+## Install
+
+```bash
+pip install envproof
+```
+
+---
+
+## Usage
+
+### Recommended: one `env.py` file in your project
+
+```python
+# env.py
+from envproof import EnvGuard
+
+class Env(EnvGuard):
+    # Required — raises EnvProofError at startup if not set
+    DATABASE_URL: str
+    SECRET_KEY: str
+    API_KEY: str
+
+    # Optional — uses default if not set
+    PORT: int = 8080
+    DEBUG: bool = False
+    LOG_LEVEL: str = "INFO"
+    ALLOWED_HOSTS: list = []
+
+env = Env()
+```
+
+Then import `env` anywhere in your app:
+
+```python
+# app.py
+from env import env
+
+app.run(port=env.PORT, debug=env.DEBUG)
+```
+
+```python
+# database.py
+from env import env
+
+db = connect(env.DATABASE_URL)
+```
+
+### One-liner style (no subclass needed)
+
+```python
+from envproof import guard
+
+env = guard(DATABASE_URL=str, PORT=int, DEBUG=bool)
+print(env.DATABASE_URL)
+```
+
+### Works great with python-dotenv
+
+```python
+from dotenv import load_dotenv
+load_dotenv()          # loads .env file into environment
+
+from env import env    # envproof validates it
+```
+
+---
+
+## Supported types
+
+| Type    | Example env value              | Python value        |
+|---------|--------------------------------|---------------------|
+| `str`   | `hello`                        | `"hello"`           |
+| `int`   | `8080`                         | `8080`              |
+| `float` | `3.14`                         | `3.14`              |
+| `bool`  | `true`, `1`, `yes`, `on`       | `True`              |
+| `bool`  | `false`, `0`, `no`, `off`      | `False`             |
+| `list`  | `localhost,example.com`        | `["localhost", "example.com"]` |
+
+---
+
+## Why envproof?
+
+| | envproof | `os.environ` | `pydantic-settings` |
+|---|---|---|---|
+| Type coercion | Yes | No | Yes |
+| Clear error messages | Yes | No | Partial |
+| Zero dependencies | Yes | Yes | No (~2MB) |
+| Fail fast at startup | Yes | No | Yes |
+| Works anywhere | Yes | Yes | Pydantic only |
+
+**vs `pydantic-settings`:** great library, but pulls in Pydantic (~2MB). envproof is a single file with zero dependencies — ideal for serverless functions, lightweight containers, or any project that doesn't already use Pydantic.
+
+---
+
+## Production use
+
+envproof is designed for production. The "fail fast" pattern — crashing at startup rather than during a request — is standard practice in production backend systems. Your app either starts correctly or doesn't start at all. No surprises mid-flight.
+
+Used in: FastAPI apps, Flask apps, Django projects, CLI tools, serverless functions, Docker containers.
+
+---
+
+## Open Source
+
+envproof is MIT licensed and open for contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started.
+
+Things we'd love help with:
+- New types: `dict`, `Path`, `Enum`
+- Framework integrations (FastAPI lifespan hooks, Django `AppConfig.ready()`)
+- Better error formatting
+- More test coverage
+
+[Open an issue](https://github.com/CoderSufiyan/envguard/issues) or submit a PR — all contributions welcome.
+
+---
+
+## License
+
+[MIT](LICENSE) © Sufiyan Khan

envproof-0.2.0/README.md

@@ -0,0 +1,172 @@
+# envproof
+
+> Validate environment variables at startup with typed, clear error messages. Zero dependencies. Production-ready.
+
+[![PyPI version](https://img.shields.io/pypi/v/envproof.svg)](https://pypi.org/project/envproof/)
+[![Python versions](https://img.shields.io/pypi/pyversions/envproof.svg)](https://pypi.org/project/envproof/)
+[![CI](https://github.com/CoderSufiyan/envguard/actions/workflows/ci.yml/badge.svg)](https://github.com/CoderSufiyan/envguard/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/CoderSufiyan/envguard/blob/main/LICENSE)
+[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/CoderSufiyan/envguard)
+
+---
+
+Every backend app reads environment variables. The standard way fails silently or crashes with a cryptic error deep inside your app at runtime:
+
+```python
+# Crashes 10 minutes in, on an obscure code path
+db = connect(os.environ["DATABASE_URL"])  # KeyError: DATABASE_URL
+
+# PORT is a string — breaks math silently
+port = os.environ["PORT"]  # "8080", not 8080
+```
+
+**envproof catches all of this at startup**, before your app serves a single request:
+
+```python
+from envproof import EnvGuard
+
+class Env(EnvGuard):
+    DATABASE_URL: str
+    PORT: int = 8080
+    DEBUG: bool = False
+    ALLOWED_HOSTS: list = []
+
+env = Env()
+print(env.PORT)  # 8080 — already an int
+```
+
+If anything is wrong, you get a clear error immediately:
+
+```
+EnvProofError:
+Missing required environment variables:
+  - DATABASE_URL (str): not set
+
+Invalid environment variable values:
+  - PORT: expected int, got 'abc'
+  - DEBUG: expected bool, got 'maybe'
+```
+
+All errors reported at once — not one at a time.
+
+---
+
+## Install
+
+```bash
+pip install envproof
+```
+
+---
+
+## Usage
+
+### Recommended: one `env.py` file in your project
+
+```python
+# env.py
+from envproof import EnvGuard
+
+class Env(EnvGuard):
+    # Required — raises EnvProofError at startup if not set
+    DATABASE_URL: str
+    SECRET_KEY: str
+    API_KEY: str
+
+    # Optional — uses default if not set
+    PORT: int = 8080
+    DEBUG: bool = False
+    LOG_LEVEL: str = "INFO"
+    ALLOWED_HOSTS: list = []
+
+env = Env()
+```
+
+Then import `env` anywhere in your app:
+
+```python
+# app.py
+from env import env
+
+app.run(port=env.PORT, debug=env.DEBUG)
+```
+
+```python
+# database.py
+from env import env
+
+db = connect(env.DATABASE_URL)
+```
+
+### One-liner style (no subclass needed)
+
+```python
+from envproof import guard
+
+env = guard(DATABASE_URL=str, PORT=int, DEBUG=bool)
+print(env.DATABASE_URL)
+```
+
+### Works great with python-dotenv
+
+```python
+from dotenv import load_dotenv
+load_dotenv()          # loads .env file into environment
+
+from env import env    # envproof validates it
+```
+
+---
+
+## Supported types
+
+| Type    | Example env value              | Python value        |
+|---------|--------------------------------|---------------------|
+| `str`   | `hello`                        | `"hello"`           |
+| `int`   | `8080`                         | `8080`              |
+| `float` | `3.14`                         | `3.14`              |
+| `bool`  | `true`, `1`, `yes`, `on`       | `True`              |
+| `bool`  | `false`, `0`, `no`, `off`      | `False`             |
+| `list`  | `localhost,example.com`        | `["localhost", "example.com"]` |
+
+---
+
+## Why envproof?
+
+| | envproof | `os.environ` | `pydantic-settings` |
+|---|---|---|---|
+| Type coercion | Yes | No | Yes |
+| Clear error messages | Yes | No | Partial |
+| Zero dependencies | Yes | Yes | No (~2MB) |
+| Fail fast at startup | Yes | No | Yes |
+| Works anywhere | Yes | Yes | Pydantic only |
+
+**vs `pydantic-settings`:** great library, but pulls in Pydantic (~2MB). envproof is a single file with zero dependencies — ideal for serverless functions, lightweight containers, or any project that doesn't already use Pydantic.
+
+---
+
+## Production use
+
+envproof is designed for production. The "fail fast" pattern — crashing at startup rather than during a request — is standard practice in production backend systems. Your app either starts correctly or doesn't start at all. No surprises mid-flight.
+
+Used in: FastAPI apps, Flask apps, Django projects, CLI tools, serverless functions, Docker containers.
+
+---
+
+## Open Source
+
+envproof is MIT licensed and open for contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get started.
+
+Things we'd love help with:
+- New types: `dict`, `Path`, `Enum`
+- Framework integrations (FastAPI lifespan hooks, Django `AppConfig.ready()`)
+- Better error formatting
+- More test coverage
+
+[Open an issue](https://github.com/CoderSufiyan/envguard/issues) or submit a PR — all contributions welcome.
+
+---
+
+## License
+
+[MIT](LICENSE) © Sufiyan Khan

envproof-0.2.0/envproof/__init__.py

@@ -0,0 +1,4 @@
+from .core import EnvProof, EnvProofError, guard
+
+__all__ = ["EnvProof", "EnvProofError", "guard"]
+__version__ = "0.2.0"

{envproof-0.1.0/envguard → envproof-0.2.0/envproof}/core.py

@@ -4,11 +4,11 @@ from typing import Any, get_type_hints
 _MISSING = object()
 
 
-class EnvGuardError(Exception):
+class EnvProofError(Exception):
     pass
 
 
-class EnvGuard:
+class EnvProof:
     """
     Subclass this and declare your env vars as type-annotated class attributes.
 
@@ -54,7 +54,7 @@ class EnvGuard:
                 errors.append(f"  - {name}: expected {type_name}, got '{raw}'")
 
         if errors:
-            raise EnvGuardError("\n" + "\n".join(errors))
+            raise EnvProofError("\n" + "\n".join(errors))
 
 
 def _coerce(value: str, type_: type) -> Any:
@@ -77,7 +77,7 @@ def guard(**schema) -> Any:
         print(env.DATABASE_URL)
     """
 
-    class _Env(EnvGuard):
+    class _Env(EnvProof):
         pass
 
     _Env.__annotations__ = schema

{envproof-0.1.0 → envproof-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "envproof"
-version = "0.1.0"
+version = "0.2.0"
 description = "Validate environment variables at startup with typed, clear error messages. Zero dependencies."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -30,7 +30,7 @@ Repository = "https://github.com/CoderSufiyan/envguard"
 Issues = "https://github.com/CoderSufiyan/envguard/issues"
 
 [tool.hatch.build.targets.wheel]
-packages = ["envguard"]
+packages = ["envproof"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{envproof-0.1.0 → envproof-0.2.0}/tests/test_core.py

@@ -1,6 +1,6 @@
 import os
 import pytest
-from envguard import EnvGuard, EnvGuardError, guard
+from envproof import EnvProof, EnvProofError, guard
 
 
 def set_env(**kwargs):
@@ -13,13 +13,13 @@ def clear_env(*keys):
         os.environ.pop(k, None)
 
 
-# --- EnvGuard subclass style ---
+# --- EnvProof subclass style ---
 
 class TestRequired:
     def test_loads_required_str(self):
         set_env(APP_NAME="myapp")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             APP_NAME: str
 
         env = Env()
@@ -29,7 +29,7 @@ class TestRequired:
     def test_loads_required_int(self):
         set_env(PORT="9000")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             PORT: int
 
         env = Env()
@@ -39,7 +39,7 @@ class TestRequired:
     def test_loads_required_float(self):
         set_env(RATE="3.14")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             RATE: float
 
         env = Env()
@@ -49,10 +49,10 @@ class TestRequired:
     def test_raises_on_missing_required(self):
         clear_env("DATABASE_URL")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             DATABASE_URL: str
 
-        with pytest.raises(EnvGuardError) as exc:
+        with pytest.raises(EnvProofError) as exc:
             Env()
         assert "DATABASE_URL" in str(exc.value)
         assert "Missing" in str(exc.value)
@@ -60,11 +60,11 @@ class TestRequired:
     def test_raises_on_multiple_missing(self):
         clear_env("DB_URL", "API_KEY")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             DB_URL: str
             API_KEY: str
 
-        with pytest.raises(EnvGuardError) as exc:
+        with pytest.raises(EnvProofError) as exc:
             Env()
         assert "DB_URL" in str(exc.value)
         assert "API_KEY" in str(exc.value)
@@ -74,7 +74,7 @@ class TestOptional:
     def test_uses_default_when_not_set(self):
         clear_env("PORT")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             PORT: int = 8080
 
         env = Env()
@@ -83,7 +83,7 @@ class TestOptional:
     def test_overrides_default_when_set(self):
         set_env(PORT="9000")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             PORT: int = 8080
 
         env = Env()
@@ -93,7 +93,7 @@ class TestOptional:
     def test_optional_str_default(self):
         clear_env("LOG_LEVEL")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             LOG_LEVEL: str = "INFO"
 
         env = Env()
@@ -105,7 +105,7 @@ class TestBoolCoercion:
     def test_truthy_values(self, value):
         set_env(DEBUG=value)
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             DEBUG: bool
 
         assert Env().DEBUG is True
@@ -115,7 +115,7 @@ class TestBoolCoercion:
     def test_falsy_values(self, value):
         set_env(DEBUG=value)
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             DEBUG: bool
 
         assert Env().DEBUG is False
@@ -124,10 +124,10 @@ class TestBoolCoercion:
     def test_invalid_bool_raises(self):
         set_env(DEBUG="maybe")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             DEBUG: bool
 
-        with pytest.raises(EnvGuardError) as exc:
+        with pytest.raises(EnvProofError) as exc:
             Env()
         assert "DEBUG" in str(exc.value)
         clear_env("DEBUG")
@@ -137,7 +137,7 @@ class TestListCoercion:
     def test_comma_separated_list(self):
         set_env(ALLOWED_HOSTS="localhost,example.com,api.example.com")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             ALLOWED_HOSTS: list
 
         env = Env()
@@ -147,7 +147,7 @@ class TestListCoercion:
     def test_list_strips_whitespace(self):
         set_env(HOSTS=" a , b , c ")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             HOSTS: list
 
         env = Env()
@@ -159,10 +159,10 @@ class TestInvalidType:
     def test_invalid_int_raises(self):
         set_env(PORT="not-a-number")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             PORT: int
 
-        with pytest.raises(EnvGuardError) as exc:
+        with pytest.raises(EnvProofError) as exc:
             Env()
         assert "PORT" in str(exc.value)
         assert "int" in str(exc.value)
@@ -171,11 +171,11 @@ class TestInvalidType:
     def test_reports_all_invalid_at_once(self):
         set_env(PORT="bad", WORKERS="also-bad")
 
-        class Env(EnvGuard):
+        class Env(EnvProof):
             PORT: int
             WORKERS: int
 
-        with pytest.raises(EnvGuardError) as exc:
+        with pytest.raises(EnvProofError) as exc:
             Env()
         assert "PORT" in str(exc.value)
         assert "WORKERS" in str(exc.value)
@@ -193,7 +193,7 @@ class TestGuard:
 
     def test_guard_raises_on_missing(self):
         clear_env("SECRET_KEY")
-        with pytest.raises(EnvGuardError):
+        with pytest.raises(EnvProofError):
             guard(SECRET_KEY=str)
 
     def test_guard_int(self):

envproof-0.1.0/PKG-INFO

@@ -1,116 +0,0 @@
-Metadata-Version: 2.4
-Name: envproof
-Version: 0.1.0
-Summary: Validate environment variables at startup with typed, clear error messages. Zero dependencies.
-Project-URL: Homepage, https://github.com/CoderSufiyan/envguard
-Project-URL: Repository, https://github.com/CoderSufiyan/envguard
-Project-URL: Issues, https://github.com/CoderSufiyan/envguard/issues
-License: MIT
-Keywords: config,dotenv,env,environment,settings,validation
-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.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-
-# envguard
-
-Validate environment variables at startup with typed, clear error messages. Zero dependencies.
-
-```python
-from envguard import EnvGuard
-
-class Env(EnvGuard):
-    DATABASE_URL: str
-    PORT: int = 8080
-    DEBUG: bool = False
-    ALLOWED_HOSTS: list = []
-
-env = Env()
-print(env.PORT)  # 8080 (int, not string)
-```
-
-If `DATABASE_URL` is missing, you get this instead of a cryptic `KeyError` somewhere deep in your app:
-
-```
-EnvGuardError:
-Missing required environment variables:
-  - DATABASE_URL (str): not set
-```
-
-## Install
-
-```bash
-pip install envguard
-```
-
-## Usage
-
-### Subclass style (recommended)
-
-```python
-from envguard import EnvGuard
-
-class Env(EnvGuard):
-    # Required — raises if not set
-    DATABASE_URL: str
-    API_KEY: str
-
-    # Optional — uses default if not set
-    PORT: int = 8080
-    DEBUG: bool = False
-    LOG_LEVEL: str = "INFO"
-    ALLOWED_HOSTS: list = []
-
-env = Env()
-```
-
-### One-liner style
-
-```python
-from envguard import guard
-
-env = guard(DATABASE_URL=str, PORT=int, DEBUG=bool)
-print(env.DATABASE_URL)
-```
-
-## Supported types
-
-| Type    | Example env value         | Python value             |
-|---------|---------------------------|--------------------------|
-| `str`   | `"hello"`                 | `"hello"`                |
-| `int`   | `"8080"`                  | `8080`                   |
-| `float` | `"3.14"`                  | `3.14`                   |
-| `bool`  | `"true"`, `"1"`, `"yes"`  | `True`                   |
-| `bool`  | `"false"`, `"0"`, `"no"`  | `False`                  |
-| `list`  | `"a,b,c"`                 | `["a", "b", "c"]`        |
-
-## Error messages
-
-All errors are collected and reported together — you won't fix one missing var only to discover another:
-
-```
-EnvGuardError:
-Missing required environment variables:
-  - DATABASE_URL (str): not set
-  - API_KEY (str): not set
-
-Invalid environment variable values:
-  - PORT: expected int, got 'abc'
-  - DEBUG: expected bool, got 'maybe'
-```
-
-## Why not pydantic-settings?
-
-`pydantic-settings` is great but pulls in Pydantic as a dependency (~2MB). `envguard` is a single file with zero dependencies — useful when you want validation without adding weight to your project.
-
-## License
-
-MIT

envproof-0.1.0/README.md

@@ -1,94 +0,0 @@
-# envguard
-
-Validate environment variables at startup with typed, clear error messages. Zero dependencies.
-
-```python
-from envguard import EnvGuard
-
-class Env(EnvGuard):
-    DATABASE_URL: str
-    PORT: int = 8080
-    DEBUG: bool = False
-    ALLOWED_HOSTS: list = []
-
-env = Env()
-print(env.PORT)  # 8080 (int, not string)
-```
-
-If `DATABASE_URL` is missing, you get this instead of a cryptic `KeyError` somewhere deep in your app:
-
-```
-EnvGuardError:
-Missing required environment variables:
-  - DATABASE_URL (str): not set
-```
-
-## Install
-
-```bash
-pip install envguard
-```
-
-## Usage
-
-### Subclass style (recommended)
-
-```python
-from envguard import EnvGuard
-
-class Env(EnvGuard):
-    # Required — raises if not set
-    DATABASE_URL: str
-    API_KEY: str
-
-    # Optional — uses default if not set
-    PORT: int = 8080
-    DEBUG: bool = False
-    LOG_LEVEL: str = "INFO"
-    ALLOWED_HOSTS: list = []
-
-env = Env()
-```
-
-### One-liner style
-
-```python
-from envguard import guard
-
-env = guard(DATABASE_URL=str, PORT=int, DEBUG=bool)
-print(env.DATABASE_URL)
-```
-
-## Supported types
-
-| Type    | Example env value         | Python value             |
-|---------|---------------------------|--------------------------|
-| `str`   | `"hello"`                 | `"hello"`                |
-| `int`   | `"8080"`                  | `8080`                   |
-| `float` | `"3.14"`                  | `3.14`                   |
-| `bool`  | `"true"`, `"1"`, `"yes"`  | `True`                   |
-| `bool`  | `"false"`, `"0"`, `"no"`  | `False`                  |
-| `list`  | `"a,b,c"`                 | `["a", "b", "c"]`        |
-
-## Error messages
-
-All errors are collected and reported together — you won't fix one missing var only to discover another:
-
-```
-EnvGuardError:
-Missing required environment variables:
-  - DATABASE_URL (str): not set
-  - API_KEY (str): not set
-
-Invalid environment variable values:
-  - PORT: expected int, got 'abc'
-  - DEBUG: expected bool, got 'maybe'
-```
-
-## Why not pydantic-settings?
-
-`pydantic-settings` is great but pulls in Pydantic as a dependency (~2MB). `envguard` is a single file with zero dependencies — useful when you want validation without adding weight to your project.
-
-## License
-
-MIT

envproof-0.1.0/envguard/__init__.py

@@ -1,4 +0,0 @@
-from .core import EnvGuard, EnvGuardError, guard
-
-__all__ = ["EnvGuard", "EnvGuardError", "guard"]
-__version__ = "0.1.0"