Python ServerDensity.com API wrapper
Project description
py-serverdensity 1.x
===============================
About py-serverdensity
----------------------
``py-serverdensity`` is a lightweight object orientated Python library for the `Server Density API <https://github.com/serverdensity.com/sd-api-docs`_.
The library provides access to all the GET and POST methods in the SD API, takes care of authentication, allows you to post values as items in a dict, returns native Python objects from the service response, and raises exceptions for service errors.
Installation
------------
The library can be installed from PyPi using ``pip``::
pip install py-serverdensity
Or cloned from `Github <http://www.github.com/>`_ using ``git``::
git clone git://github.com/1stvamp/py-serverdensity.git
cd py-serverdensity
python setup.py install
Usage
-----
Once installed just import the class ``SDApi`` from the ``serverdensity.api`` module, instance the handler with your Server Density account details (remember to turn API access on for the account you're using, see `the docs <https://github.com/serverdensity/sd-api-docs#authentication>`_, and then you can access methods on each section as attributes of the API handler::
from serverdensity.api import SDApi, SDServiceError
api = SDApi(
account='foo.serverdensity.com',
username='bar',
password='baz'
)
api.alerts.getLast()
try:
api.devices.getByHostName({'hostName': 'myserver.somedomain.com'})
api.devices.getById({},{'deviceId':'device_id'})
except SDServiceError, e:
print 'Error:', e
print 'Response:', e.response
===============================
About py-serverdensity
----------------------
``py-serverdensity`` is a lightweight object orientated Python library for the `Server Density API <https://github.com/serverdensity.com/sd-api-docs`_.
The library provides access to all the GET and POST methods in the SD API, takes care of authentication, allows you to post values as items in a dict, returns native Python objects from the service response, and raises exceptions for service errors.
Installation
------------
The library can be installed from PyPi using ``pip``::
pip install py-serverdensity
Or cloned from `Github <http://www.github.com/>`_ using ``git``::
git clone git://github.com/1stvamp/py-serverdensity.git
cd py-serverdensity
python setup.py install
Usage
-----
Once installed just import the class ``SDApi`` from the ``serverdensity.api`` module, instance the handler with your Server Density account details (remember to turn API access on for the account you're using, see `the docs <https://github.com/serverdensity/sd-api-docs#authentication>`_, and then you can access methods on each section as attributes of the API handler::
from serverdensity.api import SDApi, SDServiceError
api = SDApi(
account='foo.serverdensity.com',
username='bar',
password='baz'
)
api.alerts.getLast()
try:
api.devices.getByHostName({'hostName': 'myserver.somedomain.com'})
api.devices.getById({},{'deviceId':'device_id'})
except SDServiceError, e:
print 'Error:', e
print 'Response:', e.response
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.