Skip to main content

Modularized configuration files.

Project description

pipeline coverage

This is a Python package which enables to modularize configuration files.

In configuration-based applications, it is sometimes desirable to group sections in a configuration file. This can, for instance, be sections which are for a specific purpose, e.g. modules in an application which shall be configurable.

For this purpose, pymodconf add the functionality to define custom Tag s representing groups in a configuration file. For instance, if you have an application with multiple modules you can define the tag Module: and add that prefix to each section in the configuration file describing a certain module.


You can find the latest version on PyPi. So simply use pip with

pip install pymodconf


This following configuration file shows the feature set of pymodconf:

1: [Application]
2: name=pymodconf
3: string=Hello ${name}!
4: list=One, Two, Three, Four

6: [Some Section]
7: opt=${Application:name}-section

9: [Module: Test]
10:log-dir= /tmp/test_module


In line [1] a new section Application is created with multiple options show in lines [2]-[3].

Variable replacement

Due to the fact that pymodconf is based on the configparser module, the variable-replacement feature is available, too. In line [3] a reference to an option in the same section is shown. If you want to reference an option in any other section, you’ll have to specify the name of the section, as you can see in line [7].


If pymodconf finds any commata in the value of an option, it will split up that value and generate a list of it. In line [4] the value is represented in Python as a list with four entries: ‘One’, ‘Two’, ‘Three’, ‘Four’.

Directory creation

Another feature of pymodconf is the automatic directory creation. If any option name ends with the suffix -dir it will try to recursively create the directory tree. For instance, due to the definition in line [10], a directory test-module will be created in the directory /tmp/.


The most interesting feature of pymodconf is the ability to group sections using user-defined Tag s. As you can see in line [9] a section with the tag definition Module is defined.

Before pymodconf is able to group such sections, you’ll have to register the tag at pymodconf with:

import pymodconf as mc

module_tag = mc.tag.Tag('Module:')


Afterwards, you can load the configuration file with:

config = mc.parser.load('example.cfg')

The result is dictionary with section names and user-defined modules as keys and the corresponding options as values.

You can, for instance, access the section belonging to the group Module either with:

config['module'] # returns [{'name': ' Test', 'log-dir': '/tmp/test_module'}]

or using the tag itself with:

config[str(module_tag)] # returns [{'name': ' Test', 'log-dir': '/tmp/test_module'}]


If you like this tool, donate some bugs 💸 for a drink or two at

  • ETH: 0xf7d518A730D93a6d27415EcaE5D801Dde125dE15

  • XRP: rhVWrjB9EGDeK4zuJ1x2KXSjjSpsDQSaU6 with destination tag 653103618


or via PayPal. Cheers 🍻!


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pymodconf-0.0.3-py3-none-any.whl (24.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page