Metadata-Version: 2.1
Name: settings-vial
Version: 0.3.0
Summary: Python settings for cloud environments
Home-page: https://github.com/kpn/settings-vial
Author: Charles David de Moraes
Author-email: charles.moraes@kpn.com
License: Apache 2.0
Description: # Settings Vial
        
        Python settings for cloud environments
        
        [![image](https://api.travis-ci.com/kpn/settings-vial.svg?branch=master)](https://travis-ci.com/kpn/settings-vial?branch=master)
        [![image](https://img.shields.io/codecov/c/github/kpn/settings-vial/master.svg)](https://codecov.io/github/kpn/settings-vial?branch=master)
        [![image](https://img.shields.io/pypi/v/settings-vial)](https://pypi.python.org/pypi/settings-vial)
        [![image](https://readthedocs.org/projects/settings-vial/badge/?version=latest)](https://settings-vial.readthedocs.org/en/latest/?badge=latest)
        [![image](https://img.shields.io/badge/code%20style-black-000000.svg)]()
        
        Settings Vial is a Python package providing an abstraction to read settings from environment variables. Such settings are then available as regular
        Python variables, making it easily integrated with configuration mechanisms provided by framworks like [Django](https://docs.djangoproject.com/en/2.2/topics/settings/) or others.
        
        This package uses [pkgsettings](https://github.com/kpn-digital/py-pkgsettings), so it can be used in configuration chains.
        
        On demand setting overrides (dynamic settings), with subtrees of alternative configurations, are also possible.
        
        
        
        ## Usage
        
        ``` shell
        $ export MY_APP_TEST_VAR=42
        ```
        
        
        ``` python
        >>> from settings_vial import Settings
        >>> settings = Settings(env_prefix="MY_APP_")
        >>> settings.load_env()
        >>> settings.TEST_VAR
        42
        ```
        
        ## Features
        
        - Loads prefixed environment variables (json encoded)
        - Dynamic settings support (loads keys from callable instead)
        
        
        ## Installation
        
        ```shell
        $ pip install settings_vial
        ```
        
        ## Running tests
        
        ```shell
        $ make test
        ```
        
        ## Contributing
        
        If you'd like to contribute, please follow this workflow:
        
        1. Fork this repository
        2. Clone your fork
        3. Create and test your changes
        4. Create a pull-request
        5. Wait for review and approval from the repository collaborators
        
        Contributions are always welcome.
        
        ## Support
        
        If you need help or have bug reports, please file an issue in our [Issue Tracker](../../../issues).
        
        ## Versioning
        
        This project uses SemVer 2 for versioning. For the versions available, see the tags on this repository.
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
