envyronment 0.1.1

A tiny module to read environment variables and tranform them.

envyronment

A tiny module to read environment variables and tranform them.

When load_dotenv is available, this is called at import time.

---

---

Features

• ✅ Simple, typed API
• ✅ Loads .env if installed with extra dotenv
• ✅ Flexible casting via astype=...
• ✅ Propagates errors raised in the astype callable
• ✅ Zero dependencies required, python-dotenv optionally installed

Requirements

• Python 3.10+ (only 3.13 is tested)

Quick start

1. Install the package

   pip install envyronment
   

   or

   pip install envyronment[dotenv]  # Ensure python-dotenv is also installed
   

2. Import and use

   import env
   
   ascii_asterisk = env.read("ASCII_ASTERISK", 42, astype=int)  # typed as int, 42 by default
   debug = env.read("DEBUG", astype=bool)  # typed as bool, required
   

License

This project is licensed under the MIT License — see the LICENSE file for details.