Source

confy supports number of formats from which you can read configuration. You can see how it works with with modules in quick start tutorial. Here I’m gonna explain other features.

1. Let’s extend our example from quick start tutorial. Settings directory now looks like this:

   settings/
     |-- __init__.py
     |-- base.py
     |-- development.py
     |-- production.py
     |-- local.py
     |-- sample.ini              # <= ini file
     `-- envvars/                # <= directory with variables like for "envdir"
           |-- DATABASE/         #    http://cr.yp.to/daemontools/envdir.html
           |     |-- USER
           |     |-- PASSWORD
           |     |-- PORT
           |     |-- NAME
           |     `-- HOST
           `-- HELLO
   

   If you don’t have idea how example envvars could look like, please visit https://github.com/jqb/confy/tree/master/tests/tconf/envvars inside confy tests directory.

2. Content for settings/__init__.py for all examples below goes as follows:

     import confy
   
     confy = confy.loader(__file__)
     config = confy.merge(
         confy.from_modules('base', 'development'),
         confy.from_modules('local', silent=True),
         confy.from_ini('sample.ini'),
         confy.from_dirs('envvars'),
     )
   

INI files

confy can easily read standard “ini” files. If - let’s say - content of sample.ini is

[DEFAULT]
root = /home/user

[static]
project_dir = %{root}/static

[media]
project.dir = %{root}/media    # note there's "." not "_" in variable name

when this is what you gonna get when you import config from settings/__init__.py

from settings import config

assert config.static.project_dir == "/home/user/static"   # OK
assert config.media['project.dir'] == "/home/user/media"  # OK

As you can see confy supports ”.” notation as far as variable names allows it to do so.

Envdir source

If you know deamontools' envdir that will be easy (http://cr.yp.to/daemontools/envdir.html). confy reads data inside env directory easily. It’s a little bit more powerfull since you’re not restricted to flat names only. Every directory inside pointed directory is treaded as key in dictionary, so you can have neasted structures as well.

In my extended example you can see envvars directory which is read by confy. This is what you gonna get (all the values are from confy tests folder: https://github.com/jqb/confy/tree/master/tests/tconf/envvars)

from settings import config

assert config.DATABASE.USER == "testdb"       # OK
assert config.DATABASE.PASSWORD == "testdb"   # OK
assert config.DATABASE.POST == "9000"         # OK
# etc...

assert config.HELLO == "world!"               # OK