L(ight) CONF(iguration): A simple human-readable data serialization format for dynamic configuration.
Project description
About
LCONF stands for L(ight) CONF(iguration) a light - human-friendly, simple readable data serialization format for dynamic configuration.
The latest documentation can be found online at http://packages.python.org/LCONF.
___SECTION :: A short example with a number of features
# Comment-Line: `List-Of-Tuples`
- people_list |name|height_cm|weight_kg|
Tim, 178, 86
John, 166, 67
# Comment-Line: `Repeated-Block-Identifier`
* Persons_BLK
person1
first :: Tim
last :: Doe
age :: 39
registered :: true
salary :: 70000
sex :: M
# Comment-Line: `Key :: Value-List`
- interests :: Reading,Mountain Biking,Hacking
# Comment-Line: `Key-Value-List`
- sports
tennis
football
soccer
# Comment-Line: `Key-Value-Mapping`
. favorites
food :: Spaghetti
sport :: Soccer
color :: Blue
person2
first :: John
last :: Doe
age :: 29
registered :: true
salary :: 45000
sex :: M
# Comment-Line: empty `Key :: Value-List`
- interests ::
# Comment-Line: empty `Key-Value-List`
- sports
# Comment-Line: `Key-Value-Mapping`
. favorites
food :: Pizza
sport :: None
color :: Orange
___END
Requirements
See: RequiredSoftware in documentation or:
{SOURCE}/docs/RequiredSoftware.rst
Installation
To install from pypi using pip/pip3:
$ pip3 install LCONF
To install from the source:
$ python3 setup.py install
Building the Documentation
If you wish to generate your own copy of the documentation, you will need to:
Get the LCONF source.
If not already installed - install PSphinxTheme
$ pip3 install PSphinxTheme
If not already installed - install LconfPygmentsLexer
$ pip3 install LconfPygmentsLexer
From the LCONF source directory, run python3 setup.py build_sphinx -E.
Once Sphinx is finished, point a web browser to the file:
{SOURCE}/build/sphinx/html/index.html
Online Resources
Projects using LCONF
projects which make use of: LCONF
- PyNHEP
PyNHEP: The N(utrition) and H(ealthy) E(ating) P(lanner).
LCONF is distributed under the terms of the BSD 3-clause license. Consult LICENSE or BSD-3-Clause.
(c) 2014, peter1000 https://github.com/peter1000 All rights reserved.