semvec/pypi-packages huggingface dataset:
py-serverdensity 1.0.12
Python ServerDensity.com API wrapper
License: BSD

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