# configer

**Repository Path**: WorldEaterYI/configer

## Basic Information

- **Project Name**: configer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-01-17
- **Last Updated**: 2022-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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
```bash
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