Nab Has Shoes 0.3.1
Pour fêter la sortie de Nab Has Shoes 0.3.1, je viens d’ouvrir le projet sur rubyforge qui vient donc compléter la page sur The ShoeBox.
Have fun !
![]() |
begin require "greg.rubyfr.net" rescue MacOSX, PostgreSQL, Ruby => e RubyFR.read( "[Why not]" ) end |
L | Ma | Me | J | V | S | D |
---|---|---|---|---|---|---|
« juin | ||||||
1 | 2 | 3 | ||||
4 | 5 | 6 | 7 | 8 | 9 | 10 |
11 | 12 | 13 | 14 | 15 | 16 | 17 |
18 | 19 | 20 | 21 | 22 | 23 | 24 |
25 | 26 | 27 | 28 |
Pour fêter la sortie de Nab Has Shoes 0.3.1, je viens d’ouvrir le projet sur rubyforge qui vient donc compléter la page sur The ShoeBox.
Have fun !
Je viens de terminer la première partie de ce qui est certainement la plus grosse documentation que j’ai pu écrire dans ma vie. Je n’en dévoilerai pas plus sur le contenu, car il s’agit d’un travail pour mon employeur, sachez simplement qu’il s’agit d’une documentation d’API à destination de développeurs pour les technologies Windows DLL, Framework MacOSX, .Net, Java et SOAP. Ce qui m’intéresse ici est plutôt de vous parler de la méthode employée.
L’ensemble représente pour le moment 6 documents : 4 Quick Start, un document de référence technique (il en reste 3 à écrire) et un document de cas d’utilisations. Le tout représente plus de 450 pages et nous devrions dépasser les 1600 pages quand les trois derniers documents seront rédigés.
L’ensemble a été écrit en XML ce qui présente l’énorme avantage de pouvoir partager des paragraphes, voir des chapitres, entre plusieurs documents. De plus, l’écriture de cette documentation ce faisant à plusieurs, nous utilisons subversion comme repository de sources, impossible — ou tout au moins inutile — avec un document Word ou OOo. Chacun peut ainsi travailler sur une partie précise de la documentation sans perturber les autres. Nous utilisons CruiseControl.rb pour l’intégration continue.
Nous avons un ensemble de feuilles de styles permettant de générer des versions HTML (une page et multi-pages) et du PDF via FOP.
A l’origine nous utilisions ANT pour générer les documents, mais tout cela est en train de migrer vers Rake. Non seulement l’utilisation de FOPJava avec Ruby est très simple mais en plus cela nous permet de migrer tout un ensemble de scripts sous Ruby/Rake. En effet, nous avons plusieurs scripts pour nous aider. L’un par exemple utilise RubyDiff pour rechercher des différences, entre deux versions d’APIs, et génère automatiquement de nouvelles entrées dans la doc. L’utilisation de REXML nous permet de modifier de la documentation automatiquement, ou de générer de nouvelles pages à partir de templates XML, souvent avec l’aide d’Erb. Tout cela est en train d’être réuni dans un Rakefile. Bien entendu chaque action automatisée est journalisée et peut être rejouée, supprimée, remplacée… Ainsi pour la constitution de la trame du document, chacun peut savoir ce qui a été fait. Cela complété avec les possibilités offertes par SVN fait que nous pouvons à tout moment revoir l’ensemble de l’histoire de la fabrication de cette documentation. Bien entendu la conformité de l’ensemble est validée à chaque étape…
Utilisateur de Zsh, je traîne une configuration de cet irremplaçable shell depuis maintenant 10 ans. 10 ans de constantes évolutions qui me permettant d’utiliser la “ligne de commande” à une vitesse qui me donnerait presque envie d’encadrer mon .zshrc dans mon salon
Pour tout ce qui concerne mes projets, j’utilise subversion et mon .zshrc fourmille de fonctions et autres alias qui me permettent de tagger, copier, commiter, merger… mes sources avec une amusante facilité…
Quoi qu’il en soit, un bon outil graphique est parfois fort agréable. Ainsi j’ai abandonné Vim pour Textmate, diff pour Changes, Linux pour MacOSX…
Je n’avais rien trouvé de satisfaisant pour subversion, et bien Conerstone m’a convaincu. Non seulement ce client SVN est graphiquement excellent, mais en plus il est d’une simplicité déconcertante et c’est un véritable tout-en-un. Vous ne regretterez pas vous 69 USD.
Je viens de commiter dans le repository de bivouac la release candidate 1 de la version 0.4.0.
Au programme pas mal de changements :
Bien entendu il y a également les traditionnelles corrections de bug.
Notez enfin que l’exemple de blog fourni dans les sources a été totalement réécrit sur le modèle proposé par Magnus dans Camping.
La mise ne ligne de la version 0.4.0 devrait suivre dans peu de temps. Je voudrais refaire une passe sur les plugins avant…
Allez, ce soir on fait du Perl…
Je vous avais promis du Java… En voici…
public class Test {
public static void main( String arg[] ) {
MixrClient p = new MixrClient();
System.out.println( p.store( "cle", "valeur" ) );
System.out.println( p.get( "cle" ) );
System.out.println( p.store( "key", "value" ) );
System.out.println( "hasKey( cle ) = " + p.hasKey( "cle" ) );
System.out.println( "hasKey( truc ) = " + p.hasKey( "truc" ) );
System.out.println( "hasValue( value ) = " + p.hasValue( "value" ) );
System.out.println( "hasValue( truc ) = " + p.hasValue( "truc" ) );
System.out.println( "empty : " + p.isEmpty() );
System.out.println( "Liste des clés : " );
String[] k = p.keys();
System.out.println( k.length );
for( int x = 0; x < k.length; x++ ) {
System.out.println( k[x] );
}
System.out.println( "Liste des valeurs : " );
String[] v = p.values();
System.out.println( v.length );
for( int x = 0; x < v.length; x++ ) {
System.out.println( v[x] );
}
System.out.println( "DELETE cle : ");
System.out.println( p.delete( "cle" ) );
System.out.println( "Taille : " + p.length() );
System.out.println( "CLEAR" );
p.clear();
System.out.println( "Liste des valeurs : " );
String[] w = p.values();
System.out.println( w.length );
for( int x = 0; x < w.length; x++ ) {
System.out.println( x + " : " + w[x] );
}
System.out.println( "empty : " + p.isEmpty() );
}
}
Je viens d’ajouter dans le repository de Mixr une classe cliente pour PHP.
Elle n’est pas encore aussi complète que la version Ruby, mais vous pouvez déjà en faire quelque chose :
Bon, je n’ai pas fait de PHP depuis des lustres… Si ça ce voit, n’hésitez pas à me le dire
Bon, demain je vais faire du Java…
Il n’y a pas que des désavantages à avoir des enfants qui boivent un biberon vers 2h du matin et d’autres qui collectionnent la gastro. En effet, cette soirée de veillée m’a permis de développer un nouveau petit projet : Mixr.
Mixr is a tiny memory object caching system
La partie serveur est écrite avec erlang (vous pourrez pas dire que je ne vous avais pas prévenu !). Coté client, le gem s’accompagne bien entendu d’une classe pour Ruby, mais je n’exclue pas, à la prochaine otite de vous proposer une classe pour PHP, Perl ou Python…
Bon…
J’ai fait quelques modifications dans mon mini serveur HTTP.
En effet, il nécessite maintenant la création d’un fichier de configuration sur le format suivant :
Comme vous pouvez le voir, vous pouvez spécifier le port d’écoute du serveur et le DocumentRoot.
Voici également un petit script pour démarrer facilement ce server :