diff --git a/docs/fr/docs/advanced/async-tests.md b/docs/fr/docs/advanced/async-tests.md new file mode 100644 index 000000000..46ae4c7c7 --- /dev/null +++ b/docs/fr/docs/advanced/async-tests.md @@ -0,0 +1,107 @@ +# Tests Asynchrones + +Vous avez déjà vu comment tester vos applications **FastAPI** en utilisant le `TestClient` fourni. Jusqu'à présent, vous avez seulement vu comment écrire des tests synchrones, sans utiliser des fonctions `async`. + +Être capable d'utiliser des fonctions asynchrones dans vos tests peut être utile, par exemple, lorsque vous requêtez de manière asynchrone votre base de données. Imaginez que vous vouliez tester l'envoi de requête à votre application FastAPI, puis vérifier que votre backend a bien écrit la bonne donnée dans la base de données, tout en utilisant une librairie de base de données asynchrone. + +Voyons comment faire. + +## pytest.mark.anyio + +Afin de permettre l'appel de fonctions asynchrones dans nos tests, il est essentiel que nos fonctions de tests soient asynchrones. AnyIO propose un plugin soigneusement conçu pour cela, qui nous permet de spécifier que certaines fonctions de test doivent être appelées de manière asynchrone. + +## HTTPX + +Même si votre application **FastAPI** utilise des fonctions `def` normales plutôt que des `async def`, elle reste une application `async` application en dessous. + +`TestClient` utilise de la magie à l'intérieur pour appeler l'application FastAPI dans vos fonctions de test `def` normales, en utilisant un standard pytest. Mais cette magie ne marche plus lorsque vous l'utilisez dans une fonction asynchrone. En lançant nos tests de manière asynchrone, `TestClient` ne peut plus être utilisé dans nos fonctions de tests. + +`TestClient` repose HTTPX, et par chance, on peut l'utiliser directement pour tester l'API. + +## Exemple + +Prenons un exemple simple, on considère une structure de fichier similaire à celle décrite dans [Applications plus grandes](../tutorial/bigger-applications.md){.internal-link target=_blank} et [Testing](../tutorial/testing.md){.internal-link target=_blank}: + +``` +. +├── app +│ ├── __init__.py +│ ├── main.py +│ └── test_main.py +``` + +Dans le fichier `main.py` il y aurait: + +```Python +{!../../../docs_src/async_tests/main.py!} +``` + +Le fichier `test_main.py` contiendrait les tests pour `main.py`, et pourrait désormais ressembler à : + +```Python +{!../../../docs_src/async_tests/test_main.py!} +``` + +## Lancez les + +Comme d'habitude, vous pouvez lancer vos tests en utilisant : + +