smartenv

Smart .env loader with validation, fallback values, and secure variable handling.
Simplify your environment variable management across any Python project with smart defaults, type conversion, required flags, and secure masking.

🚀 Features

• 📦 Load variables from a .env file
• 🔐 Secure environment variables (masked in logs)
• ✅ Required variable enforcement
• 🧠 Smart default values with type conversion
• 📜 Simple API for any Python project (CLI, backend, scripts, etc.)

📦 Installation

pip install smartenv

⚡ Quick Usage

from smartenv import load_env, get_env, require_env, secure_env

load_env()  # Loads from .env

DEBUG = get_env("DEBUG", default=False, type=bool)
PORT = get_env("PORT", default=8000, type=int)
API_KEY = require_env("API_KEY")
DB_PASS = secure_env("DB_PASS")

print("DEBUG:", DEBUG)
print("DB_PASS (safe):", DB_PASS)

📄 .env Example

DEBUG=true
PORT=5000
API_KEY=supersecretkey
DB_PASS=sensitivepassword

📛 Exceptions

🔧 Supported Types

• str (default)

• int

• float

• bool (true, 1, yes, etc.)

🛡 Secure Variables

password = secure_env("SECRET")
print(password)      # prints: ******
str(password)        # prints: ******
actual = password == "SECRET"  # ✅ True

📚 License

MIT License © 2025 Ayomide Adediran https://github.com/Ay-developerweb/smartenv