@ -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 <dfntitle="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.
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). 🎨
### `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`.
# 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 :
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.
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).
@ -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` :
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.
Sebastián Ramírez
3 days ago
GitHub