Trac: plugin per eclipse

Trac ha un plugin, chiamato Eclipse Trac Integration , che consente la gestione completa di trac, direttamente da eclipse. In pratica offre un'interfaccia che consente di editare e creare nuovi contenuti per uno o più trac sites direttamente da eclipse.

Ecco come installarlo e configurarlo.

Reference: sito ufficiale del plugin

Eclipse Trac Integration, è composto da due parti: un plugin per trac e un plugin per eclipse.

Il plugin per trac ne estende le funzionalità dell'XML/RPC API e un plugin per eclipse che offre una prospettiva (perspective) (in eclipse Window->Open Perspective) e la possibilità di dialogare con uno o più trac site (via xml/rpc appunto). In pratica il plugin di eclipse trasforma eclipse in un cliente xml/rpc.

Installazione dei plugin per trac

Il plugin Eclipse Trac Integration dipende da XML_RPC Plugin:

Scarico il sorgente

mkdir /tmp/trac_xmlrpc_plugin/
cd /tmp/trac_xmlrpc_plugin/
svn co http://trac-hacks.org/svn/xmlrpcplugin/trunk/

tree -L 2
.
`-- trunk
    |-- setup.py
    `-- tracrpc

compilo il file .egg come di consueto:

cd trunk
python setup.py bdist_egg

tree -L 2
.
|-- TracXMLRPC.egg-info
|   |-- PKG-INFO
|   |-- SOURCES.txt
|   |-- dependency_links.txt
|   |-- entry_points.txt
|   |-- top_level.txt
|   `-- zip-safe
|-- build
|   |-- bdist.linux-x86_64
|   `-- lib
|-- dist
|   `-- TracXMLRPC-1.0.0-py2.5.egg
|-- setup.py
`-- tracrpc
    |-- __init__.py
    |-- api.py
    |-- search.py
    |-- templates
    |-- ticket.py
    |-- util.py
    |-- web_ui.py
    `-- wiki.py

cd dist
easy_install TracXMLRPC-1.0.0-py2.5.egg

Ora mi occupo di Eclipse Trac Integration. Scarico il sorgente

mkdir /tmp/trac_eclipse_plugin/
cd /tmp/trac_eclipse_plugin/
svn co http://trac-hacks.org/svn/eclipsetracplugin/tracrpcext/0.10/

tree -L 2
.
`-- 0.10
    |-- setup.py
    `-- tracrpcext

compilo il file .egg come di consueto:

cd 0.10
python setup.py bdist_egg

 tree -L 2
.
|-- TracExtendedXmlRpc.egg-info
|   |-- PKG-INFO
|   |-- SOURCES.txt
|   |-- dependency_links.txt
|   |-- entry_points.txt
|   |-- top_level.txt
|   `-- zip-safe
|-- build
|   |-- bdist.linux-x86_64
|   `-- lib
|-- dist
|   `-- TracExtendedXmlRpc-0.1-py2.5.egg
|-- setup.py
`-- tracrpcext
    |-- __init__.py
    |-- ticket.py
    `-- wiki.py

installo il file .egg

cd dist
easy_install TracExtendedXmlRpc-0.1-py2.5.egg

Configurazione dei plugin per trac

Alla sezione [components] del file trac.ini del progetto trac che voglio gestire via eclipse aggiungo:

tracrpc.* = enabled
tracrpcext.* = enabled

Oppure, se in trac è già stato abilitato il tracWebAdmin plugin, posso configurare tutte le opzioni per entrambi i plugin attraverso l'interfaccia web (sezione Admin->Plugins)

Installazione del plugin per eclipse

l'eclipse che ho usato è ganimede e, allo stato attuale, la jvm in uso è la 1.5.0_16

Dalla interfaccia si Software Updates di eclipse aggiungo il repository: http://trac-hacks.org/svn/eclipsetracplugin/eclipse/update/ e installo il plugin come di consueto (Eclipse Ganimede ha migliorato nettamente l'interfaccia per le installazioni e quindi questa parte non dovrebbe essere problematica).

Configurazione ed uso del plugin per eclipse

Al termine dell'installazione dopo aver riavviato eclipse e accedendo alle prospettive (Window -> Open Perspective) trovo la prospettiva Trac generata dal plugin

Seleziono Trac e mi ritrovo con questa interfaccia.

Sotto la linguetta Trac Server, cliccando con il destro posso aggiungere un Trac server

Una volta aggiunto il trac server mi ci connetto e questo è il risultato:

Posso editare, modificare e aggiungere(*) i contenuti del sito direttamente da eclipse

(*) ho verificato qualche problema in fase di aggiunta di una pagina al wiki, ma devo ancora investigare a fondo