Browse Source

rerun after a few changes in llm-prompt

pull/14228/head
Rafael de Oliveira Marques 9 months ago
parent
commit
c8f8b3dead
  1. 14
      docs/pt/docs/tutorial/bigger-applications.md
  2. 28
      docs/pt/docs/tutorial/dependencies/classes-as-dependencies.md

14
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
<img src="/img/tutorial/bigger-applications/image01.png">
## 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:

28
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:
<img src="/img/tutorial/dependencies/image02.png">
## 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

Loading…
Cancel
Save