5
5
#
6
6
# Translators:
7
7
# Marco Rougeth <marco@rougeth.com>, 2021
8
- # Hemílio Lauro <hemilioaraujo@gmail.com>, 2021
9
8
# Flávio Neves, 2022
10
9
# Nicolas Evangelista, 2022
11
- # Ruan Aragão <ruanaragao2@gmail.com>, 2023
12
10
# PAULO NASCIMENTO, 2024
13
11
# Rafael Fontenelle <rffontenelle@gmail.com>, 2024
12
+ # José Carlos, 2024
13
+ # Adorilson Bezerra <adorilson@gmail.com>, 2024
14
14
#
15
15
#, fuzzy
16
16
msgid ""
17
17
msgstr ""
18
18
"Project-Id-Version : Python 3.13\n "
19
19
"Report-Msgid-Bugs-To : \n "
20
- "POT-Creation-Date : 2024-05-24 14:15+0000\n "
20
+ "POT-Creation-Date : 2024-07-12 14:15+0000\n "
21
21
"PO-Revision-Date : 2021-06-28 00:52+0000\n "
22
- "Last-Translator : Rafael Fontenelle <rffontenelle @gmail.com>, 2024\n "
22
+ "Last-Translator : Adorilson Bezerra <adorilson @gmail.com>, 2024\n "
23
23
"Language-Team : Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
24
24
"teams/5390/pt_BR/)\n "
25
25
"MIME-Version : 1.0\n "
@@ -31,11 +31,11 @@ msgstr ""
31
31
32
32
#: ../../howto/annotations.rst:5
33
33
msgid "Annotations Best Practices"
34
- msgstr "Boas Práticas de Anotação "
34
+ msgstr "Boas práticas para anotações "
35
35
36
36
#: ../../howto/annotations.rst:0
37
37
msgid "author"
38
- msgstr "autor "
38
+ msgstr "Autor "
39
39
40
40
#: ../../howto/annotations.rst:7
41
41
msgid "Larry Hastings"
@@ -80,15 +80,15 @@ msgid ""
80
80
"`typing` module."
81
81
msgstr ""
82
82
"Note que este documento é específico sobre trabalhar com "
83
- "``__annotations__``, não usa para anotações. Se você está procurando por "
84
- "informações sobre como usar \" type hints\" no seu código, por favor veja o "
85
- "módulo :mod:`typing`"
83
+ "``__annotations__``, não para o uso *de* anotações. Se você está procurando "
84
+ "por informações sobre como usar \" type hints\" no seu código, por favor veja "
85
+ "o módulo :mod:`typing`"
86
86
87
87
#: ../../howto/annotations.rst:33
88
88
msgid "Accessing The Annotations Dict Of An Object In Python 3.10 And Newer"
89
89
msgstr ""
90
- "Acessando O Dicionário De Anotações De Um Objeto No Python 3.10 E Nas "
91
- "Versões Mais Recente. "
90
+ "Acessando o dicionário de anotações de um objeto no Python 3.10 e nas "
91
+ "versões mais recentes "
92
92
93
93
#: ../../howto/annotations.rst:35
94
94
msgid ""
@@ -100,8 +100,8 @@ msgid ""
100
100
msgstr ""
101
101
"O Python 3.10 adicionou uma nova função para a biblioteca padrão: :func:"
102
102
"`inspect.get_annotations`. No Python 3.10 e nas versões mais recentes, "
103
- "chamando esta função é a melhor pratica para acessar o dicionário de "
104
- "anotações de qualquer objeto que suporta anotações. Esta função pode até "
103
+ "chamar esta função é a melhor prática para acessar o dicionário de anotações "
104
+ "de qualquer objeto com suporte a anotações. Esta função pode até "
105
105
"\" destextualizar\" anotações textualizadas para você."
106
106
107
107
#: ../../howto/annotations.rst:42
@@ -116,12 +116,11 @@ msgid ""
116
116
msgstr ""
117
117
"Se por alguma razão :func:`inspect.get_annotations` não for viável para o "
118
118
"seu caso de uso, você pode acessar o membro de dados ``__annotations__`` "
119
- "manualmente. As melhores práticas para isto também mudaram no Python 3.10: A "
120
- "partir do Python 3.10, ``o.__annotations__`` é garantido de *sempre* "
121
- "funcionar em funções, classes e módulos Python. Se você tem certeza que o "
122
- "objeto que você está examinando é um desses três *exatos* objetos, pode "
123
- "simplesmente usar ``o.__annotations__`` para chegar no dicionário de "
124
- "anotações do objeto."
119
+ "manualmente. As melhores práticas para isto também mudaram no Python 3.10: a "
120
+ "partir do Python 3.10, ``o.__annotations__`` é garantido *sempre* funcionar "
121
+ "em funções, classes e módulos Python. Se você tem certeza que o objeto que "
122
+ "você está examinando é um desses três *exatos* objetos, pode simplesmente "
123
+ "usar ``o.__annotations__`` para chegar no dicionário de anotações do objeto."
125
124
126
125
#: ../../howto/annotations.rst:52
127
126
msgid ""
@@ -153,8 +152,8 @@ msgstr ""
153
152
#: ../../howto/annotations.rst:68
154
153
msgid "Accessing The Annotations Dict Of An Object In Python 3.9 And Older"
155
154
msgstr ""
156
- "Acessando O Dicionário De Anotações De Um Objeto No Python 3.9 E Nas Versões "
157
- "Mais Antigas. "
155
+ "Acessando o dicionário de anotações de um objeto no Python 3.9 e nas versões "
156
+ "mais antigas "
158
157
159
158
#: ../../howto/annotations.rst:70
160
159
msgid ""
@@ -175,6 +174,11 @@ msgid ""
175
174
"should use three-argument :func:`getattr` to access the object's "
176
175
"``__annotations__`` attribute."
177
176
msgstr ""
177
+ "As melhores práticas para acessar os dicionários de anotações de outros "
178
+ "objetos, funções, outros chamáveis e módulos - são as mesmas melhores "
179
+ "práticas para 3.10, supondo que você não esteja chamando :func:`inspect."
180
+ "get_annotations`: você deve usar a função :func:`getattr` com três "
181
+ "argumentos para acessar os atributos do objeto ``__annotations__``."
178
182
179
183
#: ../../howto/annotations.rst:82
180
184
msgid ""
@@ -184,10 +188,16 @@ msgid ""
184
188
"``__annotations__`` attribute of a class may inadvertently return the "
185
189
"annotations dict of a *base class.* As an example::"
186
190
msgstr ""
191
+ "Infelizmente, essas não são as melhores práticas para classes. O problema é "
192
+ "que, como ``__annotations__`` é opcional nas classes, e posto que classes "
193
+ "podem herdar atributos das suas classes base, acessar o atributo "
194
+ "``__annotations__`` de uma classe pode inesperadamente retornar o dicionário "
195
+ "de anotações de uma *classe base.* Por exemplo::"
187
196
188
197
#: ../../howto/annotations.rst:98
189
198
msgid "This will print the annotations dict from ``Base``, not ``Derived``."
190
199
msgstr ""
200
+ "Isso mostrará o dicionário de anotações de ``Base``, não de ``Derived``."
191
201
192
202
#: ../../howto/annotations.rst:101
193
203
msgid ""
@@ -198,27 +208,43 @@ msgid ""
198
208
"dictionary. Since the class may or may not have annotations defined, best "
199
209
"practice is to call the ``get`` method on the class dict."
200
210
msgstr ""
211
+ "Seu código deve seguir uma abordagem diferente caso o objeto que você esteja "
212
+ "examinando seja uma classe (``isinstance(o, type)``). Nesse caso, a melhor "
213
+ "prática está ligada a um detalhe de implementação do Python 3.9 e "
214
+ "anteriores: se a classe possui anotações definidas, elas são armazenadas no "
215
+ "dicionário ``__dict__`` da classe. Como a classe pode ou não ter anotações "
216
+ "definidas, a melhor prática é chamar o método ``get`` no dicionário da "
217
+ "classe."
201
218
202
219
#: ../../howto/annotations.rst:109
203
220
msgid ""
204
221
"To put it all together, here is some sample code that safely accesses the "
205
222
"``__annotations__`` attribute on an arbitrary object in Python 3.9 and "
206
223
"before::"
207
224
msgstr ""
225
+ "Considerando tudo isso, aqui está um exemplo de código que acessa de forma "
226
+ "segura o atributo ``__annotations__`` em um objeto arbitrário em Python 3.9 "
227
+ "e anteriores::"
208
228
209
229
#: ../../howto/annotations.rst:118
210
230
msgid ""
211
231
"After running this code, ``ann`` should be either a dictionary or ``None``. "
212
232
"You're encouraged to double-check the type of ``ann`` using :func:"
213
233
"`isinstance` before further examination."
214
234
msgstr ""
235
+ "Após executar este código, ``ann`` deve ser um dicionário ou ``None``. Você "
236
+ "é encorajado a fazer uma checagem dupla do tipo de ``ann`` utilizando :func:"
237
+ "`isinstance` antes de uma análise mais aprofundada."
215
238
216
239
#: ../../howto/annotations.rst:123
217
240
msgid ""
218
241
"Note that some exotic or malformed type objects may not have a ``__dict__`` "
219
242
"attribute, so for extra safety you may also wish to use :func:`getattr` to "
220
243
"access ``__dict__``."
221
244
msgstr ""
245
+ "Note que alguns tipos de objetos exóticos ou mal formatados podem não "
246
+ "possuir um atributo ``__dict__``, então por precaução você também pode "
247
+ "querer usar :func:`getattr` para acessar ``__dict__``."
222
248
223
249
#: ../../howto/annotations.rst:129
224
250
msgid "Manually Un-Stringizing Stringized Annotations"
@@ -304,7 +330,7 @@ msgstr ""
304
330
305
331
#: ../../howto/annotations.rst:179
306
332
msgid "Best Practices For ``__annotations__`` In Any Python Version"
307
- msgstr "Melhores Prática Para ``__annotations__`` Em Qualquer Versão Python"
333
+ msgstr "Melhores práticas para ``__annotations__`` em qualquer versão Python"
308
334
309
335
#: ../../howto/annotations.rst:181
310
336
msgid ""
@@ -327,7 +353,7 @@ msgstr ""
327
353
328
354
#: ../../howto/annotations.rst:191
329
355
msgid "You should avoid modifying ``__annotations__`` dicts."
330
- msgstr "Você deve evitar modificar ``__annotations__`` dicts ."
356
+ msgstr "Você deve evitar modificar o dicionário ``__annotations__``."
331
357
332
358
#: ../../howto/annotations.rst:193
333
359
msgid ""
0 commit comments