AVÍS: DOCUMENT EN CONSTRUCCIÓ!

Aquest document explica com instal·lar i configurar l'entorn de desenvolupament PyDev si voleu fer contribucions al codi de MailToTicket i encara no teniu un IDE predilecte per desenvolupar en Python.

El procediment descrit no presuposa cap coneixement previ sobre Eclipse ni PyDev.

Instal·lació de l'Eclipse

Podeu baixar l'Eclipse de la seva web. Es recomana baixar la distribució Eclipse IDE for Java Developers, que ocupa menys espai que altres i és suficient per al PyDev.

Un cop baixat l'Eclipse, descomprimiu el tarball en qualsevol subdirectori. En el nostre cas voldrem tenir-lo, a ~/soft/eclipse-pydev:

$ mkdir ~/soft
$ cd ~/soft
$ tar zxvf eclipse-java-mars-2-linux-gtk-x86_64.tar.gz
$ mv eclipse eclipse-pydev

A partir d'ara ja podeu arrencar l'eclipse executant la comanda ~/soft/eclipse-pydev/eclipse.

Quan s'executa per primera vegada, l'Eclipse us demana que seleccioneu el workspace: un directori on guardarà els fitxers de projectes i altres configuracions. Per exemple, ~/workspace-pydev (si no existeix el directori, el crearà). També recomanem marcar la casella Use this as the default and do not ask again.

Quan obriu Eclipse per primera vegada, us apareix una pestanya d'introducció, que podeu tancar per accedir al workbench (l'espai de treball).

(opcional) Crear un accés directe a l'escriptori

Si voleu un accés directe al vostre escriptori per obrir l'Eclipse, creeu al vostre escriptori un fitxer anomenat, per exemple, eclipse-pydev.desktop (el nom pot ser qualsevol, sempre que l'extensió sigui .desktop) amb el següent contingut:

[Desktop Entry]
Version=1.0
Type=Application
Terminal=false
Exec=/home/usuari/soft/eclipse-pydev/eclipse
Name=PyDev
Icon=/home/usuari/soft/eclipse-pydev/icon.xpm

Observeu que haureu de modificar les rutes perquè apuntin al directori on hagueu descomprimit l'Eclipse.

Instal·lar el PyDev

Ara cal instal·lar l'entorn PyDev, ja que Eclipse per defecte no incorpora utilitats per desenvolupar en Python. L'entorn PyDev, és un paquet que s'instal·la damunt de l'Eclipse i que afegeix suport per al llenguatge Python.

Per instal·lar PyDev, amb l'Eclipse obert escollim el menú Help -> Eclipse Marketplace.... Al camp de cerca escrivim pydev i premem return. Quan apareguin els resultats, premem el botó Install corresponent al PyDev.

Durant la instal·lació haurem d'acceptar les llicències de PyDev, després haurem d'indicar a Eclipse que accepti els certificats de PyDev, i finalment ens demanarà reiniciar l'Eclipse.

Un cop reiniciat l'Eclipse, ja tenim el PyDev instal·lat.

Importar MailToTicket com a projecte de PyDev

Abans d'importar el projecte MailToTicket al PyDev, suposarem que tenim una còpia del repositori de MailToTicket en algun directori, per exemple ~/src/mailtoticket, i que hem seguit les instruccions per configurar el virtualenv i instal·lar tots els mòduls de Python necessaris tal i com s'explica al fitxer README.md (pip install -r requierements.txt, etc.).

Desinstal·lar

Si alguna vegada voleu desinstal·lar el PyDev, haureu d'esborrar:

• El directori on heu instal·lat l'Eclipse (per exemple, ~/soft/eclipse-pydev).
• El directori workspace (per exemple, ~/workspace-pydev).
• La icona d'accés directe a l'escriptori (el fitxer .desktop, si l'heu creat).