August 2008 - Nuiton-utils-commits - mailman.cloud.codelutin.com

[Lutinutil-commits] r1016 - trunk/lutinutil/src/site/xdoc/fr/rst
by tchemit＠users.labs.libre-entreprise.org Aug. 13, 2008

Aug. 13, 2008

Author: tchemit Date: 2008-08-13 09:47:37 +0000 (Wed, 13 Aug 2008) New Revision: 1016 Added: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst Removed: trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst Log: improve site (due to improve in lutinproject) Deleted: trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst =================================================================== (Binary files differ) Copied: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst (from rev 1014, trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst) =================================================================== (Binary files differ) Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst ___________________________________________________________________ Name: svn:mime-type + application/octet-stream

1 0

[Lutinutil-commits] r1015 - in trunk/maven-i18n-plugin: . src src/main/java/org/codelutin/i18n/plugin/core src/main/java/org/codelutin/i18n/plugin/extension src/site src/site/apt src/site/fml src/site/xdoc src/site/xdoc/fr src/site/xdoc/fr/rst
by tchemit＠users.labs.libre-entreprise.org Aug. 13, 2008

Aug. 13, 2008

Author: tchemit Date: 2008-08-13 01:10:56 +0000 (Wed, 13 Aug 2008) New Revision: 1015 Added: trunk/maven-i18n-plugin/src/site/ trunk/maven-i18n-plugin/src/site/apt/ trunk/maven-i18n-plugin/src/site/apt/index.apt trunk/maven-i18n-plugin/src/site/apt/usage.apt trunk/maven-i18n-plugin/src/site/fml/ trunk/maven-i18n-plugin/src/site/fml/faq.fml trunk/maven-i18n-plugin/src/site/site.xml trunk/maven-i18n-plugin/src/site/xdoc/ trunk/maven-i18n-plugin/src/site/xdoc/fr/ trunk/maven-i18n-plugin/src/site/xdoc/fr/rst/ trunk/maven-i18n-plugin/src/site/xdoc/fr/rst/Todo.rst Modified: trunk/maven-i18n-plugin/pom.xml trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Generate.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Getter.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJava.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaActionConfig.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaTabConfig.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJaxx.java trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserSwixat.java Log: mise en place de lutinproject:2.4 pour un plugin avec un debut de site reajustement des goals pour toujours etre avant une phase compile Modified: trunk/maven-i18n-plugin/pom.xml =================================================================== --- trunk/maven-i18n-plugin/pom.xml 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/pom.xml 2008-08-13 01:10:56 UTC (rev 1015) @@ -8,15 +8,16 @@   <parent> - <groupId>lutinlib</groupId> + <groupId>org.codelutin</groupId> <artifactId>lutinproject</artifactId> - <version>2.3</version> + <version>2.4</version> </parent> <groupId>lutinplugin</groupId> <artifactId>maven-i18n-plugin</artifactId> <dependencies> + <dependency> <groupId>org.apache.maven</groupId> <artifactId>maven-plugin-api</artifactId> @@ -57,34 +58,13 @@   <name>Plugin maven pour lutini18n</name> - <version>0.4</version> + <version>0.4-SNAPSHOT</version> <description> Plugin pour maven 2 pour la génération des bundles pour l'internationnalisation des applications java fait par lutinutil-i18n </description> <inceptionYear>2007</inceptionYear> - <contributors> - <contributor> - <name>Julien Ruchaud</name> - <email>ruchaud(a)codelutin.com</email> - <organization>Code Lutin</organization> - <timezone>+2</timezone> - <roles> - <role>Developer</role> - </roles> - </contributor> - <contributor> - <name>Tony Chemit</name> - <email>chemit(a)codelutin.com</email> - <organization>Code Lutin</organization> - <timezone>+2</timezone> - <roles> - <role>Developer</role> - </roles> - </contributor> - </contributors> -    @@ -94,32 +74,15 @@ <build> <plugins> -  <plugin> <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-source-plugin</artifactId> - <executions> - <execution> - <phase>verify</phase> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> + <artifactId>maven-plugin-plugin</artifactId> </plugin> -  +  <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-javadoc-plugin</artifactId> - <executions> - <execution> - <phase>verify</phase> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> + <groupId>lutinplugin</groupId> + <artifactId>maven-jrst-plugin</artifactId> </plugin> </plugins> @@ -130,61 +93,17 @@  <labs.id>12</labs.id> +  <labs.project>lutinutil</labs.project> -  - <maven.compile.source>1.6</maven.compile.source> - <maven.compile.target>1.6</maven.compile.target> - <maven.compile.encoding>UTF-8</maven.compile.encoding> +  + <maven.scm.url>https://${labs.host}/plugins/scmsvn/viewcvs.php/trunk/${pom.artifactId}?root=${labs.project} + </maven.scm.url> -  - <labs.lists> - http://lists.labs.libre-entreprise.org/mailman/listinfo/lutinutil - </labs.lists> - -  - <maven.scm.developerConnection>scm:svn:svn+ssh://${username}@${labs.host}/svnroot/lutinutil/trunk - </maven.scm.developerConnection> - -  - <maven.scm.connection>scm:svn:svn:anonymous@${labs.host}/svnroot/lutinutil/trunk</maven.scm.connection> - </properties> - <profiles> - <profile> - <id>project</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>tests</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>false</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>site</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>true</maven.reports.generate> - </properties> - </profile> - </profiles> + <scm> + <url>${maven.scm.url}</url> + </scm> </project> Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Generate.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Generate.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Generate.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -34,7 +34,7 @@ * * @author julien * @goal gen - * @phase process-resources + * @phase generate-resources * @execute goal=get */ public class Generate extends AbstractI18nPlugin { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Getter.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Getter.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/core/Getter.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -32,7 +32,7 @@ * * @author julien * @goal get - * @phase process-resources + * @phase generate-resources */ public class Getter extends AbstractI18nPlugin { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJava.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJava.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJava.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -35,38 +35,36 @@ * * @author julien * @goal parserJava - * @phase process-resources + * @phase generate-resources */ public class ParserJava extends AbstractI18nParser { /** - * @description Source entries (src+includes+excludes) . + * Source entries (src+includes+excludes) . * @parameter expression="${i18n.defaultIncludes}" default-value="**\\/*.java" */ protected String defaultIncludes; /** - * @description default src for an entry. + * default src for an entry. * @parameter expression="${i18n.defaultBasedir}" default-value="${basedir}/src/java" */ protected File defaultBasedir; /** - * @description Dependance du projet. + * Dependance du projet. * @parameter default-value="${project}" * @readonly */ protected MavenProject project; /** - * @description Repertoire sources des fichiers i18n. + * Repertoire sources des fichiers i18n. * @parameter expression="${i18n.cp}" default-value="${basedir}/target/classes" * @required */ protected File cp; - //protected List<String> annotationClass; - @Override protected String[] getDefaultIncludes() { return new String[]{defaultIncludes}; @@ -99,9 +97,6 @@ protected I18nFilter filter; - //protected URLClassLoader loader; - //protected Annotation annotation; - @Override public void init() { super.init(); @@ -116,11 +111,6 @@ return clazz.exists() && file1.lastModified() < clazz.lastModified(); } - /* - * (non-Javadoc) - * @see org.codelutin.i18n.plugin.core.Parser#parseFile(java.io.File) - */ - @Override public void parseFile(File srcFile) { try { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaActionConfig.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaActionConfig.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaActionConfig.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -29,7 +29,7 @@ * * @author chemit * @goal parserJavaActionConfig - * @phase process-resources + * @phase generate-resources */ public class ParserJavaActionConfig extends ParserJava { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaTabConfig.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaTabConfig.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJavaTabConfig.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -19,7 +19,7 @@ * * @author chemit * @goal parserJavaTabConfig - * @phase process-resources + * @phase generate-resources */ public class ParserJavaTabConfig extends ParserJavaActionConfig { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJaxx.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJaxx.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserJaxx.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -26,7 +26,7 @@ * * @author julien * @goal parserJaxx - * @phase process-resources + * @phase generate-resources */ public class ParserJaxx extends ParserXml { Modified: trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserSwixat.java =================================================================== --- trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserSwixat.java 2008-08-12 22:56:14 UTC (rev 1014) +++ trunk/maven-i18n-plugin/src/main/java/org/codelutin/i18n/plugin/extension/ParserSwixat.java 2008-08-13 01:10:56 UTC (rev 1015) @@ -26,7 +26,7 @@ * * @author julien * @goal parserSwixat - * @phase process-resources + * @phase generate-resources */ public class ParserSwixat extends ParserXml { Added: trunk/maven-i18n-plugin/src/site/apt/index.apt =================================================================== --- trunk/maven-i18n-plugin/src/site/apt/index.apt (rev 0) +++ trunk/maven-i18n-plugin/src/site/apt/index.apt 2008-08-13 01:10:56 UTC (rev 1015) @@ -0,0 +1,39 @@ + ------ + Introduction + ------ + Tony Chemit + ------ + August 2008 + ------ + +Maven 2 I18n Plugin + + The Maven 2 I18n Plugin is used to compute i18n bundles for a given maven module. + +* Goals Overview + + The I18n plugin has the following goals: + + * {{{parserJava-mojo.html}i18n:parserJava}} parse Java sources. + + * {{{parserJaxx-mojo.html}i18n:parserJaxx}} parse Jaxx sources. + + * {{{parserSwixat-mojo.html}i18n:parserSwixat}} parse Jaxx sources. + + * {{{parserJavaActionConfig-mojo.html}i18n:parserJavaActionConfig}} parse des actions jaxx. + + * {{{parserJavaTabConfig-mojo.html}i18n:parserJavaTabConfig}} parse des onglets jaxx. + + * {{{get-mojo.html}i18n:get}} assembly getter computed by parser-like goals. + + * {{{gen-mojo.html}i18n:gen}} generate i18n bundle from getters. + + * {{{help-mojo.html}i18n:help}} display help. + +* Usage + + Instructions on how to use the Help Plugin can be found {{{usage.html}here}}. + +* Examples + + to be done. Added: trunk/maven-i18n-plugin/src/site/apt/usage.apt =================================================================== --- trunk/maven-i18n-plugin/src/site/apt/usage.apt (rev 0) +++ trunk/maven-i18n-plugin/src/site/apt/usage.apt 2008-08-13 01:10:56 UTC (rev 1015) @@ -0,0 +1,27 @@ + ------ + Usage + ------ + Tony Chemit + ------ + August 2008 + ------ + +Usage + + Below are the different goals and configurations of the I18n plugin. + + +* The <<<parserJava>>> Mojo + + The <<<parserJava>>> mojo is used to discover i18n entries from java source files. + + You can execute this mojo using the following command for a simple java project with no generation : + ++-----+ +mvn i18n:parserJava ++-----+ + + +* The <<<i18n:get>>> Mojo + +To be done. Added: trunk/maven-i18n-plugin/src/site/fml/faq.fml =================================================================== --- trunk/maven-i18n-plugin/src/site/fml/faq.fml (rev 0) +++ trunk/maven-i18n-plugin/src/site/fml/faq.fml 2008-08-13 01:10:56 UTC (rev 1015) @@ -0,0 +1,33 @@ +<?xml version="1.0"?> + + + +<faqs id="FAQ" title="Frequently Asked Questions"> + <part id="General"> + <faq id="Test question?"> + <question>test question?</question> + <answer> + <p> + The first answer :) + </p> + </answer> + </faq> + </part> +</faqs> \ No newline at end of file Added: trunk/maven-i18n-plugin/src/site/site.xml =================================================================== --- trunk/maven-i18n-plugin/src/site/site.xml (rev 0) +++ trunk/maven-i18n-plugin/src/site/site.xml 2008-08-13 01:10:56 UTC (rev 1015) @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="${project.name}"> + + <skin> + <groupId>lutinlib</groupId> + <artifactId>lutin-site-skin</artifactId> + <version>0.1</version> + </skin> + + <bannerLeft> + <name>${project.name}</name> + </bannerLeft> + + <bannerRight> + <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> + <href>${project.organization.url}</href> + </bannerRight> + + <poweredBy> + <logo href="http://maven.apache.org" name="Maven" img="images/logos/maven-feather.png"/> + <logo href="http://jrst.labs.libre-entreprise.org" name="JRst" img="images/jrst-logo.png"/> + <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" + img="images/restructuredtext-logo.png"/> + </poweredBy> + + <body> + <links> + <item name="Labs" href="http://labs.libre-entreprise.org/"/> + <item name="${project.organization.name}" href="${project.organization.url}"/> + </links> + + <menu name="Utilisateur"> + <item name="Introduction" href="index.html"/> + <item name="Goals" href="plugin-info.html"/> + <item name="Usage" href="usage.html"/> + <item name="FAQ" href="faq.html"/> + </menu> + <menu name="Examples"> + <item name="Simplest example Configuring Describe Mojo" href="/examples/describe-configuration.html"/> + </menu> + + <menu name="Téléchargement"> + <item href="${labs.builder.url}/lutinplugin/${project.artifactId}/${project.version}" + name="Télécharger la dernière version"/> + <item href="${labs.builder.url}/lutinplugin/${project.artifactId}" + name="Voir toutes les versions"/> + </menu> + + <menu name="Développeur"> + <item name="A faire" href="Todo.html"/> + </menu> + + <menu ref="reports"/> + + </body> +</project> Added: trunk/maven-i18n-plugin/src/site/xdoc/fr/rst/Todo.rst =================================================================== --- trunk/maven-i18n-plugin/src/site/xdoc/fr/rst/Todo.rst (rev 0) +++ trunk/maven-i18n-plugin/src/site/xdoc/fr/rst/Todo.rst 2008-08-13 01:10:56 UTC (rev 1015) @@ -0,0 +1,80 @@ +Un nouveau parser d'argument +============================ + +L'idée est d'avoir une description simple des arguments et de leur type et +que soit généré une classe à partir de cette description. Dans le +programme il suffirat de demander à la classe généré les inforamtions. + +Les options sont chargées par leur valeur par defaut, puis sont surchargées +par les valeurs des fichiers de configurations, puis surchargé +par les valeurs des variables d'environnement, et enfin surchargé par les +valeurs de la ligne de commande. + +Les fichiers de configuraiton sont lu dans l'ordre suivant: /etc/ + chemin +indiqué, puis $HOME/. + chemin indiqué. + +si le chemin indiqué est titi/toto.conf et que l'on est sur un système Linux +les fichiers de configuration seront: /etc/titi/toto.conf et +~/.titi/toto.conf + +exemple de description +---------------------- + +Par exemple on pourrait avoir le fichier Toto.java.conf dans les sources du +projet qui fournirait le fichier Toto.java:: + + configfile: titi/toto.conf + + outFile: le fichier de sortie + short: o + long: outfile + default: - + type: File + environment: toto + + number: Le nombre de fichier à produire + required: 1 + short: n + default: 1 + long: number + condition: 0<Number && Number<10 + type: int + +La description commence l'option non obligatoire *configfile* qui donne le +nom du fichier de configuration à utiliser pour l'application. Puis on +trouve les options. Une option commence par un nom, puis sa description +ensuite l'option peut avoir plusieurs options: + +- short: l'option courte sur la ligne de commande. Si absente pas d'option + courte +- long: l'option longue sur la ligne de commande, si pas d'option, on + reprend le nom de l'option +- type: le type de l'option (int, Float, String, char, File, ...) +- default: la valeur par default, si elle n'est pas specifier sur la ligne + de commande, ni dans les variables d'environnement ni dans le fichier de + configuration. Pour une option de type File si default faut -, alors + le fichier est la sortie standard. +- condition: la condition que doit respecter l'option pour être valide + la condition est une expression java contenant le nom de l'option comme + valeur de variable. +- environment: le nom de la variable d'environnement qu'il faut utiliser + si l'option n'est pas retrouve sur la ligne de commande. Si cette option + n'est pas indiqué alors, la variable d'environnement recherchée est le nom + du fichier de description suivi d'un point, suivi du nom de l'option. + par exemple toto.outfile + + +L'objet résultat sera Toto placé dans le fichier Toto.java. L'extension +java.conf est obligatoire pour détecter un fichier de configuration à +parser. Cet objet aurai les méthodes getOutputFile():File et getNumber():int + +Librairies utilisé +------------------ + +Sans doute utilisé, le parser redwood pour le fichier de configuration +http://www.isellrenohomes.com/parser/. Il lit directement des EBNF. + +projet de parsage d'argument +---------------------------- + +http://www.martiansoftware.com/jsap/

1 0

[Lutinutil-commits] r1014 - in trunk/lutinutil: . src/site src/site/xdoc src/site/xdoc/fr/rst
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 22:56:14 +0000 (Tue, 12 Aug 2008) New Revision: 1014 Added: trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst Removed: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst trunk/lutinutil/src/site/xdoc/navigation.xml Modified: trunk/lutinutil/changelog trunk/lutinutil/pom.xml trunk/lutinutil/src/site/site.xml Log: improve site (due to improve in lutinproject) Modified: trunk/lutinutil/changelog =================================================================== --- trunk/lutinutil/changelog 2008-08-12 17:35:52 UTC (rev 1013) +++ trunk/lutinutil/changelog 2008-08-12 22:56:14 UTC (rev 1014) @@ -1,3 +1,7 @@ +ver-0-31 chemit 2008???? + * utilisation de lutinproject 2.4 et nettoyage du pom + * reorganisation du site + ver-0-30 chemit 20080710 * passage en maven 2 layout directory * utilisation de lutinproject 2.3 Modified: trunk/lutinutil/pom.xml =================================================================== --- trunk/lutinutil/pom.xml 2008-08-12 17:35:52 UTC (rev 1013) +++ trunk/lutinutil/pom.xml 2008-08-12 22:56:14 UTC (rev 1014) @@ -9,12 +9,11 @@  <parent> - <groupId>lutinlib</groupId> + <groupId>org.codelutin</groupId> <artifactId>lutinproject</artifactId> - <version>2.3</version> + <version>2.4</version> </parent> - <groupId>org.codelutin</groupId> <artifactId>lutinutil</artifactId> <dependencies> @@ -22,31 +21,31 @@ <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> + <version>1.2.14</version> + <scope>compile</scope> </dependency> <dependency> - <groupId>commons-logging</groupId> - <artifactId>commons-logging</artifactId> - </dependency> - - <dependency> <groupId>commons-primitives</groupId> <artifactId>commons-primitives</artifactId> + <version>1.0</version> + <scope>compile</scope> </dependency> <dependency> <groupId>commons-collections</groupId> <artifactId>commons-collections</artifactId> + <version>3.2.1</version> + <scope>compile</scope> </dependency> <dependency> <groupId>commons-beanutils</groupId> <artifactId>commons-beanutils</artifactId> + <version>1.7.0</version> + <scope>compile</scope> </dependency> - <dependency> - <groupId>org.apache.maven</groupId> - <artifactId>maven-toolchain</artifactId> - </dependency> + </dependencies> @@ -70,85 +69,25 @@  <labs.id>12</labs.id> - <labs.project>lutinutil</labs.project> +  +  +  -  -  - -  - <maven.compile.source>1.6</maven.compile.source> - <maven.compile.target>1.6</maven.compile.target> - <maven.compile.encoding>UTF-8</maven.compile.encoding> - -  - <labs.lists>http://lists.labs.libre-entreprise.org/mailman/listinfo/lutinutil</labs.lists> - -  - <maven.scm.developerConnection>scm:svn:svn+ssh://${username}@${labs.host}/svnroot/lutinutil/trunk - </maven.scm.developerConnection> - -  - <maven.scm.connection>scm:svn:svn:anonymous@${labs.host}/svnroot/lutinutil/trunk</maven.scm.connection> - + <maven.test.testFailureIgnore>true</maven.test.testFailureIgnore> </properties> - <profiles> - <profile> - <id>project</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>tests</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>site</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>false</maven.test.skip> - <maven.reports.generate>true</maven.reports.generate> - </properties> - </profile> - </profiles> + <scm> + <url>${maven.scm.url}</url> + </scm> -  - <issueManagement> - <url>http://labs.libre-entreprise.org/tracker/?group_id=12</url> - </issueManagement> <build> <plugins> + +  <plugin> <groupId>lutinplugin</groupId> <artifactId>maven-i18n-plugin</artifactId> -  - <configuration> - <bundles> - <param>fr_FR</param> - <param>en_GB</param> - </bundles> - <src>${maven.src.dir}/main/resources/i18n</src> - <defaultBasedir>${maven.src.dir}/main/java</defaultBasedir> - <keysModifier>false</keysModifier> - <keepBackup>false</keepBackup> - </configuration> <executions> <execution> <phase>process-resources</phase> @@ -159,97 +98,30 @@ </execution> </executions> </plugin> -  + +  <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-source-plugin</artifactId> - <executions> - <execution> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> + <groupId>lutinplugin</groupId> + <artifactId>maven-jrst-plugin</artifactId> + <configuration> +  +  +  + </configuration> </plugin> -  + <plugin> <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-javadoc-plugin</artifactId> - <executions> - <execution> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> + <artifactId>maven-site-plugin</artifactId> <configuration> -  - <encoding>${maven.compile.encoding}</encoding> +  +  +  </configuration> + </plugin> + </plugins> </build> - <dependencyManagement> - <dependencies> - - <dependency> - <groupId>log4j</groupId> - <artifactId>log4j</artifactId> - <version>1.2.14</version> - <scope>compile</scope> - </dependency> - - <dependency> - <groupId>commons-logging</groupId> - <artifactId>commons-logging</artifactId> - <version>1.1.1</version> - <scope>compile</scope> - </dependency> - - <dependency> - <groupId>commons-primitives</groupId> - <artifactId>commons-primitives</artifactId> - <version>1.0</version> - <scope>compile</scope> - </dependency> - - <dependency> - <groupId>commons-collections</groupId> - <artifactId>commons-collections</artifactId> - <version>3.2.1</version> - <scope>compile</scope> - </dependency> - - <dependency> - <groupId>commons-beanutils</groupId> - <artifactId>commons-beanutils</artifactId> - <version>1.7.0</version> - <scope>compile</scope> - </dependency> - <dependency> - <groupId>org.apache.maven</groupId> - <artifactId>maven-toolchain</artifactId> - <version>1.0</version> - <scope>test</scope> - </dependency> - -  - <dependency> - <groupId>lutinplugin</groupId> - <artifactId>maven-i18n-plugin</artifactId> - <version>0.4</version> - </dependency> - - </dependencies> - </dependencyManagement> - - -  - </project> Modified: trunk/lutinutil/src/site/site.xml =================================================================== --- trunk/lutinutil/src/site/site.xml 2008-08-12 17:35:52 UTC (rev 1013) +++ trunk/lutinutil/src/site/site.xml 2008-08-12 22:56:14 UTC (rev 1014) @@ -1,43 +1,52 @@ -<?xml version="1.0" encoding="ISO-8859-1"?> +<?xml version="1.0" encoding="UTF-8"?> <project name="LutinUtil"> - <skin> - <groupId>lutinlib</groupId> - <artifactId>lutin-site-skin</artifactId> - <version>0.1</version> - </skin> - - <bannerLeft> - <name>Lutin Util</name> - </bannerLeft> - - <bannerRight> - <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> - <href>http://www.codelutin.com</href> - </bannerRight> + <skin> + <groupId>lutinlib</groupId> + <artifactId>lutin-site-skin</artifactId> + <version>0.1</version> + </skin> + <bannerLeft> + <name>Lutin Util</name> + </bannerLeft> + + <bannerRight> + <src>http://www.codelutin.com/images/lutinorange-codelutin.png</src> + <href>${project.organization.url}</href> + </bannerRight> + <poweredBy> - <logo href="http://maven.apache.org" name="Maven" img="images/logos/maven-feather.png"/> - <logo href="http://jrst.labs.libre-entreprise.org" name="JRst" img="images/jrst-logo.png"/> - <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="images/restructuredtext-logo.png"/> - </poweredBy> + <logo href="http://maven.apache.org" name="Maven" img="images/logos/maven-feather.png"/> + <logo href="http://jrst.labs.libre-entreprise.org" name="JRst" img="images/jrst-logo.png"/> + <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" + img="images/restructuredtext-logo.png"/> + </poweredBy> - <body> - <links> - <item name="Labs" href="http://labs.libre-entreprise.org/"/> - <item name="Code Lutin" href="http://www.codelutin.com/"/> - </links> + <body> + <links> + <item name="Labs" href="http://labs.libre-entreprise.org/"/> + <item name="${project.organization.name}" href="${project.organization.url}"/> + </links> - <menu name="Utilisateur"> - <item name="Accueil" href="index.html"/> - <item href="http://lutinbuilder.labs.libre-entreprise.org/maven2/lutinlib/lutinutil/" name="T�l�chargement"/> - </menu> + <menu name="Utilisateur"> + <item name="Accueil" href="abstract.html"/> + <item name="Documentation" href="/LutinUtil.html"/> + </menu> - <menu name="D�veloppeur"> - <item name="A faire" href="Todo.html"/> - </menu> + <menu name="Téléchargement"> + <item href="${labs.builder.url}/org/codelutin/${project.artifactId}/${project.version}" + name="Télécharger la dernière version"/> + <item href="${labs.builder.url}/org/codelutin/${project.artifactId}" + name="Voir toutes les versions"/> + </menu> - ${reports} + <menu name="Développeur"> + <item name="A faire" href="Todo.html"/> + <item name="CommandLineArgumentApplication" href="/CommandLineArgumentApplication.html"/> + </menu> - </body> + <menu ref="reports"/> + + </body> </project> Copied: trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst (from rev 1013, trunk/lutinutil/src/site/xdoc/fr/rst/index.rst) =================================================================== (Binary files differ) Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/abstract.rst ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Deleted: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst =================================================================== (Binary files differ) Deleted: trunk/lutinutil/src/site/xdoc/navigation.xml =================================================================== --- trunk/lutinutil/src/site/xdoc/navigation.xml 2008-08-12 17:35:52 UTC (rev 1013) +++ trunk/lutinutil/src/site/xdoc/navigation.xml 2008-08-12 22:56:14 UTC (rev 1014) @@ -1,19 +0,0 @@ -<?xml version="1.0" encoding="ISO-8859-15"?> - -<project name="Lutin Util"> - <title>Lutin Util</title> - <body> - <links> - <item href="http://labs.libre-entreprise.org/" name="Labs"></item> - <item href="http://www.codelutin.com/" name="Code Lutin"></item> - </links> - <menu name="Utilisateur"> - <item href="/LutinUtil.html" name="Documentation"></item> - <item href="http://lutinbuilder.labs.libre-entreprise.org/maven/lutinlib/jars/" name="T�l�chargement"></item> - </menu> - <menu name="Developpeur"> - <item href="/Todo.html" name="Todo"></item> - <item href="/Todo.html" name="Todo"></item> - </menu> - </body> -</project>

1 0

[Lutinutil-commits] r1013 - in trunk/lutinutil: doc src/site src/site/xdoc src/site/xdoc/fr src/site/xdoc/fr/rst
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 17:35:52 +0000 (Tue, 12 Aug 2008) New Revision: 1013 Added: trunk/lutinutil/src/site/xdoc/ trunk/lutinutil/src/site/xdoc/fr/ trunk/lutinutil/src/site/xdoc/fr/rst/ trunk/lutinutil/src/site/xdoc/fr/rst/CommandLineArgumentApplication.rst trunk/lutinutil/src/site/xdoc/fr/rst/LutinUtil.rst trunk/lutinutil/src/site/xdoc/fr/rst/Todo.rst trunk/lutinutil/src/site/xdoc/fr/rst/index.rst Removed: trunk/lutinutil/doc/CommandLineArgumentApplication.rst trunk/lutinutil/doc/LutinUtil.rst trunk/lutinutil/doc/Todo.rst trunk/lutinutil/doc/index.rst trunk/lutinutil/src/site/xdocs/ Modified: trunk/lutinutil/src/site/xdoc/navigation.xml Log: deplacement vers le repertoire par defaut de site Deleted: trunk/lutinutil/doc/CommandLineArgumentApplication.rst =================================================================== --- trunk/lutinutil/doc/CommandLineArgumentApplication.rst 2008-08-12 16:51:11 UTC (rev 1012) +++ trunk/lutinutil/doc/CommandLineArgumentApplication.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -1,124 +0,0 @@ -====================== -Argument d'application -====================== - -Il y a deux type d'argument d'application: -- les arguments permettant de modifier la configuration qui peuvent aussi - être dans un fichier de configuration ou en variable d'environnement. -- les arguments permettant d'indiquer des actions a faire a l'application - -Les options de configuration -============================ - -Les options de configuration peuvent être décrit directement par un POJO -avec des annotations:: - - @OptionConfigOrder("resource MonApp.properties", "file /etc/MonApp.properties", - "optionfile configFile", "env", "line") - public class MonAppConfig extends OptionConfig { - - @Option - @OptionSaveFile - public File configFile = new File("$HOME/.MonApp"); - - @Option(pattern [^\s]+) - public String username = "anonyous"; - - @Option(pattern ..) - public String lang = "fr"; - - @Option(pattern ..) - public String country = "FR"; - - @Option - public boolean showGui = true; - - @Option(min=10, max=10) - public List<Integer> value; - - @Unparsed - public List<String> other; - } - -La classe OptionConfig ----------------------- - -La classe OptionConfig contient plusieurs méthodes: - -- load sans argument qui permet de charger le POJO en fonction de - OptionConfigOrder -- load(File) qui permet de charger le POJO seulement en fonction d'un - fichier. Il bien sur possible d'appeler load() puis load(File). -- save qui permet de sauver les informations du POJO, le fichier ou sauver - les options est indiqué par l'annotation @OptionSaveFile - -Annotation OptionConfigOrder ----------------------------- - -OptionConfigOrder permet de déterminer l'ordre de recherche de la bonne -valeur des options. Le dernier indiqué sera le dernier lu et donc celui qui -aura raison. - -resource - indique un fichier resource a rechercher dans le classpath - -file - indique un fichier sur le systeme de fichier - -optionfile - indique un fichier dont le chemin est indiqué par une option - -env - indique les variables d'environnement du processus - -line - indique les options sur la ligne de commande - -Implantation -~~~~~~~~~~~~ - -# On charge dans un objet **Properties** chaque entre de - **OptionConfigOrder** sauf **optionfile** s'il y en a. -# On chaine tous les fichiers de proprietes pour pouvoir demander - l'information au dernier qui recherchera lui meme dans son pere s'il n'a pas - l'informaiton. -# Pour chaque **optionfile** on demande sa valeur, on crée le fichier de - propriété et on l'ajoute dans la chaine à la bonne place -# Pour chaque option trouvé dans le POJO on met a jour sa valeur avec la - valeur trouvé dans les propriétés. - -Annotation Option ------------------ - -Indique une option possible. Elle peut contenir: - -- description -- pattern -- alias -- min -- max - -Par defaut l'option sur la ligne de commande sera le nom de la variable precedé de -- - -Annotation Unparsed -------------------- - -Indique que toutes les options de la ligne de commande non reconnu finisse dans ce champs -Il est possible de type la collection autrement que par String. - -Annotation OptionSaveFile -------------------------- - -Indique le fichier a utiliser pour sauver les options - -Les actions -=========== - -TODO: comment différencier les actions des options ? comment reutiliser le travail de tony ? - -Amélioration possible -===================== - -- Générer automatiquement par un plugin maven les methodes get/set sur les options -- Gérer les options read/write et read -- un plugin maven qui verifie la coherence des options Deleted: trunk/lutinutil/doc/LutinUtil.rst =================================================================== --- trunk/lutinutil/doc/LutinUtil.rst 2008-08-12 16:51:11 UTC (rev 1012) +++ trunk/lutinutil/doc/LutinUtil.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -1,100 +0,0 @@ -========================= -Documentation - LutinUtil -========================= - -:Authors: Benjamin POUSSIN -:Contact: poussin(a)codelutin.com -:Revision: $Revision$ -:Date: $Date$ - -.. sectnum:: - -.. contents:: - - -LutinUtil contient un ensemble de librairies trop petites pour avoir -leur propre projet. Elles sont aussi utile à la plupart des projets de -Code Lutin. - - -Resource -======== - -Cette librairie permet de rechercher une ressource dans le maximum -d'endroit possible et si elle est trouvée l'url de la ressource est -retournée. - -:: - - import org.codelutin.util.Resource; - import java.net.URL; - ... - URL image = Resource.getURL("/images/bidulle.png"); - ... - -Dans cet exemple l'image est recherchée sur le système de fichier -local, si elle n'est pas trouvée, elle est recherché dans le -classpath, et si elle n'est toujours pas trouvée une exception est -alors levée. - - -ArgumentsParser -=============== - -Cette librairie permet de traiter les arguments de la ligne de commande de -façon simple mais évoluable. Son principe de fonctionnement est que l'on -déclare les arguements que l'on attend sur la ligne de commande avec le nombre -de paramètre qu'ils prennent et une petite description de l'option. Ensuite -on dispose de toutes les fonctions utiles pour le traitement de la ligne de -commande. - -Voici un exemple d'utilisation:: - - import org.codelutin.util.ArgumentsParser; - ... - ArgumentsParser parser = new ArgumentsParser("ToPIA"); - - parser.addOption("version", "affiche le numéro de version", new String[]{"--version", "-v"}, 0).setRepetitionMax(1); - - parser.addOption("help", "affiche l'aide de topia", new String[]{"--help", "-h"}, 0).setRepetitionMax(1); - - parser.addOption("start", "Lancement d'une application", new - String[]{"--start", "-s"}, 1).setRepetitionMax(1); - - System.out.println(parser.checkCoherence()); - parser.parse(args); - - if(parser.hasParsedOption("help")){ - System.out.println(parser.usage()); - }else if (parser.hasParsedOption("start")){ - System.out.println ("--> Executing application: "); - String arg = parser.getParsedOption("start") - new Application(arg); - }else if (parser.hasParsedOption("version")){ - System.out.println( "- Topia version 0.01 - " + - "Get new release at http://www.codelutin.com/ -" ); - } - -Cette librairie permet d'afficher l'aide de la ligne de commande:: - - System.out.println(parser.usage()); - -Elle permet aussi de vérifier le nombre de fois qu'une option de la ligne de -commande est présente et que ce nombre est bien compris dans l'ensemble des -valeurs acceptées, grâce au méthode *setRepetitionMax*, et *setRepetitionMin*. - -Si l'implantation par défaut du parseur d'option ne convient pas pour une de vos -option, par exemple si le nombre de paramètre de l'option varie suivant la valeur -du premier paramètre vous pouvez alors écrire votre propre Parser pour cette -Option et l'utilisée avec les autres. - - -Log -=== - -Cette objet permet de suivre ce que fait une application simplement. Le -développeur indique grâce à cette classe l'état dans lequel l'application est. - -Ensuite, il peut mettre des listeners sur cette classe qui afficheront -les messages qui ont été envoyés. Ou afficheront l'état d'une tâche en train -de s'exécuter. Deleted: trunk/lutinutil/doc/Todo.rst =================================================================== --- trunk/lutinutil/doc/Todo.rst 2008-08-12 16:51:11 UTC (rev 1012) +++ trunk/lutinutil/doc/Todo.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -1,80 +0,0 @@ -Un nouveau parser d'argument -============================ - -L'idée est d'avoir une description simple des arguments et de leur type et -que soit généré une classe à partir de cette description. Dans le -programme il suffirat de demander à la classe généré les inforamtions. - -Les options sont chargées par leur valeur par defaut, puis sont surchargées -par les valeurs des fichiers de configurations, puis surchargé -par les valeurs des variables d'environnement, et enfin surchargé par les -valeurs de la ligne de commande. - -Les fichiers de configuraiton sont lu dans l'ordre suivant: /etc/ + chemin -indiqué, puis $HOME/. + chemin indiqué. - -si le chemin indiqué est titi/toto.conf et que l'on est sur un système Linux -les fichiers de configuration seront: /etc/titi/toto.conf et -~/.titi/toto.conf - -exemple de description ----------------------- - -Par exemple on pourrait avoir le fichier Toto.java.conf dans les sources du -projet qui fournirait le fichier Toto.java:: - - configfile: titi/toto.conf - - outFile: le fichier de sortie - short: o - long: outfile - default: - - type: File - environment: toto - - number: Le nombre de fichier à produire - required: 1 - short: n - default: 1 - long: number - condition: 0<Number && Number<10 - type: int - -La description commence l'option non obligatoire *configfile* qui donne le -nom du fichier de configuration à utiliser pour l'application. Puis on -trouve les options. Une option commence par un nom, puis sa description -ensuite l'option peut avoir plusieurs options: - -- short: l'option courte sur la ligne de commande. Si absente pas d'option - courte -- long: l'option longue sur la ligne de commande, si pas d'option, on - reprend le nom de l'option -- type: le type de l'option (int, Float, String, char, File, ...) -- default: la valeur par default, si elle n'est pas specifier sur la ligne - de commande, ni dans les variables d'environnement ni dans le fichier de - configuration. Pour une option de type File si default faut -, alors - le fichier est la sortie standard. -- condition: la condition que doit respecter l'option pour être valide - la condition est une expression java contenant le nom de l'option comme - valeur de variable. -- environment: le nom de la variable d'environnement qu'il faut utiliser - si l'option n'est pas retrouve sur la ligne de commande. Si cette option - n'est pas indiqué alors, la variable d'environnement recherchée est le nom - du fichier de description suivi d'un point, suivi du nom de l'option. - par exemple toto.outfile - - -L'objet résultat sera Toto placé dans le fichier Toto.java. L'extension -java.conf est obligatoire pour détecter un fichier de configuration à -parser. Cet objet aurai les méthodes getOutputFile():File et getNumber():int - -Librairies utilisé ------------------- - -Sans doute utilisé, le parser redwood pour le fichier de configuration -http://www.isellrenohomes.com/parser/. Il lit directement des EBNF. - -projet de parsage d'argument ----------------------------- - -http://www.martiansoftware.com/jsap/ Deleted: trunk/lutinutil/doc/index.rst =================================================================== (Binary files differ) Copied: trunk/lutinutil/src/site/xdoc (from rev 1012, trunk/lutinutil/src/site/xdocs) Copied: trunk/lutinutil/src/site/xdoc/fr/rst/CommandLineArgumentApplication.rst (from rev 1012, trunk/lutinutil/doc/CommandLineArgumentApplication.rst) =================================================================== --- trunk/lutinutil/src/site/xdoc/fr/rst/CommandLineArgumentApplication.rst (rev 0) +++ trunk/lutinutil/src/site/xdoc/fr/rst/CommandLineArgumentApplication.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -0,0 +1,124 @@ +====================== +Argument d'application +====================== + +Il y a deux type d'argument d'application: +- les arguments permettant de modifier la configuration qui peuvent aussi + être dans un fichier de configuration ou en variable d'environnement. +- les arguments permettant d'indiquer des actions a faire a l'application + +Les options de configuration +============================ + +Les options de configuration peuvent être décrit directement par un POJO +avec des annotations:: + + @OptionConfigOrder("resource MonApp.properties", "file /etc/MonApp.properties", + "optionfile configFile", "env", "line") + public class MonAppConfig extends OptionConfig { + + @Option + @OptionSaveFile + public File configFile = new File("$HOME/.MonApp"); + + @Option(pattern [^\s]+) + public String username = "anonyous"; + + @Option(pattern ..) + public String lang = "fr"; + + @Option(pattern ..) + public String country = "FR"; + + @Option + public boolean showGui = true; + + @Option(min=10, max=10) + public List<Integer> value; + + @Unparsed + public List<String> other; + } + +La classe OptionConfig +---------------------- + +La classe OptionConfig contient plusieurs méthodes: + +- load sans argument qui permet de charger le POJO en fonction de + OptionConfigOrder +- load(File) qui permet de charger le POJO seulement en fonction d'un + fichier. Il bien sur possible d'appeler load() puis load(File). +- save qui permet de sauver les informations du POJO, le fichier ou sauver + les options est indiqué par l'annotation @OptionSaveFile + +Annotation OptionConfigOrder +---------------------------- + +OptionConfigOrder permet de déterminer l'ordre de recherche de la bonne +valeur des options. Le dernier indiqué sera le dernier lu et donc celui qui +aura raison. + +resource + indique un fichier resource a rechercher dans le classpath + +file + indique un fichier sur le systeme de fichier + +optionfile + indique un fichier dont le chemin est indiqué par une option + +env + indique les variables d'environnement du processus + +line + indique les options sur la ligne de commande + +Implantation +~~~~~~~~~~~~ + +# On charge dans un objet **Properties** chaque entre de + **OptionConfigOrder** sauf **optionfile** s'il y en a. +# On chaine tous les fichiers de proprietes pour pouvoir demander + l'information au dernier qui recherchera lui meme dans son pere s'il n'a pas + l'informaiton. +# Pour chaque **optionfile** on demande sa valeur, on crée le fichier de + propriété et on l'ajoute dans la chaine à la bonne place +# Pour chaque option trouvé dans le POJO on met a jour sa valeur avec la + valeur trouvé dans les propriétés. + +Annotation Option +----------------- + +Indique une option possible. Elle peut contenir: + +- description +- pattern +- alias +- min +- max + +Par defaut l'option sur la ligne de commande sera le nom de la variable precedé de -- + +Annotation Unparsed +------------------- + +Indique que toutes les options de la ligne de commande non reconnu finisse dans ce champs +Il est possible de type la collection autrement que par String. + +Annotation OptionSaveFile +------------------------- + +Indique le fichier a utiliser pour sauver les options + +Les actions +=========== + +TODO: comment différencier les actions des options ? comment reutiliser le travail de tony ? + +Amélioration possible +===================== + +- Générer automatiquement par un plugin maven les methodes get/set sur les options +- Gérer les options read/write et read +- un plugin maven qui verifie la coherence des options Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/CommandLineArgumentApplication.rst ___________________________________________________________________ Name: svn:keywords + Author Date Id Revision Name: svn:eol-style + native Copied: trunk/lutinutil/src/site/xdoc/fr/rst/LutinUtil.rst (from rev 1012, trunk/lutinutil/doc/LutinUtil.rst) =================================================================== --- trunk/lutinutil/src/site/xdoc/fr/rst/LutinUtil.rst (rev 0) +++ trunk/lutinutil/src/site/xdoc/fr/rst/LutinUtil.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -0,0 +1,100 @@ +========================= +Documentation - LutinUtil +========================= + +:Authors: Benjamin POUSSIN +:Contact: poussin(a)codelutin.com +:Revision: $Revision$ +:Date: $Date$ + +.. sectnum:: + +.. contents:: + + +LutinUtil contient un ensemble de librairies trop petites pour avoir +leur propre projet. Elles sont aussi utile à la plupart des projets de +Code Lutin. + + +Resource +======== + +Cette librairie permet de rechercher une ressource dans le maximum +d'endroit possible et si elle est trouvée l'url de la ressource est +retournée. + +:: + + import org.codelutin.util.Resource; + import java.net.URL; + ... + URL image = Resource.getURL("/images/bidulle.png"); + ... + +Dans cet exemple l'image est recherchée sur le système de fichier +local, si elle n'est pas trouvée, elle est recherché dans le +classpath, et si elle n'est toujours pas trouvée une exception est +alors levée. + + +ArgumentsParser +=============== + +Cette librairie permet de traiter les arguments de la ligne de commande de +façon simple mais évoluable. Son principe de fonctionnement est que l'on +déclare les arguements que l'on attend sur la ligne de commande avec le nombre +de paramètre qu'ils prennent et une petite description de l'option. Ensuite +on dispose de toutes les fonctions utiles pour le traitement de la ligne de +commande. + +Voici un exemple d'utilisation:: + + import org.codelutin.util.ArgumentsParser; + ... + ArgumentsParser parser = new ArgumentsParser("ToPIA"); + + parser.addOption("version", "affiche le numéro de version", new String[]{"--version", "-v"}, 0).setRepetitionMax(1); + + parser.addOption("help", "affiche l'aide de topia", new String[]{"--help", "-h"}, 0).setRepetitionMax(1); + + parser.addOption("start", "Lancement d'une application", new + String[]{"--start", "-s"}, 1).setRepetitionMax(1); + + System.out.println(parser.checkCoherence()); + parser.parse(args); + + if(parser.hasParsedOption("help")){ + System.out.println(parser.usage()); + }else if (parser.hasParsedOption("start")){ + System.out.println ("--> Executing application: "); + String arg = parser.getParsedOption("start") + new Application(arg); + }else if (parser.hasParsedOption("version")){ + System.out.println( "- Topia version 0.01 - " + + "Get new release at http://www.codelutin.com/ -" ); + } + +Cette librairie permet d'afficher l'aide de la ligne de commande:: + + System.out.println(parser.usage()); + +Elle permet aussi de vérifier le nombre de fois qu'une option de la ligne de +commande est présente et que ce nombre est bien compris dans l'ensemble des +valeurs acceptées, grâce au méthode *setRepetitionMax*, et *setRepetitionMin*. + +Si l'implantation par défaut du parseur d'option ne convient pas pour une de vos +option, par exemple si le nombre de paramètre de l'option varie suivant la valeur +du premier paramètre vous pouvez alors écrire votre propre Parser pour cette +Option et l'utilisée avec les autres. + + +Log +=== + +Cette objet permet de suivre ce que fait une application simplement. Le +développeur indique grâce à cette classe l'état dans lequel l'application est. + +Ensuite, il peut mettre des listeners sur cette classe qui afficheront +les messages qui ont été envoyés. Ou afficheront l'état d'une tâche en train +de s'exécuter. Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/LutinUtil.rst ___________________________________________________________________ Name: svn:keywords + Author Date Id Revision Name: svn:eol-style + native Copied: trunk/lutinutil/src/site/xdoc/fr/rst/Todo.rst (from rev 1012, trunk/lutinutil/doc/Todo.rst) =================================================================== --- trunk/lutinutil/src/site/xdoc/fr/rst/Todo.rst (rev 0) +++ trunk/lutinutil/src/site/xdoc/fr/rst/Todo.rst 2008-08-12 17:35:52 UTC (rev 1013) @@ -0,0 +1,80 @@ +Un nouveau parser d'argument +============================ + +L'idée est d'avoir une description simple des arguments et de leur type et +que soit généré une classe à partir de cette description. Dans le +programme il suffirat de demander à la classe généré les inforamtions. + +Les options sont chargées par leur valeur par defaut, puis sont surchargées +par les valeurs des fichiers de configurations, puis surchargé +par les valeurs des variables d'environnement, et enfin surchargé par les +valeurs de la ligne de commande. + +Les fichiers de configuraiton sont lu dans l'ordre suivant: /etc/ + chemin +indiqué, puis $HOME/. + chemin indiqué. + +si le chemin indiqué est titi/toto.conf et que l'on est sur un système Linux +les fichiers de configuration seront: /etc/titi/toto.conf et +~/.titi/toto.conf + +exemple de description +---------------------- + +Par exemple on pourrait avoir le fichier Toto.java.conf dans les sources du +projet qui fournirait le fichier Toto.java:: + + configfile: titi/toto.conf + + outFile: le fichier de sortie + short: o + long: outfile + default: - + type: File + environment: toto + + number: Le nombre de fichier à produire + required: 1 + short: n + default: 1 + long: number + condition: 0<Number && Number<10 + type: int + +La description commence l'option non obligatoire *configfile* qui donne le +nom du fichier de configuration à utiliser pour l'application. Puis on +trouve les options. Une option commence par un nom, puis sa description +ensuite l'option peut avoir plusieurs options: + +- short: l'option courte sur la ligne de commande. Si absente pas d'option + courte +- long: l'option longue sur la ligne de commande, si pas d'option, on + reprend le nom de l'option +- type: le type de l'option (int, Float, String, char, File, ...) +- default: la valeur par default, si elle n'est pas specifier sur la ligne + de commande, ni dans les variables d'environnement ni dans le fichier de + configuration. Pour une option de type File si default faut -, alors + le fichier est la sortie standard. +- condition: la condition que doit respecter l'option pour être valide + la condition est une expression java contenant le nom de l'option comme + valeur de variable. +- environment: le nom de la variable d'environnement qu'il faut utiliser + si l'option n'est pas retrouve sur la ligne de commande. Si cette option + n'est pas indiqué alors, la variable d'environnement recherchée est le nom + du fichier de description suivi d'un point, suivi du nom de l'option. + par exemple toto.outfile + + +L'objet résultat sera Toto placé dans le fichier Toto.java. L'extension +java.conf est obligatoire pour détecter un fichier de configuration à +parser. Cet objet aurai les méthodes getOutputFile():File et getNumber():int + +Librairies utilisé +------------------ + +Sans doute utilisé, le parser redwood pour le fichier de configuration +http://www.isellrenohomes.com/parser/. Il lit directement des EBNF. + +projet de parsage d'argument +---------------------------- + +http://www.martiansoftware.com/jsap/ Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/Todo.rst ___________________________________________________________________ Name: svn:keywords + Author Date Id Revision Name: svn:eol-style + native Copied: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst (from rev 1012, trunk/lutinutil/doc/index.rst) =================================================================== (Binary files differ) Property changes on: trunk/lutinutil/src/site/xdoc/fr/rst/index.rst ___________________________________________________________________ Name: svn:mime-type + application/octet-stream Modified: trunk/lutinutil/src/site/xdoc/navigation.xml =================================================================== --- trunk/lutinutil/src/site/xdocs/navigation.xml 2008-08-12 16:51:11 UTC (rev 1012) +++ trunk/lutinutil/src/site/xdoc/navigation.xml 2008-08-12 17:35:52 UTC (rev 1013) @@ -13,6 +13,7 @@ </menu> <menu name="Developpeur"> <item href="/Todo.html" name="Todo"></item> + <item href="/Todo.html" name="Todo"></item> </menu> </body> </project>

1 0

[Lutinutil-commits] r1012 - in trunk/lutinutil: . src/site
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 16:51:11 +0000 (Tue, 12 Aug 2008) New Revision: 1012 Added: trunk/lutinutil/src/site/xdocs/ Removed: trunk/lutinutil/xdocs/ Log: deplacement vers le repertoire par defaut de site Copied: trunk/lutinutil/src/site/xdocs (from rev 999, trunk/lutinutil/xdocs)

1 0

[Lutinutil-commits] r1011 - in trunk/lutinutil: . src
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 16:34:59 +0000 (Tue, 12 Aug 2008) New Revision: 1011 Added: trunk/lutinutil/src/site/ Removed: trunk/lutinutil/site/ Log: deplacement vers le repertoire par defaut de site Copied: trunk/lutinutil/src/site (from rev 999, trunk/lutinutil/site)

1 0

[Lutinutil-commits] r1010 - trunk/lutinutil/src/main/java/org/codelutin/i18n/bundle
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 16:31:16 +0000 (Tue, 12 Aug 2008) New Revision: 1010 Modified: trunk/lutinutil/src/main/java/org/codelutin/i18n/bundle/I18nBundleEntry.java Log: add log on i18n entries loaded to debug UTF-8 problem Modified: trunk/lutinutil/src/main/java/org/codelutin/i18n/bundle/I18nBundleEntry.java =================================================================== --- trunk/lutinutil/src/main/java/org/codelutin/i18n/bundle/I18nBundleEntry.java 2008-08-12 16:22:09 UTC (rev 1009) +++ trunk/lutinutil/src/main/java/org/codelutin/i18n/bundle/I18nBundleEntry.java 2008-08-12 16:31:16 UTC (rev 1010) @@ -24,6 +24,7 @@ import java.io.InputStream; import java.net.URL; import java.util.Locale; +import java.util.Map.Entry; import java.util.Properties; /** @@ -123,7 +124,13 @@ try { I18nFileReader fileReader = new I18nFileReader(); inputStream = getPath().openStream(); - fileReader.load(inputStream, language.getEncoding()); + String encoding = language.getEncoding(); + fileReader.load(inputStream, encoding); + if (I18nBundle.log.isDebugEnabled()) { + for (Entry<Object, Object> entry : resource.entrySet()) { + I18nBundle.log.debug(encoding + " : " + entry); + } + } resource.putAll(fileReader); fileReader.clear(); if (I18nBundle.log.isDebugEnabled()) {

1 0

[Lutinutil-commits] r1009 - tags
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 16:22:09 +0000 (Tue, 12 Aug 2008) New Revision: 1009 Added: tags/lutinutil_before_lutinproject:2.4/ Log: taggage avant l'utilisation du super-pom org.codelutin:lutinproject:2.4 Copied: tags/lutinutil_before_lutinproject:2.4 (from rev 1008, trunk/lutinutil)

1 0

[Lutinutil-commits] r1008 - in trunk/commandline: . commandline-core commandline-demo commandline-ui commandline-ui-action maven-plugin
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 14:41:55 +0000 (Tue, 12 Aug 2008) New Revision: 1008 Modified: trunk/commandline/commandline-core/pom.xml trunk/commandline/commandline-demo/pom.xml trunk/commandline/commandline-ui-action/pom.xml trunk/commandline/commandline-ui/pom.xml trunk/commandline/maven-plugin/pom.xml trunk/commandline/pom.xml Log: utilisation de org.codelutin:lutinproject:2.4 :) Modified: trunk/commandline/commandline-core/pom.xml =================================================================== --- trunk/commandline/commandline-core/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/commandline-core/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -7,14 +7,14 @@ <parent> <groupId>org.codelutin.commandline</groupId> <artifactId>commandline-pom</artifactId> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> </parent> <artifactId>commandline-core</artifactId> <name>core</name> <packaging>jar</packaging> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description>lutincommandline core library</description> <build> @@ -25,7 +25,6 @@ <artifactId>maven-i18n-plugin</artifactId> <executions> <execution> - <phase>compile</phase> <goals> <goal>parserJava</goal> <goal>gen</goal> Modified: trunk/commandline/commandline-demo/pom.xml =================================================================== --- trunk/commandline/commandline-demo/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/commandline-demo/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -12,7 +12,7 @@ <parent> <groupId>org.codelutin.commandline</groupId> <artifactId>commandline-pom</artifactId> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> </parent> <artifactId>commandline-demo</artifactId> @@ -53,7 +53,7 @@  <name>commandline-demo</name> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description>commandline demo module</description>  @@ -71,55 +71,16 @@ <build> <plugins> + <plugin> - <groupId>lutinplugin</groupId> - <artifactId>maven-i18n-plugin</artifactId> - <executions> -  - <execution> - <id>java</id> - <phase>compile</phase> - <configuration> - <entries> - <entry> - <basedir>${maven.gen.dir}/java</basedir> - </entry> - </entries> - </configuration> - <goals> - <goal>parserJava</goal> - <goal>gen</goal> - </goals> - </execution> - </executions> + <groupId>org.codelutin.jaxx</groupId> + <artifactId>maven-jaxx-plugin</artifactId> </plugin> <plugin> <groupId>org.codelutin.commandline</groupId> <artifactId>maven-commandline-plugin</artifactId> - <version>${current.version}</version> + <version>0.9</version> <configuration> <prefix>CommandLineDemo</prefix> <packageName>org.codelutin.commandline.demo</packageName> @@ -128,7 +89,6 @@ <execution> <inherited>false</inherited>  - <phase>process-resources</phase> <id>genJava</id> <goals> <goal>genJava</goal> @@ -162,13 +122,44 @@ </plugin> <plugin> - <groupId>org.codelutin.jaxx</groupId> - <artifactId>maven-jaxx-plugin</artifactId> + <groupId>lutinplugin</groupId> + <artifactId>maven-i18n-plugin</artifactId> <executions> +  <execution> - <id>generate jaxx</id> + <id>java</id> + <configuration> + <entries> + <entry> + <basedir>${maven.gen.dir}/java</basedir> + </entry> + </entries> + </configuration> <goals> - <goal>generate</goal> + <goal>parserJava</goal> + <goal>gen</goal> </goals> </execution> </executions> Modified: trunk/commandline/commandline-ui/pom.xml =================================================================== --- trunk/commandline/commandline-ui/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/commandline-ui/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -12,7 +12,7 @@ <parent> <groupId>org.codelutin.commandline</groupId> <artifactId>commandline-pom</artifactId> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> </parent> <artifactId>commandline-ui</artifactId> @@ -37,7 +37,7 @@   <name>ui</name> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description>lutin commandline UI librairy</description> <inceptionYear>2008</inceptionYear> @@ -55,21 +55,6 @@ <plugin> <groupId>org.codelutin.jaxx</groupId> <artifactId>maven-jaxx-plugin</artifactId> - <executions> - <execution> - <goals> - <goal>generate</goal> - </goals> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>org.codelutin.jaxx</groupId> - <artifactId>jaxx-swing</artifactId> - <scope>compile</scope> - <version>${jaxx.version}</version> - </dependency> - </dependencies> </plugin>  @@ -78,7 +63,6 @@ <artifactId>maven-i18n-plugin</artifactId> <executions> <execution> - <phase>compile</phase> <configuration> <entries> <entry> Modified: trunk/commandline/commandline-ui-action/pom.xml =================================================================== --- trunk/commandline/commandline-ui-action/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/commandline-ui-action/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -11,7 +11,7 @@ <parent> <groupId>org.codelutin.commandline</groupId> <artifactId>commandline-pom</artifactId> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> </parent> <artifactId>commandline-ui-action</artifactId> @@ -35,7 +35,7 @@  <name>commandine-ui-action</name> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description>basic actions implemented using jaxx-swing-action framework</description>  @@ -52,22 +52,6 @@ <plugin> <groupId>org.codelutin.jaxx</groupId> <artifactId>maven-jaxx-plugin</artifactId> - <executions> - <execution> - <phase>process-sources</phase> - <goals> - <goal>generate</goal> - </goals> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>org.codelutin.jaxx</groupId> - <artifactId>jaxx-swing</artifactId> - <scope>compile</scope> - <version>${jaxx.version}</version> - </dependency> - </dependencies> </plugin>  @@ -79,7 +63,6 @@ <executions> <execution> <id>javaActionConfig</id> - <phase>process-resources</phase> <goals> <goal>parserJavaActionConfig</goal> </goals> @@ -100,7 +83,6 @@ </execution> <execution> <id>java</id> - <phase>process-resources</phase> <goals> <goal>parserJava</goal> <goal>gen</goal> Modified: trunk/commandline/maven-plugin/pom.xml =================================================================== --- trunk/commandline/maven-plugin/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/maven-plugin/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -12,9 +12,10 @@ <parent> <groupId>org.codelutin.commandline</groupId> <artifactId>commandline-pom</artifactId> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> </parent> +  <artifactId>maven-commandline-plugin</artifactId> <name>maven-plugin</name> @@ -50,7 +51,7 @@   - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description> Plugin maven 2 pour la generation du parser d'options, des @@ -73,7 +74,6 @@ <artifactId>maven-i18n-plugin</artifactId> <executions> <execution> - <phase>compile</phase> <goals> <goal>parserJava</goal> <goal>gen</goal> @@ -81,6 +81,12 @@ </execution> </executions> </plugin> + + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-plugin-plugin</artifactId> + </plugin> + </plugins> </build> Modified: trunk/commandline/pom.xml =================================================================== --- trunk/commandline/pom.xml 2008-08-12 14:24:48 UTC (rev 1007) +++ trunk/commandline/pom.xml 2008-08-12 14:41:55 UTC (rev 1008) @@ -10,9 +10,9 @@  <parent> - <groupId>lutinpom</groupId> + <groupId>org.codelutin</groupId> <artifactId>lutinproject</artifactId> - <version>2.3</version> + <version>2.4</version> </parent> <groupId>org.codelutin.commandline</groupId> @@ -37,23 +37,10 @@   <name>pom</name> - <version>0.8-SNAPSHOT</version> + <version>0.9</version> <description>lutincommandline library main pom</description> <inceptionYear>2008</inceptionYear> -  - <developers> - <developer> - <name>Tony Chemit</name> - <email>chemit(a)codelutin.com</email> - <organization>Code Lutin</organization> - <timezone>+2</timezone> - <roles> - <role>Developer</role> - </roles> - </developer> - </developers> -    @@ -61,130 +48,48 @@ <packaging>pom</packaging> <build> - <plugins> - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-compiler-plugin</artifactId> - <configuration> - <source>${maven.compile.source}</source> - <target>${maven.compile.target}</target> - <encoding>${maven.compile.encoding}</encoding> - </configuration> - </plugin> -  - <plugin> - <groupId>lutinplugin</groupId> - <artifactId>maven-i18n-plugin</artifactId> - <configuration> - <bundles> - <param>fr_FR</param> - <param>en_GB</param> - </bundles> - <src>${maven.src.dir}/main/resources/i18n</src> - <defaultBasedir>${maven.src.dir}/main/java</defaultBasedir> - <keysModifier>false</keysModifier> - <keepBackup>false</keepBackup> - </configuration> - </plugin> -  - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-source-plugin</artifactId> - <executions> - <execution> - <phase>verify</phase> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> - </plugin> -  - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-javadoc-plugin</artifactId> - <executions> - <execution> - <phase>verify</phase> - <goals> - <goal>jar</goal> - </goals> - </execution> - </executions> - </plugin> -  - <plugin> - <groupId>lutinplugin</groupId> - <artifactId>maven-jrst-plugin</artifactId> - <executions> - <execution> - <id>jrst</id> - <phase>verify</phase> - <goals> - <goal>jrst</goal> - </goals> - </execution> - </executions> - <configuration> - <directoryIn>${maven.src.dir}/site</directoryIn> - <directoryOut>${basedir}/target/generated-site/xdoc</directoryOut> - <verbose>${maven.verbose}</verbose> - </configuration> - </plugin> -  - <plugin> - <groupId>org.apache.maven.plugins</groupId> - <artifactId>maven-site-plugin</artifactId> - <configuration> - <outputEncoding>${maven.compile.encoding}</outputEncoding> - <locales>fr</locales> - <siteDirectory>src/site</siteDirectory> - <generateReports>true</generateReports> - <xdocDirectory>${basedir}/target/generated-site/xdoc/fr/rst</xdocDirectory> - </configuration> - </plugin> + <pluginManagement> + <plugins> - <plugin> - <groupId>org.codelutin.jaxx</groupId> - <artifactId>maven-jaxx-plugin</artifactId> - <dependencies> - <dependency> - <groupId>lutinlib</groupId> - <artifactId>lutinwidget</artifactId> - <version>0.10-SNAPSHOT</version> - </dependency> - </dependencies> - </plugin> - </plugins> + <plugin> + <groupId>org.codelutin.jaxx</groupId> + <artifactId>maven-jaxx-plugin</artifactId> + <version>${jaxx.version}</version> + <executions> + <execution> + <goals> + <goal>generate</goal> + </goals> + </execution> + </executions> + <dependencies> + <dependency> + <groupId>lutinlib</groupId> + <artifactId>lutinwidget</artifactId> + <version>0.10-SNAPSHOT</version> + </dependency> + </dependencies> + </plugin> + + </plugins> + </pluginManagement> + </build> <properties>  - <current.version>0.8-SNAPSHOT</current.version> + <current.version>0.9</current.version>  - <jaxx.version>0.3-SNAPSHOT</jaxx.version> + <jaxx.version>0.4</jaxx.version>  <labs.id>12</labs.id> <labs.project>lutinutil</labs.project> -  - <maven.compile.source>1.6</maven.compile.source> - <maven.compile.target>1.6</maven.compile.target> - <maven.compile.encoding>UTF-8</maven.compile.encoding> - -  - <maven.gen.dir>${basedir}/target/generated-sources</maven.gen.dir> - -  - <labs.lists> - http://lists.labs.libre-entreprise.org/mailman/listinfo/lutinutil - </labs.lists> -  <maven.scm.developerConnection>scm:svn:svn+ssh://${username}@${labs.host}/svnroot/lutinutil/trunk </maven.scm.developerConnection> @@ -194,43 +99,6 @@ </properties> - <profiles> - <profile> - <id>project</id> - <activation> - <activeByDefault>true</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>tests</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>false</maven.test.skip> - <maven.reports.generate>false</maven.reports.generate> - </properties> - </profile> - <profile> - <id>site</id> - <activation> - <activeByDefault>false</activeByDefault> - </activation> - <properties> -  - <maven.test.skip>true</maven.test.skip> - <maven.reports.generate>true</maven.reports.generate> - </properties> - </profile> - </profiles> - - <dependencyManagement> <dependencies> @@ -313,35 +181,14 @@ <version>2.0.4</version> </dependency> - -  - <dependency> - <groupId>lutinplugin</groupId> - <artifactId>maven-i18n-plugin</artifactId> - <version>0.4</version> - </dependency> - - <dependency> - <groupId>lutinplugin</groupId> - <artifactId>maven-jrst-plugin</artifactId> - <version>0.8</version> - </dependency> - - <dependency> - <groupId>org.codelutin.jaxx</groupId> - <artifactId>maven-jaxx-plugin</artifactId> - <version>${jaxx.version}</version> - </dependency> - </dependencies> </dependencyManagement>  - <scm> +  - </scm> + </scm--> </project>

1 0

[Lutinutil-commits] r1007 - trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate
by tchemit＠users.labs.libre-entreprise.org Aug. 12, 2008

Aug. 12, 2008

Author: tchemit Date: 2008-08-12 14:24:48 +0000 (Tue, 12 Aug 2008) New Revision: 1007 Modified: trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/JavaGeneratorGoal.java trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/RstGeneratorGoal.java Log: mise en place documentation de plugin l'attribut @description dans la javadoc ne sert pas au final) Modified: trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/JavaGeneratorGoal.java =================================================================== --- trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/JavaGeneratorGoal.java 2008-08-12 14:23:28 UTC (rev 1006) +++ trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/JavaGeneratorGoal.java 2008-08-12 14:24:48 UTC (rev 1007) @@ -40,158 +40,181 @@ import java.util.TreeMap; /** - * Permet de générer la factory de définitions d'options de ligne de commande, - * pour un fichier de propriété contenant la definition formelle des options. + * Permet de generer la factory de definitions d'options de ligne de commande, + * pour un fichier de propriete contenant la definition formelle des options. * * @author chemit * @goal genJava - * @phase generate-sources + * @phase process-sources */ public class JavaGeneratorGoal extends AbstractGeneratorGoal<JavaGeneratorContext> { /** - * @description chemin du répertoire de génération des resources. + * chemin du repertoire de generation des resources. + * * @parameter expression="${jaxx.outResource}" default-value="${basedir}/target/generated-sources/resources" */ protected File outResource; /** - * @description chemin du répertoire de compilation des resources. + * chemin du repertoire de compilation des resources. + * * @parameter expression="${jaxx.outClass}" default-value="${basedir}/target/classes" */ protected File outClass; /** - * @description flag to copy generated resource files to outClass + * flag to copy generated resource files to outClass + * * @parameter expression="${jaxx.copyToCP}" default-value="true" */ protected boolean copyToCP; /** - * @description Chemin du fichier de propriétés contenant les définitions d'options à utiliser pour générer la factory de définitions d'options. + * fichier de proprietes contenant les definitions d'options a utiliser. + * * @parameter expression="${commandline.source}" * @required */ protected File source; /** - * @description Répertoire de sortie. + * Repertoire de sortie. + * * @parameter expression="${commandline.out}" default-value="${maven.src.dir}/java" * @required */ protected File out; /** - * @description le FQN de la classe concrete du Context + * le FQN de la classe concrete du Context + * * @parameter expression="${commandline.concreteContextFQN}" * @required */ protected String concreteContextFQN; /** - * @description le parser a utiliser + * le parser a utiliser + * * @parameter expression="${commandline.parserFQN}" default-value="org.codelutin.option.def.DefinitionParserFromProperties" */ protected String parserFQN; /** - * @description flag to show errors of parsing. + * flag to show errors of parsing. + * * @parameter expression="${commandLine.showError}" default-value="true" */ protected boolean showErrors; /** - * @description fqn de la super classe du parseur a generer + * fqn de la super classe du parseur a generer + * * @parameter expression="${commandline.parserSuperClass}" default-value="org.codelutin.option.OptionParser" */ protected String parserSuperClass; /** - * @description fqn de la super classe des options a generer + * fqn de la super classe des options a generer + * * @parameter expression="${commandline.optionSuperClass}" default-value="org.codelutin.option.Option" */ protected String optionSuperClass; /** - * @description fqn de la super classe des configs a generer + * fqn de la super classe des configs a generer + * * @parameter expression="${commandline.configSuperClass}" default-value="org.codelutin.option.Config" */ protected String configSuperClass; /** - * @description fqn de la super classe des actions a generer + * fqn de la super classe des actions a generer + * * @parameter expression="${commandline.actionSuperClass}" default-value="org.codelutin.option.OptionAction" */ protected String actionSuperClass; /** - * @description fqn de la super classe des actions a generer + * fqn de la super classe des actions a generer + * * @parameter expression="${commandline.contextSuperClass}" default-value="org.codelutin.option.AbstractContext" */ protected String contextSuperClass; /** - * @description flag pour indique si les configs generes sont concrete ou abstraites + * flag pour indique si les configs generes sont concrete ou abstraites + * * @parameter expression="${commandline.concreteConfig}" default-value="false" */ protected boolean concreteConfig; /** - * @description le nom du fichier de configuration dans la configuration genere + * le nom du fichier de configuration dans la configuration genere + * * @parameter expression="${commandline._configFileName}" default-value=".${project.artifactId}" * @required */ protected String _configFileName; /** - * @description le nom du projet + * le nom du projet + * * @parameter expression="${commandline._projectName}" default-value="${project.artifactId}" * @required */ protected String _projectName; /** - * @description l'url de l'application + * l'url de l'application + * * @parameter expression="${commandline._projectURL}" * @required */ protected String _projectURL; /** - * @description le nom du projet - * @parameter expression="${commandline.__organisationName}" + * le nom du projet + * + * @parameter expression="${commandline._organisationName}" * @required */ protected String _organisationName; /** - * @description l'url de l'application + * l'url de l'application + * * @parameter expression="${commandline._organisationURL}" * @required */ protected String _organisationURL; /** - * @description l'encoding par default dans la configuration genere + * l'encoding par default dans la configuration genere + * * @parameter expression="${commandline._encoding}" default-value="UTF-8" * @required */ protected String _encoding; /** - * @description la locale par default dans la configuration genere + * la locale par default dans la configuration genere + * * @parameter expression="${commandline._locale}" default-value="en_GB" * @required */ protected String _locale; /** - * @description la version dans la configuration genere + * la version dans la configuration genere + * * @parameter expression="${commandline._version}" default-value="${project.version}" * @required */ protected String _version; /** - * @description la version dans la configuration genere + * la version dans la configuration genere + * * @parameter expression="${commandline._copyright}" * @required */ Modified: trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/RstGeneratorGoal.java =================================================================== --- trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/RstGeneratorGoal.java 2008-08-12 14:23:28 UTC (rev 1006) +++ trunk/commandline/maven-plugin/src/main/java/org/codelutin/option/generate/RstGeneratorGoal.java 2008-08-12 14:24:48 UTC (rev 1007) @@ -40,7 +40,7 @@ import java.util.Locale; /** - * Permet de générer les fichiers d'usages de l'application à partir de la classe de context.. + * Permet de generer les fichiers d'usages de l'application a partir de la classe de context.. * * @author chemit * @goal genRst @@ -49,28 +49,32 @@ public class RstGeneratorGoal extends AbstractGeneratorGoal<RstGeneratorContext> { /** - * @description le chemin où trouver les fichiers de traductions pour l'initialisation I18N, sinon le fichier du - * plugin est utilisé, alors qu'il faut que ce soit celui de l'application + * le chemin ou trouver les fichiers de traductions pour l'initialisation I18N, sinon le fichier du + * plugin est utilise, alors qu'il faut que ce soit celui de l'application + * * @parameter expression="${commandline.i18nCP}" default-value="${basedir}/src/resources" */ protected File i18nCP; /** - * @description Répertoire de sortie. + * Repertoire de sortie. + * * @parameter expression="${commandline.out}" default-value="${basedir}/target/classes" * @required */ protected File out; /** - * @description Target rst file. + * Target rst file. + * * @parameter expression="${commandline.rstFilePath}" * @required */ protected String rstFilePath; /** - * @description Target rst file. + * Target rst file. + * * @parameter expression="${commandline.bundles}" */ protected String[] bundles;

1 0