Python Makefile
Latest commit 2b8729a Dec 14, 2017 @Eugeny Eugeny bump
Permalink
Failed to load latest commit information.
debian Remove six dependancies witch causes much trouble for old systems Feb 28, 2016
dist
docs
reconfigure
.gitignore
.travis.yml travis Dec 10, 2013
Makefile
README.rst README Dec 10, 2013
reconfigure.sublime-project Hosts ext Oct 4, 2012
requirements.txt
setup.cfg wheel Aug 10, 2014
setup.py

README.rst

Reconfigure - Python object mapping for config files

https://travis-ci.org/Eugeny/reconfigure.png

Browse API on SourceGraph

Quickstart

>>> from reconfigure.configs import FSTabConfig
>>> from reconfigure.items.fstab import FilesystemData
>>>
>>> config = FSTabConfig(path='/etc/fstab')
>>> config.load()
>>> print config.tree
{
    "filesystems": [
        {
            "passno": "0",
            "device": "proc",
            "mountpoint": "/proc",
            "freq": "0",
            "type": "proc",
            "options": "nodev,noexec,nosuid"
        },
        {
            "passno": "1",
            "device": "UUID=dfccef1e-d46c-45b8-969d-51391898c55e",
            "mountpoint": "/",
            "freq": "0",
            "type": "ext4",
            "options": "errors=remount-ro"
        }
    ]
}
>>> tmpfs = FilesystemData()
>>> tmpfs.mountpoint = '/srv/cache'
>>> tmpfs.type = 'tmpfs'
>>> tmpfs.device = 'none'
>>> config.tree.filesystems.append(tmpfs)
>>> config.save()
>>> quit()
$ cat /etc/fstab
proc    /proc   proc    nodev,noexec,nosuid     0       0
UUID=dfccef1e-d46c-45b8-969d-51391898c55e / ext4 errors=remount-ro 0 1
none    /srv/cache      tmpfs   none    0       0

This is actually a shortcut to:

>>> from reconfigure.parsers import SSVParser
>>> from reconfigure.builders import BoundBuilder
>>> from reconfigure.items.fstab import FSTabData
>>> content = open('/etc/fstab').read()
>>> syntax_tree = SSVParser().parse(content)
>>> syntax_tree
<reconfigure.nodes.RootNode object at 0x7f1319eeec50>
>>> print syntax_tree
(None)
        (line)
                (token)
                        value = proc
                (token)
                        value = /proc
                (token)
                        value = proc
                (token)
                        value = nodev,noexec,nosuid
                (token)
                        value = 0
                (token)
                        value = 0
        (line)
                (token)
                        value = UUID=83810b56-ef4b-44de-85c8-58dc589aef48
                (token)
                        value = /
                (token)
                        value = ext4
                (token)
                        value = errors=remount-ro
                (token)
                        value = 0
                (token)
                        value = 1

>>> builder = BoundBuilder(FSTabData)
>>> data_tree = builder.build(syntax_tree)
>>> print data_tree
{
    "filesystems": [
        {
            "passno": "0",
            "device": "proc",
            "mountpoint": "/proc",
            "freq": "0",
            "type": "proc",
            "options": "nodev,noexec,nosuid"
        },
        {
            "passno": "1",
            "device": "UUID=83810b56-ef4b-44de-85c8-58dc589aef48",
            "mountpoint": "/",
            "freq": "0",
            "type": "ext4",
            "options": "errors=remount-ro"
        }
    ]
}

Parsers and builders can be paired in almost any possible combination.

Reconfigure can be easily extended with your own parsers and builders - read the docs!

Supported configs:

  • Ajenti (ajenti)
  • BIND9 DNS (bind9)
  • Crontabs (crontab)
  • Samba CTDB (ctdb)
  • ISC DHCPD / uDHCPD (dhcpd)
  • NFS /etc/exports (exports)
  • /etc/fstab (fstab)
  • /etc/group (group)
  • /etc/hosts (hosts)
  • iptables-save dump (iptables)
  • Netatalk afp.conf (netatalk)
  • NSD DNS (nsd)
  • /etc/passwd (passwd)
  • /etc/resolv.conf (resolv)
  • Samba (samba)
  • Squid 3 (squid)
  • Supervisord (supervisor)

Included parsers:

  • BIND9 config (bind9)
  • Crontab (crontab)
  • NFS Exports (exports)
  • .ini (ini)
  • iptables-save (iptables)
  • nginx-like (nginx)
  • squid (squid)
  • nsd (nsd)
  • CSV-like space-separated values (ssv)
  • JSON (jsonparser)