Skip to main content

Multi-file Configurations for Python Applications

Project description

Package version Package license Python versions TravisCI status Code coverage

Granula is a tool that aims to help maintain multi-file configurations for Python applications (with environments and more).


$ pipenv install granula

or just use pip (though you should definitely take a look at pipenv)



  • Gathers configurations from multiple files or directories.
  • Supports widely used file formats (YAML, JSON).
  • Offers a small DSL that allows to load environment variables into config files.
  • Manages different configuration environments (e.g. testing, production).


Create a config object from a directory with multiple configuration files:

>> import granula
>> config = granula.Config.from_directory('examples/multi-file/settings')
>> config
Config({'name': 'Darth Vader', ...})
'Darth Vader'
Config({'fiancee': 'Padme Amidala', 'children': ['Luke Skywalker', 'Leia Organa']})

Files are parsed in lexicographic order. The values specified in the preceding files can be overwritten in the succeeding files.

Do the same in a recursive manner:

>> config = granula.Config.from_directory(..., recursive=True)

Match YAML files using filename pattern:

>> config = granula.Config.from_directory(..., pattern=granula.Extension('yaml'))

Do the same with a shell-style wildcard pattern:

>> config = granula.Config.from_directory(..., pattern=granula.Wildcard('*.yaml'))

Match configuration files for different environments:

>> directory = 'examples/environments/settings'
>> testing = granula.Config.from_directory(directory, pattern=granula.Environment('testing'))
>> production = granula.Config.from_directory(directory, pattern=granula.Environment('production'))

Combine patterns in arbitrary ways:

>> pattern = granula.All(granula.Environment('testing'), granula.Extension('yaml'))
>> config = granula.Config.from_directory(..., pattern=pattern)

Load environment variables into config files using a DSL, for example, in YAML:

variable: ${env VARIABLE}

Do the same with a default value:

variable: ${env VARIABLE | val 10}

Project details

Download files

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

Files for granula, version 2018.2.8
Filename, size File type Python version Upload date Hashes
Filename, size granula-2018.2.8-py3-none-any.whl (26.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size granula-2018.2.8.tar.gz (16.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page