Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Framework for using Consul as your project options storage

Project description

https://travis-ci.org/Fatal1ty/consul-options.svg?branch=master Requirements Status

How often do you wonder where to store the project settings? When your project is small it is not a big problem. But if your big project consists of dozens of microservices then there is a problem of centralized configuration management. The Сonsul have a key/value storage that is ideal for this.

With consul-options you can define and use options in your code by a simple and elegant way. Just take a look at the example:

class DB(ConsulKV):
    pass


class Users(DB):
    host = '127.0.0.1'
    port = 5432
    user = 'postgres'
    password = 'postgres'

    dbname = 'users'


class Orders(DB):
    host = '127.0.0.1'
    port = 5432
    user = 'postgres'
    password = 'postgres'

    dbname = 'orders'

Now you can access option values in a clear way:

from consul_options import options

print options.db.users.host
print options.db.orders.dbname

consul-options automagically creates folders and keys with default values defined above in Consul and later read them from there. So if anyone will change the value of db/orders/host key to something different in Consul then you will get that value.

How project options stored in Consul

When you declare a new class based on ConsulKV default bahavior is creation a folder in Consul key/value storage with name of your class in lowercase. Each class attribute you define will have mapping to key folder/key. If you don’t agree with generated folder name you are free to choose any other with reserved class attribute __key__ as shown below:

class WorkerOptions(ConsulKV):
    __key__ = 'worker'

    host = '127.0.0.1'
    port = 80

After that you can access to the option with “worker” in path:

from consul_options import options

print options.worker.host
print options.worker.port

To create hierarchical key structure you can take advantage of usual class hierarchy:

from consul_options import ConsulKV, options

class WorkerOptions(ConsulKV):
    __key__ = 'worker'

    host = '127.0.0.1'
    port = 80

class DB(WorkerOptions):
    host = '127.0.0.1'
    port = 5432
    user = 'postgres'
    password = 'postgres'

print options.worker.db.host  # 'host'
print options.worker.db.port  # 5432

It is also possible to create keys at root level with class attribute __root__:

class RootOptions(ConsulKV):
    __root__ = True

    host = '127.0.0.1'
    port = 80

print options.host
print options.port

Compatibility

consul-options is compatible with both Python 2 and Python 3.

Installation

Use pip to install:

$ pip install consul-options

License

consul-options is developed and distributed under the Apache 2.0 license.

Project details


Release history Release notifications

This version
History Node

1.2

History Node

1.1

History Node

1.0

History Node

0.8

History Node

0.7

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
consul-options-1.2.tar.gz (4.2 kB) Copy SHA256 hash SHA256 Source None Nov 8, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page