Kongalib
========

Libreria Python di comunicazione con i server `EasyByte Konga`_. Tramite
*kongalib* è possibile connettersi ad un server Konga (integrato in Konga Pro o
standalone in Konga Server), eseguire query sui database e manipolarne i dati
facilmente.


Installazione
-------------

Per sistemi operativi Windows e macOS è consigliato installare i binari di
*kongalib* tramite *pip*::

	pip install kongalib


Per ambiente Linux è necessario compilare i sorgenti. I prerequisiti per
compilare *kongalib* sono i seguenti:


**Windows**

	- Microsoft Visual Studio (versione 2013 o successiva)
	- `SDK di Konga`_


**MacOS X**

	- XCode (assicurarsi di aver installato anche i tool da linea di comando)
	- `SDK di Konga`_
	- `libmpdec`_


**Linux**
	
Al momento sono supportate ufficialmente solo le distribuzioni Linux basate su
Debian, in particolare Ubuntu Linux. Sono necessari i seguenti pacchetti *deb*:

	- build-essential
	- g++
	- python-dev
	- `easybyte-konga-dev`_
	- libmpdec-dev

La compilazione è possibile tramite la usuale procedura dei pacchetti Python::

	python setup.py install


Risorse
-------

`Versioni stable e nightly`_

	L'ultima versione ufficiale è sempre disponibile su PyPI; se tuttavia si
	desidera scaricare una versione *stable* o *nightly* specifica oppure una
	vecchia versione, è possibile farlo da qui.


`Documentazione di kongalib`_

	La documentazione della libreria per la versione ufficiale corrente e per
	le versioni	ufficiali passate è sempre accessibile da qui.


`Documentazione del dizionario dei dati`_

	Per informazioni circa la struttura dei database Konga (nozione necessaria
	per accedere correttamente ai dati)

	

.. _Versioni stable e nightly: http://www.easybyte.it
.. _EasyByte Konga: http://www.easybyte.it/it/pro
.. _Documentazione di kongalib: http://public.easybyte.it/docs/kongalib
.. _Documentazione del dizionario dei dati: http://public.easybyte.it/docs/datadict
.. _libmpdec: http://www.bytereef.org/mpdecimal/
.. _SDK di Konga: http://public.easybyte.it/downloads/current
.. _easybyte-konga-dev: http://public.easybyte.it/downloads/current

