Pour rendre les documents propres, nous avons automatisé le reformatage avec des outils disponibles gratuitement.

Pour garder le code propre, suivez ce guide (mais ne vous inquiétez pas si vous ne le suivez pas !)

• Nettoyer le code Perl, … (perltidy)
• Suivre les meilleures pratiques (perlcritic)
• Automatiser (tidyall)

Cpan minus (cpanm) installe le dernier paquet, mais cela peut entrer en conflit avec le gestionnaire de paquets OS.

cpanm install Perl::Tidy
cpanm install Perl::Critic
cpanm install Code::TidyAll

“TidyAll” automatise le formatage du code (perltidy) et la révision du code (perlcritic). Dans le dossier du projet, vous trouverez un fichier appelé : “.tidyallrc” qui contient la configuration actuelle. Consultez-le pour comprendre ce qu'il fait.

Pour simuler le résultat :

tidyall -a --check-only 

Pour le mettre en œuvre (perltidy reformatera les fichiers avec un reformatage inplace, perlcritic examinera le code, mais ne modifiera aucun fichier)

tidyall -a 

Et les fichiers sont sauvegardés dans le dossier “.tidyall.d” (ajoutez-le à vos fichiers ignorés par git, si ce n'est pas déjà fait)

(Peut changer à tout moment : soumettez vos propositions, critiques)
Similaire à arg -pbp (perl best practice), principalement :

• 4 caractères
• pas de tabulations
• Longueur de ligne 0 (