Metadata-Version: 2.0
Name: unityapiclient
Version: 0.0.1
Summary: Client library for the Unity IDM APIs
Home-page: http://eudat-b2access.github.io/unity-api-python-client
Author: Nicolas Liampotis
Author-email: nliam@grnet.gr
License: Apache License 2.0
Download-URL: https://github.com/EUDAT-B2ACCESS/unity-api-python-client
Keywords: unity identity management rest api client library
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.6,<2.8
Requires-Dist: requests
Requires-Dist: pytz

unityapiclient
==============

A Python client library for the Unity IDM APIs.

Currently, it only supprorts a subset of the operations exposed by Unity's Administration API. 

Python version
--------------

Python 2.6 or 2.7 are fully supported.

Installation
------------

To install the client library, simply run:

.. code-block:: bash

    $ pip install unityapiclient
    🍺

Third party libraries and dependencies
--------------------------------------

The following libraries will be installed when you install the client library:

* `pytz <https://github.com/newvem/pytz>`_
* `requests <https://github.com/kennethreitz/requests>`_

Usage
-----

The following example assumes a Unity IDM deployment at ``https://unity.example.org``: 

.. code-block:: python

    >>> import unityapiclient
    >>> from unityapiclient.client import UnityApiClient
    >>> client = UnityApiClient('https://unity.example.org',
    ... auth=('unityapiuser', 'secretpassword'))
    >>> entity = client.get_entity(257)
    >>> entity['entityInformation']['state']
    u'valid'

Documentation
-------------

Documentation is available at http://eudat-b2access.github.io/unity-api-python-client 

License
-------

Licensed under the Apache 2.0 license, for details see `LICENSE`.


