Skip to main content

An app configuration toolkit that tries to do things right.

Project description

An app configuration toolkit that tries to do things right.

Install

Convoke is available from PyPI:

pip install convoke

Usage

Create a Settings object:

from convoke import Settings

settings = Settings('My App Name')

Convoke will pull settings from three places, in order of priority:

  1. Local overrides:

    Settings('My App Name', foo='bar')
    
  2. os.environ values (upper-cased):

    settings.get('foo') == os.environ.get('FOO')
    
  3. a provided INI-style configuration filepath or config.ini in the OS-specific application directory:

    # ~/.config/config.ini (or OS equivalent)
    foo = bar
    

The Settings object provides convenience accessors for different value types:

  • Strings:

    settings['foo']
    settings.get('foo', default='blah')
    
  • Boolean:

    settings.as_bool('foo', default='True')
    
  • Integer:

    settings.as_int('foo', default='5')
    
  • Float:

    settings.as_float('foo', default='5.0')
    
  • Path (returns path.Path objects):

    settings.as_path('foo', default='~/blah')
    

For simple usage, there’s also a singleton Settings mode:

settings = convoke.get_settings('My App Name', foo='bar')
assert settings.app_name == 'My App Name'
assert settings['foo'] == 'bar'

# Further calls to get_settings returns the same object:
settings2 = convoke.get_settings()
assert settings2 is settings

# Future overrides have no effect:
settings2 = convoke.get_settings('Some other name', foo='blah')
assert settings.app_name == 'My App Name'
assert settings['foo'] == 'bar'

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 convoke, version 1.1
Filename, size File type Python version Upload date Hashes
Filename, size convoke-1.1.tar.gz (25.2 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