comparison README.txt @ 68:1025d283a570

start in on the README
author Jeff Hammel <jhammel@mozilla.com>
date Wed, 28 Mar 2012 10:27:17 -0700
parents b7e7f450ad1a
children 451aeb35ec04
comparison
equal deleted inserted replaced
67:c831eb58fb52 68:1025d283a570
1 configuration 1 configuration
2 =========== 2 ===========
3 3
4 multi-level unified configuration for python consumption 4 multi-level unified configuration for python consumption
5 5
6 - you have a (python) program that wants to read configuration from
7 configuration files (I currently support JSON and YAML) and also
8 from the command line
9 - you want to be able to serialize and deserialize configuration
10
6 API 11 API
7 --- 12 ---
8 13
9 TODO : document this 14 The ``configuration.Configuration`` class implements an abstract base
15 class that extends ``optparse.OptionParser``. The form of the
16 configuration is dictated by setting the ``options`` attribute on your
17 subclass. ``options`` is a dictionary of the form::
18
19 {'name': {<value>}}
20
21 ``name`` is the name of the configuration option, and ``value`` is a
22 ``dict`` that gives the form of the option.
23
24
25 For an example, see
26 http://k0s.org/mozilla/hg/configuration/file/c831eb58fb52/tests/example.py#l7
10 27
11 28
12 Configuration Files 29 Configuration Files
13 ------------------- 30 -------------------
14 31