Depuis un moment il devenait assez épuisant de devoir lire des lignes de code pour savoir comment utiliser les fonctions codées par les autres membres du groupe. Ainsi est venue l'idée d'avoir une documentation en ligne. Je connaissais déjà Doxygen de nom, et je m'étais dit qu'il fallait que je vois comment l'utiliser. C'était donc le parfait moment pour essayer. Mais qui dit documentation en ligne dit documentation qui doit être à jour. En effet, si la documentation n'est pas générée à partir du tout dernier commit, on risquerait d'avoir des problèmes de fonctions redéfinies entre temps, de nouvelles fonctions, etc.

Du coup, j'ai codé un petit programme en Python pour générer les pages Doxygen à chaque fois que Bitbucket me dirait qu'un nouveau commit est arrivé. Heureusement, Bitbucket met à notre disposition des hooks, donc pas besoin de parser un flux RSS pour voir si un nouveau commit est arrivé ! Ouf !

Et chose importante quand on fait de la génération de doc comme ça, il faut un code asynchrone, donc merci Tornado !