walter 1.2

安装

pip install walter
# or
poetry add walter

用法

这里有一个使用Walter定义其配置的Python文件的示例。

from walter.config import Config

with Config(author="Acme Inc.", name="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}!")

如果我们不设置任何内容就运行这段代码，Walter会在with块的末尾抛出错误。

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

请注意，Walter列出了我们配置中的所有错误，而不仅仅是第一个！如果我们将这些设置作为环境变量设置并再次运行代码，代码将运行到完成。

Here, you can use values like MyAwesomeApp!