Skip to main content

Universal configuration file parser

Project description

Cinco Config

Build Status Coverage Status Docs Status

Next generation universal configuration file parser. The config file structure is defined programmatically and expressively, no need to create classes and inheritance.

Let's get right to it:

# app_config.py
import getpass
from cincoconfig import *

# first, define the configuration's schema -- the fields available that
# customize the application's or library's behavior
schema = Schema()
schema.mode = ApplicationModeField(default='production')

# nested configurations are built on the fly
# http is now a subconfig
schema.http.port = PortField(default=8080, required=True)

# each field has its own validation rules that are run anytime the config
# value is loaded from disk or modified by the user.
# here, this field only accepts IPv4 network addresses and the user is
# required to define this field in the configuration file.
schema.http.address = IPv4AddressField(default='127.0.0.1', required=True)

schema.http.ssl.enabled = BoolField(default=False)
schema.http.ssl.cafile = FilenameField()
schema.http.ssl.keyfile = FilenameField()
schema.http.ssl.certfile = FilenameField()

schema.db.host = HostnameField(allow_ipv4=True, required=True, default='localhost')
schema.db.port = PortField(default=27017, required=True)
schema.db.name = StringField(default='my_app', required=True)
schema.db.user = StringField(default='admin')

# some configuration values are sensitive, such as credentials, so
# cincoconfig provides config value encryption when the value is
# saved to disk via the SecureField
schema.db.password = SecureField()

# get a field programmatically
print(schema['db.host']) # >>> schema.db.host

# once a schema is defined, build the actual configuration object
# that can load config files from disk and interact with the values
config = schema()

# print the http port
print(config.http.port) # >>> 8080

# print the http port programmatically
print(config['http.port']) # >>> 8080

config.db.password = getpass.getpass("Enter Password: ") # < 'password'

# set a config value manually
if config.mode == 'production':
    config.db.name = config.db.name + '_production'

print(config.dumps(format='json', pretty=True).decode())
# {
#   "mode": "production",
#   "http": {
#     "port": 8080,
#     "address": "127.0.0.1"
#     "ssl": {
#       "enabled": false
#     }
#   },
#   "db": {
#     "host": "localhost",
#     "port": 27017,
#     "name": "my_app_production",
#     "user": "admin",
#     "password": {
#       "method": "best",
#       "ciphertext": "<ciphertext>"
#     }
#   }
# }

Override Configuration with Command Line Arguments (argparse)

# config.py
schema = Schema()
schema.mode = ApplicationModeField(default='production', modes=['production', 'debug'])
schema.http.port = PortField(default=8080, required=True)
schema.http.address = IPv4AddressField(default='127.0.0.1', required=True)

config = schema()

# __main__.py
import argparse
from .config import config, schema

parser = schema.generate_argparse_parser()
#
# The generate_argparse_parser() method auto generates the parser using --long-opts. For this
# configuration, the returned parser is equivalent to:
#
# parser = argparse.ArgumentParser()
#
# parser.add_argument('--http-address', action='store', dest='http.address')
# parser.add_argument('--http-port', action='store', dest='http.port')
# parser.add_argument('--mode', action='store', dest='mode')
#

# new args can be added to the parser
parser.add_argument('-c', '--config', action='store')
args = parser.parse_args()
if args.config:
    config.load(args.config, format='json')

# update the configuration with arguments specified via the command line
config.cmdline_args_override(args, ignore=['config'])

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

cincoconfig-0.9.0.tar.gz (69.1 kB view details)

Uploaded Source

Built Distribution

cincoconfig-0.9.0-py3-none-any.whl (52.0 kB view details)

Uploaded Python 3

File details

Details for the file cincoconfig-0.9.0.tar.gz.

File metadata

  • Download URL: cincoconfig-0.9.0.tar.gz
  • Upload date:
  • Size: 69.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.10 Windows/10

File hashes

Hashes for cincoconfig-0.9.0.tar.gz
Algorithm Hash digest
SHA256 747a2ba917e20df9496d7f46a8be1995dfdf11fe9419a8f37c6139eaa3d4484a
MD5 43dcb22feb09f4d6b727cbc945a9859d
BLAKE2b-256 e56b0ab42bde7abc69f0fe0948a43202e454e5d4a151554a16b4cf97785209ac

See more details on using hashes here.

File details

Details for the file cincoconfig-0.9.0-py3-none-any.whl.

File metadata

  • Download URL: cincoconfig-0.9.0-py3-none-any.whl
  • Upload date:
  • Size: 52.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.3.2 CPython/3.10.10 Windows/10

File hashes

Hashes for cincoconfig-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ba200d23d74a9525405678f26e69a31457a9b7bff3c2331d3ebf747c44bf6e1f
MD5 d992afbe867abae691203a16a38c24ca
BLAKE2b-256 b7765832c10b626e5d1ade98fcc9f950dee909ad955c4208b7811ea61a18ea62

See more details on using hashes here.

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