Metadata-Version: 2.1
Name: haip-config
Version: 0.1.6
Summary: A simple yaml config manager.
Home-page: https://github.com/haipdev/config
Author: Reinhard Hainz
Author-email: reinhard.hainz@gmail.com
License: UNKNOWN
Description: # haip.config
        
        [![License](https://img.shields.io/github/license/haipdev/config.svg)](LICENSE)
        [![Build Status](https://travis-ci.org/haipdev/config.svg?branch=master)](https://travis-ci.org/haipdev/config)
        
        haip.config is a simple yaml configuration handling module for Python 3.6+.
        
        ## Features
        
        * **directory based**: place your config in multiple files in your configuration directory. haip.config will merge them automatically.
        * **environment overlay**: place your environment specific configuration in a subdirectory. haip.config will overwrite the base configuration.
        * **attribute-style**: a.b.c = a['b']['c']
        
        ## Getting Started
        
        ### Installing
        
        ```sh
        pip install haip.config
        ```
        
        or from source:
        
        ```sh
        git clone https://github.com/haipdev/config.git
        ```
        
        ### Example
        
        #### config-files
        
        /path-to-my-config-dir/databases.yml
        
        ```yaml
        databases:
            test:
                username: testuser
                host: 127.0.0.2
        ```
        
        /path-to-my-config-dir/dev/databases.yml
        
        ```yaml
        databases:
            test:
                password: testpassword
        ```
        
        #### python implementation
        
        ```python
        import haip.config as config
        
        config.load('/path-to-my-config-dir', 'dev')
        cfg = config.get('databases', 'test', username=config.MANDATORY, password=config.MANDATORY,  host='127.0.0.1', port=3306)
        
        username = cfg.databases.test.username   # <-- 'testuser' from base-config
        password = cfg.databases.test.password   # <-- 'testpassword' from dev subdir
        host = cfg.databases.test.host           # <-- '127.0.0.2' from base-config (default not used)
        port = cfg.databases.test.port           # <-- 3306 from default
        ```
        
        ## Running the tests
        
        Tests are written using pytest and located in the "tests" directory.
        
        ```sh
        pytest tests
        ```
        
        ## Contributing
        
        Feel free to use and enhance this project. Pull requests are welcome.
        
        ## Authors
        
        * **Reinhard Hainz** - *Initial work* - [haipdev](https://github.com/haipdev)
        
        ## License
        
        This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
        
        ## Dependencies
        
        * [poyo](https://github.com/hackebrot/poyo)
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
