.. _d7.01.01-build:

Compiler et tester
==================

.. _d7.01.01-build-ref:

Compilation de la version de référence
--------------------------------------

L'ensemble des opérations de construction sont nécessairement réalisées dans
un *shell* du conteneur contenant la dernière version des prérequis.

Il est recommandé de vérifier que la compilation est correcte avec la version
de référence. Pour cela, il suffit de faire :

.. code-block:: shell

    cd $HOME/dev/codeaster/src
    git checkout main
    git pull
    make bootstrap


On se place sur la branche *main*, on la met à jour avec le dépôt distant.
``make bootstrap`` est un raccourci qui fait ``./configure``, ``make`` (identique à ``make install``)
et ``make doc``.
Ceci est équivalent aux commandes ``./waf configure``, ``./waf install`` et ``./waf doc``.

Il suffit de faire ``export BUILD=debug`` avant de lancer ``make bootstrap``
pour construire une version avec les symboles de *debug*.

Il est conseillé de lancer ``install_env`` (ou ``../devtools/bin/install_env``)
depuis ``src`` pour terminer l'installation des dépôts et installer les
*hooks* automatiquement.


.. _d7.01.01-build-branch:

Fichiers des exercices
----------------------

Les fichiers préremplis sont fournis dans une branche nommée ``tp-dev-cmd``
du dépôt Git. Pour récupérer cette branche (et la renommer avec vos initiales
``xy`` pour simuler une future demande d'intégration):

Le nom différent utilisé pour la branche locale permet de distinguer les différents
développeurs si on fait des exercices sur GitLab par exemple.

Pour l'exercice :ref:`d7.01.02`, utiliser le nom de branche ``tp-dev-macro``
et ``xy-dev-macro`` pour la branche locale.

.. code-block:: shell

    cd $HOME/dev/codeaster/src
    git fetch origin tp-dev-cmd:xy-dev-cmd
    git checkout xy-dev-cmd


.. _d7.01.01-build-dev:

Construire et tester
--------------------

Il n'est pas nécessaire de faire la configuration à chaque fois (uniquement quand
on récupère des révisions du dépôt distant).

Il suffit de faire :

.. code-block:: shell

    cd $HOME/dev/codeaster/src
    make

Et pour lancer un cas-test :

.. code-block:: shell

    make <nom-du-test>

    # soit
    make tpdev01a
    # ou
    make tpdev01b


Le cas-test doit être OK, sans alarme.
Le code doit compiler sans *warning*.

Vérifier que l'output est telle qu'on l'attend.

Vérifier le source avec :ref:`d7.01.01-regles-aslint`.