Skip to main content

A simple configuration files manager package

Project description

ConfigDmanager

Installation

A simple pip install will do :

python -m pip install ConfigDmanager

Use

  • Suppose we have two Configuration files ( of json type ) :

    • ParentConfig.json :

      {
      "__name": "ParentConfig",
      "param1": "Value 1"
      }
      
    • MainConfig.json :

      • The __parent parameter specifies the path to another configuration file that will give us default values ( Think of it as inheritance ).
      • The text contained between brackets will be reinterpreted in runtime :

      in the example below ${param1} will be reinterpreted as "Value 1"

      • The use of environment variables for sensitive data like passwords is also possible : through this text ${os_environ[password]}
      • You can also read the content of a text file with a simple : ${read_file[file_path]} as shown in the example below.
      {
        "__name": "MainConfig",
        "__parent": "demo.ParentConfig",
        "param2": "Value 2 and ${param1}",
        "user_info": {"user": "username", "password": "${os_environ[password]}"},
        "long_text": "${read_file[./demo.py]}"
      }
      
  • To import those configuration using configDmanager, use this demo code :

from configDmanager import import_config


class RandomClass:
    def __init__(self, param1, param2, user_info, long_text):
        print(f"param1: {param1}")
        print(f"param2: {param2}")
        print(f'my user: {user_info.user}')
        print(f'my user: {user_info.password}')
        print(f'my long text: "{long_text[:40]}"')


config = import_config('MainConfig')

print("## Object 1")
obj = RandomClass(**config)


# You can also select specific keys
print("## Object 2")
another_obj = RandomClass(param2='Another Value', long_text="Not so long", **config[['param1', 'user_info']])

Export Config file

You can export a Config by simply using the export_config function

from configDmanager import export_config, Config

config = Config({'my_param': 'my_value'})

export_config(config, 'NewConfig')

If you wish to modify an existing config, you can use update_config function :

from configDmanager import update_config

# You can use a dict to update Config values
update_config({'param' : 'value'}, 'MyConfig')

# You can also use a callable that takes the config returns a dict
update_config(lambda conf: {'numeric': conf['numeric'] + 1}, 'MyConfig')

Project details


Download files

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

Source Distribution

ConfigDmanager-0.2.0.tar.gz (6.4 kB view hashes)

Uploaded Source

Built Distribution

ConfigDmanager-0.2.0-py3-none-any.whl (8.9 kB view hashes)

Uploaded Python 3

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