]> git.ipfire.org Git - thirdparty/fastapi/fastapi.git/commitdiff
🌐 Update translations for fr (update-outdated) (#15669)
authorSebastiĂĄn RamĂ­rez <tiangolo@gmail.com>
Mon, 1 Jun 2026 17:53:50 +0000 (19:53 +0200)
committerGitHub <noreply@github.com>
Mon, 1 Jun 2026 17:53:50 +0000 (19:53 +0200)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
docs/fr/docs/_llm-test.md
docs/fr/docs/alternatives.md
docs/fr/docs/async.md
docs/fr/docs/fastapi-cli.md
docs/fr/docs/features.md
docs/fr/docs/help-fastapi.md
docs/fr/docs/python-types.md
docs/fr/docs/tutorial/bigger-applications.md
docs/fr/docs/tutorial/header-params.md
docs/fr/docs/virtual-environments.md

index 74f9c9903c0157ce5b7ea46f5d055acd6dada5aa..9ee61126e63f0c1b7f87a4ca75e135a3255b0fe0 100644 (file)
@@ -124,10 +124,6 @@ Voir la section `### Content of code blocks` dans l’invite gĂ©nĂ©rale dans `sc
 
 //// tab | Test
 
-/// info | Info
-Du texte
-///
-
 /// note | Remarque
 Du texte
 ///
@@ -136,10 +132,6 @@ Du texte
 Du texte
 ///
 
-/// check | VĂ©rifications
-Du texte
-///
-
 /// tip | Astuce
 Du texte
 ///
index 54ad83ae84e78d814afe7147e458564dd8a65a88..b56d104812ae3f21c9cd0e78286a921f10cd743b 100644 (file)
@@ -43,7 +43,7 @@ Django REST Framework a Ă©tĂ© créé par Tom Christie. Le crĂ©ateur de Starlette
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Avoir une interface de documentation automatique de l'API.
 
@@ -65,7 +65,7 @@ qui est nĂ©cessaire, Ă©tait une caractĂ©ristique clĂ© que je voulais conserver.
 
 Compte tenu de la simplicitĂ© de Flask, il semblait bien adaptĂ© Ă  la crĂ©ation d'API. La prochaine chose Ă  trouver Ă©tait un Â« Django REST Framework Â» pour Flask.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 ĂŠtre un micro‑framework. Il est donc facile de combiner les outils et les piĂšces nĂ©cessaires.
 
@@ -107,7 +107,7 @@ def read_url():
 
 Notez les similitudes entre `requests.get(...)` et `@app.get(...)`.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 * Avoir une API simple et intuitive.
 * Utiliser les noms de mĂ©thodes HTTP (opĂ©rations) directement, de maniĂšre simple et intuitive.
@@ -128,7 +128,7 @@ Swagger pour une API permettrait d'utiliser cette interface utilisateur web auto
 
 C'est pourquoi, lorsqu'on parle de la version 2.0, il est courant de dire Â« Swagger Â», et pour la version 3+ Â« OpenAPI Â».
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Adopter et utiliser une norme ouverte pour les spĂ©cifications des API, au lieu d'un schĂ©ma personnalisĂ©.
 
@@ -164,7 +164,7 @@ Ces fonctionnalitĂ©s sont ce pourquoi Marshmallow a Ă©tĂ© construit. C'est une e
 
 Mais elle a Ă©tĂ© créée avant que les annotations de type n'existent en Python. Ainsi, pour dĂ©finir chaque <dfn title="la dĂ©finition de la façon dont les donnĂ©es doivent ĂȘtre formĂ©es">schĂ©ma</dfn>, vous devez utiliser des utilitaires et des classes spĂ©cifiques fournies par Marshmallow.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Utiliser du code pour dĂ©finir des Â« schĂ©mas Â» qui fournissent automatiquement les types de donnĂ©es et la validation.
 
@@ -180,13 +180,13 @@ Il utilise Marshmallow pour effectuer la validation des donnĂ©es. Et il a Ă©tĂ©
 
 C'est un outil formidable et je l'ai beaucoup utilisĂ© aussi, avant d'avoir **FastAPI**.
 
-/// info
+/// note | Remarque
 
 Webargs a Ă©tĂ© créé par les dĂ©veloppeurs de Marshmallow.
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Disposer d'une validation automatique des donnĂ©es des requĂȘtes entrantes.
 
@@ -210,13 +210,13 @@ Mais alors, nous avons Ă  nouveau le problĂšme d'avoir une micro-syntaxe, dans u
 
 L'Ă©diteur ne peut guĂšre aider en la matiĂšre. Et si nous modifions les paramĂštres ou les schĂ©mas Marshmallow et que nous oublions de modifier Ă©galement cette docstring YAML, le schĂ©ma gĂ©nĂ©rĂ© deviendrait obsolĂšte.
 
-/// info
+/// note | Remarque
 
 APISpec a Ă©tĂ© créé par les dĂ©veloppeurs de Marshmallow.
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Supporter la norme ouverte pour les API, OpenAPI.
 
@@ -243,13 +243,13 @@ j'ai (ainsi que plusieurs Ă©quipes externes) utilisĂ©es jusqu'Ă  prĂ©sent :
 
 Ces mĂȘmes gĂ©nĂ©rateurs full-stack ont servi de base aux [GĂ©nĂ©rateurs de projets pour **FastAPI**](project-generation.md).
 
-/// info
+/// note | Remarque
 
 Flask-apispec a Ă©tĂ© créé par les dĂ©veloppeurs de Marshmallow.
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 GĂ©nĂ©rer le schĂ©ma OpenAPI automatiquement, Ă  partir du mĂȘme code qui dĂ©finit la sĂ©rialisation et la validation.
 
@@ -270,7 +270,7 @@ Mais comme les donnĂ©es TypeScript ne sont pas prĂ©servĂ©es aprĂšs la compilatio
 
 Il ne peut pas trĂšs bien gĂ©rer les modĂšles imbriquĂ©s. Ainsi, si le corps JSON de la requĂȘte est un objet JSON comportant des champs internes qui sont Ă  leur tour des objets JSON imbriquĂ©s, il ne peut pas ĂȘtre correctement documentĂ© et validĂ©.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Utiliser les types Python pour bĂ©nĂ©ficier d'un excellent support de l'Ă©diteur.
 
@@ -290,7 +290,7 @@ Il a clairement inspirĂ© Uvicorn et Starlette, qui sont actuellement plus rapide
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Trouver un moyen d'avoir une performance folle.
 
@@ -308,7 +308,7 @@ pas possible de dĂ©clarer des paramĂštres de requĂȘte et des corps avec des indi
 
 Ainsi, la validation, la sĂ©rialisation et la documentation des donnĂ©es doivent ĂȘtre effectuĂ©es dans le code, et non pas automatiquement. Ou bien elles doivent ĂȘtre implĂ©mentĂ©es comme un framework au-dessus de Falcon, comme Hug. Cette mĂȘme distinction se retrouve dans d'autres frameworks qui s'inspirent de la conception de Falcon, qui consiste Ă  avoir un objet de requĂȘte et un objet de rĂ©ponse comme paramĂštres.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Trouver des moyens d'obtenir de bonnes performances.
 
@@ -338,7 +338,7 @@ d'utiliser des dĂ©corateurs qui peuvent ĂȘtre placĂ©s juste au-dessus de la fonc
 mĂ©thode est plus proche de celle de Django que de celle de Flask (et Starlette). Il sĂ©pare dans le code des choses
 qui sont relativement fortement couplĂ©es.
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 DĂ©finir des validations supplĂ©mentaires pour les types de donnĂ©es utilisant la valeur Â« par dĂ©faut Â» des attributs du modĂšle. Ceci amĂ©liore le support de l'Ă©diteur, et n'Ă©tait pas disponible dans Pydantic auparavant.
 
@@ -361,13 +361,13 @@ API et des CLI.
 
 Comme il est basĂ© sur l'ancienne norme pour les frameworks web Python synchrones (WSGI), il ne peut pas gĂ©rer les Websockets et autres, bien qu'il soit Ă©galement trĂšs performant.
 
-/// info
+/// note | Remarque
 
 Hug a Ă©tĂ© créé par Timothy Crosley, le crĂ©ateur de [`isort`](https://github.com/timothycrosley/isort), un excellent outil pour trier automatiquement les imports dans les fichiers Python.
 
 ///
 
-/// check | IdĂ©es ayant inspirĂ© **FastAPI**
+/// tip | IdĂ©es ayant inspirĂ© **FastAPI**
 
 Hug a inspirĂ© certaines parties d'APIStar, et Ă©tait l'un des outils que je trouvais les plus prometteurs, Ă  cĂŽtĂ© d'APIStar.
 
@@ -404,7 +404,7 @@ Il ne s'agissait plus d'un framework web API, le crĂ©ateur devant se concentrer
 
 Maintenant, APIStar est un ensemble d'outils pour valider les spĂ©cifications OpenAPI, et non un framework web.
 
-/// info
+/// note | Remarque
 
 APIStar a Ă©tĂ© créé par Tom Christie. Le mĂȘme gars qui a créé :
 
@@ -414,7 +414,7 @@ APIStar a Ă©tĂ© créé par Tom Christie. Le mĂȘme gars qui a créé :
 
 ///
 
-/// check | A inspirĂ© **FastAPI** Ă 
+/// tip | A inspirĂ© **FastAPI** Ă 
 
 Exister.
 
@@ -439,7 +439,7 @@ Cela le rend extrĂȘmement intuitif.
 Il est comparable Ă  Marshmallow. Bien qu'il soit plus rapide que Marshmallow dans les benchmarks. Et comme il est
 basĂ© sur les mĂȘmes annotations de type Python, le support de l'Ă©diteur est grand.
 
-/// check | **FastAPI** l'utilise pour
+/// tip | **FastAPI** l'utilise pour
 
 GĂ©rer toute la validation des donnĂ©es, leur sĂ©rialisation et la documentation automatique du modĂšle (basĂ©e sur le schĂ©ma JSON).
 
@@ -482,7 +482,7 @@ NĂ©anmoins, il est dĂ©jĂ  utilisĂ© comme Â« standard Â» par plusieurs outils. Ce
 
 ///
 
-/// check | **FastAPI** l'utilise pour
+/// tip | **FastAPI** l'utilise pour
 
 GĂ©rer toutes les parties web de base. Ajouter des fonctionnalitĂ©s par-dessus.
 
@@ -501,7 +501,7 @@ quelque chose qu'un framework comme Starlette (ou **FastAPI**) fournirait par-de
 
 C'est le serveur recommandĂ© pour Starlette et **FastAPI**.
 
-/// check | **FastAPI** le recommande comme
+/// tip | **FastAPI** le recommande comme
 
 Le serveur web principal pour exĂ©cuter les applications **FastAPI**.
 
index f2afba9c6d7e7adc59c1a715d27ef7d8939af235..b3fc9169abf75ee89fa08ed7e2de9b1800d5ef9c 100644 (file)
@@ -139,7 +139,7 @@ Vous et votre crush đŸ˜ mangez les burgers đŸ” et passez un bon moment âœš.
 
 <img src="/img/async/concurrent-burgers/concurrent-burgers-07.png" class="illustration">
 
-/// info
+/// note | Remarque
 
 Illustrations proposĂ©es par [Ketrina Thompson](https://www.instagram.com/ketrinadrawsalot). đŸŽš
 
@@ -205,7 +205,7 @@ Vous les mangez, et vous avez terminĂ© đŸ” âč.
 
 Durant tout ce processus, il n'y a presque pas eu de discussions ou de flirts car la plupart de votre temps Ă  Ă©tĂ© passĂ© Ă  attendre đŸ•™ devant le comptoir đŸ˜ž.
 
-/// info
+/// note | Remarque
 
 Illustrations proposĂ©es par [Ketrina Thompson](https://www.instagram.com/ketrinadrawsalot). đŸŽš
 
index 03ef75adc7cbbd3e7e29dc2fe1b7c22d22f5c040..ee58af722224862f2b0fbaf3f570d0fbd2918fc4 100644 (file)
@@ -95,7 +95,7 @@ ce qui serait Ă©quivalent Ă  :
 from backend.main import app
 ```
 
-### `fastapi dev` avec un chemin { #fastapi-dev-with-path }
+### `fastapi dev` avec un chemin ou avec l’option CLI `--entrypoint` { #fastapi-dev-with-path-or-with-entrypoint-cli-option }
 
 Vous pouvez Ă©galement passer le chemin du fichier Ă  la commande `fastapi dev`, et elle devinera l’objet d’application FastAPI Ă  utiliser :
 
@@ -103,7 +103,13 @@ Vous pouvez Ă©galement passer le chemin du fichier Ă  la commande `fastapi dev`,
 $ fastapi dev main.py
 ```
 
-Mais vous devez vous rappeler de passer le bon chemin Ă  chaque fois que vous appelez la commande `fastapi`.
+Ou bien, vous pouvez aussi passer l’option `--entrypoint` Ă  la commande `fastapi dev` :
+
+```console
+$ fastapi dev --entrypoint main:app
+```
+
+Mais vous devez vous rappeler de passer le bon chemin\entrypoint Ă  chaque fois que vous appelez la commande `fastapi`.
 
 De plus, d’autres outils pourraient ne pas pouvoir le trouver, par exemple l’[extension VS Code](editor-support.md) ou [FastAPI Cloud](https://fastapicloud.com), il est donc recommandĂ© d’utiliser le `entrypoint` dans `pyproject.toml`.
 
index 7fae1d8817f475d590b2d55a9b270712d5ea8765..0bb16b343793957e432b6db376b923fbb68d965b 100644 (file)
@@ -63,7 +63,7 @@ second_user_data = {
 my_second_user: User = User(**second_user_data)
 ```
 
-/// info
+/// note | Remarque
 
 `**second_user_data` signifie :
 
index e24809d6a8e7a54b2a056c01f0fc12cfb73cd1a9..7a6da3c0872d94526f3e77d42c193e5f8ffd9205 100644 (file)
@@ -1,14 +1,8 @@
-# Aider FastAPI - Obtenir de l'aide { #help-fastapi-get-help }
+# Aider { #help }
 
-Aimez-vous **FastAPI** ?
+Souhaitez-vous aider FastAPI ou obtenir de l'aide Ă  propos de FastAPI ?
 
-Souhaitez-vous aider FastAPI, les autres utilisateurs et l'auteur ?
-
-Ou souhaitez-vous obtenir de l'aide avec **FastAPI** ?
-
-Il existe des moyens trĂšs simples d'aider (plusieurs ne nĂ©cessitent qu'un ou deux clics).
-
-Et il existe aussi plusieurs façons d'obtenir de l'aide.
+Il existe des moyens trĂšs simples d'aider et d'obtenir de l'aide.
 
 ## S'abonner Ă  la newsletter { #subscribe-to-the-newsletter }
 
@@ -20,9 +14,13 @@ Vous pouvez vous abonner Ă  la (peu frĂ©quente) [newsletter **FastAPI and friend
 * Changements majeurs đŸšš
 * Astuces et conseils âœ…
 
-## Suivre FastAPI sur X (Twitter) { #follow-fastapi-on-x-twitter }
+## Suivre FastAPI en ligne { #follow-fastapi-online }
 
-[Suivez @fastapi sur **X (Twitter)**](https://x.com/fastapi) pour obtenir les derniĂšres nouvelles sur **FastAPI**. đŸŠ
+Vous pouvez suivre **FastAPI** en ligne Ă  plusieurs endroits :
+
+* [@fastapi sur **X / Twitter**](https://x.com/fastapi)
+* [@fastapi.tiangolo.com sur **Bluesky**](https://bsky.app/profile/fastapi.tiangolo.com)
+* [FastAPI sur **LinkedIn**](https://www.linkedin.com/company/fastapi/)
 
 ## Mettre une Ă©toile Ă  **FastAPI** sur GitHub { #star-fastapi-in-github }
 
@@ -38,98 +36,28 @@ Vous pouvez y sĂ©lectionner Â« Releases only Â».
 
 Ainsi, vous recevrez des notifications (par e‑mail) chaque fois qu'il y aura une nouvelle release (une nouvelle version) de **FastAPI** avec des corrections de bugs et de nouvelles fonctionnalitĂ©s.
 
-## Entrer en contact avec l'auteur { #connect-with-the-author }
-
-Vous pouvez entrer en contact avec [moi (SebastiĂĄn RamĂ­rez / `tiangolo`)](https://tiangolo.com), l'auteur.
-
-Vous pouvez :
-
-* [Me suivre sur **GitHub**](https://github.com/tiangolo).
-    * Voir d'autres projets Open Source que j'ai créés et qui pourraient vous aider.
-    * Me suivre pour voir quand je crĂ©e un nouveau projet Open Source.
-* [Me suivre sur **X (Twitter)**](https://x.com/tiangolo) ou sur [Mastodon](https://fosstodon.org/@tiangolo).
-    * Me dire comment vous utilisez FastAPI (j'adore l'entendre).
-    * ĂŠtre informĂ© quand je fais des annonces ou publie de nouveaux outils.
-    * Vous pouvez aussi [suivre @fastapi sur X (Twitter)](https://x.com/fastapi) (un compte sĂ©parĂ©).
-* [Me suivre sur **LinkedIn**](https://www.linkedin.com/in/tiangolo/).
-    * ĂŠtre informĂ© quand je fais des annonces ou publie de nouveaux outils (mĂȘme si j'utilise plus souvent X (Twitter) đŸ€·â€â™‚).
-* Lire ce que j'Ă©cris (ou me suivre) sur [**Dev.to**](https://dev.to/tiangolo) ou [**Medium**](https://medium.com/@tiangolo).
-    * Lire d'autres idĂ©es, des articles, et dĂ©couvrir des outils que j'ai créés.
-    * Me suivre pour lire quand je publie quelque chose de nouveau.
-
-## Tweeter Ă  propos de **FastAPI** { #tweet-about-fastapi }
-
-[Tweetez Ă  propos de **FastAPI**](https://x.com/compose/tweet?text=I'm loving @fastapi because... https://github.com/fastapi/fastapi) et faites savoir Ă  moi et aux autres pourquoi vous l'apprĂ©ciez. đŸŽ‰
-
-J'adore entendre comment **FastAPI** est utilisĂ©, ce que vous avez aimĂ©, dans quel projet/quelle entreprise vous l'utilisez, etc.
+## Suivre l'auteur { #follow-the-author }
 
-## Voter pour FastAPI { #vote-for-fastapi }
+Vous pouvez suivre [moi (SebastiĂĄn RamĂ­rez / `tiangolo`)](https://tiangolo.com), l'auteur, Ă  plusieurs endroits, pour ĂȘtre informĂ© quand j'ai des nouvelles Ă  partager sur FastAPI et ses amis :
 
-* [Votez pour **FastAPI** sur Slant](https://www.slant.co/options/34241/~fastapi-review).
-* [Votez pour **FastAPI** sur AlternativeTo](https://alternativeto.net/software/fastapi/about/).
-* [Indiquez que vous utilisez **FastAPI** sur StackShare](https://stackshare.io/pypi-fastapi).
+* [@tiangolo sur **GitHub**](https://github.com/tiangolo).
+* [@tiangolo sur **X (Twitter)**](https://x.com/tiangolo)
+* [@tiangolo.com sur **Bluesky**](https://bsky.app/profile/tiangolo.com)
+* [@tiangolo sur **LinkedIn**](https://www.linkedin.com/in/tiangolo/).
 
 ## Aider les autres avec des questions sur GitHub { #help-others-with-questions-in-github }
 
-Vous pouvez essayer d'aider les autres avec leurs questions dans :
-
-* [GitHub Discussions](https://github.com/fastapi/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered)
-* [GitHub Issues](https://github.com/fastapi/fastapi/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Aquestion+-label%3Aanswered+)
+Vous pouvez essayer d'aider les autres avec leurs questions dans [GitHub Discussions](https://github.com/fastapi/fastapi/discussions/categories/questions?discussions_q=category%3AQuestions+is%3Aunanswered).
 
 Dans de nombreux cas, vous connaissez peut-ĂȘtre dĂ©jĂ  la rĂ©ponse Ă  ces questions. đŸ€“
 
 Si vous aidez beaucoup de personnes avec leurs questions, vous deviendrez un [Expert FastAPI](fastapi-people.md#fastapi-experts) officiel. đŸŽ‰
 
-N'oubliez pas, le point le plus important est : essayez d'ĂȘtre aimable. Les gens viennent avec leurs frustrations et, dans bien des cas, ne posent pas la question de la meilleure façon, mais faites de votre mieux pour rester aimable. đŸ€—
-
-L'idĂ©e est que la communautĂ© **FastAPI** soit bienveillante et accueillante. En mĂȘme temps, n'acceptez pas l'intimidation ni les comportements irrespectueux envers les autres. Nous devons prendre soin les uns des autres.
-
----
-
-Voici comment aider les autres avec des questions (dans les discussions ou les issues) :
-
-### Comprendre la question { #understand-the-question }
-
-* VĂ©rifiez si vous comprenez quel est l’**objectif** et le cas d'utilisation de la personne qui pose la question.
-
-* Ensuite, vĂ©rifiez si la question (la grande majoritĂ© sont des questions) est **claire**.
-
-* Dans de nombreux cas, la question porte sur une solution imaginaire de l'utilisateur, mais il pourrait y en avoir une **meilleure**. Si vous comprenez mieux le problĂšme et le cas d'utilisation, vous pourriez suggĂ©rer une **solution alternative** plus adaptĂ©e.
-
-* Si vous ne comprenez pas la question, demandez plus de **dĂ©tails**.
-
-### Reproduire le problĂšme { #reproduce-the-problem }
+N'oubliez pas, le point le plus important est : essayez d'ĂȘtre aimable. đŸ€—
 
-Dans la plupart des cas et pour la plupart des questions, il y a quelque chose liĂ© au **code original** de la personne.
+### Comment aider { #how-to-help }
 
-Dans de nombreux cas, elle ne copiera qu'un fragment de code, mais ce n'est pas suffisant pour **reproduire le problĂšme**.
-
-* Vous pouvez leur demander de fournir un [exemple minimal, complet et vĂ©rifiable](https://stackoverflow.com/help/minimal-reproducible-example), que vous pouvez **copier‑coller** et exĂ©cuter localement pour voir la mĂȘme erreur ou le mĂȘme comportement qu'ils observent, ou pour mieux comprendre leur cas d'utilisation.
-
-* Si vous vous sentez trĂšs gĂ©nĂ©reux, vous pouvez essayer de **crĂ©er un tel exemple** vous‑mĂȘme, simplement Ă  partir de la description du problĂšme. Gardez simplement Ă  l'esprit que cela peut prendre beaucoup de temps et qu'il peut ĂȘtre prĂ©fĂ©rable de leur demander d'abord de clarifier le problĂšme.
-
-### SuggĂ©rer des solutions { #suggest-solutions }
-
-* AprĂšs avoir compris la question, vous pouvez leur donner une **rĂ©ponse** possible.
-
-* Dans de nombreux cas, il est prĂ©fĂ©rable de comprendre leur **problĂšme sous‑jacent ou cas d'utilisation**, car il pourrait exister une meilleure façon de le rĂ©soudre que ce qu'ils essaient de faire.
-
-### Demander la clĂŽture { #ask-to-close }
-
-S'ils rĂ©pondent, il y a de fortes chances que vous ayez rĂ©solu leur problĂšme, bravo, **vous ĂȘtes un hĂ©ros** ! đŸŠž
-
-* Maintenant, si cela a rĂ©solu leur problĂšme, vous pouvez leur demander de :
-
-    * Dans GitHub Discussions : marquer le commentaire comme **rĂ©ponse**.
-    * Dans GitHub Issues : **fermer** l'issue.
-
-## Suivre le dĂ©pĂŽt GitHub { #watch-the-github-repository }
-
-Vous pouvez Â« watch Â» FastAPI sur GitHub (en cliquant sur le bouton Â« watch Â» en haut Ă  droite) : [https://github.com/fastapi/fastapi](https://github.com/fastapi/fastapi). đŸ‘€
-
-Si vous sĂ©lectionnez Â« Watching Â» au lieu de Â« Releases only Â», vous recevrez des notifications lorsque quelqu'un crĂ©e une nouvelle issue ou question. Vous pouvez aussi prĂ©ciser que vous ne souhaitez ĂȘtre notifiĂ© que pour les nouvelles issues, ou les discussions, ou les PR, etc.
-
-Vous pouvez alors essayer de les aider Ă  rĂ©soudre ces questions.
+Suivez le [guide sur la maniĂšre d'aider](https://tiangolo.com/open-source/help/#help-others-with-questions-in-github) ici.
 
 ## Poser des questions { #ask-questions }
 
@@ -138,119 +66,22 @@ Vous pouvez [crĂ©er une nouvelle question](https://github.com/fastapi/fastapi/di
 * Poser une **question** ou demander Ă  propos d'un **problĂšme**.
 * SuggĂ©rer une nouvelle **fonctionnalitĂ©**.
 
-**Remarque** : si vous le faites, je vais vous demander d'aider aussi les autres. đŸ˜‰
-
-## Relire des Pull Requests { #review-pull-requests }
-
-Vous pouvez m'aider Ă  relire les pull requests des autres.
-
-Encore une fois, essayez autant que possible d'ĂȘtre aimable. đŸ€—
-
----
-
-Voici ce Ă  garder Ă  l'esprit et comment relire une pull request :
-
-### Comprendre le problĂšme { #understand-the-problem }
-
-* D'abord, assurez‑vous de **comprendre le problĂšme** que la pull request essaie de rĂ©soudre. Il peut y avoir une discussion plus longue dans une GitHub Discussion ou une issue.
-
-* Il y a aussi de bonnes chances que la pull request ne soit pas rĂ©ellement nĂ©cessaire parce que le problĂšme peut ĂȘtre rĂ©solu d'une **autre maniĂšre**. Vous pouvez alors le suggĂ©rer ou poser la question.
-
-### Ne pas s'inquiĂ©ter du style { #dont-worry-about-style }
-
-* Ne vous souciez pas trop des choses comme les styles de messages de commit, je ferai un squash and merge en personnalisant le commit manuellement.
-
-* Ne vous inquiĂ©tez pas non plus des rĂšgles de style, il existe dĂ©jĂ  des outils automatisĂ©s qui vĂ©rifient cela.
-
-Et s'il y a d'autres besoins de style ou de cohĂ©rence, je le demanderai directement, ou j'ajouterai des commits par‑dessus avec les changements nĂ©cessaires.
-
-### VĂ©rifier le code { #check-the-code }
-
-* VĂ©rifiez et lisez le code, voyez s'il a du sens, **exĂ©cutez‑le localement** et voyez s'il rĂ©sout effectivement le problĂšme.
-
-* Ensuite, **commentez** en disant que vous l'avez fait, c'est ainsi que je saurai que vous l'avez vraiment vĂ©rifiĂ©.
-
-/// info
-
-Malheureusement, je ne peux pas simplement faire confiance aux PR qui ont juste plusieurs approbations.
-
-Plusieurs fois, il est arrivĂ© qu'il y ait des PR avec 3, 5 ou plus approbations, probablement parce que la description est attrayante, mais lorsque je vĂ©rifie les PR, elles sont en fait cassĂ©es, ont un bug, ou ne rĂ©solvent pas le problĂšme qu'elles prĂ©tendent rĂ©soudre. đŸ˜…
-
-Donc, il est vraiment important que vous lisiez et exĂ©cutiez le code, et que vous me le disiez dans les commentaires. đŸ€“
-
-///
-
-* Si la PR peut ĂȘtre simplifiĂ©e d'une certaine maniĂšre, vous pouvez le demander, mais il n'est pas nĂ©cessaire d'ĂȘtre trop pointilleux, il peut y avoir beaucoup de points de vue subjectifs (et j'aurai les miens aussi đŸ™ˆ), donc il est prĂ©fĂ©rable de vous concentrer sur les choses fondamentales.
-
-### Tests { #tests }
-
-* Aidez‑moi Ă  vĂ©rifier que la PR a des **tests**.
-
-* VĂ©rifiez que les tests **Ă©chouent** avant la PR. đŸšš
-
-* Puis vĂ©rifiez que les tests **rĂ©ussissent** aprĂšs la PR. âœ…
-
-* Beaucoup de PR n'ont pas de tests, vous pouvez leur **rappeler** d'ajouter des tests, ou mĂȘme **suggĂ©rer** des tests vous‑mĂȘme. C'est l'une des choses qui consomment le plus de temps et vous pouvez beaucoup aider.
-
-* Commentez aussi ce que vous avez essayĂ©, ainsi je saurai que vous l'avez vĂ©rifiĂ©. đŸ€“
-
-## CrĂ©er une Pull Request { #create-a-pull-request }
-
-Vous pouvez [contribuer](contributing.md) au code source avec des Pull Requests, par exemple :
-
-* Corriger une coquille que vous avez trouvĂ©e dans la documentation.
-* Partager un article, une vidĂ©o ou un podcast que vous avez créé ou trouvĂ© Ă  propos de FastAPI en [modifiant ce fichier](https://github.com/fastapi/fastapi/edit/master/docs/en/data/external_links.yml).
-    * Vous devez vous assurer d'ajouter votre lien au dĂ©but de la section correspondante.
-* Aider Ă  [traduire la documentation](contributing.md#translations) dans votre langue.
-    * Vous pouvez aussi aider Ă  relire les traductions créées par d'autres.
-* Proposer de nouvelles sections de documentation.
-* Corriger une issue/un bug existant.
-    * Vous devez ajouter des tests.
-* Ajouter une nouvelle fonctionnalitĂ©.
-    * Vous devez ajouter des tests.
-    * Vous devez ajouter de la documentation si c'est pertinent.
-
-## Aider Ă  maintenir FastAPI { #help-maintain-fastapi }
-
-Aidez‑moi Ă  maintenir **FastAPI** ! đŸ€“
-
-Il y a beaucoup de travail Ă  faire, et pour la plupart, **VOUS** pouvez le faire.
-
-Les principales tĂąches que vous pouvez faire dĂšs maintenant sont :
-
-* [Aider les autres avec des questions sur GitHub](#help-others-with-questions-in-github) (voir la section ci‑dessus).
-* [Relire des Pull Requests](#review-pull-requests) (voir la section ci‑dessus).
-
-Ces deux tĂąches sont celles qui **consomment le plus de temps**. C'est le travail principal de la maintenance de FastAPI.
-
-Si vous pouvez m'aider avec cela, **vous m'aidez Ă  maintenir FastAPI** et Ă  vous assurer qu'il continue **d'avancer plus vite et mieux**. đŸš€
-
 ## Rejoindre le chat { #join-the-chat }
 
 Rejoignez le đŸ‘„ [serveur Discord](https://discord.gg/VQjSZaeJmf) đŸ‘„ et Ă©changez avec d'autres membres de la communautĂ© FastAPI.
 
 /// tip | Astuce
 
-Pour les questions, posez‑les dans [GitHub Discussions](https://github.com/fastapi/fastapi/discussions/new?category=questions), vous avez bien plus de chances de recevoir de l'aide par les [Experts FastAPI](fastapi-people.md#fastapi-experts).
+Pour les questions, posez‑les dans GitHub Discussions, vous avez bien plus de chances de recevoir de l'aide.
 
 Utilisez le chat uniquement pour d'autres conversations gĂ©nĂ©rales.
 
 ///
 
-### N'utilisez pas le chat pour les questions { #dont-use-the-chat-for-questions }
+### Ne pas utiliser le chat pour les questions { #dont-use-the-chat-for-questions }
 
 Gardez Ă  l'esprit que, comme les chats permettent une Â« conversation libre Â», il est facile de poser des questions trop gĂ©nĂ©rales et plus difficiles Ă  rĂ©pondre ; vous pourriez donc ne pas recevoir de rĂ©ponses.
 
-Sur GitHub, le modĂšle vous guidera pour rĂ©diger la bonne question afin que vous puissiez plus facilement obtenir une bonne rĂ©ponse, ou mĂȘme rĂ©soudre le problĂšme vous‑mĂȘme avant de demander. Et sur GitHub, je peux m'assurer de toujours tout rĂ©pondre, mĂȘme si cela prend du temps. Je ne peux pas personnellement faire cela avec les systĂšmes de chat. đŸ˜…
-
-Les conversations dans les systĂšmes de chat ne sont pas non plus aussi facilement recherchables que sur GitHub, donc les questions et rĂ©ponses peuvent se perdre dans la conversation. Et seules celles sur GitHub comptent pour devenir un [Expert FastAPI](fastapi-people.md#fastapi-experts), vous aurez donc trĂšs probablement plus d'attention sur GitHub.
-
-D'un autre cĂŽtĂ©, il y a des milliers d'utilisateurs dans les systĂšmes de chat, il y a donc de fortes chances que vous trouviez presque toujours quelqu'un avec qui parler. đŸ˜„
-
-## Sponsoriser l'auteur { #sponsor-the-author }
-
-Si votre **produit/entreprise** dĂ©pend de **FastAPI** ou y est liĂ© et que vous souhaitez atteindre ses utilisateurs, vous pouvez sponsoriser l'auteur (moi) via [GitHub sponsors](https://github.com/sponsors/tiangolo). Selon le niveau, vous pourriez obtenir des avantages supplĂ©mentaires, comme un badge dans les documents. đŸŽ
-
----
+Sur GitHub, le modĂšle vous guidera pour rĂ©diger la bonne question afin que vous puissiez plus facilement obtenir une bonne rĂ©ponse, ou mĂȘme rĂ©soudre le problĂšme vous‑mĂȘme avant de demander.
 
-Merci ! đŸš€
+Les conversations dans les systĂšmes de chat ne sont pas non plus aussi facilement recherchables que sur GitHub, elles se perdent.
index 97230b7b925620d07bc9dbc8c8c61dcd8042ec7d..55bc8bdc9e3d5bffed5f408e5b2363a91c87580f 100644 (file)
@@ -172,7 +172,7 @@ Comme la liste est un type qui contient des types internes, mettez-les entre cro
 
 {* ../../docs_src/python_types/tutorial006_py310.py hl[1] *}
 
-/// info
+/// note | Remarque
 
 Ces types internes entre crochets sont appelĂ©s Â« paramĂštres de type Â».
 
@@ -283,7 +283,7 @@ Un exemple tirĂ© de la documentation officielle de Pydantic :
 
 {* ../../docs_src/python_types/tutorial011_py310.py *}
 
-/// info
+/// note | Remarque
 
 Pour en savoir plus Ă  propos de [Pydantic, consultez sa documentation](https://docs.pydantic.dev/).
 
@@ -341,7 +341,7 @@ Tout cela peut sembler abstrait. Ne vous inquiĂ©tez pas. Vous verrez tout cela e
 
 L'important est qu'en utilisant les types standards de Python, en un seul endroit (au lieu d'ajouter plus de classes, de dĂ©corateurs, etc.), **FastAPI** fera une grande partie du travail pour vous.
 
-/// info
+/// note | Remarque
 
 Si vous avez dĂ©jĂ  parcouru tout le tutoriel et ĂȘtes revenu pour en voir plus sur les types, une bonne ressource est [l'« aide-mĂ©moire Â» de `mypy`](https://mypy.readthedocs.io/en/latest/cheat_sheet_py3.html).
 
index 82e204224c87a410f9b8e4f4c07e5971e549be7a..d5e1bb5673ce968fb4ff44a4f791db38a4acead4 100644 (file)
@@ -4,7 +4,7 @@ Si vous crĂ©ez une application ou une API web, il est rare que vous puissiez tou
 
 **FastAPI** fournit un outil pratique pour structurer votre application tout en conservant toute la flexibilitĂ©.
 
-/// info
+/// note | Remarque
 
 Si vous venez de Flask, cela Ă©quivaut aux Blueprints de Flask.
 
@@ -194,7 +194,7 @@ Avoir des `dependencies` dans le `APIRouter` peut servir, par exemple, Ă  exiger
 
 ///
 
-/// check | VĂ©rifications
+/// tip | Astuce
 
 Les paramĂštres `prefix`, `tags`, `responses` et `dependencies` sont (comme dans de nombreux autres cas) simplement une fonctionnalitĂ© de **FastAPI** pour vous aider Ă  Ă©viter la duplication de code.
 
@@ -339,7 +339,7 @@ Nous pourrions aussi les importer ainsi :
 from app.routers import items, users
 ```
 
-/// info
+/// note | Remarque
 
 La premiĂšre version est un Â« import relatif Â» :
 
@@ -382,7 +382,7 @@ Incluons maintenant les `router` des sous-modules `users` et `items` :
 
 {* ../../docs_src/bigger_applications/app_an_py310/main.py hl[10:11] title["app/main.py"] *}
 
-/// info
+/// note | Remarque
 
 `users.router` contient le `APIRouter` Ă  l'intĂ©rieur du fichier `app/routers/users.py`.
 
@@ -402,7 +402,7 @@ Donc, en coulisses, cela fonctionnera comme si tout faisait partie d'une seule e
 
 ///
 
-/// check | VĂ©rifications
+/// tip | Astuce
 
 Vous n'avez pas Ă  vous soucier de la performance lors de l'inclusion de routeurs.
 
@@ -451,7 +451,7 @@ Ici, nous le faisons ... juste pour montrer que nous le pouvons đŸ€· :
 
 et cela fonctionnera correctement, avec tous les autres *chemins d'accĂšs* ajoutĂ©s avec `app.include_router()`.
 
-/// info | DĂ©tails trĂšs techniques
+/// note | DĂ©tails trĂšs techniques
 
 Note : c'est un dĂ©tail trĂšs technique que vous pouvez probablement **simplement ignorer**.
 
@@ -482,7 +482,7 @@ from app.main import app
 
 De cette façon, la commande `fastapi` saura oĂč trouver votre app.
 
-/// Note | Remarque
+/// note | Remarque
 
 Vous pourriez aussi passer le chemin Ă  la commande, comme :
 
index 608559c858f77d0f9bd30d834d6b945105474159..5d5844fc80bcf2af7ce0bd695900bbc4555b371b 100644 (file)
@@ -24,7 +24,7 @@ Mais rappelez-vous que lorsque vous importez `Query`, `Path`, `Header` et d'autr
 
 ///
 
-/// info
+/// note | Remarque
 
 Pour dĂ©clarer des en-tĂȘtes, vous devez utiliser `Header`, sinon les paramĂštres seraient interprĂ©tĂ©s comme des paramĂštres de requĂȘte.
 
index 94bc650723c8dfb9d3cd3e93eb38974cd5b9b023..c9eefb37be03906db98c4ac94330d921075deb3e 100644 (file)
@@ -2,7 +2,7 @@
 
 Lorsque vous travaillez sur des projets Python, vous devriez probablement utiliser un environnement virtuel (ou un mĂ©canisme similaire) pour isoler les packages que vous installez pour chaque projet.
 
-/// info
+/// note | Remarque
 
 Si vous connaissez dĂ©jĂ  les environnements virtuels, comment les crĂ©er et les utiliser, vous pouvez passer cette section. đŸ€“
 
@@ -18,7 +18,7 @@ Un environnement virtuel est un rĂ©pertoire contenant certains fichiers.
 
 ///
 
-/// info
+/// note | Remarque
 
 Cette page vous apprendra Ă  utiliser les environnements virtuels et Ă  comprendre leur fonctionnement.