Skip to content

easybyte-software/kongalib

Repository files navigation

Kongalib

Current version Supported Python versions LGPL v3 License Build Status

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. La libreria comprende anche i moduli aggiuntivi kongaui e kongautil, utili ad interfacciarsi ed integrarsi con Konga e Konga Client.

Installazione

Sono forniti pacchetti wheel binari per sistemi operativi Windows, macOS e Linux; l'installazione per questi sistemi è pertanto banale e si effettua tramite pip:

pip install kongalib

Compilazione manuale

Se si desidera è possibile compilare i sorgenti. I prerequisiti per compilare kongalib sono i seguenti:

Windows

Sono supportate le versioni di Windows dalla 10 in su. Come prerequisiti è necessario installare:

MacOS X

Sono supportate le versioni di macOS dalla 10.9 in su. Come prerequisiti è necessario installare:

  • XCode (assicurarsi di aver installato anche i tool da linea di comando)
  • SDK di Konga

Linux

Benchè il pacchetto binario wheel per Linux supporti tutte le distribuzioni Linux moderne (specifica manylinux_2_28), al momento la compilazione da parte di terzi è supportata ufficialmente solo se si usa una distribuzione Linux basata su Debian, in particolare Ubuntu Linux dalla versione 20.04 in su. Sono necessari i seguenti pacchetti deb:

La compilazione come da standard Python è possibile sempre tramite pip, eseguendo dalla directory dei sorgenti:

pip install .

Note

Sotto piattaforma Windows per la corretta compilazione è necessario impostare la variabile d'ambiente KONGASDK alla directory d'installazione dell'SDK di Konga.

Risorse

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)

Script di utilità comune per Konga

Gli script contenuti in questo repository possono essere utati come esempi nell'uso di kongalib.