Version anglaise: NutchWiki:HowToContribute (interwiki)
Cette page est un HOWTO rapide expliquant comment
facilement contribuer des patchs pour Nutch.
Obtenir le code source
Tout d'abord, vous avez besoin du code source de Nutch.Créez un répertoire dans lequel vous allez stocker le code source de Nutch sur votre disque local.
> cd quelquePartSurVotreDisque
> mkdir nutch
> cd nutch
Récuperez alors le code source sur votre disque local en utilisant SVN.
svn checkout http://svn.apache.org/repos/asf/incubator/nutch/
Au travail !
Il est maintenant temps de se mettre au travail.Vous pouvez modifier le code source comme vous l'entendez et ajouter de (merveilleuses) nouvelles fonctionnalités en utilisant votre AGL de prédilection.
Cependant, soyez attentif quant aux points suivants :
- Toutes les méthodes et classes publiques doivent contenir des commentaires javadoc informatifs,
- Les tests unitaires sont recommandés (http://www.junit.org/).
Écrire un patch
Veuillez avant tout réaliser quelques tests de non-régression avant de soumettre votre code :- en recompilant tout le code de Nutch,
- en exécutant tous les tests unitaires.
Recompiler Nutch
> cd quelquepart/sur/disque/nutch
> ant
Après quelques instants, si vous voyez apparaître :
BUILD SUCCESSFUL
c'est que tout va bien. Par contre, si vous lisez :
BUILD FAILED
veuillez relire attentivement les messages d'erreur et vérifier votre code.
Test unitaires
> cd quelquepart/sur/disque/nutch
> ant test
Après quelques instants, si vous voyez apparaître :
BUILD SUCCESSFUL
c'est que tout va bien. Par contre, si vous lisez :
BUILD FAILED
veuillez relire attentivement les messages d'erreur et vérifier votre code.
Test fonctionnels
Si vous êtes un perfectionniste, vous pouvez également réaliser des tests fonctionnels en lançant Nutch. Veuillez pour cela vous référer au tutorial Nutch.Créer un patch
Pour créer un patch, il vous suffit de taper :svn diff > monJoliPatch.patch
vi monJoliPatch.patch
Cette commande crée un rapport contenant toutes les modifications du code source Nutch que vous avez faites sur votre disque et le sauve dans un fichier appelé monJoliPatch.patch. Il vous faut alors éditer ce fichier pour vous assurer que seules les modifications que vous souhaitez ajouter au repository SVN de Nutch y figurent.
Proposer votre travail
Enfin, vous pouvez joindre votre travail à un message et l'envoyer à la liste de diffusion nutch-dev, ou soumettre un rapport de bug dans Jira.
Il n'y a pas de commentaire sur cette page.
[Afficher commentaires/formulaire]