Merge 3.11 into 3.7

github-actions · github-actions · commit 248f12b80015 · 2023-04-21T23:11:22.000Z
diff --git a/reference/expressions.po b/reference/expressions.po
@@ -534,6 +534,8 @@ 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:374
 msgid ""
@@ -552,21 +554,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:386
 msgid "Asynchronous generator expressions were introduced."
-msgstr ""
+msgstr "Expressões geradoras assíncronas foram introduzidas."
 
 #: ../../reference/expressions.rst:389
 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:401
 msgid "Yield expressions"
-msgstr ""
+msgstr "Expressões yield"
 
 #: ../../reference/expressions.rst:413
 msgid ""
@@ -599,6 +609,9 @@ msgid ""
 "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:440
 msgid ""
@@ -628,6 +641,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:465
 msgid ""
@@ -637,6 +655,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:474
 msgid ""
@@ -658,16 +681,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:489
 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:492
 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:498
 msgid ":pep:`255` - Simple Generators"
@@ -678,6 +710,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:502
 msgid ":pep:`342` - Coroutines via Enhanced Generators"
@@ -688,6 +721,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:506
 msgid ":pep:`380` - Syntax for Delegating to a Subgenerator"
@@ -701,29 +736,35 @@ msgstr ""
 
 #: ../../reference/expressions.rst:509
 msgid ":pep:`525` - Asynchronous Generators"
-msgstr ""
+msgstr ":pep:`525` - Geradores assíncronos"
 
 #: ../../reference/expressions.rst:509
 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:516
 msgid "Generator-iterator methods"
-msgstr ""
+msgstr "Métodos de iterador gerador"
 
 #: ../../reference/expressions.rst:518
 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:521
 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:529
 msgid ""
@@ -742,6 +783,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:544
 msgid ""
@@ -753,6 +796,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:555
 msgid ""
@@ -774,6 +823,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:577
 msgid "Examples"
@@ -784,12 +840,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:606
 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:612
 msgid "Asynchronous generator functions"
