On Sat, 28 Apr 2012 12:05:14 +0200 Benjamin POUSSIN <poussin@codelutin.com> wrote:
On Fri, 27 Apr 2012 12:44:09 +0200 Tony Chemit <chemit@codelutin.com> wrote:
...
Au niveau de Applicationconfig c'est assez facile en fait car on a les OptionDef qui caractérisent des options donc pas grand chose à faire.
AppConfig a toujours été fait pour qu'on est pas cette doc a écrire. Mais pour l'instant la seule doc générée est celle que l'on peut faire facilement via par exemple un --help sur la ligne de commande. Oui moi je pense aux applications web et autre.
Il faut écrire à la main de help, on l'a qu'en console et donc pas très sexy et pratique. Le fait de l'avoir généré sur le site pour mmoi c'est tout bonus.
La seule crainte que j'ai avec la notion de service provider, est que du coup le développeur de l'application finale ne puisse pas choisir les enums a intégrer pour son programme, toutes celles qui seront trouvées seront utilisées. Et en même temps je ne vois pas de cas, ou on utiliserait une librairies avec AppConfig dont on ne souhaiterait pas pouvoir charger les options.
Pas de soucis, on peut ajouter une notion de filtre sur les providers à inserer dans la doc (include/exclude). On récuèpre dans le report tous les providers puis ensuite on ne traite que ceux voulus (ou tous si pas de modif de conf).
Si quelqu'un voit des cas l'autre solution serait que le développeur mette en place une action --help-html (le développeur utilise une méthode qui génère tout le html de AppConfig). Et le plugin pour générer la doc lancerait juste l'application avec l'option --help-html et récupère la sortie. Donc dans ce cas on est sur que le développeur à pu choisir les Enum qu'il voulait et ne pas prendre celle qu'il ne voulait pas.
ça ne marche que pour les clients lourds. Je préfère la solution d'une page générée dans le site directement.
Mais je préfère ta solution tant que personne ne trouve de cas, ou un développeur ne voudrait pas de toutes les options. Car justement, il n'aura plus à se préoccuper à penser à inclure les options de telle ou telle lib. Elle seront incluses automatiquement lorsqu'il aura mis une lib en dépendance. (si j'ai bien tout compris ? :))
Yes, je pars la-dessus et on avisera si besoin ;)
Sur les imports, on pourrait avoir :
- annotations - javadoc doclets
Là, je ne comprend rien ? je ne vois pas de quoi tu parles :(
impor-csv et autres... Autre sujet. -- Tony Chemit -------------------- tél: +33 (0) 2 40 50 29 28 email: chemit@codelutin.com http://www.codelutin.com