Example

Here is a quick example of how to use ConfigModel.

First, define a config for your app:

from configmodel import ConfigModel, config_file, nested_field

# ============================
# define a config for your app
# ============================
@config_file("config.ini")
class AppConfig(ConfigModel):
    color_scheme = "dark"
    font_size = 12

    class AccountInfo(ConfigModel):
        username = "guest"
        password = ""
        last_login = ""

    class GoogleApi(ConfigModel):
        client_id = "<put your client id here>"
        secret = "<put your secret here>"

    photos_api = GoogleApi()
    maps_api = GoogleApi()

Then, use your config:

# ============================
# use your config
# ============================
def main():
    # get config parameter
    print(AppConfig.AccountInfo.username)
    # set config parameters
    AppConfig.AccountInfo.last_login = "2024-01-01"
    AppConfig.photos_api.client_id = "1234"
    AppConfig.maps_api.client_id = "5678"

It will create a config file config.ini with the following content:

[Global]
color_scheme = dark
font_size = 12

[account_info]
username = guest
password =
last_login = 2024-01-01

[photos_api]
client_id = 1234
secret = <put your secret here>

[maps_api]
client_id = 5678
secret = <put your secret here>

Note that

1. You can specify config file name with @config_file decorator.

2. Section names ([account_password]) of nested classes are automatically generated from class names, if no instances of this class are created.

3. You can reuse nested classes (GoogleApi) in different places of your config.

Installation

You can install ConfigModel using pip:

pip install ConfigModel