Browse Source

🌐 Add Portuguese translation for `docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-operators.md` (#11804)

pull/11811/head
João Pedro Pereira Holanda 9 months ago
committed by GitHub
parent
commit
4eb8db3cd3
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 138
      docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md

138
docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-decorators.md

@ -0,0 +1,138 @@
# Dependências em decoradores de operações de rota
Em alguns casos você não precisa necessariamente retornar o valor de uma dependência dentro de uma *função de operação de rota*.
Ou a dependência não retorna nenhum valor.
Mas você ainda precisa que ela seja executada/resolvida.
Para esses casos, em vez de declarar um parâmetro em uma *função de operação de rota* com `Depends`, você pode adicionar um argumento `dependencies` do tipo `list` ao decorador da operação de rota.
## Adicionando `dependencies` ao decorador da operação de rota
O *decorador da operação de rota* recebe um argumento opcional `dependencies`.
Ele deve ser uma lista de `Depends()`:
=== "Python 3.9+"
```Python hl_lines="19"
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
```
=== "Python 3.8+"
```Python hl_lines="18"
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
```
=== "Python 3.8 non-Annotated"
!!! tip "Dica"
Utilize a versão com `Annotated` se possível
```Python hl_lines="17"
{!> ../../../docs_src/dependencies/tutorial006.py!}
```
Essas dependências serão executadas/resolvidas da mesma forma que dependências comuns. Mas o valor delas (se existir algum) não será passado para a sua *função de operação de rota*.
!!! tip "Dica"
Alguns editores de texto checam parâmetros de funções não utilizados, e os mostram como erros.
Utilizando `dependencies` no *decorador da operação de rota* você pode garantir que elas serão executadas enquanto evita errors de editores/ferramentas.
Isso também pode ser útil para evitar confundir novos desenvolvedores que ao ver um parâmetro não usado no seu código podem pensar que ele é desnecessário.
!!! info "Informação"
Neste exemplo utilizamos cabeçalhos personalizados inventados `X-Keys` e `X-Token`.
Mas em situações reais, como implementações de segurança, você pode obter mais vantagens em usar as [Ferramentas de segurança integradas (o próximo capítulo)](../security/index.md){.internal-link target=_blank}.
## Erros das dependências e valores de retorno
Você pode utilizar as mesmas *funções* de dependências que você usaria normalmente.
### Requisitos de Dependências
Dependências podem declarar requisitos de requisições (como cabeçalhos) ou outras subdependências:
=== "Python 3.9+"
```Python hl_lines="8 13"
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
```
=== "Python 3.8+"
```Python hl_lines="7 12"
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
```
=== "Python 3.8 non-Annotated"
!!! tip "Dica"
Utilize a versão com `Annotated` se possível
```Python hl_lines="6 11"
{!> ../../../docs_src/dependencies/tutorial006.py!}
```
### Levantando exceções
Essas dependências podem levantar exceções, da mesma forma que dependências comuns:
=== "Python 3.9+"
```Python hl_lines="10 15"
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
```
=== "Python 3.8+"
```Python hl_lines="9 14"
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
```
=== "Python 3.8 non-Annotated"
!!! tip "Dica"
Utilize a versão com `Annotated` se possível
```Python hl_lines="8 13"
{!> ../../../docs_src/dependencies/tutorial006.py!}
```
### Valores de retorno
E elas também podem ou não retornar valores, eles não serão utilizados.
Então, você pode reutilizar uma dependência comum (que retorna um valor) que já seja utilizada em outro lugar, e mesmo que o valor não seja utilizado, a dependência será executada:
=== "Python 3.9+"
```Python hl_lines="11 16"
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
```
=== "Python 3.8+"
```Python hl_lines="10 15"
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
```
=== "Python 3.8 non-Annotated"
!!! tip "Dica"
Utilize a versão com `Annotated` se possível
```Python hl_lines="9 14"
{!> ../../../docs_src/dependencies/tutorial006.py!}
```
## Dependências para um grupo de *operações de rota*
Mais a frente, quando você ler sobre como estruturar aplicações maiores ([Bigger Applications - Multiple Files](../../tutorial/bigger-applications.md){.internal-link target=_blank}), possivelmente com múltiplos arquivos, você aprenderá a declarar um único parâmetro `dependencies` para um grupo de *operações de rota*.
## Dependências globais
No próximo passo veremos como adicionar dependências para uma aplicação `FastAPI` inteira, para que ela seja aplicada em toda *operação de rota*.
Loading…
Cancel
Save