Merge 3.10 into 3.9

github-actions · github-actions · commit bd519b7f9a34 · 2021-11-08T23:27:23.000Z
diff --git a/faq/programming.po b/faq/programming.po
@@ -43,8 +43,8 @@ msgid ""
 "Is there a source code level debugger with breakpoints, single-stepping, "
 "etc.?"
 msgstr ""
-"Existe um depurador a nível de código-fonte que possui breakpoints, single-"
-"stepping e etc.?"
+"Existe um depurador a nível de código-fonte que possuo pontos de interrupção "
+"(breakpoints), single-stepping etc.?"
 
 #: ../../faq/programming.rst:17 ../../faq/programming.rst:57
 msgid "Yes."
@@ -90,6 +90,12 @@ msgid ""
 "the `ActivePython <https://www.activestate.com/products/python/>`_ "
 "distribution."
 msgstr ""
+"O PythonWin é uma IDE feita para o Python que inclui um depurador de GUI "
+"baseado no pdb. O depurador PythonWin colora os pontos de interrupção e tem "
+"alguns recursos legais, como a depuração de programas que não são PythonWin. "
+"O PythonWin está disponível como parte do projeto `pywin32 <https://github."
+"com/mhammond/pywin32>`_ e como parte da distribuição `ActivePython <https://"
+"www.activestate.com/products/python/>`_."
 
 #: ../../faq/programming.rst:38
 msgid ""
@@ -104,6 +110,8 @@ msgid ""
 "`trepan3k <https://github.com/rocky/python3-trepan/>`_ is a gdb-like "
 "debugger."
 msgstr ""
+"`trepan3k <https://github.com/rocky/python3-trepan/>`_ é um depurador "
+"similar ao gdb."
 
 #: ../../faq/programming.rst:43
 msgid ""
@@ -123,15 +131,15 @@ msgstr ""
 
 #: ../../faq/programming.rst:49
 msgid "`Wing IDE <https://wingware.com/>`_"
-msgstr ""
+msgstr "`Wing IDE <https://wingware.com/>`_"
 
 #: ../../faq/programming.rst:50
 msgid "`Komodo IDE <https://www.activestate.com/products/komodo-ide/>`_"
-msgstr ""
+msgstr "`Komodo IDE <https://www.activestate.com/products/komodo-ide/>`_"
 
 #: ../../faq/programming.rst:51
 msgid "`PyCharm <https://www.jetbrains.com/pycharm/>`_"
-msgstr ""
+msgstr "`PyCharm <https://www.jetbrains.com/pycharm/>`_"
 
 #: ../../faq/programming.rst:55
 msgid "Are there tools to help find bugs or perform static analysis?"
@@ -222,29 +230,32 @@ msgstr ""
 
 #: ../../faq/programming.rst:97
 msgid "`Nuitka <https://nuitka.net/>`_ (Cross-platform)"
-msgstr ""
+msgstr "`Nuitka <https://nuitka.net/>`_ (Multiplataforma)"
 
 #: ../../faq/programming.rst:98
 msgid "`PyInstaller <http://www.pyinstaller.org/>`_ (Cross-platform)"
-msgstr ""
+msgstr "`PyInstaller <http://www.pyinstaller.org/>`_ (Multiplataforma)"
 
 #: ../../faq/programming.rst:99
 msgid ""
 "`PyOxidizer <https://pyoxidizer.readthedocs.io/en/stable/>`_ (Cross-platform)"
 msgstr ""
+"`PyOxidizer <https://pyoxidizer.readthedocs.io/en/stable/>`_ "
+"(Multiplataforma)"
 
 #: ../../faq/programming.rst:100
 msgid ""
 "`cx_Freeze <https://marcelotduarte.github.io/cx_Freeze/>`_ (Cross-platform)"
 msgstr ""
+"`cx_Freeze <https://marcelotduarte.github.io/cx_Freeze/>`_ (Multiplataforma)"
 
 #: ../../faq/programming.rst:101
 msgid "`py2app <https://github.com/ronaldoussoren/py2app>`_ (macOS only)"
-msgstr ""
+msgstr "`py2app <https://github.com/ronaldoussoren/py2app>`_ (somente macOS)"
 
 #: ../../faq/programming.rst:102
 msgid "`py2exe <http://www.py2exe.org/>`_ (Windows only)"
-msgstr ""
+msgstr "`py2exe <http://www.py2exe.org/>`_ (somente Windows)"
 
 #: ../../faq/programming.rst:105
 msgid "Are there coding standards or a style guide for Python programs?"
@@ -361,6 +372,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:201
 msgid ""
@@ -705,11 +724,11 @@ msgid ""
 "tuple and the keyword arguments as a dictionary.  You can then pass these "
 "arguments when calling another function by using ``*`` and ``**``::"
 msgstr ""
-"Preceda os argumentos com o uso de especificadores (asteriscos) ``*`` ou "
-"``**`` na lista de parâmetros da função; Isso faz com que os argumentos "
-"posicionais como uma tupla e os keyword arguments sejam passados como um "
-"dicionário. Poderás, também, passar esses argumentos ao invocar outra função "
-"usando ``*`` e ``**``::"
+"Colete os argumentos usando os especificadores ``*`` ou ``**`` na lista de "
+"parâmetros da função. Isso faz com que os argumentos posicionais como tupla "
+"e os argumentos nomeados sejam passados como um dicionário. Você pode, "
+"também, passar esses argumentos ao invocar outra função usando ``*`` e "
+"``**``::"
 
 #: ../../faq/programming.rst:408
 msgid "What is the difference between arguments and parameters?"
@@ -824,6 +843,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:480
 msgid ""
@@ -834,6 +862,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:487
 msgid "In other words:"
@@ -1025,6 +1059,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:670
 msgid ""
@@ -1065,6 +1103,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:688
 msgid ""
@@ -1132,13 +1175,15 @@ msgstr ""
 
 #: ../../faq/programming.rst:734
 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:736
 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:763
 msgid "Don't try this at home, kids!"
@@ -1157,13 +1202,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:784
 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:795
 msgid "Numbers and strings"
@@ -1212,6 +1266,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:832
 msgid ""
@@ -1221,6 +1278,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:840
 msgid "How do I convert a string to a number?"
@@ -1245,6 +1307,12 @@ msgid ""
 "the number is interpreted using Python's rules: a leading '0o' indicates "
 "octal, and '0x' indicates a hex number."
 msgstr ""
+"Por padrão, eles interpretam o número como decimal, de modo que "
+"``int('0144') == 144`` é verdadeiro e ``int('0x144')`` levanta :exc:"
+"`ValueError`. ``int(string, base)`` toma a base para converter como um "
+"segundo argumento opcional, então ``int( '0x144', 16) == 324``. Se a base "
+"for especificada como 0, o número é interpretado usando as regras do Python: "
+"um \"0o\" à esquerda indica octal e \"0x\" indica um número hexadecimal."
 
 #: ../../faq/programming.rst:853
 msgid ""
@@ -1255,13 +1323,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:860
 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:866
 msgid "How do I convert a number to a string?"
@@ -2181,7 +2258,7 @@ msgid ""
 "using default arguments.  For example::"
 msgstr ""
 "Em Python você tem que escrever um único construtor que pega todos os casos "
-"usando argumentos padrões. Por exemplo:: "
+"usando argumentos padrão. Por exemplo::"
 
 #: ../../faq/programming.rst:1641
 msgid "This is not entirely equivalent, but close enough in practice."
