Shoop

Présentation de Daddy Project

Daddy Inspector est un projet qui permet d'inspecter tout les scripts d'un projet fait en Python.

Après inspection, un rapport est généré sur le projet permettant de suivre tout les dépendences de modules internes au projet, ainsi que les dépendances externes (d'autres projets connus par Dad ou bien simplement des modules installés).

Contrairement à la majorité des projets de sourcing en Python, Dad n'utilise pas l'introspection de Python mais un parsing des scripts, il n'est donc pas obligé que les projets inspectés soit réellement installés.

Frontend Web

L'index présente la liste des projets déja inspectés avec un lien pour chacun qui affichera la liste des différents rapports de chaque projets s'il utilise les révisions d'inspections, ou bien directement le rapport s'il n'utilise pas les révisions.

La fenêtre du rapport se divise en trois partie, l'entête du haut, l'arborescence complète des modules du projet sur la gauche et le contenu sur la droite. Chaque contenu d'un script possède en plus de quelques informations (nom de fichier, date, révision, etc..) un onglet de la source du script colorée syntaxiquement et deux onglets optionnels :

  • Modules importés : liste tout les modules que le script importe, chacuns de ces modules connus par Dad possède un lien pour visualiser le script.
  • Modules référents : liste tout les modules de projets connus par Dad qui font référence au script en tant que module.

Outils d'inspection

L'outils d'inspection est accessible comme commande de django-admin sous le nom de commande inspector. Une option verbose permet de gérer le niveau de sortie de l'outils pour les différentes actions disponibles.

L'aide de l'outils d'inspection est disponible en utilisant la commande suivante dans le répertoire de Dad :

django-admin help inspector

Ajouter un nouveau raccourci

Pour ajouter un nouveau raccourci, il suffit d'utiliser l'option -a suivi du chemin absolu vers le projet à inspecter. Il vous suffit ensuite de répondre aux questions pour remplir les informations nécessaires à l'ajout.

Lister les raccourcis

L'option -p liste tout les raccourcis de projet avec leur options enregistrés.

Inspecter un projet

Pour lancer l'inspection d'un projet utilisez l'option -l suivit d'un nom clé de raccourci.

Supprimer un raccourci

Pour supprimer le raccourci d'un projet donné utilisez l'option -r suivi d'un nom clé de raccourci. Vous pouvez supprimer plusieurs projets, pour ce faire utilisez l'option -r pour chaque raccourci. Vous pouvez aussi supprimer tout les raccourcis, pour ce faire utiliser simplement all' comme nom clé.

Lorsque vous supprimez un raccourci, vous supprimez aussi le projet qui y est lié ainsi que tout ses rapports d'inspections.

Exporter en html

Permet d'exporter les rapports d'un projet sous la forme d'une documentation Html lisible. Cette documentation est lisible hors connexion.

Il vous faut utiliser l'option -e suivit d'un nom clé de raccourci puis d'un chemin où sera créer la documentation.

Téléchargement

Daddy Inspector est uniquement téléchargeable via son dépôt SVN :

http://svn.logicielslibres.info/bordel/sveetch/dad/

Dernière édition le Sunday 28 June 2009 à 05:59