From 053651d1840ff44d4a002f3586e44c0166c350e5 Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 09:23:20 +0200 Subject: [PATCH 1/9] docs(fr): add deployment index page --- docs/fr/mkdocs.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/fr/mkdocs.yml b/docs/fr/mkdocs.yml index 6511f64d5e553..1d2d81edb9425 100644 --- a/docs/fr/mkdocs.yml +++ b/docs/fr/mkdocs.yml @@ -58,6 +58,8 @@ nav: - python-types.md - Tutoriel - Guide utilisateur: - tutorial/background-tasks.md +- Deployment: + - deployment/index.md - project-generation.md - alternatives.md - external-links.md From 567c354fadeefc14e0d01488a079a03ac890e94c Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 09:26:16 +0200 Subject: [PATCH 2/9] docs(fr): add translation --- docs/fr/docs/deployment/index.md | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 docs/fr/docs/deployment/index.md diff --git a/docs/fr/docs/deployment/index.md b/docs/fr/docs/deployment/index.md new file mode 100644 index 0000000000000..15ed52ca602ca --- /dev/null +++ b/docs/fr/docs/deployment/index.md @@ -0,0 +1,7 @@ +# Déploiement - Intro + +Le déploiement d'une application **FastAPI** est relativement facile. + +Il y a plusieurs façons de le faire en fonction de votre cas d'utilisation spécifique et des outils que vous utilisez. + +Vous verrez plus de détails à avoir en tête et certaines des techniques pour le faire dans les sections suivantes. From 940e286f00c55cb6d251e971096b19914528a4dc Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 09:40:05 +0200 Subject: [PATCH 3/9] docs(fr): fix toc --- docs/fr/mkdocs.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/fr/mkdocs.yml b/docs/fr/mkdocs.yml index 1d2d81edb9425..667d59b044865 100644 --- a/docs/fr/mkdocs.yml +++ b/docs/fr/mkdocs.yml @@ -58,8 +58,9 @@ nav: - python-types.md - Tutoriel - Guide utilisateur: - tutorial/background-tasks.md -- Deployment: +- Déploiement: - deployment/index.md + - deployment/versions.md - project-generation.md - alternatives.md - external-links.md From 37ee6823c5f6c6867a8c1d3cd7a53316e8adf082 Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 09:40:58 +0200 Subject: [PATCH 4/9] docs(fr): fix toc --- docs/fr/mkdocs.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/fr/mkdocs.yml b/docs/fr/mkdocs.yml index 667d59b044865..550be437c2860 100644 --- a/docs/fr/mkdocs.yml +++ b/docs/fr/mkdocs.yml @@ -60,7 +60,6 @@ nav: - tutorial/background-tasks.md - Déploiement: - deployment/index.md - - deployment/versions.md - project-generation.md - alternatives.md - external-links.md From 53326cc551d6379d35e6d4fb19df5bbb963609b1 Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 09:42:18 +0200 Subject: [PATCH 5/9] docs(fr): add versions page --- docs/fr/mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/fr/mkdocs.yml b/docs/fr/mkdocs.yml index 550be437c2860..667d59b044865 100644 --- a/docs/fr/mkdocs.yml +++ b/docs/fr/mkdocs.yml @@ -60,6 +60,7 @@ nav: - tutorial/background-tasks.md - Déploiement: - deployment/index.md + - deployment/versions.md - project-generation.md - alternatives.md - external-links.md From 686fdb3621575b7d9dc9bd72fce92aca34bc8b0e Mon Sep 17 00:00:00 2001 From: Ruidy Date: Thu, 12 Aug 2021 10:14:36 +0200 Subject: [PATCH 6/9] docs(fr): add translation --- docs/fr/docs/deployment/versions.md | 96 +++++++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 docs/fr/docs/deployment/versions.md diff --git a/docs/fr/docs/deployment/versions.md b/docs/fr/docs/deployment/versions.md new file mode 100644 index 0000000000000..c987a969cf4ae --- /dev/null +++ b/docs/fr/docs/deployment/versions.md @@ -0,0 +1,96 @@ +# À propos des versions de FastAPI + +**FastAPI** est déjà utilisé en production dans de nombreuses applications et systèmes. Et la couverture de test est maintenue à 100 %. Mais son développement est toujours aussi rapide. + +De nouvelles fonctionnalités sont ajoutées fréquemment, des bogues sont corrigés régulièrement et le code est +amélioré continuellement. + +C'est pourquoi les versions actuelles sont toujours `0.x.x`, cela reflète que chaque version peut potentiellement +recevoir des changements non rétrocompatibles. Cela suit les conventions de versionnage sémantique. + +Vous pouvez créer des applications de production avec **FastAPI** dès maintenant (et vous le faites probablement depuis un certain temps), vous devez juste vous assurer que vous utilisez une version qui fonctionne correctement avec le reste de votre code. + +## Épinglez votre version de `fastapi` + +Tout d'abord il faut "épingler" la version de **FastAPI** que vous utilisez à la dernière version dont vous savez +qu'elle fonctionne correctement pour votre application. + +Par exemple, disons que vous utilisez la version `0.45.0` dans votre application. + +Si vous utilisez un fichier `requirements.txt`, vous pouvez spécifier la version avec : + +```txt +fastapi==0.45.0 +``` + +ce qui signifierait que vous utiliseriez exactement la version `0.45.0`. + +Ou vous pourriez aussi l'épingler avec : + +```txt +fastapi>=0.45.0,<0.46.0 +``` + +cela signifierait que vous utiliseriez les versions `0.45.0` ou supérieures, mais inférieures à `0.46.0`, par exemple, une version `0.45.2` serait toujours acceptée. + +Si vous utilisez un autre outil pour gérer vos installations, comme Poetry, Pipenv, ou autres, ils ont tous un moyen que vous pouvez utiliser pour définir des versions spécifiques pour vos paquets. + +## Versions disponibles + +Vous pouvez consulter les versions disponibles (par exemple, pour vérifier quelle est la dernière version en date) dans les [Notes de version](../release-notes.md){.internal-link target=_blank}. + +## À propos des versions + +Suivant les conventions de versionnage sémantique, toute version inférieure à `1.0.0` peut potentiellement ajouter +des changements non rétrocompatibles. + +FastAPI suit également la convention que tout changement de version "PATCH" est pour des corrections de bogues et +des changements rétrocompatibles. + +!!! tip + Le "PATCH" est le dernier chiffre, par exemple, dans `0.2.3`, la version PATCH est `3`. + +Donc, vous devriez être capable d'épingler une version comme suit : + +```txt +fastapi>=0.45.0,<0.46.0 +``` + +Les changements non rétrocompatibles et les nouvelles fonctionnalités sont ajoutés dans les versions "MINOR". + +!!! tip + Le "MINOR" est le numéro au milieu, par exemple, dans `0.2.3`, la version MINOR est `2`. + +## Mise à jour des versions FastAPI + +Vous devriez tester votre application. + +Avec **FastAPI** c'est très facile (merci à Starlette), consultez la documentation : [Testing](../tutorial/testing.md){. +internal-link target=_blank} + +Après avoir effectué des tests, vous pouvez mettre à jour la version **FastAPI** vers une version plus récente, et vous assurer que tout votre code fonctionne correctement en exécutant vos tests. + +Si tout fonctionne, ou après avoir fait les changements nécessaires, et que tous vos tests passent, vous pouvez +épingler votre version de `fastapi` à cette nouvelle version récente. + +## À propos de Starlette + +Vous ne devriez pas épingler la version de `starlette`. + +Différentes versions de **FastAPI** utiliseront une version spécifique plus récente de Starlette. + +Ainsi, vous pouvez simplement laisser **FastAPI** utiliser la bonne version de Starlette. + +## À propos de Pydantic + +Pydantic inclut des tests pour **FastAPI** avec ses propres tests, ainsi les nouvelles versions de Pydantic (au-dessus +de `1.0.0`) sont toujours compatibles avec FastAPI. + +Vous pouvez épingler Pydantic à toute version supérieure à `1.0.0` qui fonctionne pour vous et inférieure à `2.0.0`. + +Par exemple : + +```txt +pydantic>=1.2.0,<2.0.0 +``` \ No newline at end of file From d03be7af9191c4fe665031274af3e76ae66d22ff Mon Sep 17 00:00:00 2001 From: Ruidy Date: Sun, 12 Sep 2021 20:45:19 +0200 Subject: [PATCH 7/9] Apply suggestions from Smlep's review Co-authored-by: Sam Courtemanche --- docs/fr/docs/deployment/versions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fr/docs/deployment/versions.md b/docs/fr/docs/deployment/versions.md index c987a969cf4ae..8612e6d667fb6 100644 --- a/docs/fr/docs/deployment/versions.md +++ b/docs/fr/docs/deployment/versions.md @@ -48,7 +48,7 @@ des changements non rétrocompatibles. FastAPI suit également la convention que tout changement de version "PATCH" est pour des corrections de bogues et des changements rétrocompatibles. -!!! tip +!!! tip "Astuce" Le "PATCH" est le dernier chiffre, par exemple, dans `0.2.3`, la version PATCH est `3`. Donc, vous devriez être capable d'épingler une version comme suit : @@ -59,7 +59,7 @@ fastapi>=0.45.0,<0.46.0 Les changements non rétrocompatibles et les nouvelles fonctionnalités sont ajoutés dans les versions "MINOR". -!!! tip +!!! tip "Astuce" Le "MINOR" est le numéro au milieu, par exemple, dans `0.2.3`, la version MINOR est `2`. ## Mise à jour des versions FastAPI @@ -85,7 +85,7 @@ Ainsi, vous pouvez simplement laisser **FastAPI** utiliser la bonne version de S ## À propos de Pydantic Pydantic inclut des tests pour **FastAPI** avec ses propres tests, ainsi les nouvelles versions de Pydantic (au-dessus -de `1.0.0`) sont toujours compatibles avec FastAPI. +de `1.0.0`) sont toujours compatibles avec **FastAPI**. Vous pouvez épingler Pydantic à toute version supérieure à `1.0.0` qui fonctionne pour vous et inférieure à `2.0.0`. From 644edc575a0c695a7c773c013aa2915b19f33c94 Mon Sep 17 00:00:00 2001 From: Ruidy Date: Sun, 12 Sep 2021 20:46:21 +0200 Subject: [PATCH 8/9] fix linebreak --- docs/fr/docs/deployment/versions.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/fr/docs/deployment/versions.md b/docs/fr/docs/deployment/versions.md index 8612e6d667fb6..ede4b36c73b94 100644 --- a/docs/fr/docs/deployment/versions.md +++ b/docs/fr/docs/deployment/versions.md @@ -66,8 +66,7 @@ Les changements non rétrocompatibles et les nouvelles fonctionnalités sont ajo Vous devriez tester votre application. -Avec **FastAPI** c'est très facile (merci à Starlette), consultez la documentation : [Testing](../tutorial/testing.md){. -internal-link target=_blank} +Avec **FastAPI** c'est très facile (merci à Starlette), consultez la documentation : [Testing](../tutorial/testing.md){.internal-link target=_blank} Après avoir effectué des tests, vous pouvez mettre à jour la version **FastAPI** vers une version plus récente, et vous assurer que tout votre code fonctionne correctement en exécutant vos tests. From bbe93cd8bc236a3121afa699e0fcecaa8c9ee04f Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Fri, 14 Oct 2022 19:22:01 +0000 Subject: [PATCH 9/9] =?UTF-8?q?=F0=9F=8E=A8=20[pre-commit.ci]=20Auto=20for?= =?UTF-8?q?mat=20from=20pre-commit.com=20hooks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/fr/docs/deployment/versions.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/fr/docs/deployment/versions.md b/docs/fr/docs/deployment/versions.md index ede4b36c73b94..136165e9d1585 100644 --- a/docs/fr/docs/deployment/versions.md +++ b/docs/fr/docs/deployment/versions.md @@ -2,18 +2,18 @@ **FastAPI** est déjà utilisé en production dans de nombreuses applications et systèmes. Et la couverture de test est maintenue à 100 %. Mais son développement est toujours aussi rapide. -De nouvelles fonctionnalités sont ajoutées fréquemment, des bogues sont corrigés régulièrement et le code est +De nouvelles fonctionnalités sont ajoutées fréquemment, des bogues sont corrigés régulièrement et le code est amélioré continuellement. -C'est pourquoi les versions actuelles sont toujours `0.x.x`, cela reflète que chaque version peut potentiellement -recevoir des changements non rétrocompatibles. Cela suit les conventions de versionnage sémantique. Vous pouvez créer des applications de production avec **FastAPI** dès maintenant (et vous le faites probablement depuis un certain temps), vous devez juste vous assurer que vous utilisez une version qui fonctionne correctement avec le reste de votre code. ## Épinglez votre version de `fastapi` -Tout d'abord il faut "épingler" la version de **FastAPI** que vous utilisez à la dernière version dont vous savez +Tout d'abord il faut "épingler" la version de **FastAPI** que vous utilisez à la dernière version dont vous savez qu'elle fonctionne correctement pour votre application. Par exemple, disons que vous utilisez la version `0.45.0` dans votre application. @@ -42,10 +42,10 @@ Vous pouvez consulter les versions disponibles (par exemple, pour vérifier quel ## À propos des versions -Suivant les conventions de versionnage sémantique, toute version inférieure à `1.0.0` peut potentiellement ajouter +Suivant les conventions de versionnage sémantique, toute version inférieure à `1.0.0` peut potentiellement ajouter des changements non rétrocompatibles. -FastAPI suit également la convention que tout changement de version "PATCH" est pour des corrections de bogues et +FastAPI suit également la convention que tout changement de version "PATCH" est pour des corrections de bogues et des changements rétrocompatibles. !!! tip "Astuce" @@ -70,7 +70,7 @@ Avec **FastAPI** c'est très facile (merci à Starlette), consultez la documenta Après avoir effectué des tests, vous pouvez mettre à jour la version **FastAPI** vers une version plus récente, et vous assurer que tout votre code fonctionne correctement en exécutant vos tests. -Si tout fonctionne, ou après avoir fait les changements nécessaires, et que tous vos tests passent, vous pouvez +Si tout fonctionne, ou après avoir fait les changements nécessaires, et que tous vos tests passent, vous pouvez épingler votre version de `fastapi` à cette nouvelle version récente. ## À propos de Starlette @@ -83,7 +83,7 @@ Ainsi, vous pouvez simplement laisser **FastAPI** utiliser la bonne version de S ## À propos de Pydantic -Pydantic inclut des tests pour **FastAPI** avec ses propres tests, ainsi les nouvelles versions de Pydantic (au-dessus +Pydantic inclut des tests pour **FastAPI** avec ses propres tests, ainsi les nouvelles versions de Pydantic (au-dessus de `1.0.0`) sont toujours compatibles avec **FastAPI**. Vous pouvez épingler Pydantic à toute version supérieure à `1.0.0` qui fonctionne pour vous et inférieure à `2.0.0`. @@ -92,4 +92,4 @@ Par exemple : ```txt pydantic>=1.2.0,<2.0.0 -``` \ No newline at end of file +```