{{tag>dev c tests-unitaires}}

====== CUnit ======

CUnit est un framework de tests unitaires pour les programmes en C. Étapes générales:

  * Définir les fonctions de test en s’appuyant sur les fonctions et les structures de la bibliothèque CUnit.
  * Initialiser le catalogue (registry)
  * Définir / enregistrer les suites de tests dans le catalogue.

===== Installation =====

<code bash>
$ sudo apt-get install libcunit1-dev
</code>

Pour générer le binaire:
  * A la compilation préciser le dossier contenant les headers si nécessaire via l'argument **-I**
  * A l'édition des liens préciser au linker l'utilisation de la bibliothèque CUnit avec l'argument **-lcunit**


===== Définition des fonctions de test =====

Première étape on définit la ou les fonctions de test, le prototype est de la forme:

<code c>
void test_function_a(void);
</code>

===== Programme de test =====

==== Inclusions ====

Le programme de test peut s'interfacer de différentes façons, la méthode la plus simple consiste à utiliser le mode console (CLI). Dans ce cas inclure le fichier CUnit/Basic.h

<code c>
#include  <CUnit/Basic.h>
</code>

Le catalogue est une structure fournie par CUnit dans laquelle les suites de tests sont enregistrées. Dans le programme de test, on commence par appeler la fonction d’initialisation du catalogue:

<code c>

</code>


===== Exemple de sortie =====

===== Références =====

  * http://sites.uclouvain.be/SystInfo/notes/Outils/html/cunit.html