Metadata-Version: 2.5
Name: envlet
Version: 0.1.0
Summary: Pull your Envlet environment at runtime: load, get, or inject values with one token.
Project-URL: Homepage, https://github.com/selcor/envlet
Project-URL: Repository, https://github.com/selcor/envlet
Project-URL: Issues, https://github.com/selcor/envlet/issues
Author: SELCOR
License: MIT
License-File: LICENSE
Keywords: configuration,environment,secrets
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 :: Only
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: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# envlet

Pull your Envlet environment at runtime. The host platform holds one secret,
an Envlet token, and your app loads everything else at boot.

```python
from envlet import inject

inject()
```

`inject()` fetches every value the token's identity may read and sets
`os.environ`. Values already set by the host are never overwritten. Pass
`override=True` to force Envlet's values.

```python
from envlet import get, load

values = load()
stripe_key = get("STRIPE_KEY")
```

`load()` returns the values as a `dict[str, str]`. `get(name)` fetches one value
and raises `EnvletNotFoundError` when the identity cannot read it.

Install the package from PyPI:

```sh
python3 -m pip install envlet
```

Configuration comes from `ENVLET_TOKEN` or the `token` keyword argument. Set
`ENVLET_API_URL` or pass `api_url` to use another API base URL. Requests retry
on network errors and 5xx responses by default. Pass `retry=False` to make one
attempt.

Authentication failures raise `EnvletAuthError`. All SDK exceptions inherit
from `EnvletError` and expose `code` and `status` attributes. Values are fetched
at call time, and the SDK never caches or returns partial results.
