Add mock exo with TODO

TP3/test_vectors.py

@@ -0,0 +1,33 @@
+"""Tests of the Vector class"""
+
+from vectors import Vector
+
+
+def test_init():
+    """Test the x and y properties after initialization."""
+
+
+def test_from_origin():
+    """Test the x and y properties after initialization
+    with the from_origin constructor.
+    """
+
+
+def test_negation():
+    """Test taking the negative of a vector (-v) works and gives the right result."""
+
+
+def test_addition():
+    """Test that adding two vectors works and gives the right result."""
+
+
+def test_subtraction():
+    """Test that subtracting two vectors works and gives the right result."""
+
+
+def test_multiplication_by_scalar():
+    """Test that multiplying a vector by a scalar number works and gives the right result."""
+
+
+def test_scalar_product():
+    """Test the scalar product of two vectors."""

TP4/README.md

@@ -1,3 +1,112 @@
 # Test unitaire
 
-TODO
+## Prérequis
+
+Nous [pytest](https://docs.pytest.org/en/8.0.x/) pour ce TP.
+
+Veuillez installer `pytest`, `pytest-cov` et `pytest-html` avec :
+```sh
+pip install pytest pytest-cov pytest-html
+```
+
+[pytest documentation](https://docs.pytest.org/en/7.1.x/contents.html)
+
+## 1. Tester FizzBuzz
+
+Reprenez l'exercice "FizzBuzz" du TP1. Vérifier que la fonction que vous avez implémenté retourne une string, et n'effectue pas directement de `print`.
+
+## 1.1 Tests cas par cas
+
+1. Créez un fichier `test_fizzbuzz.py`
+1. Ajoutez une fonction `test_fizz`: on testera ici que la fonction renvoie bien "Fizz" lorsqu'on l'appelle en donnant 3 en argument
+1. Ajoutez une fonction `test_buzz`: on testera ici que la fonction renvoie bien "Buzz" lorsqu'on l'appelle en donnant 5 en argument
+1. Ajoutez une fonction `test_fizzbuzz`: on testera ici que la fonction renvoie bien "FizzBuzz" lorsqu'on l'appelle en donnant 15 en argument
+1. Ajoutez une fonction `test_number`: on testera ici que la fonction renvoie bien "2" lorsqu'on l'appelle en donnant 2 en argument
+
+## 1.2 Tests paramétrés
+
+On aimerait bien tester la fonction avec plus de valeurs, mais de manière plus efficace. Pour cela, nous utiliserons la paramétrisation de tests avec `pytest.mark.parametrize`
+
+[Documentation pytest.mark.parametrize](https://docs.pytest.org/en/7.1.x/how-to/parametrize.html)
+
+1. Créer un nouveau module `test_fizzbuzz_parametrized.py`
+1. Créer une seule fonction de test `test_fizzbuzz`. En utilisant le décorateur `@pytest.mark.parametrize`, testez tous les mêmes cas que précédemment. Les paramètres de notre fonction de test seront :
+  - `value: int` : la valeur à donner en argument de la fonction `fizzbuzz` à tester
+  - `expected: int` : la valeur de retour attendue
+1. Il est maintenant très facile de tester plus de valeurs. Ajouter les tests pour les valeurs suivantes :
+  - 0
+  - 1
+  - 2
+  - 3
+  - 4
+  - 5
+  - 10
+  - 20
+
+A noter qu'il est intéressant de tester 0, car c'est un "cas limite".
+
+# 2 Tester une levée d'exception
+
+## 2.1 Ajouter la fonctionnalité en utilisant le TDD
+
+Pour cet exercice, nous allons ajouter une fonctionnalité à notre implémentation de "FizzBuzz" en utilisant le workflow du TDD (Test Driven Development).
+
+Objectif : on voudrait que notre fonction lève une `ValueError` si le nombre donné en argument est strictement négatif.
+
+**ETAPE 1** : ajouter un test à `test_fizzbuzz_parametrized.py`:
+
+- fonction de test `test_value_error_is_raised_for_negative_input`
+- quoi tester : on appelle la fonction avec un nombre négatif (par exemple -1) et on vérifie que la fonction a bien levée une exception de type `ValueError`. Pour cela, on pourra utiliesr `with pytest.raises(ValueError)`
+- Pour l'instant, ce test n'est pas paramétrisé
+
+Exécutez ce test. Il devrait échouer. C'est normal, c'est l'étape "ROUGE" du workflow du TDD.
+
+**ETAPE 2** : modifier notre implémentation jusqu'á ce que notre test  `test_value_error_is_raised_for_negative_input` passe.
+
+C'est l'étape "VERTE" du workflow du TDD.
+
+A priori, cette tâche étant siple et nécessitant peu de code, **l'étape 3 : REFACTOR** n'est pas nécessaire.
+
+## 2.2 Tester plus de valeurs avec la paramétrisation
+
+Paramétrisez le test `test_value_error_is_raised_for_negative_input` et tester les valeurs : -1, -2, -10, -100
+
+# Tester la classe Vector
+
+L'objectif est de tester la classe `Vector` du TP3.
+
+Ouverz le fichier [TP3/test_vectors.py](../TP3/test_vectors.py) et complétez les tests.  **TODO LOIC**: en fait créer un petit package dans un sous dossier avec vectors.py, test_vectors.py, pytest_ini
+
+Si vous avez besoin d'éxecuter un même test avec plusieurs combinaisons de valeurs, paramétrisez le test.
+
+A tout moment, vous pouvez visualiser la **couverture de test** (code coverage). Après votre premier lancement de pytest, ouvrer le rapport de coverage `coverage_report/index.html`. Ensuite, après chaque nouveau lancement de la commande pytest, vous pouvez simplement actualiser la page web dans votre navigateur.
+
+# Utilisation de mocks
+
+On voudrait tester l'implémentation de l'éxercice "Météo" du TP1.
+Nous voulons tester que notre programme est bien capable d'extraire les bonnes informations des données renvoyées par l'API.
+
+On pourra utiliser la version corrigé ici.
+### TODO
+
+Nous ne voulons pas déclencher de vraies requêtes vers l'API du service OpenWeatherMap lors de nos tests, car :
+- les tests sont exécutés de nombreuses fois, et le risque d'atteindre le quota maximal d'appel de l'API est grand
+- les tests doivent pouvoir être exécutés même si le service est down
+- les tests doivent pouvoir être exécutés même sans connexion internet
+- ...
+
+Pour cela, nous allons donc **patcher** la fonction `get` de `requests`. C'est-à-dire : à chaque fois que `request.get` sera appelé, python appelera notre fonction mock et non l'implémentation originale dans le package `requests`.
+
+Nous allons utiliser la fixture `monkey_patch` incluse avec `pytest`, mais sachez qu'il y a d'autres possibilités.
+[Documentation monkeypatch](https://docs.pytest.org/en/latest/how-to/monkeypatch.html)
+
+
+Voici un exemple d'utilisation de `monkey_patch.`
+### TODO snippet
+
+Voici un exemple de ce que l'API renvoie :
+### TODO snippet
+
+1. Créez un module ``test_weather.py``
+1. Ajouter une fonction `get_mock` avec la même signature que `request.get` (càd les mêmes paramètres et le même type de retour)
+1. Ajouter une fonctoin `test_get_weather_info` dont le but est de tester la fonctoin `get_weather`. On patchera la fonction `request.get` avec `get_mock` dans ce test.