Skip to main content

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

walter-1.1.tar.gz (16.6 kB view details)

Uploaded Source

Built Distribution

walter-1.1-py3-none-any.whl (17.4 kB view details)

Uploaded Python 3

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

Hashes for walter-1.1.tar.gz
Algorithm Hash digest
SHA256 5c152638f312191c87d08bef738ac3913e3bbd8d2a066068ccb4811a6252de71
MD5 adf7c8285e55bcc17d11417c6623cace
BLAKE2b-256 7150de173d658ec91d0c852a7ded31719608b146e612d32388f2cdb06cf0e7e8

See more details on using hashes here.

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

Hashes for walter-1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e6e161bfb40672386181072d84e041c21e043290708fe52eadd2428f032a653a
MD5 1e9279c2c95944084bfaca1241ab55e8
BLAKE2b-256 9d3abb5c904535bd6b2750500be7f9d8a3eab7fe796a848334a27e5f0f45427a

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page