55#
66# Translators:
77# Marco Rougeth <marco@rougeth.com>, 2021
8- # Hemílio Lauro <hemilioaraujo@gmail.com>, 2021
98# Flávio Neves, 2022
109# Nicolas Evangelista, 2022
11- # Ruan Aragão <ruanaragao2@gmail.com>, 2023
1210# PAULO NASCIMENTO, 2024
1311# Rafael Fontenelle <rffontenelle@gmail.com>, 2024
12+ # José Carlos, 2024
13+ # Adorilson Bezerra <adorilson@gmail.com>, 2024
1414#
1515#, fuzzy
1616msgid ""
1717msgstr ""
1818"Project-Id-Version : Python 3.13\n "
1919"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 "
2121"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 "
2323"Language-Team : Portuguese (Brazil) (https://app.transifex.com/python-doc/ "
2424"teams/5390/pt_BR/)\n "
2525"MIME-Version : 1.0\n "
@@ -31,11 +31,11 @@ msgstr ""
3131
3232#: ../../howto/annotations.rst:5
3333msgid "Annotations Best Practices"
34- msgstr "Boas Práticas de Anotação "
34+ msgstr "Boas práticas para anotações "
3535
3636#: ../../howto/annotations.rst:0
3737msgid "author"
38- msgstr "autor "
38+ msgstr "Autor "
3939
4040#: ../../howto/annotations.rst:7
4141msgid "Larry Hastings"
@@ -80,15 +80,15 @@ msgid ""
8080"`typing` module."
8181msgstr ""
8282"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`"
8686
8787#: ../../howto/annotations.rst:33
8888msgid "Accessing The Annotations Dict Of An Object In Python 3.10 And Newer"
8989msgstr ""
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 "
9292
9393#: ../../howto/annotations.rst:35
9494msgid ""
@@ -100,8 +100,8 @@ msgid ""
100100msgstr ""
101101"O Python 3.10 adicionou uma nova função para a biblioteca padrão: :func:"
102102"`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é "
105105"\" destextualizar\" anotações textualizadas para você."
106106
107107#: ../../howto/annotations.rst:42
@@ -116,12 +116,11 @@ msgid ""
116116msgstr ""
117117"Se por alguma razão :func:`inspect.get_annotations` não for viável para o "
118118"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."
125124
126125#: ../../howto/annotations.rst:52
127126msgid ""
@@ -153,8 +152,8 @@ msgstr ""
153152#: ../../howto/annotations.rst:68
154153msgid "Accessing The Annotations Dict Of An Object In Python 3.9 And Older"
155154msgstr ""
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 "
158157
159158#: ../../howto/annotations.rst:70
160159msgid ""
@@ -175,6 +174,11 @@ msgid ""
175174"should use three-argument :func:`getattr` to access the object's "
176175"``__annotations__`` attribute."
177176msgstr ""
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__``."
178182
179183#: ../../howto/annotations.rst:82
180184msgid ""
@@ -184,10 +188,16 @@ msgid ""
184188"``__annotations__`` attribute of a class may inadvertently return the "
185189"annotations dict of a *base class.* As an example::"
186190msgstr ""
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::"
187196
188197#: ../../howto/annotations.rst:98
189198msgid "This will print the annotations dict from ``Base``, not ``Derived``."
190199msgstr ""
200+ "Isso mostrará o dicionário de anotações de ``Base``, não de ``Derived``."
191201
192202#: ../../howto/annotations.rst:101
193203msgid ""
@@ -198,27 +208,43 @@ msgid ""
198208"dictionary. Since the class may or may not have annotations defined, best "
199209"practice is to call the ``get`` method on the class dict."
200210msgstr ""
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."
201218
202219#: ../../howto/annotations.rst:109
203220msgid ""
204221"To put it all together, here is some sample code that safely accesses the "
205222"``__annotations__`` attribute on an arbitrary object in Python 3.9 and "
206223"before::"
207224msgstr ""
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::"
208228
209229#: ../../howto/annotations.rst:118
210230msgid ""
211231"After running this code, ``ann`` should be either a dictionary or ``None``. "
212232"You're encouraged to double-check the type of ``ann`` using :func:"
213233"`isinstance` before further examination."
214234msgstr ""
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."
215238
216239#: ../../howto/annotations.rst:123
217240msgid ""
218241"Note that some exotic or malformed type objects may not have a ``__dict__`` "
219242"attribute, so for extra safety you may also wish to use :func:`getattr` to "
220243"access ``__dict__``."
221244msgstr ""
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__``."
222248
223249#: ../../howto/annotations.rst:129
224250msgid "Manually Un-Stringizing Stringized Annotations"
@@ -304,7 +330,7 @@ msgstr ""
304330
305331#: ../../howto/annotations.rst:179
306332msgid "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"
308334
309335#: ../../howto/annotations.rst:181
310336msgid ""
@@ -327,7 +353,7 @@ msgstr ""
327353
328354#: ../../howto/annotations.rst:191
329355msgid "You should avoid modifying ``__annotations__`` dicts."
330- msgstr "Você deve evitar modificar ``__annotations__`` dicts ."
356+ msgstr "Você deve evitar modificar o dicionário ``__annotations__``."
331357
332358#: ../../howto/annotations.rst:193
333359msgid ""
0 commit comments