Blogounage

I’m currently writing this article offline, since I’m in a place where even phones don’t work fine. Imagine the following situation:

• Granted, it’s the summer, but outside the weather is more suited to the frogs than to the human beings…;
• Your laptop is sitting next to you, waiting for you to tackle this long overdue task on a dev project ;
• You use git, but your Internet connection is between lacky and inexistent. Your only way to receive updates is to regularly take your computer to some place where the network is a bit better (so you can sync your emails, for example).

So, what you would like to do is quite simple: work offline with git (it’s one of its best forces, right?), then push a mail somewhere with your commits. To do that, you have many possibilities:

• Zip -9 your repository and send it as attachment!
  • Ahem, mine is 400MB. Forget about it.
• Git request-pull/am/format-patch to send mails and integrate them automatically on the other side
  • Requires too many configurations for what I want.

So what’s left? git bundle. Let’s have a look at the documentation:

git-bundle - Move objects and refs by archive

Ahem, well, not very explicit if you ask me. Let’s look at the description:

Some workflows require that one or more branches of development on one machine be replicated on another machine, but the two machines cannot be directly connected…. This command provides support for git fetch and git pull to operate by packaging objects and references in an archive at the originating machine, then importing those into another repository using git fetch and git pull after moving the archive by some means (e.g., by sneakernet). …

More interesting.

I’ll rephrase it: we’re going to create a special archive, containing only the commits I want, and finally send it as an attachment. People receiving this mail will be able to just pull from this archive, as from a normal repository! Sounds great, doesn’t it?

So, how to use it? Here’s my use case: I have to do some kind of code review. So I’m gonna create a new branch from the main one “develop”, I’ll call that new one reviewFeatX. Then, that‘s at least the content of this branch I’d like to be able to send.

The principle

For bundling to be efficient and interesting, it’s assumed that both repositories have a common basis. That’s quite obvious anyway: if the repository you’re working on is totally new, then you are likely to have to send it in its entirety. Sending “some commits” only makes sense when there’s in fact commits already present in both places.

Thanks to git’s “everything-is-a-sha” policy + every commit has a parent, it’s quite easy for it to find the link between your work tree and another one.

Creating the archive

Looking at the picture above, what we would like to do is quite obvious: send the blue part as an archive, and not a lot more if possible. Now, how do we do that?

$ git bundle create ../reviewFeatX.gitbundle develop..reviewFeatX

Notice the “develop..reviewFeatX”: this part will be passed through the git rev-list command, which will in fact return all the hashes (sha) corresponding to the blue part above in the diagram. Now you have a reviewFeatX.gitbundle file that you can send by email, dropbox or whatever you want.

Using the archive

On the other end of the pipe, someone is hopefully going to want to retrieve commits from the file. Here’s how to do that:

• First, you can just check if the bundle contains enough information to apply to your repository (that is: your local repository contains at least the commit basis onto which the bundle was created)

$ git bundle verify ../reviewFeatX.gitbundle
The bundle contains 1 ref
8c7feeb8d13233a466459cffc487ca08334af838 refs/heads/reviewFeatX
The bundle requires these 1 ref
6807f3ac794d72a410ac23fa8e2dc5c0bbd6c422 some log
../reviewFeatX.gitbundle is okay

• So now, we can just apply it! To do that, just use the bundle as a remote repository.

$ git ls-remote ../reviewFeatX.gitbundle
1fd7         refs/heads/reviewFeatX

$ git fetch ../reviewFeatX.gitbundle reviewFeatX:reviewFeatX
From ../reviewFeatX.gitbundle
 * [new branch]      reviewFeatX -> reviewFeatX

$ git branch
* develop
  master
  reviewFeatX

$ git checkout reviewFeatX
Switched to branch 'reviewFeatX'

$ git log --oneline develop..reviewFeatX
1fd7 log3
df56 log2
abc1 log1

That’s it! You’ve now imported the commits from the bundle you received by mail.

As said in the introduction, you see there’s many ways to exchange commits. I hope you’ll have found this one interesting and that it will be useful to you.

J'ai lu le livre Apache Maven, édité chez Pearson. Pour un premier livre en français sur Maven, on peut dire que l'expérience est globalement très réussie.

Mon expérience de maven

Disons-le tout de suite, je ne suis pas néophyte sur Maven. J'ai été utilisateur de maven 1 un tout petit peu (preuve ici :-)), avant de me plonger dans maven 2 depuis maintenant plusieurs années. Bon, ça c'est fait. J'espère que vous comprendrez que là, je veux pas me la péter hein. Je veux juste dire que nombre de concepts du livre m'étaient déjà connus. Et que, donc, mon analyse ne sera forcément pas celle d'un nouvel arrivant sur Maven.

Le style du livre

J'avoue que j'ai trouvé la lecture très agréable. C'est volontaire de la part des auteurs, et c'est réussi. Ils ont réussi à apporter beaucoup de concepts dans un style facile à lire. Ils ne sont pas tombés dans le piège de la documentation de référence, parfois un peu dure à lire, voire carrément chiante, qu'on n'ouvrirait que pour y faire un grep sur ce qu'on cherche (et ce n'est à mon sens pas le but pour un livre papier).

Le livre se lit un peu comme un roman : un petit projet débute, et rencontre les problèmes classiques du packaging qui devient une usine à gaz, et que seul celui qui l'a développé (et encore) peut lancer. Au fil de l'eau, on explique donc comment fonctionne maven (et pourquoi il a été créé), comment packager simplement, etc. Ensuite, on se rend compte que l'écriture et le lancement de tests est fastidieuse, alors on explique comment ajouter des tests, et ainsi de suite en décrivant la mise en œuvre de choses de plus en plus complexes.

La structure et le contenu du livre

"Premiers pas avec Maven"

La première partie introduit maven, d'où il arrive, qui l'a créé et pourquoi. Exemple : un projet, quel qu'il soit (et dans quelque langage que ce soit), rencontre presque toujours les trois besoins suivants lors de sa construction : préparer la construction (initialisation), compilation, puis assemblage.

Tout y est, "convention-over-configuration", la notion de dépendance, la transitivité, les scopes, les classifiers, etc... Et tout passe comme une lettre à la poste. Vraiment, je le redis : l'exploit de Nicolas et Arnaud réside dans la capacité à nous permettre de lire le livre sans avoir l'impression de lire une documentation technique.

Comme je le disais sur twitter, je pense que ce livre est un outil formidable sur lequel s'appuyer pour préparer des sensibilisations à Maven dans vos boîtes. Mais surtout, CITEZ VOS SOURCES !!!

Dans la première partie, on la jouait petit. En tant qu'utilisateur expérimenté de maven, ça m'a surtout donné envie de voir comment on pourrait déployer Selenium et FitNesse en IC chez nous.

"Maven en entreprise"

Là, on commence à ouvrir les vannes. Le projet est devenu complexe : comment gérer les dépendances proprement avec un repo manager, centraliser les informations dans un pom parent, utiliser Maven dans l'IDE.., et on arrive enfin à "mais diantre, comment on release un projet avec Maven ? On pourrait pas gérer automatiquement ces actions répétitives, rébarbatives qu'on se tape à chaque livraison, et sur lesquelles on se trompe une fois sur deux ?".

"Encore plus loin avec Maven"

On lâche les chevaux : écriture de plugin maison, comment le tester, intégrer de l'assurance qualité (analyse de code, couverture de code), la génération des rapports et enfin on parle de Sonar, la rolls de l'analyse qualité d'un projet.

Une fois la partie "technique" terminée, Arnaud et Nicolas se livrent même à l'exercice périlleux de prédiction : Maven 3 et consorts (Encore bon pour le moment : Maven 3 à attendre plutôt pour fin 2010, d'après le livre imprimé en novembre 2009. On en est à l'alpha-7 à ce jour.).

Les reproches

Il en faut, sinon, vous allez penser que je ne suis pas objectif :-).

• Tests d'intégration : les mettre dans le projet, ou dans un projet externe ? Le livre dit que les deux approches sont valides, mais sans creuser. J'aurais aimé davantage de retours sur le sujet. Au moins essayer de donner des pistes ou des exemples sur quelle stratégie plutôt adopter qu'une autre dans une situation en particulier. Ou même simplement l'avis d'Arnaud et de Nicolas (je suis sûr que vous en avez un :)) si aucun consensus n'existe effectivement.
• Problèmes d'impression en N&B : je suppose que quelques captures ou diagrammes (exemple : p.206, un des écrans de sonar) ont dû être envoyés à l'éditeur en couleur. Le passage au noir&blanc les rend peu lisibles (essayez de différencier du bleu et du vert une fois dans des nuances de gris...). Je pense qu'il aurait fallu soit vérifier la conversion au noir&blanc, soit voir avec l'éditeur pour imprimer en couleur au moins ceux-là (je suppose que ça permet de baisser le prix de revient du livre).
• Évolution de Maven 3 : pouvoir référencer un pom parent sans version. Le problème de la poule et de l'œuf de Maven. Cette évolution me paraît à la fois intéressante, et en même temps pose question. En effet, l'une des forces de Maven est qu'il est actuellement possible de checkouter un seul module (et non tous) et de travailler dessus. Un peu comme SVN, on peut checkouter n'importe quel niveau, et Maven s'y retrouve très bien. Je suppose que si la version parent n'est plus spécifiée, il devient impossible de checkouter de cette façon. Je pense que ce sera comme ça, mais j'aurais aimé quelques détails sur le sujet.

Mon impression générale

Dans la description de ce petit projet devenu gros, j'ai retrouvé une très grande partie des choses que nous avons faites chez nous. Je pense que certains choix n'ont pas toujours été faits immédiatement, et la lecture d'un tel livre nous aurait économisé pas mal de temps et de recherches (le release-plugin marche très bien, une fois qu'il marche. Mais il peut être difficile d'initialiser les premières releases, où il y a toujours un truc qui plante au milieu).

Petit bonus en prime : le style adopté, et la partie à la fin du livre vous donnent l'impression de connaître tout le monde, de faire un peu partie de la famille :). Maintenant on connait l'âge de tous les développeurs francophones de Maven, même celui de Vincent qui a tenté un chiffrement en héxa :-).

Globalement, donc, je recommande chaudement ce livre à toute personne qui utilise maven et qui souhaite maîtriser l'outil. Le livre offre un accès facile à toutes les facettes du projet, des plus simples au plus avancées, sans omettre le côté humain qui est si important dans les projets opensource.

Souhaitons que cette nouvelle année soit le début d'un retour aux manettes de ceux qui font à la place de ceux qui comptent. Mais j'avoue que j'y crois très peu :-).

Je viens d'éclater de rire en voyant une publicité passer dans Gmail :

Le plus extraordinaire, c'est que le site en question semble pourtant se vouloir très sérieux :-).

Tiens, j'avais raté cette news (300 billets en attente dans mon google reader :-/, que je n'arrive à dépiler que 10 par 10. Ça ne suffit pas :-)) : Subversion a intégré l'incubateur d'Apache.

En français, ça veut dire que bientôt, Subversion sera un projet faisant partie entièrement de la fondation Apache. Subversion n'arrête pas son ascension, et c'est logique vu la qualité de l'outil.

Non, ce billet n'est pas une nouvelle tentative d'explication de ce que sont encodages et jeux de caractères. Je garde toujours dans un coin de ma tête de chercher un jour à écrire moi aussi un billet sur le sujet. Qu'est-ce j'aimerais pouvoir faire comprendre ce sujet à la fois simple et complexe à tous en quelques mots...

Non, ce billet est là pour remercier Vincent et Hadrien pour leurs pages récapitulant les jeux de caractères les plus courants en France. Je viens de m'en servir à l'instant pour expliquer une nouvelle fois le sujet.

• iso-8859-1 (latin-1)
• iso-8859-15 (latin-9 ou latin-0)
• windows-1252
• Unicode

Un autre site bien pratique, qui permet notamment d'avoir la valeur hexadécimale du stockage d'un point de code Unicode en UTF-8 : FileFormat.Info. Par exemple, le î (''LATIN SMALL LETTER I WITH CIRCUMFLEX'').

Et encore un rappel d'articles en français que je vous conseille sur le sujet :

• http://french.joelonsoftware.com/Articles/Unicode.html
• http://genezys.net/blog/post/99-comprendre-les-jeux-de-caracteres

En lisant un bouquin, j'ai découvert l'histoire de la mort de Félix Faure, et le commentaire fait par Clémenceau après son décès. Félix Faure, président français de la fin du 19e siècle, est en effet mort en pleins ébats avec sa maîtresse.

Et Clémenceau, publiquement de dire :

Il a voulu vivre César et il est mort Pompée.

Superbe, Georges !