Environment variable loading using cattrs

a04.py

from os import environ
from typing import TypeVar

from attr import NOTHING, define, fields

from cattr import GenConverter
from cattr._compat import is_sequence


@define
class MyEnvVars:
    """Model your environment variables as members of this class."""

    PWD: str
    PATH: list[str]
    USER: str
    INT_LIST: list[int]
    NONEXISTENT: str = "MyDefault"


c = GenConverter()


def gen_structure_envvar_seq(type):
    def structure_envvar_seq(encoded_seq: str, _) -> list:
        return [
            c.structure(e, type.__args__[0]) for e in encoded_seq.split(":")
        ]

    return structure_envvar_seq


c.register_structure_hook_factory(is_sequence, gen_structure_envvar_seq)

T = TypeVar("T")


def load_env_vars(cls: type[T], vars: dict[str, str] = environ) -> T:
    obj = {
        f.name: vars[f.name]
        for f in fields(cls)
        if f.default is NOTHING or f.name in vars
    }
    return c.structure(obj, cls)


print(load_env_vars(MyEnvVars))

I yesterday also found c._structure_list() – would this be a better alternative to the list comp. in your example?

It's kind of an internal API, but sure, it's not going anywhere.