success 87265 volumetrie 2008-12-20T21:09:32Z 2009-05-07T02:57:40Z Plus de projets : classfinfer aiscolai budgetonline volumetrie 1- PrésentationVolumetrie est un programme permettant de récupérer des informations sur un code source. Mesures est un programme permettant l'audit de code source d'une application. Tous les langages peuvent être analysés. MySQL (toutes versions) et Java (minimum 6) doivent être installé pour faire fonctionner cette application. 2- Installation de MySQLLien à suivre pour télécharger et installer MySQL Installer MySQL 3- Installation de JavaLien à suivre pour télécharger et installer Java (dernière version) Installer Java 4- Installation de mesures4.1- DémarrageExtraire l'archive à télécharger, puis, double cliquer sur l'exécutable fournit dans l'archive rar. 4.2- ConnexionRemplir les champs de connexion pour se connecter à la base MySQL qui sera le stockage des résultats d'une analyse. Les champs à remplir sont : - Hôte : Adresse IP de la machine dans laquelle est installée MySQL. Par défaut, localhost. - Port : Port de connexion vers la base. Par défaut, 3306 - Utilisateur : Utilisateur se connectant vers la base. Attention, root ne se connecter que si la machine contenant MySQL et l'application sont la même (localhost) ou si mysql.ini a été configuré de manière à accepter les connections en root à distance. L'utilisateur se connectant à la base doit avoir tous les droits sur les tables de la base de données afin de faire fonctionner l'application au mieux. Par défaut, root. - Mot de passe : Mot de passe correspondant à l'utilisateur qui a été rempli lors de l'installation de MySQL. Par défaut, root. - Nom de la base de données : Un nom de base dans lequel les résultats d'analyse seront stockés. Ce nom n'a pas d'importance. Ce ne doit pas être le nom d'une base déja existante dans MySQL. Par défaut, mesures. 4.3- Installation de la baseUne fois le formulaire rempli, cliquer sur Connexion. Si la base de données n'existe pas et qu'elle n'a jamais été installée, alors un message apparait : "la base de données a été créé, tentez de vous reconnecter". Cela signifie que la base contenant les résultat d'analyse a été créé avec succès. Cliquer sur Connexion à nouveau. Tout autre message signifie une erreur de configuration. Vérifier que MySQL est démarré et la connexion est possible à l'aide de MySQL Query Browser 4.4- Création de l'arborescenceLes étapes suivantes semblent répétitives, mais permettent de définir une arborescence dans les futurs audits à mener. Ceci permet de classer de manière clair les audits de code qui seront réalisé par la suite. L'arborescence est défini de la manière suivante : Compagnie-A Compagnie-A Compagnie-A Compagnie-A Compagnie-A Compagnie-A Compagnie-A Compagnie-A Systeme-A Systeme-A Systeme-A Systeme-A Systeme-B Systeme-B Systeme-B Systeme-B Projet-A Projet-A Projet-B Projet-B Projet-C Projet-C Projet-D Projet-D Application-A Application-B Application-C Application-D Application-E Application-F Application-G Application-H Compagnie est donc le nom de la compagnie à qui appartient les applications (ex : The Apache Software Foundation). Le système est un groupe de projet, cela peut représenter une équipe ou un département au sein d'une entreprise (ex : Apache Projects). Le projet est le nom du projet (ex : Http Server). L'application est une division du projet permettant de cibler au mieux les défauts, cela peut être, par exemple, les différents répertoires du code source (ex : inc ou Server). 4.5- Scan d'un code sourcePour scanner un code source, un formulaire est à remplir. - Version de l'application : Défini la version de l'application qui est auditée. Elle est unique dans le référentiel. - Dossier contenant le code source : Dossier dans lequel se trouve le code source de l'application. Faire un copié-collé du nom du dossier à auditer se trouvant sur le disque. - Dossier contenant les paramètres : Non modifiable. Ce dossier montre l'endroit où mesures récupère les paramètres du code source. Ces paramètres sont stockés dans des fichiers txt dans le dossier lan-parametres, par défaut. L'édition d'un de ces fichiers permet la modification des paramètres d'un langage (commentaires, lignes de code, extension...). L'ajout d'un langage se fait par l'ajout d'un fichier dans ce répertoire. - Date de la version : Cette date correspond à la date de livraison de l'application. Elle est unique. On considère que deux versions ne peuvent être livrées le même jour. Une fois le formulaire remplir, cliquer sur le bouton scanner. Une fenêtre indiquant le nombre de fichiers en cours de scan apparait. Il est recommandé de ne pas scanner plus de 1.000 fichiers à la fois. Cela ralentit le système et dégrade fortement les performances. En cas de dépassement de ce chiffre, il est recommandé de diviser l'application en deux applications. Pour notre démonstration, nous allons scanner une deuxième version de l'application. 4.6- RésultatsLes deux versions apparaissent sur la fenêtre de la liste des version. La note qui apparait est une note sur 1.000. - Une note inférieure à 100 signifie que les développeurs ne se soucie pas de la maintenance du code source. Un chantier de documentation et de simplification est plus que recommandé. - Une note supérieure à 100 et inférieure à 500 signifie que l'équipe de développement se soucie de la maintenance, mais des endroits du code sont difficile à maintenir. Un effort doit être fait dans les versions futures. - Une note entre 500 et 800 signifie qu'un chantier dans le but de mener une amélioration a été entrepris. L'application pourrait être amélioré, mais les risques d'aller retour entre l'équipe de développement et de recette sont fortement diminué. La maintenance de l'application est très simple. - Une note entre 800 et 1.000 signifie que l'application est parfaite. Si fonctionnellement l'application présente des erreurs, la correction de ces erreurs sera exessivement rapide. A ce niveau, un changement d'équipe ou un nouveau développeur peuvent s'adapter très rapidement. Le gain en temps et en cout est maximal. L'application qui a été audité a une note médiocre. Un effort a été fait entre les deux versions, mais des efforts restent à faire pour atteindre un niveau acceptable de la qualité du code. Les pistes à explorer sont : - Documentation (la documentation permet la compréhension du code. Les lignes de commentaires NE DOIVENT PAS être sur les mêmes lignes que celles du code. Cela rend le code illisible. Le système le considérera comme du code mis en commentaire) - Code mis en commentaire (nuit à la lisibilité, quelles sont les lignes fonctionnelles ?) - Taille des fichiers (un fichier contenant plus de 1.000 lignes de code aura une note égale à 0) - Copié-collé (vérifier le nombre de copié-collé et tenté de factoriser la complexité du code) - Le nombre d'instruction (ajouter du commentaire ou des sauts de ligne pour améliorer la visibilité du code) Nous allons voir en détail la dernière version de l'application. Pour cela, cliquer sur la version la plus en bas. L'application mesures calcul, alors, la note de chacun des fichiers et l'historique. Dans la fenêtre de log, l'information sur l'état d'avancé du calcul apparait "Calcul des notes - Etapes xx/xxx". Une fois le calcul terminé, la liste des fichiers apparait. - Le chiffre de gauche représente la note obtenue dans la version qui a été cliquée - Le chiffre du milieu est la note de la version précédente à celle qui a été cliquée - Le chiffre à droite est la différence entre la dernière version et la version précédente. Cela représente l'effort qui a été mis en oeuvre (dégradation ou amélioration). Les fichiers encadrés en rouge, sont les fichiers à modifier en priorité, car posant le plus de problème. Après avoir cliqué sur un des fichiers, le code source ainsi que de nouvelles mesures apparaissent. Sur le fichier en question, on observe que : - Le nombre de ligne de code à augmenter (150 à 182), mais la documentation est restée constante (52). Cela veut dire que la modification amenée n'a pas été documentée ou mal documentée. - Il n'y a pas de code mis en commentaire. - La complexité a augmentée (4 à 7) mais cela ne pose pas un réel problème comparé au volume du fichier. - Le nombre d'instruction est trop élevé et cela depuis la version précédente. Le code source doit donc être plus aéré ou la documentation doit être améliorée. Conclusion pour ce fichier : Augmenter la documentation. 5- ConclusionMesures ne permet pas de faire des mesures précises sur un code source, mais de donner une idée de la qualité du code. La liste des fichiers à corriger est fournie par l'application, afin de permettre aux développeurs d'améliorer leur travail et d'améliorer la qualité de leurs applications. Références : 1Annuaire - 1Sponsor - AnnuForum - AnnuLien - AnnuH4 - Assinie - BestNet - BestWeb - Developpez - FabrikSite - GigAnnu - Glaneur - Gnoztik - Google - Gratuit1 - Hiwit - IServices - Logiciels - Lycos - MeetYou - MegaLiens - MeilleurWeb - Moteur2Re - MsnSearch - MyAnnu - PetitAnnu - PubliMax - RealPos - RecherchWeb - RechFacile - RefTeam - RefWeb - SitePerso - Tagbox - TheOueb - Tibari - TrouvFacil - Volumétrie - Yahoo - Magazine - Référencement - Référencement Team - ReferencementGratuit - FranceAstro http://code.google.com/p/volumetrie volumetrie 0 0 gpl3_or_later GNU General Public License 3 or later