A better configuration library for Django and other Python projects
Project description
Walter is a configuration library, inspired by python-decouple, and intended to replace direct access to os.environ in Django settings.py files (although it is by no means Django-specific). It currently supports Python 3.6+.
It differs from other, similar libraries for one reason: when your users try to start up your app with invalid configuration, the error message they get shows a list of all of the errors with every configuration parameter, not just the first one.
Installation
pip install walter
# or
poetry add walter
Usage
Here’s an example of a Python file that uses Walter to define its configuration.
from walter.config import Config with Config("Acme Inc.", "My Awesome App") as config: # Read a configuration value with config() SECRET_KEY = config('SECRET_KEY') # Convert the returned value to something other than a string with cast. DEBUG = config('DEBUG', cast=bool) # You can pass any function that takes a string to `cast`. # Here, we're using a third party function to parse a database URL # string into a Django-compatible dictionary. import dj_database_url DATABASES = { 'default': config('DATABASE_URL', cast=dj_database_url.parse), } # You can also make a parameter optional by giving it a default. SENTRY_DSN = config('SENTRY_DSN', default=None) print(f"Here, you can use values like {SITE_NAME}!")
If we run that code without setting anything, Walter throws an error at the end of the with block.
Traceback (most recent call last):
File "<stdin>", line 27, in <module>
File "/Users/leigh/Projects/walter/walter/config.py", line 90, in __exit__
raise ConfigErrors(errors=self.errors)
walter.config.ConfigErrors: 4 configuration values not set, 0 invalid
SECRET_KEY not set
DEBUG not set
DATABASE_URL not set
SITE_NAME not set
Note that Walter lists out all of the errors in our configuration, not just the first one! If we set all of those settings as environment variables and run the code again, the code runs to completion:
Here, you can use values like MyAwesomeApp!
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file walter-1.1.tar.gz
.
File metadata
- Download URL: walter-1.1.tar.gz
- Upload date:
- Size: 16.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.5 CPython/3.8.2 Darwin/19.4.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c152638f312191c87d08bef738ac3913e3bbd8d2a066068ccb4811a6252de71 |
|
MD5 | adf7c8285e55bcc17d11417c6623cace |
|
BLAKE2b-256 | 7150de173d658ec91d0c852a7ded31719608b146e612d32388f2cdb06cf0e7e8 |
Provenance
File details
Details for the file walter-1.1-py3-none-any.whl
.
File metadata
- Download URL: walter-1.1-py3-none-any.whl
- Upload date:
- Size: 17.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.0.5 CPython/3.8.2 Darwin/19.4.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e6e161bfb40672386181072d84e041c21e043290708fe52eadd2428f032a653a |
|
MD5 | 1e9279c2c95944084bfaca1241ab55e8 |
|
BLAKE2b-256 | 9d3abb5c904535bd6b2750500be7f9d8a3eab7fe796a848334a27e5f0f45427a |