Merge 3.11 into 3.9

Author: github-actions

reference/expressions.po

@@ -554,13 +554,18 @@ msgid ""
 "The parentheses can be omitted on calls with only one argument.  See "
 "section :ref:`calls` for details."
 msgstr ""
+"Os parênteses podem ser omitidos em chamadas com apenas um argumento. Veja a "
+"seção :ref:`calls` para detalhes."
 
 #: ../../reference/expressions.rst:385
 msgid ""
 "To avoid interfering with the expected operation of the generator expression "
 "itself, ``yield`` and ``yield from`` expressions are prohibited in the "
 "implicitly defined generator."
 msgstr ""
+"Para evitar interferir com a operação esperada da própria expressão "
+"geradora, as expressões ``yield`` e ``yield from`` são proibidas no gerador "
+"definido implicitamente."
 
 #: ../../reference/expressions.rst:389
 msgid ""
@@ -570,21 +575,29 @@ msgid ""
 "asynchronous generator object, which is an asynchronous iterator (see :ref:"
 "`async-iterators`)."
 msgstr ""
+"Se uma expressão geradora contém cláusulas :keyword:`!async for` ou "
+"expressões :keyword:`await`, ela é chamada de :dfn:`expressão geradora "
+"assíncrona`. Uma expressão geradora assíncrona retorna um novo objeto "
+"gerador assíncrono, que é um iterador assíncrono (consulte :ref:`async-"
+"iterators`)."
 
 #: ../../reference/expressions.rst:395
 msgid "Asynchronous generator expressions were introduced."
-msgstr ""
+msgstr "Expressões geradoras assíncronas foram introduzidas."
 
 #: ../../reference/expressions.rst:398
 msgid ""
 "Prior to Python 3.7, asynchronous generator expressions could only appear "
 "in :keyword:`async def` coroutines.  Starting with 3.7, any function can use "
 "asynchronous generator expressions."
 msgstr ""
+"Antes do Python 3.7, as expressões geradoras assíncronas só podiam aparecer "
+"em corrotinas :keyword:`async def`. A partir da versão 3.7, qualquer função "
+"pode usar expressões geradoras assíncronas."
 
 #: ../../reference/expressions.rst:410
 msgid "Yield expressions"
-msgstr ""
+msgstr "Expressões yield"
 
 #: ../../reference/expressions.rst:422
 msgid ""
@@ -602,19 +615,27 @@ msgid ""
 "not permitted as part of the implicitly defined scopes used to implement "
 "comprehensions and generator expressions."
 msgstr ""
+"Devido a seus efeitos colaterais no escopo recipiente, as expressões "
+"``yield`` não são permitidas como parte dos escopos definidos implicitamente "
+"usados para implementar compreensões e expressões geradoras."
 
 #: ../../reference/expressions.rst:439
 msgid ""
 "Yield expressions prohibited in the implicitly nested scopes used to "
 "implement comprehensions and generator expressions."
 msgstr ""
+"Expressões yield proibidas nos escopos aninhados implicitamente usados para "
+"implementar compreensões e expressões geradoras."
 
 #: ../../reference/expressions.rst:443
 msgid ""
 "Generator functions are described below, while asynchronous generator "
 "functions are described separately in section :ref:`asynchronous-generator-"
 "functions`."
 msgstr ""
+"As funções geradoras são descritas abaixo, enquanto as funções geradoras "
+"assíncronas são descritas separadamente na seção :ref:`asynchronous-"
+"generator-functions`"
 
 #: ../../reference/expressions.rst:447
 msgid ""
@@ -644,6 +665,11 @@ msgid ""
 "function cannot control where the execution should continue after it yields; "
 "the control is always transferred to the generator's caller."
 msgstr ""
+"Tudo isso torna as funções geradoras bastante semelhantes às corrotinas; "
+"cedem múltiplas vezes, possuem mais de um ponto de entrada e sua execução "
+"pode ser suspensa. A única diferença é que uma função geradora não pode "
+"controlar onde a execução deve continuar após o seu rendimento; o controle é "
+"sempre transferido para o chamador do gerador."
 
 #: ../../reference/expressions.rst:472
 msgid ""
@@ -653,6 +679,11 @@ msgid ""
 "meth:`~generator.close` method will be called, allowing any pending :keyword:"
 "`finally` clauses to execute."
 msgstr ""
+"Expressões yield são permitidas em qualquer lugar em uma construção :keyword:"
+"`try`. Se o gerador não for retomado antes de ser finalizado (ao atingir uma "
+"contagem de referências zero ou ao ser coletado como lixo), o método :meth:"
+"`~generator.close` do iterador de gerador será chamado, permitindo que "
+"quaisquer cláusulas :keyword:`finally` pendentes sejam executadas."
 
 #: ../../reference/expressions.rst:481
 msgid ""
@@ -665,6 +696,14 @@ msgid ""
 "exc:`AttributeError` or :exc:`TypeError`, while :meth:`~generator.throw` "
 "will just raise the passed in exception immediately."
 msgstr ""
+"Quando ``yield from <expr>`` é usado, a expressão fornecida deve ser "
+"iterável. Os valores produzidos pela iteração desse iterável são passados "
+"diretamente para o chamador dos métodos do gerador atual. Quaisquer valores "
+"passados com :meth:`~generator.send` e quaisquer exceções passadas com :meth:"
+"`~generator.throw` são passados para o iterador subjacente se ele tiver os "
+"métodos apropriados. Se este não for o caso, então :meth:`~generator.send` "
+"irá levantar :exc:`AttributeError` ou :exc:`TypeError`, enquanto :meth:"
+"`~generator.throw` irá apenas levantar a exceção passada imediatamente."
 
 #: ../../reference/expressions.rst:490
 msgid ""
@@ -674,16 +713,25 @@ msgid ""
 "`StopIteration`, or automatically when the subiterator is a generator (by "
 "returning a value from the subgenerator)."
 msgstr ""
+"Quando o iterador subjacente estiver completo, o atributo :attr:"
+"`~StopIteration.value` da instância :exc:`StopIteration` gerada torna-se o "
+"valor da expressão yield. Ele pode ser definido explicitamente ao levantar :"
+"exc:`StopIteration` ou automaticamente quando o subiterador é um gerador "
+"(retornando um valor do subgerador)."
 
 #: ../../reference/expressions.rst:496
 msgid "Added ``yield from <expr>`` to delegate control flow to a subiterator."
 msgstr ""
+"Adicionado ``yield from <expr>`` para delegar o fluxo de controle a um "
+"subiterador."
 
 #: ../../reference/expressions.rst:499
 msgid ""
 "The parentheses may be omitted when the yield expression is the sole "
 "expression on the right hand side of an assignment statement."
 msgstr ""
+"Os parênteses podem ser omitidos quando a expressão yield é a única "
+"expressão no lado direito de uma instrução de atribuição."
 
 #: ../../reference/expressions.rst:505
 msgid ":pep:`255` - Simple Generators"
@@ -694,6 +742,7 @@ msgid ""
 "The proposal for adding generators and the :keyword:`yield` statement to "
 "Python."
 msgstr ""
+"A proposta para adicionar geradores e a instrução :keyword:`yield` ao Python."
 
 #: ../../reference/expressions.rst:509
 msgid ":pep:`342` - Coroutines via Enhanced Generators"
@@ -704,6 +753,8 @@ msgid ""
 "The proposal to enhance the API and syntax of generators, making them usable "
 "as simple coroutines."
 msgstr ""
+"A proposta de aprimorar a API e a sintaxe dos geradores, tornando-os "
+"utilizáveis como simples corrotinas."
 
 #: ../../reference/expressions.rst:513
 msgid ":pep:`380` - Syntax for Delegating to a Subgenerator"
@@ -717,29 +768,35 @@ msgstr ""
 
 #: ../../reference/expressions.rst:516
 msgid ":pep:`525` - Asynchronous Generators"
-msgstr ""
+msgstr ":pep:`525` - Geradores assíncronos"
 
 #: ../../reference/expressions.rst:516
 msgid ""
 "The proposal that expanded on :pep:`492` by adding generator capabilities to "
 "coroutine functions."
 msgstr ""
+"A proposta que se expandiu em :pep:`492` adicionando recursos de gerador a "
+"funções de corrotina."
 
 #: ../../reference/expressions.rst:523
 msgid "Generator-iterator methods"
-msgstr ""
+msgstr "Métodos de iterador gerador"
 
 #: ../../reference/expressions.rst:525
 msgid ""
 "This subsection describes the methods of a generator iterator.  They can be "
 "used to control the execution of a generator function."
 msgstr ""
+"Esta subseção descreve os métodos de um iterador gerador. Eles podem ser "
+"usados para controlar a execução de uma função geradora."
 
 #: ../../reference/expressions.rst:528
 msgid ""
 "Note that calling any of the generator methods below when the generator is "
 "already executing raises a :exc:`ValueError` exception."
 msgstr ""
+"Observe que chamar qualquer um dos métodos do gerador abaixo quando o "
+"gerador já estiver em execução levanta uma exceção :exc:`ValueError`."
 
 #: ../../reference/expressions.rst:536
 msgid ""
@@ -758,6 +815,8 @@ msgid ""
 "This method is normally called implicitly, e.g. by a :keyword:`for` loop, or "
 "by the built-in :func:`next` function."
 msgstr ""
+"Este método é normalmente chamado implicitamente, por exemplo por um laço :"
+"keyword:`for`, ou pela função embutida :func:`next`."
 
 #: ../../reference/expressions.rst:551
 msgid ""
@@ -769,6 +828,12 @@ msgid ""
 "called with :const:`None` as the argument, because there is no yield "
 "expression that could receive the value."
 msgstr ""
+"Retoma a execução e \"envia\" um valor para a função geradora. O argumento "
+"*value* torna-se o resultado da expressão yield atual. O método :meth:`send` "
+"retorna o próximo valor gerado pelo gerador, ou levanta :exc:`StopIteration` "
+"se o gerador sair sem produzir outro valor. Quando :meth:`send` é chamado "
+"para iniciar o gerador, ele deve ser chamado com :const:`None` como "
+"argumento, porque não há nenhuma expressão yield que possa receber o valor."
 
 #: ../../reference/expressions.rst:562
 msgid ""
@@ -790,6 +855,13 @@ msgid ""
 "is propagated to the caller.  :meth:`close` does nothing if the generator "
 "has already exited due to an exception or normal exit."
 msgstr ""
+"Levanta :exc:`GeneratorExit` no ponto onde a função geradora foi pausada. Se "
+"a função geradora sair normalmente, já estiver fechada ou levantar :exc:"
+"`GeneratorExit` (por não capturar a exceção), \"close\" retornará ao seu "
+"chamador. Se o gerador produzir um valor, um :exc:`RuntimeError` é "
+"levantado. Se o gerador levantar qualquer outra exceção, ela será propagada "
+"para o chamador. :meth:`close` não faz nada se o gerador já saiu devido a "
+"uma exceção ou saída normal."
 
 #: ../../reference/expressions.rst:584
 msgid "Examples"
@@ -800,12 +872,16 @@ msgid ""
 "Here is a simple example that demonstrates the behavior of generators and "
 "generator functions::"
 msgstr ""
+"Aqui está um exemplo simples que demonstra o comportamento de geradores e "
+"funções geradoras::"
 
 #: ../../reference/expressions.rst:613
 msgid ""
 "For examples using ``yield from``, see :ref:`pep-380` in \"What's New in "
 "Python.\""
 msgstr ""
+"Para exemplos usando ``yield from``, consulte a :ref:`pep-380` em \"O que há "
+"de novo no Python.\""
 
 #: ../../reference/expressions.rst:619
 msgid "Asynchronous generator functions"