🌐 Add Portuguese translation for docs/pt/docs/tutorial/response-model.md#12933
Conversation
|
📝 Docs preview for commit 496c6e5 at: https://0a7ff239.fastapitiangolo.pages.dev Modified Pages |
ceb10n
left a comment
There was a problem hiding this comment.
Really great work @AndreBBM
I didn't find anything wrong. But I've added some suggestions to keep the standards for the portuguse translation...
It's approved since there are only suggestions, but feel free to add them if you want :D
| @@ -0,0 +1,357 @@ | |||
| # Modelo de resposta - Tipo de retorno | |||
|
|
|||
| Você pode declarar o tipo usado para a resposta anotando o **tipo de retorno** *da função de operação de caminho (path operation function)*. | |||
There was a problem hiding this comment.
The pattern used in portuguese translations for path operation is "operação de rota".
So it would be nice to keep it. It would be something like:
Você pode declarar o tipo usado para a resposta anotando o tipo de retorno da função de operação de rota
|
|
||
| Nesses casos, você pode usar o parâmetro `response_model` do *path operation decorator* em vez do tipo de retorno. | ||
|
|
||
| Você pode usar o parâmetro `response_model` em qualquer uma das *operações de caminho (path operations)*: |
There was a problem hiding this comment.
You can remove the (path operations) and just keep the translation to operações de rota
|
|
||
| Se você adicionasse a anotação do tipo de retorno, ferramentas e editores reclamariam com um erro (correto) informando que sua função está retornando um tipo (por exemplo, um dict) diferente do que você declarou (por exemplo, um modelo Pydantic). | ||
|
|
||
| Nesses casos, você pode usar o parâmetro `response_model` do *path operation decorator* em vez do tipo de retorno. |
There was a problem hiding this comment.
You can translate path operation decorator to decorador de operação de rota.
|
|
||
| {* ../../docs_src/response_model/tutorial001_py310.py hl[17,22,24:27] *} | ||
|
|
||
| /// note |
There was a problem hiding this comment.
You can add the translation for this admonition:
/// note | Nota
|
|
||
| /// note | ||
|
|
||
| Observe que `response_model` é um parâmetro do método "decorator" (`get`, `post`, etc). Não da sua *função de operação de caminho (path operation function)*, como todos os parâmetros e corpo. |
There was a problem hiding this comment.
You can change
função de operação de caminho (path operation function)
to
função de operação de rota
|
|
||
| ### `response_model_include` e `response_model_exclude` | ||
|
|
||
| Você também pode usar os parâmetros `response_model_include` e `response_model_exclude` do *path operation decorator*. |
There was a problem hiding this comment.
You can translate to decorador de operação de rota
|
|
||
| Isso pode ser usado como um atalho rápido se você tiver apenas um modelo Pydantic e quiser remover alguns dados da saída. | ||
|
|
||
| /// tip | dica |
There was a problem hiding this comment.
You can use a capital letter here:
/// tip | Dica
|
|
||
| {* ../../docs_src/response_model/tutorial005_py310.py hl[29,35] *} | ||
|
|
||
| /// tip | dica |
There was a problem hiding this comment.
You can use a capital letter here:
/// tip | Dica
|
|
||
| /// | ||
|
|
||
| #### Usando `listas` em vez de `set`s |
There was a problem hiding this comment.
I think you can remove the translation to lists here:
Usando `list`s em vez de `set`s
|
|
||
| ## Recapitulação | ||
|
|
||
| Use o parâmetro `response_model` do *path operation decorator* para definir modelos de resposta e, especialmente, para garantir que dados privados sejam filtrados. |
There was a problem hiding this comment.
You can translate to decorador de operação de rota.
|
Thank you for the review, @ceb10n I'll update the PR! |
|
📝 Docs preview for commit abc347b at: https://154c6c6c.fastapitiangolo.pages.dev Modified Pages |
|
📝 Docs preview for commit e62cf9b at: https://26d01fdd.fastapitiangolo.pages.dev Modified Pages |
nazarepiedady
left a comment
There was a problem hiding this comment.
Thanks for your collaboration, @AndreBBM.
docs/pt/docs/tutorial/response-model.md
|
📝 Docs preview for commit c79d7ed at: https://dcb82442.fastapitiangolo.pages.dev Modified Pages |
No description provided.