README.md

Configer

This is the repository for the package CONFIGER helps with easy configuration of arguments in a python code.

Introduction

When Python programs grow large, one would eventually need a way to load configurations through a file. The common answer to this would by Python's ConfigParser. But at least I find the result of using ConfigParse an ugly code:

import ConfigParser
Config = ConfigParser.ConfigParser()
Config.read("c:\\tomorrow.ini")
Config.get(section, option)

That's why I packaged my solution to this issue. Configer basically gives you a flattened ConfigParser with extra functionality:

• dot-access of values in the settings file
• dump settings to a file for later use
• add different settings while choosing to overload previous one.

Dependencies

This package supports Python 2.7 and 3.5+.

Installation

You can install directly from the git repository

pip install git+https://github.com/MPI-IS/configer

Examples

Overall Configer will be a sleek way to disentangle settings away from the mechanics. An exact copy of the above code will be:

from configer import Configer
Config = Configer(default_ps_fname='c:\\tomorrow.ini')
Config.option

Note that you don't have sections anymore and you can access an option with a dot-access approach.

Other use cases would be:

1. Loading default settings

   default_ps_fname = 'pyconfiger/Configer/test/sample_settings.ini'
   ps = Configer(default_ps_fname=default_ps_fname)
   print(ps.status) # None
   

2. Loading default settings while adding new arguments

   ps = Configer(default_ps_fname=default_ps_fname, status=False)
   print(ps.status) # False
   ps.status = True
   print(ps.status) # True
   ps.new_status = True
   print(ps.new_status) # True
   

3. Loading default settings while initializing with a dictionary of arguments

   ps = Configer(default_ps_fname=default_ps_fname, status=False,**{'somethings': [1.0, 2.0]})
   print(ps.somethings) # [1.0, 2.0]
   

4. Adding and overloading with a second Configer instance

   ps1 = Configer(status=False)
   ps2 = Configer(status=True, othersetting = 'this')
   
   ps3 = ps1 + ps2
   print(ps3.status) # False
   print(ps3.othersetting) # 'this'
   
   ps4 = ps1.overload(ps2)
   print(ps4.status) # True
   

5. Dumping current Configer instance as an .ini file

   ps = Configer(default_ps_fname=default_ps_fname, status=False)
   print(ps.status) # False
   ps.dump_settings(fname='~/settings.ini') # saves the settings to the specified file
   

Tests

To run the tests, type in in the root directory:

python -m unittest discover

License

See LICENSE.txt

Author

Nima Ghorbani, nima.ghorbani@tuebingen.mpg.de