Sith/doc/start/install.rst

Installer le projet
===================

Dépendances du système
----------------------

Certaines dépendances sont nécessaires niveau système :

* poetry
* libmysqlclient
* libssl
* libjpeg
* libxapian-dev
* zlib1g-dev
* python3
* gettext
* graphviz
* mysql-client (pour migrer de l'ancien site)

Sur Ubuntu
~~~~~~~~~~

.. sourcecode:: bash

    sudo apt install libssl-dev libjpeg-dev zlib1g-dev python3-dev libffi-dev python3-dev libgraphviz-dev pkg-config libxapian-dev gettext git
    curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python3 -

    # To include mysql for importing old bdd
    sudo apt install libmysqlclient-dev

Sur MacOS
~~~~~~~~~

Pour installer les dépendances, il est fortement recommandé d'installer le gestionnaire de paquets `homebrew <https://brew.sh/index_fr>`_.

.. sourcecode:: bash

    brew install git python xapian graphviz poetry

    # Si vous aviez une version de python ne venant pas de homebrew
    brew link --overwrite python


    # Pour bien configurer gettext
    brew link gettext # (suivez bien les instructions supplémentaires affichées)

    # Pour installer poetry
    pip3 install poetry

.. note::

    Si vous rencontrez des erreurs lors de votre configuration, n'hésitez pas à vérifier l'état de votre installation homebrew avec :code:`brew doctor`

Installer le projet
-------------------

.. sourcecode:: bash

    git clone https://ae-dev.utbm.fr/ae/Sith.git
    cd Sith

    # Création de l'environnement et installation des dépendances
    poetry install

    # Activation de l'environnement virtuel
    poetry shell

    # Prépare la base de donnée
    ./manage.py setup

    # Installe les traductions
    ./manage compilemessages

.. note::

    Pour éviter d'avoir à utiliser la commande poetry shell systématiquement, il est possible de consulter :ref:`direnv`.

Configuration pour le développement
-----------------------------------

Lorsqu'on souhaite développer pour le site, il est nécessaire de passer le logiciel en mode debug dans les settings_custom. Il est aussi conseillé de définir l'URL du site sur localhost. Voici un script rapide pour le faire.

.. sourcecode:: bash

    echo "DEBUG=True" > sith/settings_custom.py
    echo 'SITH_URL = "localhost:8000"' >> sith/settings_custom.py

Démarrer le serveur de développement
------------------------------------

Il faut toujours avoir préalablement activé l'environnement virtuel comme fait plus haut et se placer à la racine du projet. Il suffit ensuite d'utiliser cette commande :

.. sourcecode:: bash

    ./manage.py runserver

.. note::

    Le serveur est alors accessible à l'adresse http://localhost:8000.

Générer la documentation
------------------------

La documentation est automatiquement mise en ligne sur readthedocs à chaque envoi de code sur GitLab.

Pour l'utiliser en local ou globalement pour la modifier, il existe une commande du site qui génère la documentation et lance un serveur la rendant accessible à l'adresse http://localhost:8080.

Cette commande génère la documentation à chacune de ses modifications, inutile de relancer le serveur à chaque fois.

.. sourcecode:: bash

    ./manage.py documentation

    # Il est possible de spécifier un port et une adresse d'écoute différente
    ./manage.py documentation adresse:port

Lancer les tests
----------------

Pour lancer les tests il suffit d'utiliser la commande intégrée à django.

.. code-block:: bash

    # Lancer tous les tests
    ./manage.py test

    # Lancer les tests de l'application core
    ./manage.py test core

    # Lancer les tests de la classe UserRegistrationTest de core
    ./manage.py test core.tests.UserRegistrationTest

    # Lancer une méthode en particulier de cette même classe
    ./manage.py test core.tests.UserRegistrationTest.test_register_user_form_ok

Vérifier les dépendances Javascript
-----------------------------------

Une commande a été écrite pour vérifier les éventuelles mises à jour à faire sur les librairies Javascript utilisées.
N'oubliez pas de mettre à jour à la fois le fichier de la librairie, mais également sa version dans `sith/settings.py`.

.. code-block:: bash

    # Vérifier les mises à jour
    ./manage.py check_front