Contents
Code Review
Codereview és una eina de revisió de codi per a Tryton. Qualsevol proposta de codi ha de passar pel codereview:
Core de Tryton: http://codereview.tryton.org/
Trytonspain http://codereview.tryton-erp.es/
Documentació oficial: http://code.google.com/p/tryton/wiki/HowtoContribute
Instal·lació
Ens instal·larem hgreview. Es un paquet python que amplia opcions en el Mercurial:
hg review --help
Opcions hgreview
Afegirem al fitxer .hgrc del nostre usuari o projecte mercurial les següents opcions, en aquest exemple hem afegit dos servidors a on enviar les revisions de codi, per mòduls que van al codereview del core de Tryton (tryton.org) i per mòduls que van al codereview de trytonspain (tryton-erp.es):
[extensions] hgreview= [review] usernames = usuari@domini.com servers = http://codereview.tryton.org [usuari@gmail.com] GOOGLE http://codereview.tryton-erp.es [usuari] HOSTED send_email = True
Per enviar-los a tryton.org és necessari disposar d'un compte de Google, per enviar-los a tryton-erp.es s'ha de crear un compte en el propi servidor pel que prèviament s'ha de contactar amb algun membre actual per que la crei.
Ús del hgreview
Enviar un nou codereview
Quan fem un canvi de codi en un mòdul i volem debatre-ho, ho enviarem al codereview:
hg review -m "nom_modul: descripció"
Ara a http://codereview.tryton.org/ la gent pot afegir comentaris en el codi i debatre-ho.
Actualitzar codereview
Per publicar de nou codi en el mateix codereview:
hg review -i REVIEWNUMBER -m "Correcció realitzada"
Tots els comentaris que hi han al codereview desapareixeran i s'actualitzarà el codi en la nova versió.
Actualitzar codereview d'altres
Per disposar de permisos per publicar o modificar l'issue, el creador de l'issue ha d'afegir l'email d'altres usuaris a la descripció en línies separades:
COLLABORATOR=usuari@domini.com COLLABORATOR=usuari2@domini2.com
D'aquesta manera disposarem de permisos per enviar diferències amb:
hg review -i REVIEWNUMBER
Podeu veure un exemple a: http://codereview.tryton-erp.es/38/
Aplicar canvis al nostre local
Per aplicar els canvis d'un review del codereview en el nostre repositori per testejar-ho ens col·loquem dins del directori del mòdul:
hg review --fetch -i REVIEWNUMBER
Si el que volem és descarregar-nos un nou mòdul del codereview, el que hem de fer és:
- Crear el directori amb el nom del mòdul (mkdir nommodul).
- Entrar dins del directori (cd nommodul).
- Crear el repositori mercurial (hg init).
- Aplicar el canvi (review --fetch -i REVIEWNUMBER).
o bé fer:
- Crear el directori amb el nom del mòdul (mkdir nommodul).
wget https://tryton-rietveld.appspot.com/download/issue####.diff
patch -p1 < issue####.diff
Altres
Saber el id review que estem treballant:
hg review --id
Saber la url del codereview que estem treballant:
hg review --url
HgReview + HgClone
Si el repo es baixat amb nclone, caldrà que la opció "-n" en les comandes per aplicar-ho al codereview
- hg review -nm "Missatge
- hg review -ni REVIEWID #Actualizar codi
Cookies
El hgreview fa ús d'un fitxer per les cookies:
~/.codereview_upload_cookies