glueplate 1.0

Easy to write - Merge

You and your user write easiry.

Just import Glue as _ and write like nested dict.

from glueplate import Glue as _


settings = _(
    GLUE_PLATE_ENVIRONMENT_VARIABLE_KEY = 'BASEPACKAGE_SETTINGS_MODULE',
    from_base = 'comming from base',
    to_be_override = 'I am base.',
)

glueplate import variable named settings from os.environ[‘GLUE_PLATE_BASE_MODULE’], this is a base settings.

Then glueplate looks settings.GLUE_PLATE_ENVIRONMENT_VARIABLE_KEY and import variable named settings from os.environ[settings.GLUE_PLATE_ENVIRONMENT_VARIABLE_KEY], this is a user customized settings. Customized settings needs only user needs override, or addition.

from glueplate import Glue as _


settings = _(
    from_sub='comming from sub',
    to_be_override = 'I am sub.',
)

They are merged and easy to use.

from glueplate import config

assert('I am sub' == config.settings.to_be_override)
assert('comming from base' == config.settings.from_base)
assert('comming from sub' == config.settings.from_sub)

Append to list

You may not want to override by you user, just add user’s additional data.

glueplate provide special keyword prefix to append original settings variable.

• GLUE_PLATE_PLUS_BEFORE_

  User can append list before.

  # base
  settings = _(
      list1 = [1,2,3],
  )
  
  # user customized
  settings = _(
      GLUE_PLATE_PLUS_BEFORE_list1 = [5,4]
  )
  
  # config.settings.list1 == [5, 4, 1, 2, 3]

• GLUE_PLATE_PLUS_AFTER_

  Same as GLUE_PLATE_PLUS_BEFORE_ but append to backward.

  # base
  settings = _(
      list1 = [1,2,3],
  )
  
  # user customized
  settings = _(
      GLUE_PLATE_PLUS_AFTER_list1 = [5,4]
  )
  
  # config.settings.list1 == [1, 2, 3, 5, 4]

Inherit other glueplate

You might use library using glueplate. Environment variable GLUE_PLATE_BASE_MODULE is only one on your process.

Your base settings can indecate library’s gluplate settings module.

• GLUE_PLATE_PARENT_MODULES

  Specify library’s gluplate settings module names as list.

  from glueplate import Glue as _
  
  
  settings = _(
      GLUE_PLATE_PARENT_MODULES=[
          'parentpackage1.parentpackage1_settings',
          'parentpackage2.parentpackage2_settings'
      ]
  )