ABOUT
=====
This package provide a python binding to the KIT Gruppenverwaltung REST API.


INSTALLATION
============
``$ python setup.py develop``

or

``$ pip install -e .``

or any other method, you use to install your python packages.


USAGE
=====
::

 from kitgvapi import KitGvProvider

 gv = KitGvProvider()
 gv.auth('myusername', 'mypassword')
 
 iism = gv.getOe('IISM')
 for g in iism.get_groups():
     print g.name
 iism.create_group('IISM-EM-newgroup', 'Neue Gruppe')

 staff = gv.getGroup('IISM-EM-OU-Staff')
 for u in staff.get_users(effective=True):
     print "{fn} {ln} ({un})".format(fn=u.firstname, ln=u.lastname, un=u.samaccount)
 for g in staff.get_groups():
     print "{gn} ({desc})".format(gn=g.name, desc=g.description)

 me = gv.getUser('zy8373')
 others = me.oe.get_users()


LICENCE
=======
Author: Jens Kleineheismann <kleineheismann@kit.edu>

Permission to use, copy, modify, and/or distribute this software
for any purpose with or without fee is hereby granted.