Merge 3.10 into 3.8

github-actions · github-actions · commit 331e35920713 · 2021-11-08T23:27:22.000Z
diff --git a/faq/programming.po b/faq/programming.po
@@ -386,6 +386,14 @@ msgid ""
 "a component of an imported module.  This clutter would defeat the usefulness "
 "of the ``global`` declaration for identifying side-effects."
 msgstr ""
+"Embora um pouco surpreendente no início, um momento de consideração explica "
+"isso. Por um lado, exigir :keyword:`global` para variáveis atribuídas "
+"fornece uma barreira contra efeitos colaterais indesejados. Por outro lado, "
+"se ``global`` fosse necessário para todas as referências globais, você "
+"estaria usando ``global`` o tempo todo. Você teria que declarar como global "
+"todas as referências a uma função embutida ou a um componente de um módulo "
+"importado. Essa desordem anularia a utilidade da declaração de ``global`` "
+"para identificar efeitos colaterais."
 
 #: ../../faq/programming.rst:211
 msgid ""
@@ -849,6 +857,15 @@ msgid ""
 "copy of ``y``, you'll instead end up with ``None``, which will likely cause "
 "your program to generate an easily diagnosed error."
 msgstr ""
+"Algumas operações (por exemplo, ``y.append(10)`` e ``y.sort()``) alteram o "
+"objeto, enquanto operações superficialmente semelhantes (por exemplo ``y = y "
+"+ [10]`` e ``sorted(y)``) cria um novo objeto. Em geral em Python (e em "
+"todos os casos na biblioteca padrão) um método que transforma um objeto "
+"retornará ``None`` para ajudar a evitar confundir os dois tipos de "
+"operações. Portanto, se você escrever por engano ``y.sort()`` pensando que "
+"lhe dará uma cópia ordenada de ``y``, você terminará com ``None``, o que "
+"provavelmente fará com que seu programa gere um erro facilmente "
+"diagnosticado."
 
 #: ../../faq/programming.rst:490
 msgid ""
@@ -859,6 +876,12 @@ msgid ""
 "mutates ``a_list``, whereas ``some_tuple += (1, 2, 3)`` and ``some_int += "
 "1`` create new objects)."
 msgstr ""
+"No entanto, há uma classe de operações em que a mesma operação às vezes tem "
+"comportamentos diferentes com tipos diferentes: os operadores de atribuição "
+"aumentada. Por exemplo, ``+=`` transforma listas, mas não tuplas ou ints "
+"(``a_list += [1, 2, 3]`` é equivalente a``a_list.extend([1, 2, 3])`` a "
+"altera ``a_list``, sendo que ``some_tuple += (1, 2, 3)`` e ``some_int += 1`` "
+"cria novos objetos)."
 
 #: ../../faq/programming.rst:497
 msgid "In other words:"
@@ -1050,6 +1073,10 @@ msgid ""
 "``def`` and ``class`` statements, but in that case the value is a callable. "
 "Consider the following code::"
 msgstr ""
+"De um modo geral, não pode, porque os objetos realmente não têm nomes. "
+"Essencialmente, a atribuição sempre liga um nome a um valor; o mesmo é "
+"verdade para as instruções ``def`` e ``class``, mas nesse caso o valor é um "
+"chamável. Considere o seguinte código::"
 
 #: ../../faq/programming.rst:677
 msgid ""
@@ -1090,6 +1117,11 @@ msgid ""
 "so the only way to find out what it's called is to ask all your neighbours "
 "(namespaces) if it's their cat (object)..."
 msgstr ""
+"Da mesma forma que você pega o nome daquele gato que encontrou na sua "
+"varanda: o próprio gato (objeto) não pode lhe dizer o seu nome, e ele "
+"realmente não se importa -- então a única maneira de descobrir como ele se "
+"chama é perguntar a todos os seus vizinhos (espaços de nomes) se é o gato "
+"deles (objeto)..."
 
 #: ../../faq/programming.rst:695
 msgid ""
@@ -1157,13 +1189,15 @@ msgstr ""
 
 #: ../../faq/programming.rst:741
 msgid "Is it possible to write obfuscated one-liners in Python?"
-msgstr ""
+msgstr "É possível escrever instruções de uma só linha ofuscadas em Python?"
 
 #: ../../faq/programming.rst:743
 msgid ""
 "Yes.  Usually this is done by nesting :keyword:`lambda` within :keyword:`!"
 "lambda`.  See the following three examples, due to Ulf Bartelt::"
 msgstr ""
+"sim. Normalmente, isso é feito aninhando :keyword:`lambda` dentro de :"
+"keyword:`!lambda`. Veja os três exemplos a seguir, devido a Ulf Bartelt::"
 
 #: ../../faq/programming.rst:770
 msgid "Don't try this at home, kids!"
@@ -1182,13 +1216,22 @@ msgid ""
 "position. For example, :func:`divmod` is a function that accepts positional-"
 "only parameters. Its documentation looks like this::"
 msgstr ""
+"Uma barra na lista de argumentos de uma função indica que os parâmetros "
+"anteriores são somente-posicionais. Parâmetros somente-posicionais são "
+"aqueles sem um nome utilizável externamente. Ao chamar uma função que aceita "
+"parâmetros somente-posicionais, os argumentos são mapeados para parâmetros "
+"com base apenas em sua posição. Por exemplo, :func:`divmod` é uma função que "
+"aceita parâmetros somente-posicionais. Sua documentação se parece com isto::"
 
 #: ../../faq/programming.rst:791
 msgid ""
 "The slash at the end of the parameter list means that both parameters are "
 "positional-only. Thus, calling :func:`divmod` with keyword arguments would "
 "lead to an error::"
 msgstr ""
+"A barra no final da lista de parâmetros significa que ambos os parâmetros "
+"são somente-posicionais. Assim, chamar :func:`divmod` com argumentos "
+"nomeados levaria a um erro::"
 
 #: ../../faq/programming.rst:802
 msgid "Numbers and strings"
@@ -1237,6 +1280,9 @@ msgid ""
 "identity to hold, and then compilers that truncate ``i // j`` need to make "
 "``i % j`` have the same sign as ``i``."
 msgstr ""
+"então a divisão inteira deve retornar o piso. C também requer que essa "
+"identidade seja mantida, e então os compiladores que truncarem ``i // j`` "
+"precisam fazer com que ``i % j`` tenham o mesmo sinal que ``i``."
 
 #: ../../faq/programming.rst:839
 msgid ""
@@ -1246,6 +1292,11 @@ msgid ""
 "say 200 hours ago?  ``-190 % 12 == 2`` is useful; ``-190 % 12 == -10`` is a "
 "bug waiting to bite."
 msgstr ""
+"Existem poucos casos de uso reais para ``i % j`` quando ``j`` é negativo. "
+"Quando ``j`` é positivo, existem muitos, e em virtualmente todos eles é mais "
+"útil para ``i % j`` ser ``>= 0``. Se o relógio marca 10 agora, o que dizia "
+"há 200 horas? ``-190 % 12 == 2`` é útil, enquanto ``-190 % 12 == -10`` é um "
+"bug esperando para morder."
 
 #: ../../faq/programming.rst:847
 msgid "How do I convert a string to a number?"
@@ -1280,13 +1331,22 @@ msgid ""
 "``__import__('os').system(\"rm -rf $HOME\")`` which would erase your home "
 "directory."
 msgstr ""
+"Não use a função embutida :func:`eval` se tudo que você precisa é converter "
+"strings em números. :func:`eval` será significativamente mais lento e "
+"apresenta um risco de segurança: alguém pode passar a você uma expressão "
+"Python que pode ter efeitos colaterais indesejados. Por exemplo, alguém "
+"poderia passar ``__import__('os').system(\"rm -rf $HOME\")`` que apagaria "
+"seu diretório pessoal."
 
 #: ../../faq/programming.rst:866
 msgid ""
 ":func:`eval` also has the effect of interpreting numbers as Python "
 "expressions, so that e.g. ``eval('09')`` gives a syntax error because Python "
 "does not allow leading '0' in a decimal number (except '0')."
 msgstr ""
+":func:`eval` também tem o efeito de interpretar números como expressões "
+"Python, para que, por exemplo, ``eval('09')`` dá um erro de sintaxe porque "
+"Python não permite '0' inicial em um número decimal (exceto '0')."
 
 #: ../../faq/programming.rst:872
 msgid "How do I convert a number to a string?"
