Update translations from Transifex

Author: github-actions

.tx/config

@@ -722,6 +722,13 @@ source_file  = /pot/howto/logging-cookbook.pot
 type         = PO
 minimum_perc = 0
 
+[o:python-doc:p:python-newest:r:howto--mro]
+file_filter  = ./<lang>/LC_MESSAGES/howto/mro.po
+trans.pt_BR  = howto/mro.po
+source_file  = /pot/howto/mro.pot
+type         = PO
+minimum_perc = 0
+
 [o:python-doc:p:python-newest:r:howto--perf_profiling]
 file_filter  = ./<lang>/LC_MESSAGES/howto/perf_profiling.po
 trans.pt_BR  = howto/perf_profiling.po

c-api/perfmaps.po

@@ -3,13 +3,17 @@
 # This file is distributed under the same license as the Python package.
 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 #
+# Translators:
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2024
+#
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-19 14:14+0000\n"
+"POT-Creation-Date: 2024-04-14 22:56+0000\n"
 "PO-Revision-Date: 2023-05-24 13:07+0000\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
 "teams/5390/pt_BR/)\n"
 "MIME-Version: 1.0\n"
@@ -21,7 +25,7 @@ msgstr ""
 
 #: ../../c-api/perfmaps.rst:6
 msgid "Support for Perf Maps"
-msgstr ""
+msgstr "Suporte a Mapas do Perf"
 
 #: ../../c-api/perfmaps.rst:8
 msgid ""
@@ -34,18 +38,31 @@ msgid ""
 "Perf tool <https://git.kernel.org/pub/scm/linux/ kernel/git/torvalds/linux."
 "git/tree/tools/perf/Documentation/jit-interface.txt>`_."
 msgstr ""
+"Em plataformas suportadas (no momento em que este livro foi escrito, apenas "
+"Linux), o tempo de execução pode tirar vantagem dos *arquivos de mapa perf* "
+"para tornar as funções Python visíveis para uma ferramenta de perfilação "
+"externa (como `perf <https://perf.wiki.kernel.org/index.php/Main_Page>`_). "
+"Um processo em execução pode criar um arquivo no diretório ``/tmp``, que "
+"contém entradas que podem mapear uma seção de código executável para um "
+"nome. Esta interface é descrita na `documentação da ferramenta Linux Perf "
+"<https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/"
+"tools/perf/Documentation/jit-interface.txt>`_."
 
 #: ../../c-api/perfmaps.rst:16
 msgid ""
 "In Python, these helper APIs can be used by libraries and features that rely "
 "on generating machine code on the fly."
 msgstr ""
+"Em Python, essas APIs auxiliares podem ser usadas por bibliotecas e recursos "
+"que dependem da geração de código de máquina dinamicamente."
 
 #: ../../c-api/perfmaps.rst:19
 msgid ""
 "Note that holding the Global Interpreter Lock (GIL) is not required for "
 "these APIs."
 msgstr ""
+"Observe que manter o bloqueio global do interpretador, ou Global Interpreter "
+"Lock (GIL), não é necessário para essas APIs."
 
 #: ../../c-api/perfmaps.rst:23
 msgid ""
@@ -56,26 +73,42 @@ msgid ""
 "`PyUnstable_WritePerfMapEntry` and it will initialize the state on first "
 "call."
 msgstr ""
+"Abre o arquivo ``/tmp/perf-$pid.map``, a menos que já esteja aberto, e cria "
+"um bloqueio para garantir escritas seguras para thread no arquivo (desde que "
+"as escritas sejam feitas através de :c:func:"
+"`PyUnstable_WritePerfMapEntry` ). Normalmente, não há necessidade de chamar "
+"isso explicitamente; basta usar :c:func:`PyUnstable_WritePerfMapEntry` e ele "
+"inicializará o estado na primeira chamada."
 
 #: ../../c-api/perfmaps.rst:29
 msgid ""
 "Returns ``0`` on success, ``-1`` on failure to create/open the perf map "
 "file, or ``-2`` on failure to create a lock. Check ``errno`` for more "
 "information about the cause of a failure."
 msgstr ""
+"Retorna ``0`` em caso de sucesso, ``-1`` em caso de falha ao criar/abrir o "
+"arquivo de mapa de desempenho ou ``-2`` em caso de falha na criação de um "
+"bloqueio. Verifique ``errno`` para mais informações sobre a causa de uma "
+"falha."
 
 #: ../../c-api/perfmaps.rst:35
 msgid ""
 "Write one single entry to the ``/tmp/perf-$pid.map`` file. This function is "
 "thread safe. Here is what an example entry looks like::"
 msgstr ""
+"Escreve uma única entrada no arquivo ``/tmp/perf-$pid.map``. Esta função é "
+"segura para thread. Aqui está a aparência de um exemplo de entrada::"
 
 #: ../../c-api/perfmaps.rst:41
 msgid ""
 "Will call :c:func:`PyUnstable_PerfMapState_Init` before writing the entry, "
 "if the perf map file is not already opened. Returns ``0`` on success, or the "
 "same error codes as :c:func:`PyUnstable_PerfMapState_Init` on failure."
 msgstr ""
+"Chamará :c:func:`PyUnstable_PerfMapState_Init` antes de escrever a entrada, "
+"se o arquivo de mapa de desempenho ainda não estiver aberto. Retorna ``0`` "
+"em caso de sucesso ou os mesmos códigos de erro que :c:func:"
+"`PyUnstable_PerfMapState_Init` em caso de falha."
 
 #: ../../c-api/perfmaps.rst:47
 msgid ""
@@ -84,3 +117,8 @@ msgid ""
 "general, there shouldn't be a reason to explicitly call this, except to "
 "handle specific scenarios such as forking."
 msgstr ""
+"Fecha o arquivo de mapa do perf aberto por :c:func:"
+"`PyUnstable_PerfMapState_Init`. Isso é chamado pelo próprio tempo de "
+"execução durante o desligamento do interpretador. Em geral, não deve haver "
+"motivo para chamar isso explicitamente, exceto para lidar com cenários "
+"específicos, como bifurcação."

howto/perf_profiling.po

@@ -5,15 +5,16 @@
 #
 # Translators:
 # Hemílio Lauro <hemilioaraujo@gmail.com>, 2023
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2024
 #
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-12 14:14+0000\n"
+"POT-Creation-Date: 2024-04-14 22:56+0000\n"
 "PO-Revision-Date: 2023-05-24 13:07+0000\n"
-"Last-Translator: Hemílio Lauro <hemilioaraujo@gmail.com>, 2023\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
 "teams/5390/pt_BR/)\n"
 "MIME-Version: 1.0\n"
@@ -25,15 +26,15 @@ msgstr ""
 
 #: ../../howto/perf_profiling.rst:7
 msgid "Python support for the Linux ``perf`` profiler"
-msgstr ""
+msgstr "Suporte do Python ao perfilador ``perf`` do Linux"
 
 #: ../../howto/perf_profiling.rst:0
 msgid "author"
 msgstr "autor"
 
 #: ../../howto/perf_profiling.rst:9
 msgid "Pablo Galindo"
-msgstr ""
+msgstr "Pablo Galindo"
 
 #: ../../howto/perf_profiling.rst:11
 msgid ""
@@ -42,6 +43,10 @@ msgid ""
 "of your application. ``perf`` also has a very vibrant ecosystem of tools "
 "that aid with the analysis of the data that it produces."
 msgstr ""
+"`O perfilador perf do Linux <https://perf.wiki.kernel.org>`_ é uma "
+"ferramenta muito poderosa que permite criar perfis e obter informações sobre "
+"o desempenho da sua aplicação. ``perf`` também possui um ecossistema muito "
+"vibrante de ferramentas que auxiliam na análise dos dados que produz."
 
 #: ../../howto/perf_profiling.rst:17
 msgid ""
@@ -51,6 +56,11 @@ msgid ""
 "and file names of Python functions in your code will not appear in the "
 "output of ``perf``."
 msgstr ""
+"O principal problema de usar o perfilador ``perf`` com aplicações Python é "
+"que ``perf`` apenas obtém informações sobre símbolos nativos, ou seja, os "
+"nomes de funções e procedimentos escritos em C. Isso significa que os nomes "
+"de funções Python e seus nomes de arquivos em seu código não aparecerão na "
+"saída de ``perf``."
 
 #: ../../howto/perf_profiling.rst:22
 msgid ""
@@ -61,6 +71,13 @@ msgid ""
 "will teach ``perf`` the relationship between this piece of code and the "
 "associated Python function using :doc:`perf map files <../c-api/perfmaps>`."
 msgstr ""
+"Desde o Python 3.12, o interpretador pode ser executado em um modo especial "
+"que permite que funções do Python apareçam na saída do criador de perfilador "
+"``perf``. Quando este modo está habilitado, o interpretador interporá um "
+"pequeno pedaço de código compilado instantaneamente antes da execução de "
+"cada função Python e ensinará ``perf`` a relação entre este pedaço de código "
+"e a função Python associada usando :doc:`arquivos de mapa perf <../c-api/"
+"perfmaps>`."
 
 #: ../../howto/perf_profiling.rst:31
 msgid ""
@@ -69,18 +86,24 @@ msgid ""
 "check the output of ``python -m sysconfig | grep HAVE_PERF_TRAMPOLINE`` to "
 "see if your system is supported."
 msgstr ""
+"O suporte para o perfilador ``perf`` está atualmente disponível apenas para "
+"Linux em arquiteturas selecionadas. Verifique a saída da etapa de construção "
+"``configure`` ou verifique a saída de ``python -m sysconfig | grep "
+"HAVE_PERF_TRAMPOLINE`` para ver se o seu sistema é compatível."
 
 #: ../../howto/perf_profiling.rst:36
 msgid "For example, consider the following script:"
-msgstr ""
+msgstr "Por exemplo, considere o seguinte script:"
 
 #: ../../howto/perf_profiling.rst:55
 msgid "We can run ``perf`` to sample CPU stack traces at 9999 hertz::"
 msgstr ""
+"Podemos executar ``perf`` para obter amostras de rastreamentos de pilha da "
+"CPU em 9999 hertz::"
 
 #: ../../howto/perf_profiling.rst:59
 msgid "Then we can use ``perf report`` to analyze the data:"
-msgstr ""
+msgstr "Então podemos usar ``perf report`` para analisar os dados:"
 
 #: ../../howto/perf_profiling.rst:100
 msgid ""
@@ -90,15 +113,22 @@ msgid ""
 "functions use the same C function to evaluate bytecode so we cannot know "
 "which Python function corresponds to which bytecode-evaluating function."
 msgstr ""
+"Como você pode ver, as funções Python não são mostradas na saída, apenas "
+"``_PyEval_EvalFrameDefault`` (a função que avalia o bytecode Python) "
+"aparece. Infelizmente isso não é muito útil porque todas as funções Python "
+"usam a mesma função C para avaliar bytecode, portanto não podemos saber qual "
+"função Python corresponde a qual função de avaliação de bytecode."
 
 #: ../../howto/perf_profiling.rst:105
 msgid ""
 "Instead, if we run the same experiment with ``perf`` support enabled we get:"
 msgstr ""
+"Em vez disso, se executarmos o mesmo experimento com o suporte ``perf`` "
+"ativado, obteremos:"
 
 #: ../../howto/perf_profiling.rst:152
 msgid "How to enable ``perf`` profiling support"
-msgstr ""
+msgstr "Como habilitar o suporte a perfilação com ``perf``"
 
 #: ../../howto/perf_profiling.rst:154
 msgid ""
@@ -107,32 +137,38 @@ msgid ""
 "X>` option, or dynamically using :func:`sys.activate_stack_trampoline` and :"
 "func:`sys.deactivate_stack_trampoline`."
 msgstr ""
+"O suporte à perfilação com ``perf`` pode ser habilitado desde o início "
+"usando a variável de ambiente :envvar:`PYTHONPERFSUPPORT` ou a opção :option:"
+"`-X perf <-X>`, ou dinamicamente usando :func:`sys."
+"activate_stack_trampoline` e :func:`sys.deactivate_stack_trampoline`."
 
 #: ../../howto/perf_profiling.rst:160
 msgid ""
 "The :mod:`!sys` functions take precedence over the :option:`!-X` option, "
 "the :option:`!-X` option takes precedence over the environment variable."
 msgstr ""
+"As funções :mod:`!sys` têm precedência sobre a opção :option:`!-X`, a opção :"
+"option:`!-X` tem precedência sobre a variável de ambiente."
 
 #: ../../howto/perf_profiling.rst:163
 msgid "Example, using the environment variable::"
-msgstr ""
+msgstr "Exemplo usando a variável de ambiente::"
 
 #: ../../howto/perf_profiling.rst:168
 msgid "Example, using the :option:`!-X` option::"
-msgstr ""
+msgstr "Exemplo usando a opção :option:`!-X`::"
 
 #: ../../howto/perf_profiling.rst:173
 msgid "Example, using the :mod:`sys` APIs in file :file:`example.py`:"
-msgstr ""
+msgstr "Exemplo usando as APIs de :mod:`sys` em :file:`example.py`:"
 
 #: ../../howto/perf_profiling.rst:185
 msgid "...then::"
-msgstr ""
+msgstr "... então::"
 
 #: ../../howto/perf_profiling.rst:192
 msgid "How to obtain the best results"
-msgstr ""
+msgstr "Como obter os melhores resultados"
 
 #: ../../howto/perf_profiling.rst:194
 msgid ""
@@ -143,15 +179,27 @@ msgid ""
 "dynamically generated it doesn't have any DWARF debugging information "
 "available."
 msgstr ""
+"Para melhores resultados, Python deve ser compilado com ``CFLAGS=\"-fno-omit-"
+"frame-pointer -mno-omit-leaf-frame-pointer\"``, pois isso permite que os "
+"perfiladores façam o desenrolamento de pilha (ou *stack unwinding*) usando "
+"apenas o ponteiro de quadro e não no DWARF informações de depuração. Isso "
+"ocorre porque como o código interposto para permitir o suporte ``perf`` é "
+"gerado dinamicamente, ele não possui nenhuma informação de depuração DWARF "
+"disponível."
 
 #: ../../howto/perf_profiling.rst:201
 msgid ""
 "You can check if your system has been compiled with this flag by running::"
 msgstr ""
+"Você pode verificar se o seu sistema foi compilado com este sinalizador "
+"executando::"
 
 #: ../../howto/perf_profiling.rst:205
 msgid ""
 "If you don't see any output it means that your interpreter has not been "
 "compiled with frame pointers and therefore it may not be able to show Python "
 "functions in the output of ``perf``."
 msgstr ""
+"Se você não vir nenhuma saída, significa que seu interpretador não foi "
+"compilado com ponteiros de quadro e, portanto, pode não ser capaz de mostrar "
+"funções Python na saída de ``perf``."

library/dataclasses.po

@@ -43,6 +43,10 @@ msgid ""
 "__init__` and :meth:`~object.__repr__` to user-defined classes.  It was "
 "originally described in :pep:`557`."
 msgstr ""
+"Este módulo fornece um decorador e funções para adicionar automaticamente :"
+"term:`métodos especiais <método especial>` tais como :meth:`~object."
+"__init__` e :meth:`~object.__repr__` a classes definidas pelo usuário. Foi "
+"originalmente descrita em :pep:`557`."
 
 #: ../../library/dataclasses.rst:19
 msgid ""
@@ -61,6 +65,8 @@ msgid ""
 "Note that this method is automatically added to the class: it is not "
 "directly specified in the :class:`!InventoryItem` definition shown above."
 msgstr ""
+"Observe que este método é adicionado automaticamente à classe: ele não é "
+"especificado diretamente na definição :class:`!InventoryItem` mostrada acima."
 
 #: ../../library/dataclasses.rst:47
 msgid "Module contents"
@@ -127,6 +133,8 @@ msgid ""
 "*init*: If true (the default), a :meth:`~object.__init__` method will be "
 "generated."
 msgstr ""
+"*init*: Se verdadeiro (o padrão), o método :meth:`~object.__init__` será "
+"gerado."
 
 #: ../../library/dataclasses.rst:92
 msgid ""
@@ -143,6 +151,12 @@ msgid ""
 "example: ``InventoryItem(name='widget', unit_price=3.0, "
 "quantity_on_hand=10)``."
 msgstr ""
+"*repr*: Se verdadeiro (o padrão), um método :meth:`~object.__repr__` será "
+"gerado. A sequência de string de representação gerada terá o nome da classe "
+"e o nome e representação de cada campo, na ordem em que são definidos na "
+"classe. Os campos marcados como excluídos da representação não são "
+"incluídos. Por exemplo: ``InventoryItem(name='widget', unit_price=3.0, "
+"quantity_on_hand=10)``."
 
 #: ../../library/dataclasses.rst:102
 msgid ""
@@ -157,6 +171,9 @@ msgid ""
 "fields, in order.  Both instances in the comparison must be of the identical "
 "type."
 msgstr ""
+"*eq*: Se verdadeiro (o padrão), um método :meth:`~object.__eq__` será "
+"gerado. Este método compara a classe como se fosse uma tupla de campos, em "
+"ordem. Ambas as instâncias na comparação devem ser de tipo idêntico."
 
 #: ../../library/dataclasses.rst:110
 msgid ""
@@ -172,6 +189,11 @@ msgid ""
 "fields, in order.  Both instances in the comparison must be of the identical "
 "type.  If *order* is true and *eq* is false, a :exc:`ValueError` is raised."
 msgstr ""
+"*order*: Se verdadeiro (o padrão é ``False``), os métodos :meth:`~object."
+"__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__` e :meth:`~object."
+"__ge__` serão gerados.  Comparam a classe como se fosse uma tupla de campos, "
+"em ordem.  Ambas instâncias na comparação devem ser de tipo idêntico.  Se "
+"*order* é verdadeiro e *eq* é falso, a exceção :exc:`ValueError` é levantada."
 
 #: ../../library/dataclasses.rst:120
 msgid ""
@@ -187,6 +209,8 @@ msgid ""
 "*unsafe_hash*: If ``False`` (the default), a :meth:`~object.__hash__` method "
 "is generated according to how *eq* and *frozen* are set."
 msgstr ""
+"*unsafe_hash*: Se ``False`` (o padrão), um método :meth:`~object.__hash__` é "
+"gerado, conforme a forma como *eq* e *frozen* estão configurados."
 
 #: ../../library/dataclasses.rst:127
 msgid ""