Cependant, la passerelle subversion de github s'est révélée, après expérimentation, être parfaitement compatible avec l'outil d'intégration continue d'atoum.
De plus, atoum doit être utilisé à partir de début juillet chez PMSIpilot, et la migration vers github était l'un des pré-requis.
Enfin, la sortie d'un client officiel pour MacOS pour github a eu raison de mes dernières réserves.
Je disposais en effet du logiciel ad hoc, je n'avais plus de code à écrire pour migrer et j'avais pris un engagement vis à vis du projet et de PMSIpilot que je me devais d'honorer.
J'ai donc résisté pendant longtemps, mais j'ai fini par céder : depuis aujourd'hui, le code source d'atoum est sur github, grâce entre autre à cet excellent tutorial, auquel il ne manque que la procédure de création des fichiers .gitignore
via git svn create-ignore
.
Amusez-vous bien !
9 réactions
1 De Sébastien - 24/06/2011, 07:01
J'ai regardé les sources d'atoum. Félicitations, le code dégage une impression de clarté, de simplicité, c'est très KISS (keep it simple & stupid).
Je pense utiliser atoum une fois que celui-ci sera documenté.
2 De webozor - 24/06/2011, 09:28
Excellent choix !
Par contre c'est vrai qu'il manque une doc, un petit tutorial d'introduction mais j'ai peut-être mal cherché ?
3 De mageekguy - 24/06/2011, 09:29
@webozor : Certain te dirais que les tests unitaires sont la documentation.
Je n'irais pas jusque là, mais le répertoire
tests/units
est un bon point de départ pour comprendre comment écrire un test.La documentation est la prochaine étape dans le développement, et du code est d'ailleurs en cours d'écriture pour en générer une partie automatiquement.
4 De Grummfy - 24/06/2011, 19:31
Hello,
quelques exemple + comment les lancer peuvent suffire pour que *l'on* commence a créer de la documentation...
là en dehors de regarder le code il est difficile de voir comment commencer...
5 De Matthieu - 24/06/2011, 21:28
Merci pour le lien de github pour Mac, l'interface est vraiment super sympa ! Vivement la doc Atoum.
6 De mageekguy - 24/06/2011, 23:35
@Grummfy : Ton vœux est exaucé.
Je viens en effet de mettre en ligne sur github un fichier README permettant d'installer et d'utiliser atoum, ou du moins de démarrer avec.
7 De Amaury - 27/06/2011, 21:35
Je partage un peu ton avis sur Git. Quand on a l'habitude de Subversion, passer à Git est un peu... comment dire... pas vraiment pénible, mais on se retrouve à gérer des notions supplémentaires dont on se passait très bien jusque-là. Et donc à taper des commandes supplémentaires, d'où l'aspect verbeux dont tu parles.
Mon expérience personnelle, c'est que Subversion marche plutôt bien en entreprise, où l'aspect centralisé n'est pas un problème et que les numéros de révision globaux sont pratiques pour suivre les commits. Par contre, il faut bien dire que Git est très fort pour les projets libres (surtout utilisé avec GitHub).
Sinon, j'ai regardé ton code en diagonale. C'est vrai que l'absence totale de commentaire (en tout cas, pour les fichiers que j'ai regardé) m'a fait bizarre.
En tout cas, j'espère que ton projet ira loin !
8 De mageekguy - 28/06/2011, 00:15
@Amaury : L'absence de commentaires dans le code est totalement assumé, car tout est fait pour ne pas en avoir besoin.
Avoir besoin d'écrire des commentaires pour comprendre du code est pour moi le signe d'un problème.
Après, j'ai bien conscience que c'est un point de vue qui peut à tout le moins interpeller et au maximum me faire passer pour un dingue intégriste, mais il semble que le code soit lisible d'après les commentaires que je reçois à ce sujet, donc pour l'instant, la remise en cause de cette politique n'est pas à l'ordre du jour.
Quand à Git, ce n'est pas l'étendue de son domaine fonctionnel qui me gène mais bien la façon dont ce domaine est implémenté.
En dehors des commandes basiques, c'est un pur outil de barbu très loin d'être intuitif, que ce soit en terme d'utilisation que de vocabulaire, et devoir lire le manuel à longueur de temps devient vite fatiguant, voir très stressant en cas de problème.
9 De Amaury - 28/06/2011, 18:01
Agree to disagree. On en a déjà parlé.
Mais bon, en entreprise je n'accepterais pas d'être obligé de lire tout le code d'une méthode pour comprendre à quoi elle sert et comment elle s'utilise ; idem au niveau des objets. Et l'argument «le nom doit être assez explicite» − avec lequel je suis fondamentalement d'accord − n'est pas toujours suffisant au quotidien.
Idem pour l'argument «les tests sont la doc». Je n'ai pas plus envie de lire des tests unitaires pour savoir quelle méthode utiliser, là où un commentaire de 2 lignes me donnerait l'info immédiatement.
C'est vrai que le code d'Atoum est lisible. Mais tu as tout de même un grand nombre d'objets. Naviguer dans une documentation générée avec PHPDoc se fait plus rapidement que d'ouvrir des myriades de fichiers PHP.
Mais l'essentiel reste qu'il s'agit d'un beau projet.