tomlenv 0.2.0

Environment Wrapped TOML

TOMLenv

Environment wrapped TOML.

Getting Started

Install the library

Using pip:

$ pip install tomlenv

Using pipenv:

$ pipenv install tomlenv

Using poetry:

$ poetry add tomlenv

Basic Usage

Assuming you have this TOML file:

token = "dev"
debug = false

And this environment set:

TOMLENV_DEBUG=true

Create your configuration dataclass and parse configuration into it:

import tomlenv

class Config:
    token: str | None = ""
    enabled: bool = False

config = Config()
parser = tomlenv.Parser()

parser.load(config)

# You can now access the fields of your fully typed Config class
# that contains values from a TOML config file and the environment.
#
# For example:

token = config.token
debug = config.debug
print(token) # prints "dev"
print(debug) # prints True

Tests

This project uses Poetry and GNU Make.

Run tests from the project root with:

$ make test

To get a coverage report:

$ make cov