Visualizza wikitesto di Odoo PyCharm install debug

== Configurazione e debug di Odoo con PyCharm-community  ==

Di seguito, trovate un breve tutorial da seguire per creare e configurare un progetto Odoo con PyCharm:

Poniamo che la nostra installazione si trovi su:

 '''/home/myuser/odoo-dev/OCB'''

Per creare un nuovo progetto ODOO, avviamo il programma PyCharm, chiudiamo eventuali progetti 
esistenti e selezioniamo '''File -> Create new project'''. 

Selezioniamo ''Create new project'' e come location scegliamo la cartella che
che contiene lo script di avvio di ODOO, nel nostro caso 
/home/myuser/odoo-dev/OCB, scegliamo l'interprete Python 2.7 e facciamo click
su Create.

PyCharm ci avverte che la directory selezionata non è vuota e ci chiede se vogliamo attivare il progetto da sorgenti esistenti. Facciamo click su Yes.

A questo punto si apre PyCharm con il nostro progetto e vengono creati i files di configurazione del progetto che si trovano in una cartella di 
nome .idea posizionata nella root del progetto, nel nostro caso:
 /home/myuser/odoo-dev/OCB/.idea

Non è finita, ora dobbiamo ancora insegnare a PyCharm a trovare le cartelle 
degli 'addons'' di Odoo e ad avviare il programma.

Andiamo su: '''File -> Settings''' e scegliamo la voce '''"Project: Project Structure"''', e facciamo click su '''"Add Content Root"''', per aggiungere altre cartelle che fanno parte del progetto, nel nostro caso aggiungiamo cartelle di addons che si trovano fuori dalla cartella principale; ad esempio:

 /home/myuser/odoo-dev/addons<br />
 /home/myuser/odoo-dev/addons_ita<br />

Se vogliamo possiamo aggiungere anche cartelle che non contengono sorgenti python, ma ad esempio files di configurazione, appunti ecc..., ad esempio:

 /home/myuser/odoo-dev/extra_data

Ora PyCharm sa dove trovare i sorgenti di odoo ed anche i sorgenti dei moduli che andremo a sviluppare, non ci resta che insegnargli come lanciare Odoo.

Andiamo su '''Run -> Debug...''' e scegliamo '''"Edit configuration"''' ed andiamo sul tab '''Defaults -> Python'''

Come script scegliamo:

 '''/home/myuser/odoo-dev/OCB/odoo-bin'''

e come script parameters indichiamo il file di configurazione che usiamo per far partite Odoo da riga di comando.<br> (la gestione dei files di configurazione
di Odoo non fa parte di questo tutorial; diamo per scontato che ci sia già un file di configurazione).<br> Nel nostro caso il file è:

 '''--config=/home/myuser/odoo-dev/extra_data/odoo.conf'''

Ora navighiamo nell albero dei files del progetto ed apriamo:

 '''/home/myuser/odoo-dev/OCB/odoo-bin'''

Andiamo nel menu Run ed apriamo '''Debug odoo-bin'''

Se le configurazioni effettuate qui sopra sono corrette, tutto andrà bene; ora il nostro progetto è partito e lo verifichiamo andando a visualizzare con un browser, l'URL: 

 '''http://localhost:8069/'''

Ora possiamo fermare lo script facendo click sul pulsante di arresto (quadratino rosso) sulla finestra di console di Run nella parte bassa.

Per ultima cosa vediamo se funziona il debugger. Supponiamo di aver installato il modulo "CRM Custom Fields" nella cartella:

 '''/home/myuser/odoo-dev/addons/crm_custom_fields'''

Apriamo il file:

 '''/home/myuser/odoo-dev/addons/crm_custom_fields/models/ir_model.py'''

e mettiamo un ''breakpoint'' sulla riga 6 con scritto: '''_inherit = "ir.model"'''

Se abbiamo fatto tutto per bene, dopo il riavvio del debugger, l'esecuzione si fermerà su quella riga e da li potremo ispezionare i valori delle variabili attive
in quel momento.

Ora siamo pronti a sviluppare i nostri moduli usufruendo del potente ambiente di lavoro messoci a disposizione da PyCharm.

'''Un ultima nota''':

Python è un linguaggio dinamico che permette di modificare gli oggetti a runtime. Odoo utilizza questa potenzialità per attivare un particolare sistema
non standard di ereditarietà degli oggetti. Questo limita un po' le grandi potenzialità di PyCharm in fatto di auto completamento in fase di scrittura
del codice, ma è un problema con cui si può e si deve convivere.
<br><br>