Parsenvy: Enviously Elegant Environment Variable Parsing

Parsenvy is an enviously elegant environment variable parsing Python library.

Environment variables are strings by default. This can be rather inconvenient if you're dealing with a number of them, and in a variety of desired types. Parsenvy aims to provide an intuitive, explicit interface for retrieving these values in appropriate types with human-friendly syntax.

Features

• Compatible with Python 3.6+ only (the last Python 2 compatible version was 1.0.2).
• Fully tested on Linux, macOS, and Windows.
• No dependencies outside of the Python standard library.
• BSD (3-Clause) licensed.
• Utterly awesome.
• Now with docs!

Examples

>>> import parsenvy
>>> parsenvy.bool('BOOL_ENV_VAR')  # BOOL_ENV_VAR=True
True
>>> parsenvy.int('INT_ENV_VAR')  # INT_ENV_VAR=13
13
>>> parsenvy.float('FLOAT_ENV_VAR')  # FLOAT_ENV_VAR=555.55
555.55
>>> parsenvy.list('LIST_ENV_VAR')  # LIST_ENV_VAR=shiver,me,timbers
['shiver', 'me', 'timbers']
>>> parsenvy.tuple('TUPLE_ENV_VAR')  # TUPLE_ENV_VAR=hello,world
('hello', 'world')
>>> parsenvy.str('STR_ENV_VAR')  # STR_ENV_VAR=meep
'meep'
>>> parsenvy.set('SET_ENV_VAR')  # SET_ENV_VAR=wat,wut,wot
set(['wat', 'wut', 'wot'])

Install

pip install parsenvy

Contributing

Contributions are welcome, and more information is available in the contributing guide.