Il s'agit de la commande api-sanity-checker qui peut être exécutée dans le fournisseur d'hébergement gratuit OnWorks en utilisant l'un de nos multiples postes de travail en ligne gratuits tels que Ubuntu Online, Fedora Online, l'émulateur en ligne Windows ou l'émulateur en ligne MAC OS
PROGRAMME:
Nom
api-sanity-checker - un générateur automatique de tests unitaires de base pour une API de bibliothèque C/C++.
DESCRIPTION
NOM:
API Sanity Checker (api-sanity-checker) Générer des tests unitaires de base pour un C/C++
API de bibliothèque
DESCRIPTION:
API Sanity Checker est un générateur automatique de tests unitaires de base pour un C/C++
une bibliothèque. Il permet de générer rapidement des tests simples (qualité "sanitaire" ou "superficielle")
pour chaque fonction dans une API en utilisant leurs signatures, définitions de types de données et
relations entre les fonctions directement à partir des fichiers d'en-tête de la bibliothèque
("Header Driven Generation"). Chaque cas de test contient un appel de fonction avec
des paramètres d'entrée raisonnables (dans la plupart des cas, mais malheureusement pas dans tous). Les
la qualité des tests générés permet de vérifier l'absence d'erreurs critiques en
cas d'utilisation et peut être grandement amélioré en impliquant des outils spécialisés hautement réutilisables
types pour la bibliothèque.
L'outil peut exécuter les tests générés et détecter les plantages, les abandons, toutes sortes de
signaux émis, code de retour de programme non nul, suspension et exigence de programme
pannes (si spécifié). L'outil peut être considéré comme un outil pour out-of-box
vérification de l'intégrité à faible coût de l'API de la bibliothèque ou en tant que cadre de développement de test pour
génération initiale de modèles pour les tests avancés. Il prend également en charge l'universel
Format Template2Code des tests, spécifications de l'attelle, mode de génération de test aléatoire
et d'autres fonctionnalités utiles.
Cet outil est un logiciel libre : vous pouvez le redistribuer et/ou le modifier sous le
termes de la GNU LGPL ou de la GNU GPL.
UTILISATION:
api-sanity-checker [options]
Exemple:
api-sanity-checker -lib Nom -d VER.xml -gén -construire -courir
VERSION.xml est un descripteur XML :
1.0
/chemin1/vers/en-tête(s)/ /chemin2/vers/en-tête(s)/
/chemin1/vers/bibliothèque(s)/ /chemin2/vers/bibliothèque(s)/
INFORMATION OPTIONS :
-h|-aide
Imprimez cette aide.
-Info
Imprimer les informations complètes.
-v|-version
Imprimer les informations sur la version.
-version de vidage
Imprimez la version de l'outil (1.98.7) et ne faites rien d'autre.
GÉNÉRAL OPTIONS :
-l|-lib|-library NOM
Nom de la bibliothèque (sans version).
-d|-descripteur CHEMIN
Chemin d'accès au descripteur de bibliothèque (fichier VER.xml) :
1.0
/chemin1/vers/en-tête(s)/ /chemin2/vers/en-tête(s)/ ...
/chemin1/vers/bibliothèque(s)/ /chemin2/vers/bibliothèque(s)/ ...
Pour plus d'informations, s'il vous plaît voir:
http://lvc.github.com/api-sanity-checker/Xml-Descriptor.html
-gén|-générer
Générer des tests. Options -l et -d doit être précisé. Pour générer un test pour le
fonction particulière l'utiliser avec -f option. Code de sortie : nombre de cas de test échoués
construire.
-construire|-faire
Construire le(s) test(s). Options -l et -d doit être précisé. Pour construire un test pour le
fonction particulière l'utiliser avec -f option. Code de sortie : nombre de cas de test échoués
générer.
-courir
Exécutez le(s) test(s), créez un rapport de test. Options -l et -d doit être précisé. Courir
tester pour la fonction particulière l'utiliser avec -f option. Code de sortie : nombre de
cas de test échoués.
-nettoyer
Test(s) propre(s). Options -l et -d doit être précisé. Pour nettoyer le test pour le
fonction particulière l'utiliser avec -f option.
EXTRA OPTIONS :
-numéro virtuel NUM
Spécifiez la version de la bibliothèque en dehors du descripteur.
-s|-symbole NOM
Générer/Construire/Exécuter un test pour la fonction spécifiée (nom mutilé en C++).
-liste-de-symboles PATH
Cette option permet de spécifier un fichier avec une liste de fonctions (une par ligne,
nom mutilé en C++) qui doit être testé, les autres fonctions de la bibliothèque ne seront pas
testé.
-entête Nom
Cette option permet de restreindre une liste de fonctions qui doivent être testées par
fournissant un nom de fichier d'en-tête dans lequel ils sont déclarés. Cette option est destinée
pour le développement de tests étape par étape.
-tout
Générez des tests pour tous les symboles inclus de manière récursive dans le(s) fichier(s) d'en-tête.
-xvfb
Utilisez le serveur Xvfb au lieu du serveur X actuel (par défaut) pour exécuter les tests.
-t2c|-template2code
Générez des tests au format universel Template2Code. Pour plus d'informations, veuillez
voir:
http://sourceforge.net/projects/template2code/
-strict-gen
Terminer le processus de génération de tests et renvoyer le code d'erreur '1' si impossible
générer au moins un cas de test.
-strict-build
Terminez le processus de génération de test et renvoyez le code d'erreur « 1 » si vous ne pouvez pas générer
au moins un cas de test.
-exécution stricte
Terminer le processus d'exécution des tests et renvoyer le code d'erreur '1' si au moins un
le cas de test a échoué.
-stricte
Cette option permet à tous -stricte-* option.
-r|-aléatoire
Mode de génération de test aléatoire.
-min
Générer un code minimum, appeler des fonctions avec un nombre minimum de paramètres à
initialiser les paramètres d'autres fonctions.
-max
Générer un maximum de code, appeler des fonctions avec un nombre maximum de paramètres à
initialiser les paramètres d'autres fonctions.
-afficher-retval
Affiche le type de retour de la fonction dans le rapport.
-check-reval
Insérez des exigences sur les valeurs de retour (retval!=NULL) pour chaque fonction appelée.
-St|-types-spécialisés CHEMIN
Chemin d'accès au fichier avec la collection de types spécialisés. Pour plus d'informations,
s'il te plait regarde:
http://lvc.github.com/api-sanity-checker/Specialized-Type.html
-td|-test-données CHEMIN
Chemin d'accès au répertoire contenant les fichiers de données de test. Pour plus d'informations, veuillez consulter :
http://lvc.github.com/api-sanity-checker/Specialized-Type.html
-en-têtes-seulement
Si la bibliothèque se compose uniquement de fonctions en ligne et n'a pas d'objets partagés, vous
doit spécifier cette option.
-pas de ligne
Ne générez pas de tests pour les fonctions en ligne.
-garder-interne
Générer des tests pour les symboles internes (fonctions avec préfixe '__' et méthodes de
classes déclarées à l'intérieur d'autres classes).
-isolé
Permet de restreindre l'utilisation des fonctions par les listes spécifiées par le -liste-fonctions
option ou par la division du groupe dans le descripteur.
-en lecture seule
Supprimez tous les fichiers de la suite de tests, à l'exception des fichiers *.html. Cette option permet de
créer un index html léger pour tous les tests.
-disable-valeurs-par-défaut
Désactivez l'utilisation des valeurs par défaut pour les paramètres de fonction.
-optimize-inclut NIVEAU
Activez l'optimisation de la liste des en-têtes inclus dans chaque scénario de test. Disponible
les niveaux:
Élevé (par défaut) Moyen Faible Aucun - désactiver
-p|-params CHEMIN
Chemin d'accès au fichier avec les noms des paramètres de fonction. Il peut être utilisé pour améliorer
tests générés si les fichiers d'en-tête de bibliothèque ne contiennent pas de noms de paramètres. Déposer
Format:
fonction1;param1;param2;param3 ... fonction2;param1;param2;param3 ... ...
-Titre Nom
Le nom de la bibliothèque dans le titre du rapport.
-relpath|-reldir CHEMIN
Remplacez {RELPATH} dans le descripteur de bibliothèque par PATH.
-long LANGUE
Définir le langage de la bibliothèque (C ou C++). Vous pouvez utiliser cette option si l'outil ne peut pas
détecter automatiquement une langue.
-cible COMPILATEUR
Le compilateur qui doit être utilisé pour construire les tests générés sous Windows.
Prise en charge:
gcc - compilateur GNU cl - compilateur MS (par défaut)
-déboguer
Écrire un journal étendu pour le débogage.
-cache
Mettez en cache le vidage ABI et utilisez-le lors de la prochaine exécution.
AUTRES OPTIONS :
-tester
Exécutez des tests internes. Créez une bibliothèque simple et exécutez l'outil dessus. Cette option
permet de vérifier si l'outil fonctionne correctement sur le système.
-désactiver la réutilisation des variables
Désactivez la réutilisation des variables précédemment créées dans le test.
-noms-de-variables-longs
Activez les noms de variables longs (complexes) au lieu de noms courts.
EXIT CODES:
0 - Tests réussis. L'outil a fonctionné sans aucune erreur. différent de zéro - Les tests ont échoué
ou l'outil s'est exécuté avec des erreurs.
AUTRES INFORMATION:
http://lvc.github.com/api-sanity-checker/
Utilisez api-sanity-checker en ligne à l'aide des services onworks.net