From c8f8b3dead3dd76a347ecc5435208ac89d54d23f Mon Sep 17 00:00:00 2001 From: Rafael de Oliveira Marques Date: Fri, 24 Oct 2025 10:59:56 -0300 Subject: [PATCH] rerun after a few changes in llm-prompt --- docs/pt/docs/tutorial/bigger-applications.md | 14 +++++----- .../dependencies/classes-as-dependencies.md | 28 +++++++++---------- 2 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/pt/docs/tutorial/bigger-applications.md b/docs/pt/docs/tutorial/bigger-applications.md index 8bbe622da..c479eb5d9 100644 --- a/docs/pt/docs/tutorial/bigger-applications.md +++ b/docs/pt/docs/tutorial/bigger-applications.md @@ -81,7 +81,7 @@ Mas ele ainda faz parte da mesma aplicação/web API **FastAPI** (faz parte do m Você pode criar as *operações de rotas* para esse módulo usando o `APIRouter`. -### Importar `APIRouter` { #import-apirouter } +### Importe `APIRouter` { #import-apirouter } você o importa e cria uma "instância" da mesma maneira que faria com a classe `FastAPI`: @@ -234,7 +234,7 @@ Os parâmetros `prefix`, `tags`, `responses` e `dependencies` são (como em muit /// -### Importar as dependências { #import-the-dependencies } +### Importe as dependências { #import-the-dependencies } Este código reside no módulo `app.routers.items`, o arquivo `app/routers/items.py`. @@ -420,7 +420,7 @@ Então, para poder usar ambos no mesmo arquivo, importamos os submódulos direta {!../../docs_src/bigger_applications/app/main.py!} ``` -### Incluir o `APIRouter`s para `usuários` e `itens` { #include-the-apirouters-for-users-and-items } +### Inclua os `APIRouter`s para `usuários` e `itens` { #include-the-apirouters-for-users-and-items } Agora, vamos incluir os `router`s dos submódulos `users` e `items`: @@ -458,7 +458,7 @@ Então não afetará o desempenho. ⚡ /// -### Incluir um `APIRouter` com um `prefix`, `tags`, `responses` e `dependencies` personalizados { #include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies } +### Inclua um `APIRouter` com um `prefix`, `tags`, `responses` e `dependencies` personalizados { #include-an-apirouter-with-a-custom-prefix-tags-responses-and-dependencies } Agora, vamos imaginar que sua organização lhe deu o arquivo `app/internal/admin.py`. @@ -491,7 +491,7 @@ Mas isso afetará apenas o `APIRouter` em nosso aplicativo, e não em nenhum out Assim, por exemplo, outros projetos poderiam usar o mesmo `APIRouter` com um método de autenticação diferente. -### Incluir uma *operação de rota* { #include-a-path-operation } +### Inclua uma *operação de rota* { #include-a-path-operation } Também podemos adicionar *operações de rota* diretamente ao aplicativo `FastAPI`. @@ -537,7 +537,7 @@ Você verá a documentação automática da API, incluindo os caminhos de todos -## Incluir o mesmo roteador várias vezes com `prefix` diferentes { #include-the-same-router-multiple-times-with-different-prefix } +## Inclua o mesmo roteador várias vezes com `prefix` diferentes { #include-the-same-router-multiple-times-with-different-prefix } Você também pode usar `.include_router()` várias vezes com o *mesmo* roteador usando prefixos diferentes. @@ -545,7 +545,7 @@ Isso pode ser útil, por exemplo, para expor a mesma API sob prefixos diferentes Esse é um uso avançado que você pode não precisar, mas está lá caso precise. -## Incluir um `APIRouter` em outro { #include-an-apirouter-in-another } +## Inclua um `APIRouter` em outro { #include-an-apirouter-in-another } Da mesma forma que você pode incluir um `APIRouter` em um aplicativo `FastAPI`, você pode incluir um `APIRouter` em outro `APIRouter` usando: diff --git a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md index ef67aa979..061b0b654 100644 --- a/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md +++ b/docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md @@ -1,8 +1,8 @@ -# Classes como Dependências +# Classes como Dependências { #classes-as-dependencies } Antes de nos aprofundarmos no sistema de **Injeção de Dependência**, vamos melhorar o exemplo anterior. -## `dict` do exemplo anterior +## `dict` do exemplo anterior { #a-dict-from-the-previous-example } No exemplo anterior, nós retornávamos um `dict` da nossa dependência ("injetável"): @@ -14,7 +14,7 @@ E sabemos que editores de texto não têm como oferecer muitas funcionalidades ( Podemos fazer melhor... -## O que caracteriza uma dependência +## O que caracteriza uma dependência { #what-makes-a-dependency } Até agora você apenas viu dependências declaradas como funções. @@ -38,7 +38,7 @@ something(some_argument, some_keyword_argument="foo") Então esse objeto é um "chamável". -## Classes como dependências +## Classes como dependências { #classes-as-dependencies_1 } Você deve ter percebido que para criar um instância de uma classe em Python, a mesma sintaxe é utilizada. @@ -89,7 +89,7 @@ Em ambos os casos teremos: Os dados serão convertidos, validados, documentados no esquema da OpenAPI e etc nos dois casos. -## Utilizando +## Utilizando { #use-it } Agora você pode declarar sua dependência utilizando essa classe. @@ -97,7 +97,7 @@ Agora você pode declarar sua dependência utilizando essa classe. O **FastAPI** chama a classe `CommonQueryParams`. Isso cria uma "instância" dessa classe e é a instância que será passada para o parâmetro `commons` na sua função. -## Anotações de Tipo vs `Depends` +## Anotações de Tipo vs `Depends` { #type-annotation-vs-depends } Perceba como escrevemos `CommonQueryParams` duas vezes no código abaixo: @@ -109,7 +109,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)] //// -//// tab | Python 3.8+ non-Annotated +//// tab | Python 3.8+ não anotado /// tip | Dica @@ -145,7 +145,7 @@ commons: Annotated[CommonQueryParams, ... //// -//// tab | Python 3.8+ non-Annotated +//// tab | Python 3.8+ não anotado /// tip | Dica @@ -171,7 +171,7 @@ commons: Annotated[Any, Depends(CommonQueryParams)] //// -//// tab | Python 3.8+ non-Annotated +//// tab | Python 3.8+ não anotado /// tip | Dica @@ -189,11 +189,11 @@ commons = Depends(CommonQueryParams) {* ../../docs_src/dependencies/tutorial003_an_py310.py hl[19] *} -Mas declarar o tipo é encorajado por que é a forma que o seu editor de texto sabe o que será passado como valor do parâmetro `commons`. +Mas declarar o tipo é encorajado por que é a forma que o seu editor de texto sabe o que será passado como valor do parâmetro `commons`, e assim ele pode ajudar com preenchimento automático, verificações de tipo, etc: -## Pegando um Atalho +## Pegando um Atalho { #shortcut } Mas você pode ver que temos uma repetição do código neste exemplo, escrevendo `CommonQueryParams` duas vezes: @@ -205,7 +205,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)] //// -//// tab | Python 3.8+ non-Annotated +//// tab | Python 3.8+ não anotado /// tip | Dica @@ -233,7 +233,7 @@ commons: Annotated[CommonQueryParams, Depends(CommonQueryParams)] //// -//// tab | Python 3.8+ non-Annotated +//// tab | Python 3.8+ não anotado /// tip | Dica @@ -257,7 +257,7 @@ commons: Annotated[CommonQueryParams, Depends()] //// -//// tab | Python 3.8 non-Annotated +//// tab | Python 3.8 não anotado /// tip | Dica