fastenv 0.0.1

Unified settings management for FastAPI and beyond.

fastenv

🔧 Unified settings management for FastAPI and beyond 🚀

🚧 UNDER CONSTRUCTION - NOT FOR PRODUCTION 🚧

Description

Environment variables are key-value pairs provided to the operating system with syntax like VARIABLE_NAME=value. Collections of environment variables are stored in files commonly named .env and called "dotenv" files. The Python standard library provides tools for reading environment variables, such as os.getenv("VARIABLE_NAME"), but these tools only read environment variables that have already been loaded. Additional logic is therefore needed to load environment variables before they can be read by Python.

This project aims to:

• Unify settings management for FastAPI. Uvicorn, Starlette, and pydantic each have their own ways of loading environment variables and configuring application settings. This means that, when configuring a FastAPI application, there are at least three different settings management tools available, each with their own pros and cons. It would be helpful to address the limitations of each of these options, potentially providing a similar, improved API for each one.
• Replace the aging python-dotenv project with a similar, but more intuitive API, and modern syntax and tooling.
• Read settings from TOML. It's all about pyproject.toml now. Poetry has pushed PEP 517 build tooling and PEP 518 build requirements forward, and even setuptools has come around. Why don’t we use the metadata from our pyproject.toml files in our Python APIs?
• Integrate with object storage. Dotenv files are commonly kept in object storage like AWS S3, but none of the tools mentioned above integrate with object storage clients.

Let's see how this goes!

Further information

See CONTRIBUTING.md.