Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Python high level configuration library
Python Shell
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
pymlconf
.gitignore
README.html
README.md
README.rst
generate.docs
generate.readmes
setup.py
tasks

README.md

pymlconf

pymlconf (Python YAML Configuration Library) helps to easily manage and access to your application configurations which was already Written in YAML language.

It can merge two or more configuration files according their names and automatically treat file-names as namespaces, or simply merge several parts of configuration(YAML-string or Python-dict) on arbitrary config node. for more informations see documentations.

Config file

# filename: config.yaml
app:
    root_dir: %(here)s

Python code:

# filename: config.py
from pymlconf import ConfigManager

config_str='''
app:
    name: MyApp
    listen:
        sock1:
            addr: %(hostname)s
            port: %(port)s
    languages:
        - english
        - {language: persian, country: iran}

logfile: /var/log/myapp.log
'''

cfg = ConfigManager(init_value=config_str, context=dict(hostname='192.168.0.1', port=8080))
cfg.load_files('path/to/config.yaml')

print cfg.app.name
print cfg.app.listen.sock1.addr
print cfg.app.languages[0]
print cfg.app.languages[1].country
print cfg.logfile

# --------- Prints:
# MyApp
# 192.168.0.1
# english
# iran
# /var/log/myapp.log

Installation

Latest stable version:

$ pip install pymlconf
# or
$ easy_install pymlconf

Development version:

$ pip install git+git@github.com:pylover/pymlconf.git

From source:

$ cd source_dir
$ python setup.py install

Manually download it from pypi

Unit-Tests

Install nose and change current directory to project's dir:

$ pip install nose  
$ cd path/to/pymlconf 

Running tests:

$ nosetests

Or

$ python setup.py test

Syntax Reference

You can find the canonical syntax reference on PyYAML site

Documentation

Something went wrong with that request. Please try again.