Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Python high level configuration library

Project description

pymlconf
========

**pymlconf** (Python YAML Configuration Library) helps to easily manage and access to your application configurations which was already Written in [YAML](http://pyyaml.org) 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](https://github.com/pylover/pymlconf#documentation).


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


#### Deferred(Proxied)

# module configuration.py
from pymlconf import DeferredConfigManager
settings = DeferredConfigManager()

# another_module.py
from configuration import settings
def serve_request():
return settings.message

# in application startup
from configuration import settings
settings.load(
# the signature is the same as the `ConfigManager.__init__`
)


#### 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](https://pypi.python.org/pypi/pymlconf)

#### 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](http://pyyaml.org/wiki/PyYAMLDocumentation#YAMLsyntax) site


#### Documentation

* [pythonhosted.org] (http://pythonhosted.org/pymlconf/)
* [readthedocs.org] (http://pymlconf.readthedocs.org/en/latest/)


#### Change Log

- [0.5.1] Encoding option python2 compatibility
- [0.5.0] Adding encoding option
- [0.4.0] Adding DeferredConfigManager

Project details


Release history Release notifications

History Node

0.8.6

History Node

0.8.5

History Node

0.7.3

History Node

0.7.2

History Node

0.7.1

History Node

0.7.0

History Node

0.6.0

History Node

0.5.23

History Node

0.5.22

History Node

0.5.21

History Node

0.5.20

History Node

0.5.19

History Node

0.5.18

History Node

0.5.16

History Node

0.5.14

History Node

0.5.13

History Node

0.5.12

History Node

0.5.11

History Node

0.5.10

History Node

0.5.9

History Node

0.5.8

History Node

0.5.6

History Node

0.5.5

History Node

0.5.4

This version
History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.21

History Node

0.3.20

History Node

0.3.18

History Node

0.3.17

History Node

0.3.16

History Node

0.3.15

History Node

0.3.14

History Node

0.3.13

History Node

0.3.12

History Node

0.3.11

History Node

0.3.10

History Node

0.3.9

History Node

0.3.8

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.2

History Node

0.2.10

History Node

0.2.8

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pymlconf-0.5.3-py3-none-any.whl (18.7 kB) Copy SHA256 hash SHA256 Wheel 3.5 Aug 8, 2016
pymlconf-0.5.3.tar.gz (10.8 kB) Copy SHA256 hash SHA256 Source None Aug 8, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page