ViewCVS: Overview, installazione ed uso

ViewCVS è un tool scritto in Pyton, che permette di accedere via web ad un repository CVS, è possibile visualizzare i change logs, le revisioni dei file, ed effettuare il browse delle directory di un progetto, tutto questo in base ai tags oppure ai branchs definiti.

PREREQUISITI  
Per poter utilizzare ViewCvs è necessaria la presenza di alcuni software nel sistema:  
- Un web server per l'esecuzione dello script CGI che gestisce la visualizzazione;  
- Il linguaggio Pyton di versione 1.5 o superiore;  
- Il sistema RCS (Revision Control System) che viene utilizzato per tener traccia delle revisioni dei file;  

DOWNLOAD
Il download del pacchetto, può essere effettuato dal sito del progetto su SourceForge a questo indirizzo sourceforge.net/projects/viewcvs/:
[email protected]:/usr/local# wget --passive http://viewcvs.sourceforge.net/viewcvs-0.9.2.tar.gz   
--16:04:18--  http://viewcvs.sourceforge.net/viewcvs-0.9.2.tar.gz  
           => `viewcvs-0.9.2.tar.gz'  
Resolving viewcvs.sourceforge.net... done.  
Connecting to viewcvs.sourceforge.net[66.35.250.209]:80... connected.  
HTTP request sent, awaiting response... 200 OK  
Length: 140,063 [application/x-tar]  
100%[==================================================================================>] 140,063        4.24K/s    ETA 00:00  
16:04:52 (4.24 KB/s) - `viewcvs-0.9.2.tar.gz' saved [140063/140063]


SCOMPATTAZIONE  
Una volta terminato il download è possibile eseguire la scompattazione del pacchetto tar compresso con gzip:  
[email protected]:/usr/local# tar xvfz viewcvs-0.9.2.tar.gz  
viewcvs-0.9.2/  
viewcvs-0.9.2/cgi/  
viewcvs-0.9.2/cgi/cvsgraph.conf.dist  
viewcvs-0.9.2/cgi/granny.cgi  
viewcvs-0.9.2/cgi/query.cgi  
viewcvs-0.9.2/cgi/viewcvs.cgi  
viewcvs-0.9.2/cgi/viewcvs.conf.dist  
...  
viewcvs-0.9.2/website/upgrading.html  
viewcvs-0.9.2/website/who.html  
viewcvs-0.9.2/LICENSE.html


INSTALLAZIONE  
L'installazione viene effettuata tramite uno script fornito a corredo del software, il quale chiede di indicare la directory di installazione:  
[email protected]:/usr/local/viewcvs-0.9.2# ./viewcvs-install  
This is the ViewCVS 0.9.2 installer.  

It will allow you to choose the install path for ViewCVS.  You will  
now be asked some installation questions.  

Defaults are given in square brackets.  Just hit [Enter] if a default
is okay.

Installation Path [/usr/local/viewcvs-0.9.2]: /usr/local/viewcvs  
L'unica domanda posta dall'installer è il percorso in cui vogliamo il software  
Installing ViewCVS to: /usr/local/viewcvs  
  cgi/viewcvs.cgi  
  cgi/query.cgi  
  standalone.py  
  cgi/viewcvs.conf.dist  
  cgi/cvsgraph.conf.dist  
  lib/PyFontify.py  
  lib/blame.py  
  lib/compat.py  
  lib/config.py  
  lib/cvsdb.py  
...  
  website/help_logtable.html  
  website/images/logo.png  
  website/images/chalk.jpg  
  website/images/cvsgraph_16x16.png  
  website/images/cvsgraph_32x32.png  

Installation Complete


CONFIGURAZIONE POSTINSTALLAZIONE  
Terminata l'installazione è necessario copiare i file *.cgi presenti nella directory di installazione sotto /cgi/ in quella utilizzata dal Web server per l'esecuzione degli script:  
[email protected]:/usr/local/viewcvs/cgi# ls  
query.cgi  viewcvs.cgi  
[email protected]:/usr/local/viewcvs/cgi# cp *.cgi /usr/local/apache/cgi-bin/
  
A questo punto è d'obbligo una minima configurazione di base di attraverso la modifica di alcuni parametri nel file viewcvs.conf. In particolare:  
[email protected]:/usr/local/viewcvs# cat viewcvs.conf  
cvs_roots = Joker : /home/cvs  
# this is the name of the default CVS root.  
Dove risiede il repository  
default_root = Joker  
Quale repository visualizzare in case fossero più di uno  
# uncomment if the RCS binaries are not on the standard path  
#rcs_path = /usr/bin/  
# This address is shown in the footer of the generated pages.  
# It must be replaced with the address of the local CVS maintainer.  
address = <a href="mailto:[email protected]"> CVS admin Arnaldo aka Homer</a>  
L'amministratore del CVS   
# this title is used on the main entry page  
main_title = CVS Joker Repository   
Il titolo da visualizzare via Web
  

A questo punto è possibile accedere al repository in lettura all'indirizzo /cgi-bin/viewcvs.cgi/ del proprio webserver.

Privacy Policy