castaway
A simple wrapper for python-dotenv that allows for easy casting of environment strings to various data types.
Installation
Standard install:
pip install castaway
If you want Django integration (dj-email-url, dj-database-url), do:
pip install castaway[django]
Example
Easiest form is:
from castaway import config
SOME_SETTING = config('SOME_SETTING', default=None)Like python-dotenv, this will load .env from the current working directory,
or walk the parent directory tree until it is found.
For more custom usage, you can specify the exact name and path to whatever file you need.
For instance, using the tests/.env file from this repo.
from datetime import datetime
from castaway import Config
config = Config('tests/.env')
CASTAWAY_INT = config('CASTAWAY_INT', cast=int)
assert CASTAWAY_INT == 23
CASTAWAY_LIST = config('CASTAWAY_LIST', cast=list)
assert CASTAWAY_LIST == ['a', 'b', 'c']
CASTAWAY_DATETIME = config('CASTAWAY_DATETIME', cast=datetime.fromisoformat)
assert CASTAWAY_DATETIME == datetime(2021, 4, 3, 14, 25)