Python client for Consul (http://www.consul.io)
Project description
PyConsul
========
> Python client for [Consul][1]
A dummy, one-file, implementation on top of the [HTTP API][5] of Consul.
Install
-------
* Install Consul following [the official guide][3] or this one-liner:
```console
$ # Install consul 0.1.0_linux_amd64 under /usr/local/bin
$ wget -qO- https://raw.githubusercontent.com/hackliff/pyconsul/master/install-consul.sh | (sudo) bash
```
* Install pyconsul library
```console
$ git clone https://github.com/hackliff/pyconsul
$ cd pyconsul && (sudo) python setup.py install
```
Getting started
---------------
I strongly advise you to go through [the official Consul documentation][4]
before playing around with pyconsul.
Make sure an agent is running, for example with :
```console
consul agent -server -bootstrap \
-data-dir /tmp/consul \
-node=agent-one \
-bind=0.0.0.0
```
Then you can talk to it
```python
from pyconsul import Consul
# On the same server
consul_ = Consul()
print consul_.status
print consul_.health(node='agent-one')
# Access key / value storage
consul_.set('node/name', 'test')
print consul_.storage.get('node/name')
consul_.storage.delete('node/name')
# Or manage local agent (incomplete)
print consul_.local_agent.members
print consul_.local_agent.services
consul_.local_agent.join('172.17.0.3')
```
... in construction ...
License
-------
Copyright 2014 Xavier Bruhiere.
PyConsul is available under the [MIT Licence][2].
[1]: http://consul.io
[2]: http://opensource.org/licenses/MIT
[3]: http://www.consul.io/intro/getting-started/install.html
[4]: http://www.consul.io/intro/
[5]: http://www.consul.io/docs/agent/http.html
========
> Python client for [Consul][1]
A dummy, one-file, implementation on top of the [HTTP API][5] of Consul.
Install
-------
* Install Consul following [the official guide][3] or this one-liner:
```console
$ # Install consul 0.1.0_linux_amd64 under /usr/local/bin
$ wget -qO- https://raw.githubusercontent.com/hackliff/pyconsul/master/install-consul.sh | (sudo) bash
```
* Install pyconsul library
```console
$ git clone https://github.com/hackliff/pyconsul
$ cd pyconsul && (sudo) python setup.py install
```
Getting started
---------------
I strongly advise you to go through [the official Consul documentation][4]
before playing around with pyconsul.
Make sure an agent is running, for example with :
```console
consul agent -server -bootstrap \
-data-dir /tmp/consul \
-node=agent-one \
-bind=0.0.0.0
```
Then you can talk to it
```python
from pyconsul import Consul
# On the same server
consul_ = Consul()
print consul_.status
print consul_.health(node='agent-one')
# Access key / value storage
consul_.set('node/name', 'test')
print consul_.storage.get('node/name')
consul_.storage.delete('node/name')
# Or manage local agent (incomplete)
print consul_.local_agent.members
print consul_.local_agent.services
consul_.local_agent.join('172.17.0.3')
```
... in construction ...
License
-------
Copyright 2014 Xavier Bruhiere.
PyConsul is available under the [MIT Licence][2].
[1]: http://consul.io
[2]: http://opensource.org/licenses/MIT
[3]: http://www.consul.io/intro/getting-started/install.html
[4]: http://www.consul.io/intro/
[5]: http://www.consul.io/docs/agent/http.html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyconsul-0.0.1.tar.gz
(3.7 kB
view hashes)