python
diff --git a/‎faq/library.po
Lines changed: 115 additions & 7 deletions b/‎faq/library.po
Lines changed: 115 additions & 7 deletions
@@ -17,7 +17,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-04-19 14:13+0000\n"
+"POT-Creation-Date: 2024-04-26 14:13+0000\n"
 "PO-Revision-Date: 2021-06-28 00:52+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -119,7 +119,7 @@ msgid ""
 "interpreter."
 msgstr ""
 "Você precisa fazer duas coisas: o arquivo do script deve ser executável e a "
-"primeira linha deve começar com \"#!\" seguido do caminho do interpretador "
+"primeira linha deve começar com ``#!`` seguido do caminho do interpretador "
 "Python."
 
 #: ../../faq/library.rst:53
@@ -211,6 +211,12 @@ msgid ""
 "but there don't seem to be any currently maintained OSes that fall into this "
 "category."
 msgstr ""
+"O módulo :mod:`curses` provê recursos básicos de curses, bem como muitas "
+"funções adicionais de ncurses e curses SYSV, como cor, suporte a conjuntos "
+"de caracteres alternativos, pads e suporte a mouse. Isso significa que o "
+"módulo não é compatível com sistemas operacionais que possuem apenas "
+"maldições BSD, mas não parece haver nenhum sistema operacional mantido "
+"atualmente que se enquadre nesta categoria."
 
 #: ../../faq/library.rst:111
 msgid "Is there an equivalent to C's onexit() in Python?"
@@ -221,6 +227,8 @@ msgid ""
 "The :mod:`atexit` module provides a register function that is similar to "
 "C's :c:func:`!onexit`."
 msgstr ""
+"O módulo :mod:`atexit` fornece uma função de registro similar ao :c:func:`!"
+"onexit` do C."
 
 #: ../../faq/library.rst:118
 msgid "Why don't my signal handlers work?"
@@ -236,7 +244,7 @@ msgstr ""
 
 #: ../../faq/library.rst:125
 msgid "so it should be declared with two parameters::"
-msgstr ""
+msgstr "portanto, isso deve ser declarado com dois parâmetros::"
 
 #: ../../faq/library.rst:132
 msgid "Common tasks"
@@ -252,7 +260,7 @@ msgid ""
 "examples in the docstrings for a module and runs them, comparing the output "
 "with the expected output given in the docstring."
 msgstr ""
-"A Python vem com dois frameworks de teste. O :mod:`doctest` busca por "
+"A Python vem com dois frameworks de teste. O módulo :mod:`doctest` busca por "
 "exemplos nas docstrings de um módulo e os executa, comparando o resultado "
 "com a saída esperada informada na docstring."
 
@@ -274,6 +282,13 @@ msgid ""
 "avoid depending on mutating global variables, since this makes testing much "
 "more difficult to do."
 msgstr ""
+"Para facilitar os testes, você deve usar um bom design modular em seu "
+"programa. Seu programa deve ter quase todas as funcionalidades encapsuladas "
+"em funções ou métodos de classe -- e isso às vezes tem o efeito "
+"surpreendente e agradável de fazer o programa executar mais rápido (porque "
+"os acessos às variáveis locais são mais rápidos que os acessos globais). "
+"Além disso, o programa deve evitar depender de variáveis globais mutantes, "
+"pois isso torna os testes muito mais difíceis de serem realizados."
 
 #: ../../faq/library.rst:152
 msgid "The \"global main logic\" of your program may be as simple as ::"
@@ -294,12 +309,23 @@ msgid ""
 "the \"production code\", since this makes it easy to find bugs and even "
 "design flaws earlier."
 msgstr ""
+"Depois que seu programa estiver organizado como uma coleção tratável de "
+"comportamentos de funções e classes, você deverá escrever funções de teste "
+"que exercitem os comportamentos. Um conjunto de testes que automatiza uma "
+"sequência de testes pode ser associado a cada módulo. Parece muito "
+"trabalhoso, mas como o Python é tão conciso e flexível, é surpreendentemente "
+"fácil. Você pode tornar a codificação muito mais agradável e divertida "
+"escrevendo suas funções de teste em paralelo com o \"código de produção\", "
+"pois isso torna mais fácil encontrar bugs e até mesmo falhas de design mais "
+"cedo."
 
 #: ../../faq/library.rst:167
 msgid ""
 "\"Support modules\" that are not intended to be the main module of a program "
 "may include a self-test of the module. ::"
 msgstr ""
+"Os \"módulos de suporte\" que não se destinam a ser o módulo principal de um "
+"programa podem incluir um autoteste do módulo. ::"
 
 #: ../../faq/library.rst:173
 msgid ""
@@ -322,6 +348,11 @@ msgid ""
 "docstrings is `epydoc <https://epydoc.sourceforge.net/>`_.  `Sphinx <https://"
 "www.sphinx-doc.org>`_ can also include docstring content."
 msgstr ""
+"O módulo :mod:`pydoc` pode criar HTML a partir das strings de documentos em "
+"seu código-fonte Python. Uma alternativa para criar documentação de API "
+"puramente a partir de docstrings é `epydoc <https://epydoc.sourceforge.net/"
+">`_. `Sphinx <https://www.sphinx-doc.org>`_ também pode incluir conteúdo "
+"docstring."
 
 #: ../../faq/library.rst:188
 msgid "How do I get a single keypress at a time?"
@@ -349,10 +380,13 @@ msgid ""
 "module. The :mod:`threading` module builds convenient abstractions on top of "
 "the low-level primitives provided by the :mod:`_thread` module."
 msgstr ""
+"Certifique-se de usar o módulo :mod:`threading` e não o módulo :mod:"
+"`_thread`. O módulo :mod:`threading` constrói abstrações convenientes sobre "
+"as primitivas de baixo nível fornecidas pelo módulo :mod:`_thread`."
 
 #: ../../faq/library.rst:245
 msgid "None of my threads seem to run: why?"
-msgstr "Nenhuma de minhas threads parece funcionar, por quê?"
+msgstr "Nenhuma de minhas threads parece funcionar, por que?"
 
 #: ../../faq/library.rst:247
 msgid ""
@@ -377,6 +411,10 @@ msgid ""
 "run sequentially, one at a time!  The reason is that the OS thread scheduler "
 "doesn't start a new thread until the previous thread is blocked."
 msgstr ""
+"Mas agora (em muitas plataformas) as threads não funcionam em paralelo, mas "
+"parecem funcionar sequencialmente, um de cada vez! O motivo é que o "
+"agendador de threads do sistema operacional não inicia uma nova thread até "
+"que a thread anterior seja bloqueada."
 
 #: ../../faq/library.rst:269
 msgid "A simple fix is to add a tiny sleep to the start of the run function::"
@@ -392,16 +430,23 @@ msgid ""
 "the queue when it finishes, and let the main thread read as many tokens from "
 "the queue as there are threads."
 msgstr ""
+"Em vez de tentar adivinhar um bom valor de atraso para :func:`time.sleep`, é "
+"melhor usar algum tipo de mecanismo de semáforo. Uma ideia é usar o módulo :"
+"mod:`queue` para criar um objeto fila, deixar cada thread anexar um token à "
+"fila quando terminar e deixar a thread principal ler tantos tokens da fila "
+"quantos threads houver."
 
 #: ../../faq/library.rst:290
 msgid "How do I parcel out work among a bunch of worker threads?"
-msgstr ""
+msgstr "Como distribuo o trabalho entre várias threads de trabalho?"
 
 #: ../../faq/library.rst:292
 msgid ""
 "The easiest way is to use the :mod:`concurrent.futures` module, especially "
 "the :mod:`~concurrent.futures.ThreadPoolExecutor` class."
 msgstr ""
+"A maneira mais fácil é usar o módulo :mod:`concurrent.futures`, "
+"especialmente a classe :mod:`~concurrent.futures.ThreadPoolExecutor`."
 
 #: ../../faq/library.rst:295
 msgid ""
@@ -412,6 +457,13 @@ msgid ""
 "``.get()`` method to return them.  The class will take care of the locking "
 "necessary to ensure that each job is handed out exactly once."
 msgstr ""
+"Ou, se quiser um controle preciso sobre o algoritmo de despacho, você pode "
+"escrever sua própria lógica manualmente. Use o módulo :mod:`queue` para "
+"criar uma fila contendo uma lista de tarefas. A classe :class:`~queue.Queue` "
+"mantém uma lista de objetos e possui um método ``.put(obj)`` que adiciona "
+"itens à fila e um método ``.get()`` para retorná-los. A classe cuidará do "
+"bloqueio necessário para garantir que cada trabalho seja entregue exatamente "
+"uma vez."
 
 #: ../../faq/library.rst:302
 msgid "Here's a trivial example::"
@@ -426,7 +478,7 @@ msgid ""
 "Consult the module's documentation for more details; the :class:`~queue."
 "Queue` class provides a featureful interface."
 msgstr ""
-"Consulte a documentação dos módulos para mais detalhes; a classe :class:"
+"Consulte a documentação do módulo para mais detalhes; a classe :class:"
 "`~queue.Queue` fornece uma interface com recursos."
 
 #: ../../faq/library.rst:363
@@ -442,6 +494,13 @@ msgid ""
 "instruction and therefore all the C implementation code reached from each "
 "instruction is therefore atomic from the point of view of a Python program."
 msgstr ""
+"Um :term:`bloqueio global do interpretador` (GIL) é usado internamente para "
+"garantir que apenas um thread seja executado na VM Python por vez. Em geral, "
+"Python oferece alternar entre threads apenas entre instruções de bytecode; a "
+"frequência com que ele muda pode ser definida via :func:`sys."
+"setswitchinterval`. Cada instrução de bytecode e, portanto, todo o código de "
+"implementação C alcançado por cada instrução é, portanto, atômico do ponto "
+"de vista de um programa Python."
 
 #: ../../faq/library.rst:372
 msgid ""
@@ -450,12 +509,18 @@ msgid ""
 "shared variables of built-in data types (ints, lists, dicts, etc) that "
 "\"look atomic\" really are."
 msgstr ""
+"Em teoria, isso significa que uma contabilidade exata requer um entendimento "
+"exato da implementação do bytecode PVM. Na prática, isso significa que as "
+"operações em variáveis compartilhadas de tipos de dados integrados "
+"(inteiros, listas, dicionarios, etc.) que \"parecem atômicas\" realmente são."
 
 #: ../../faq/library.rst:377
 msgid ""
 "For example, the following operations are all atomic (L, L1, L2 are lists, "
 "D, D1, D2 are dicts, x, y are objects, i, j are ints)::"
 msgstr ""
+"Por exemplo, as seguintes operações são todas atômicas (L, L1, L2 são "
+"listas, D, D1, D2 são dicionários, x, y são objetos, i, j são inteiros)::"
 
 #: ../../faq/library.rst:392
 msgid "These aren't::"
@@ -468,6 +533,11 @@ msgid ""
 "can affect things.  This is especially true for the mass updates to "
 "dictionaries and lists.  When in doubt, use a mutex!"
 msgstr ""
+"Operações que substituem outros objetos podem invocar o método :meth:"
+"`~object.__del__` desses outros objetos quando sua contagem de referências "
+"chega a zero, e isso pode afetar as coisas. Isto é especialmente verdadeiro "
+"para as atualizações em massa de dicionários e listas. Em caso de dúvida, "
+"use um mutex!"
 
 #: ../../faq/library.rst:406
 msgid "Can't we get rid of the Global Interpreter Lock?"
@@ -480,6 +550,11 @@ msgid ""
 "multi-threaded Python program effectively only uses one CPU, due to the "
 "insistence that (almost) all Python code can only run while the GIL is held."
 msgstr ""
+"O :term:`bloqueio global do interpretador` (GIL) é frequentemente visto como "
+"um obstáculo para a implantação do Python em máquinas servidoras "
+"multiprocessadas de ponta, porque um programa Python multi-threaded "
+"efetivamente usa apenas uma CPU, devido à insistência de que (quase) todo "
+"código Python só pode ser executado enquanto o GIL é mantido."
 
 #: ../../faq/library.rst:415
 msgid ""
@@ -492,6 +567,14 @@ msgid ""
 "due to the amount of fine-grained locking necessary to compensate for the "
 "removal of the GIL."
 msgstr ""
+"Na época do Python 1.5, Greg Stein implementou um conjunto abrangente de "
+"patches (os patches de \"threading livre\") que removeu o GIL e o substituiu "
+"por bloqueio refinado. Adam Olsen recentemente fez um experimento semelhante "
+"em seu projeto `python-safethread <https://code.google.com/archive/p/python-"
+"safethread>`_. Infelizmente, ambos os experimentos exibiram uma queda "
+"acentuada no desempenho de thread único (pelo menos 30% mais lento), devido "
+"à quantidade de bloqueio de granulação fina necessária para compensar a "
+"remoção do GIL."
 
 #: ../../faq/library.rst:423
 msgid ""
@@ -503,6 +586,13 @@ msgid ""
 "module provides a lower-level API in case you want more control over "
 "dispatching of tasks."
 msgstr ""
+"Isso não significa que você não possa fazer bom uso do Python em máquinas "
+"com várias CPUs! Você só precisa ser criativo ao dividir o trabalho entre "
+"vários *processos* em vez de vários *threads*. A classe :class:`~concurrent."
+"futures.ProcessPoolExecutor` no novo módulo :mod:`concurrent.futures` "
+"fornece uma maneira fácil de fazer isso; o módulo :mod:`multiprocessing` "
+"fornece uma API de nível inferior caso você queira mais controle sobre o "
+"envio de tarefas."
 
 #: ../../faq/library.rst:431
 msgid ""
@@ -512,6 +602,11 @@ msgid ""
 "work done.  Some standard library modules such as :mod:`zlib` and :mod:"
 "`hashlib` already do this."
 msgstr ""
+"O uso criterioso de extensões C também ajudará; se você usar uma extensão C "
+"para executar uma tarefa demorada, a extensão poderá liberar o GIL enquanto "
+"o thread de execução estiver no código C e permitir que outros threads "
+"realizem algum trabalho. Alguns módulos de biblioteca padrão como :mod:"
+"`zlib` e :mod:`hashlib` já fazem isso."
 
 #: ../../faq/library.rst:437
 msgid ""
@@ -524,6 +619,15 @@ msgid ""
 "types have their own free list; these free lists would have to be moved to "
 "the interpreter state. And so on."
 msgstr ""
+"Foi sugerido que o GIL deveria ser um bloqueio por estado por interpretador, "
+"em vez de verdadeiramente global; os interpretadores não seriam capazes de "
+"compartilhar objetos. Infelizmente, isso também não é provável que aconteça. "
+"Seria uma quantidade enorme de trabalho, porque muitas implementações de "
+"objetos atualmente possuem estado global. Por exemplo, inteiros pequenos e "
+"strings curtas são armazenados em cache; esses caches teriam que ser movidos "
+"para o estado de interpretador. Outros tipos de objetos possuem sua própria "
+"lista livre; essas listas livres teriam que ser movidas para o estado de "
+"interpretador. E assim por diante."
 
 #: ../../faq/library.rst:446
 msgid ""
@@ -532,6 +636,10 @@ msgid ""
 "extensions are being written at a faster rate than you can convert them to "
 "store all their global state in the interpreter state."
 msgstr ""
+"E duvido que isso possa ser feito em tempo finito, porque o mesmo problema "
+"existe para extensões de terceiros. É provável que extensões de terceiros "
+"estejam sendo gravadas em uma taxa mais rápida do que você pode convertê-las "
+"para armazenar todo o seu estado global no estado do interpretador."
 
 #: ../../faq/library.rst:451
 msgid ""