Author: tchemit Date: 2012-07-15 21:48:53 +0200 (Sun, 15 Jul 2012) New Revision: 310 Url: http://nuiton.org/repositories/revision/jredmine/310 Log: fixes #937: Maven test utilise les properties de test de la distribution (adding documentation) Added: branches/jredmine-1.x/src/site/apt/tests.apt Modified: branches/jredmine-1.x/pom.xml branches/jredmine-1.x/src/site/site_fr.xml Modified: branches/jredmine-1.x/pom.xml =================================================================== --- branches/jredmine-1.x/pom.xml 2012-07-15 19:18:21 UTC (rev 309) +++ branches/jredmine-1.x/pom.xml 2012-07-15 19:48:53 UTC (rev 310) @@ -739,7 +739,7 @@ </profile> <profile> - <id>jredmine-server-test</id> + <id>jredmine-test-profile</id> <build> <plugins> <plugin> Added: branches/jredmine-1.x/src/site/apt/tests.apt =================================================================== --- branches/jredmine-1.x/src/site/apt/tests.apt (rev 0) +++ branches/jredmine-1.x/src/site/apt/tests.apt 2012-07-15 19:48:53 UTC (rev 310) @@ -0,0 +1,147 @@ +~~~ +~~ #%L +~~ JRedmine +~~ +~~ $Id$ +~~ $HeadURL: http://svn.nuiton.org/svn/jredmine/branches/jredmine-1.x/src/site/apt/index.... $ +~~ %% +~~ Copyright (C) 2009 - 2012 CodeLutin,Tony Chemit +~~ %% +~~ This program is free software: you can redistribute it and/or modify +~~ it under the terms of the GNU Lesser General Public License as +~~ published by the Free Software Foundation, either version 3 of the +~~ License, or (at your option) any later version. +~~ +~~ This program is distributed in the hope that it will be useful, +~~ but WITHOUT ANY WARRANTY; without even the implied warranty of +~~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +~~ GNU General Lesser Public License for more details. +~~ +~~ You should have received a copy of the GNU General Lesser Public +~~ License along with this program. If not, see +~~ <http://www.gnu.org/licenses/lgpl-3.0.html>. +~~ #L% +~~~ +---- +JRedmine Tests +---- +---- +2009-09-15 +---- + +Introduction + + Cette page décrit comment on peut à partir de la version <<1.4>> configurer + les tests. + +Configuration de base + + Par défaut, les tests vont chercher dans un fichier dans le class-path + nommé <<test-config.properties>> les informations de base pour communiquer + avec un servuer redmine. + + Voici la configuration par défaut actuelle : + +------------------------------------------------------------------------------- +test.redmineUrl=http://nuiton.org +test.encoding=UTF-8 +test.verbose=false +------------------------------------------------------------------------------- + + Cette configuration permet de tester uniquement les fonctionnalités non + authentifiés de l'api. + +Surcharger la configuration de base + + Il est possible de surcharger cette configuration de base en utilisant des + variables d'environnement : + + * <<test.redmineUrl>> : pour changer l'url du serveur redmine à utiliser + * <<jredmine-test.verbose>> : pour changer la verbosité dans les tests. + + Exemple : + +------------------------------------------------------------------------------- +mvn install -Djredmine-test.verbose +------------------------------------------------------------------------------- + +Configuration authentifiée + + Des tests ont aussi été écrits pour tester les fonctionnées authentifiés + de l'api. + + Pour cela il faut fournir aux tests un login + password et ceci peut être fait de plusieurs manières différentes + +* Via des variables d'environnement + + Renseigner les deux variables suivantes : + + * <<jredmine-test.login>> + + * <<jredmine-test.password>> + + Exemple : + +------------------------------------------------------------------------------- +mvn install -Djredmine-test.login=login -Djredmine-test.password=password +------------------------------------------------------------------------------- + +* Via un server défini dans le <<settings.xml>> + + Cela a l'avantage de cacher et crypté votre mot de passe... et de ne pas + à avoir à renseigner vos identifiants à chaque invocation maven. + + Le serveur à utiliser est nommé <<jredmine-test>> + +Exemple : + +------------------------------------------------------------------------------- +<!-- login to jredmine test --> + <server> + <id>jredmine-test</id> + <username>login</username> + <password>Le mote de passe crypté {xxx}</password> + </server> +------------------------------------------------------------------------------- + + + Ensuite il faut utiliser le profile nommé <<jredmine-test-profile>> + pour injecter vos identifiants dans les tests + + Exemple : + +------------------------------------------------------------------------------- +mvn install -Pjredmine-test-profile +------------------------------------------------------------------------------- + + Il est aussi possible d'ajouter ce profile dans les profiles actifs par + défaut toujours dans le fichier <<settings.xml>>. + + Exemple : + +------------------------------------------------------------------------------- + + <profiles> + + <!-- ... --> + + <!-- On crée un profile vide par défaut pour ne pas avoir de warning + pour les autres builds maven... ... --> + <profile> + <id>jredmine-server-test</id> + </profile> + <!-- ... --> + + </profiles> + + <activeProfiles> + <!-- ... --> + <activeProfile>jredmine-server-test</activeProfile> + </activeProfiles> +------------------------------------------------------------------------------- + +Jeu de test + + En version <<2.0>> le jeu de test sera configurable et clairement spécifié. + + Pour le moment, le projet testé est <<jredmine>> en version<<1.3>>. Property changes on: branches/jredmine-1.x/src/site/apt/tests.apt ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision Added: svn:eol-style + native Modified: branches/jredmine-1.x/src/site/site_fr.xml =================================================================== --- branches/jredmine-1.x/src/site/site_fr.xml 2012-07-15 19:18:21 UTC (rev 309) +++ branches/jredmine-1.x/src/site/site_fr.xml 2012-07-15 19:48:53 UTC (rev 310) @@ -75,6 +75,7 @@ <menu name="Utilisateur"> <item name="Introduction" href="index.html"/> + <item name="Tests" href="tests.html"/> </menu> <menu ref="modules"/>