Metadata-Version: 2.1
Name: env-var-config
Version: 0.1.0
Summary: Parsing configuration from environment variables as typing.NamedTuple
Home-page: https://github.com/iteriodata/env_var_config
Author: UNKNOWN
Author-email: UNKNOWN
License: MIT
Project-URL: Bug Reports, https://github.com/iteriodata/env_var_config/issues
Project-URL: Source, https://github.com/iteriodata/env_var_config
Keywords: config env var
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English

env_var_config
==============

This project allows you to describe the configuration of your application as a
``typing.NamedTuple``, like so:

.. code-block:: python

    import typing

    class MyAppConfig(typing.NamedTuple):
        some_string: str
        some_int: int
        some_float: float
        some_bool: bool = True

Then, gather the configuration from the environment variables:

.. code-block:: python

    import env_var_config

    config = env_var_config.gather_config_for_class(MyAppConfig)

The code will look for variables that are called like the fields of the tuple, but uppercase.

As you might have noticed, you can set default values on the fields.
If the fields with defaults are not found in the environment, they're set to their default value
(which is quite unsurprising).
If a value without a default is missing, though, an error will be raised.
That is, unless you set ``allow_empty`` option to ``True``
in the call to ``gather_config_for_class``.
Then all missing values will be initialized with the default value for their type,
such as an empty string for ``str``, 0 for ``int``, etc.

Installation
------------

.. code-block:: bash

    pip install env_var_config


