Installazione ambiente di sviluppo eclipse + pydev per OpenErp Server

Questa guida è dedicata a tutti coloro che hanno lavorato con java in passato e sono poi passati al mondo python (e non vogliono tornare più indietro…)

Eclipse è un ambiente di sviluppo avanzato e maturo e fornisce plugin per ogni necessità, dalla integrazione con server svn, cvs e bzr all'interfacciamento di database e web services, ma soprattutto possiede diversi strumenti molto avanzati per il debug degli applicativi. Eclipse è scritto interamente in linguaggio java, tuttavia possiede diverse estensioni che permettono lo sviluppo in diversi linguaggi di programmazione. Un'estensione molto efficiente che permette lo sviluppo in python è PyDev di Aptana. Questo è un plugin completo e molto potente che fino a poco tempo fa aveva due versioni, una free con funzionalità limitate ed una proprietaria con tante funzionalità in più. Da qualche anno il plugin pydev è completamente free e offre un ambiente professionale ed affidabile per sviluppare applicazioni in linguaggio python La presente guida è quindi un riferimento per l'installazione di un'istanza del server openerp in eclipse per poterne usare completamente le potenzialità, il sistema operativo utilizzato in questa guida è la ubuntu 10.4

Python 2.5 installato

Per installare il software development kit di java aprire una shell e digitare

$sudo apt-get install sun-java6-jdk

oppure se si vuole avere la versione opensource digitare

$sudo apt-get install openjdk-6-jdk

(se non si usa un ambiente debian con apt-get scaricare quindi il package java sdk dal sito http://java.sun.com/javase/downloads/index.jsp fornire i permessi di esecuzione al file con

$chmod u+x java-sun-jdk6.bin 

ed eseguire il file. Una volta installato l'ambiente inserire le variabili di ambiente

export JAVA_HOME=/path/to/java/home
export PATH = $PATH:/path/to/java/home/jdk/jdk1.6.0_12/bin)

verificare l'avvenuta installazione digitando il comando

$java -version

dopo l'esecuzione dovrebbe comparire la versione di java installata:

java version "1.6.0_0"

Scaricare Eclipse (Galileo version 3.5) dal sito www.eclipse.org e copiare il file eclipse-SDK-3.6-linux-gtk.tar.gz in una directory della propria home; entrare quindi nella directory dove si è copiato il file e scompattare il package con il comando

$tar xzvf eclipse-SDK-3.6-linux-gtk.tar.gz

a questo punto entrare nella cartella eclipse appena scompattata e far partire il programma premendo due volte con il mouse sul file eclipse o digitando da riga di comando

$./eclipse

Una volta aperto l'IDE è necessario installare il plugin PyDev di Aptana con il plugin manager dell'IDE.Selezionare quindi dal menu la voce Help → Install New Software Premere il bottone Add e inserire nel campo nome la dicitura PyDev e nel campo location l'url di download del plugin http://pydev.org/updates premere quindi Ok ed attendere che compaiano le voci installabili. Selezionare quindi PyDev (tralasciamo l'integrazione con Mylyn, che forse un domani sarà oggetto di un nuovo post nel wiki..). A questo punto premere Next e, dopo avere accettato i termini della licenza, attendere che l'installazione abbia fine (potrebbe aprirsi una finestra che chiede la fiducia sul certificato di Aptana, confermare quindi il passo e andare avanti); non appena l'installazione è conclusa riavviare eclipse per rendere effettivi i cambiamenti apportati. A questo punto non rimane che definire un interprete python di default. Per far questo selezionare la voce di menu

Window → Preferences → PyDev → Interpreter Python

premere sul bottone New e inserire il nome che si vuole dare all'interprete, ad esempio python2.5 e la location dove si trova l'eseguibile, solitamente /usr/bin/python2.5; premere quindi Apply e chiudere la finestra con il tasto Ok.

Passiamo ora alla creazione di un nuovo progetto pydev del server di openerp; per non partire da zero scaricare il package tar.gz dal sito www.openerp.com/downloads e scompattarlo in una directory della propria home. Entrare quindi in eclipse e selezionare la voce File → New → Others → Pydev → Pydev Project

Inserire quindi il nome che si vuole dare al progetto, togliere la spunta all'opzione Use default ed inserire con l'opzione Browse il path dove si trova la cartella principale del progetto; scegliere quindi python come project type e l'interprete python2.5 appena configurato. Togliere infine la spunta all'ultima opzione Create default 'src' folder in modo che non venga creata una folder src che risulterebbe inutile. Premere quindi sul tasto finish ed attendere l'importazione del progetto.

Con l'apertura del progetto il sistema passa alla perspective pydev che fornire diversi strumenti per lo sviluppo python

Come si può vedere nella figura seguente fra le funzionalità offerte dal sistema esiste anche l'autocompletamento del codice, se infatti si preme control+spazio dopo un modulo importato si può selezionare la voce di interesse che verrà inserita in automatico.

La Utility più interessante offerta da eclipse è però quella del debug del codice, il plugin pydev mantiene completamente le funzionalità offerte per l'ambiente java anche per l'ambiente python. Vediamo quindi come far partire il server all'interno del sistema. Entrare in eclipse selezionando la voce Run → Run Configurations Dalla finestra che viene aperta selezionare la voce New dopo aver premuto il tasto destro su Python Run. Inserire quindi il nome per la configurazione, selezionare il progetto appena creato con l'opzione Browse e selezionare il modulo principale del progetto /bin/openerp-server.py.

Verificare quindi il python path della configurazione e passare al tab Arguments. Inserire qui la stringa che normalmente segue il comando openerp-server.py nella shell di linux in questo caso –db_host=127.0.0.1 –db_port=5432 –db_user=postgres –db_password=postgres

Premere quindi su Apply e verificare la configurazione premendo Run Nella console in basso dovrebbe comparire il solito messaggio: the server is running, waiting for connections… A questo punto fermare il server con il bottone stop e provare a fare ripartire la stessa configurazione in modalità debug. Scegliere Run → Debug Configurations… selezionare la configurazione appena creata e premere Debug. Attendere il messaggio di avvio nella console come prima. Benissimo, a questo punto il sistema è pronto per essere debuggato. Aprire ad esempio il file bin/addons/base/res/partner/partner.py e inserire un break point alla sinistra della seconda riga del metodo copy del partner. A questo punto aprire un client per la versione del server installata ed entrare con un utente abilitato alla creazione dei partner (come test possiamo tranquillamente utilizzare l'utente admin) scegliere quindi un partner e dalla voce del menu scegliere la funzionalità Duplica. Dopo qualche secondo si aprirà una finestra di eclipse per la conferma dello switch alla perspective di debug; confermare premendo il tasto Yes e verificare la posizione del break point appena inserito. Nella parte a destra è possibile visualizzare il valore di tutte le variabili inizializzate; mediante le frecce a sinistra invece è possibile andare avanti di una riga, entrare nel metodo o proseguire fino alla fine dell'esecuzione (o fino al breakpoint seguente).

Come si può notare il sistema è molto completo ed estremamente utile anche nel lavoro sui singoli moduli di openerp.

Eclipse è molto utile anche quando si lavora con server di versionamento come cvs, svn etc. Esiste un plugin (che non ho però provato personalmente) per bazaar; questo plugin può essere installato con il solito tool e consente di effettuare gli aggiornamenti su launchpad direttamente dall'IDE di sviluppo. Per maggiori informazioni andare sul sito del progetto http://wiki.bazaar.canonical.com/BzrEclipse

Un' altra estensione che ho trovato utile è il progetto openerp-eclipse-template che è possibile scaricare da google code hosting e fornisce un sistema veloce per la creazione delle classi python dei propri moduli ed anche un supporto alla creazione delle view xml di openerp. Per maggiori informazioni connettersi al sito http://code.google.com/p/openerp-eclipse-template/ nella pagina principale del sito sono presenti due video tutorial di installazione ed utilizzo dei template con Eclipse.

This is the End Folks… Enjoy OpenErp in Eclipse!

A presto

Angedras