Update translation

Co-Authored-By: Rainer Terroso

Author: github-actions[bot]

library/logging.handlers.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-12-09 14:17+0000\n"
+"POT-Creation-Date: 2025-12-11 14:18+0000\n"
 "PO-Revision-Date: 2025-09-16 00:01+0000\n"
 "Last-Translator: Rainer Terroso, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -241,31 +241,38 @@ msgid ""
 "does not do any formatting or output. It is essentially a 'no-op' handler "
 "for use by library developers."
 msgstr ""
+"A classe :class:`NullHandler`, localizada no pacote principal :mod:"
+"`logging`, não realiza qualquer formatação ou saída. Ela é essencialmente um "
+"manipulador 'no-op', destinado ao uso por desenvolvedores de bibliotecas."
 
 #: ../../library/logging.handlers.rst:137
 msgid "Returns a new instance of the :class:`NullHandler` class."
-msgstr ""
+msgstr "Retorna uma nova instância da classe :class:`NullHandler`."
 
 #: ../../library/logging.handlers.rst:141
 #: ../../library/logging.handlers.rst:145
 msgid "This method does nothing."
-msgstr ""
+msgstr "Esse método não faz nada."
 
 #: ../../library/logging.handlers.rst:149
 msgid ""
 "This method returns ``None`` for the lock, since there is no underlying I/O "
 "to which access needs to be serialized."
 msgstr ""
+"Este método retorna ``None`` para a trava, pois não há E/S subjacente cujo "
+"acesso precise ser serializado."
 
 #: ../../library/logging.handlers.rst:153
 msgid ""
 "See :ref:`library-config` for more information on how to use :class:"
 "`NullHandler`."
 msgstr ""
+"Consulte :ref:`library-config` para obter mais informações sobre como usar :"
+"class:`NullHandler`."
 
 #: ../../library/logging.handlers.rst:159
 msgid "WatchedFileHandler"
-msgstr ""
+msgstr "WatchedFileHandler"
 
 #: ../../library/logging.handlers.rst:163
 msgid ""
@@ -274,6 +281,10 @@ msgid ""
 "logging to. If the file changes, it is closed and reopened using the file "
 "name."
 msgstr ""
+"A classe :class:`WatchedFileHandler`, localizada no módulo :mod:`logging."
+"handlers`, é um :class:`FileHandler` que monitora o arquivo no qual está "
+"registrando logs. Se o arquivo for alterado, ele é fechado e reaberto usando "
+"o nome do arquivo."
 
 #: ../../library/logging.handlers.rst:167
 msgid ""
@@ -284,6 +295,13 @@ msgid ""
 "changed.) If the file has changed, the old file stream is closed, and the "
 "file opened to get a new stream."
 msgstr ""
+"Uma alteração no arquivo pode ocorrer devido ao modo de usar de programas "
+"como *newsyslog* e *logrotate*, que realizam a rotação de arquivos de log. "
+"Este manipulador, destinado ao uso em Unix/Linux, monitora o arquivo para "
+"verificar se ele foi alterado desde a última chamada a emit. (Considera-se "
+"que um arquivo foi alterado se o seu dispositivo ou nó-i tiverem mudado.) Se "
+"o arquivo tiver sido alterado, o fluxo do arquivo antigo é fechado, e o "
+"arquivo é aberto novamente para obter um novo fluxo."
 
 #: ../../library/logging.handlers.rst:174
 msgid ""
@@ -293,6 +311,11 @@ msgid ""
 "*ST_INO* is not supported under Windows; :func:`~os.stat` always returns "
 "zero for this value."
 msgstr ""
+"Este manipulador não é apropriado para uso no Windows, porque, nesse "
+"sistema, arquivos de log abertos não podem ser movidos ou renomeados — o "
+"logging abre os arquivos com travas exclusivas — e, portanto, não há "
+"necessidade desse tipo de manipulador. Além disso, *ST_INO* não é suportado "
+"no Windows; :func:`~os.stat` sempre retorna zero para esse valor."
 
 #: ../../library/logging.handlers.rst:183
 msgid ""
@@ -304,23 +327,35 @@ msgid ""
 "grows indefinitely. If *errors* is provided, it determines how encoding "
 "errors are handled."
 msgstr ""
+"Retorna uma nova instância da classe :class:`WatchedFileHandler`. O arquivo "
+"especificado é aberto e usado como o fluxo para registro de logs. Se *mode* "
+"não for especificado, ``'a'`` será usado. Se encoding não for ``None``, ele "
+"será usado para abrir o arquivo com essa codificação. Se *delay* for "
+"verdadeiro, a abertura do arquivo é adiada até a primeira chamada a :meth:"
+"`emit`. Por padrão, o arquivo cresce indefinidamente. Se *errors* for "
+"fornecido, ele determina como erros de codificação são tratados."
 
 #: ../../library/logging.handlers.rst:199
 msgid ""
 "Checks to see if the file has changed.  If it has, the existing stream is "
 "flushed and closed and the file opened again, typically as a precursor to "
 "outputting the record to the file."
 msgstr ""
+"Verifica se o arquivo foi alterado. Se tiver sido, o fluxo existente é "
+"descarregado e fechado, e o arquivo é aberto novamente, normalmente como um "
+"passo preliminar antes de enviar o registro para o arquivo."
 
 #: ../../library/logging.handlers.rst:208
 msgid ""
 "Outputs the record to the file, but first calls :meth:`reopenIfNeeded` to "
 "reopen the file if it has changed."
 msgstr ""
+"Emite o registro para o arquivo, mas antes chama :meth:`reopenIfNeeded` para "
+"reabrir o arquivo caso ele tenha sido alterado."
 
 #: ../../library/logging.handlers.rst:214
 msgid "BaseRotatingHandler"
-msgstr ""
+msgstr "BaseRotatingHandler"
 
 #: ../../library/logging.handlers.rst:216
 msgid ""
@@ -330,17 +365,25 @@ msgid ""
 "need to instantiate this class, but it has attributes and methods you may "
 "need to override."
 msgstr ""
+"A classe :class:`BaseRotatingHandler`, localizada no módulo :mod:`logging."
+"handlers`, é a classe base para os tratadores de arquivos com rotação, :"
+"class:`RotatingFileHandler` e :class:`TimedRotatingFileHandler` Em geral, "
+"não é necessário instanciar essa classe, mas ela possui atributos e métodos "
+"que podem precisar ser substituídos."
 
 #: ../../library/logging.handlers.rst:224
 msgid "The parameters are as for :class:`FileHandler`. The attributes are:"
-msgstr ""
+msgstr "Os parâmetros são os mesmos de :class:`FileHandler`. Os atributos são:"
 
 #: ../../library/logging.handlers.rst:228
 msgid ""
 "If this attribute is set to a callable, the :meth:`rotation_filename` method "
 "delegates to this callable. The parameters passed to the callable are those "
 "passed to :meth:`rotation_filename`."
 msgstr ""
+"Se esse atributo for definido como um chamável, o método :meth:"
+"`rotation_filename` delega a ele. Os parâmetros passados ao chamável são os "
+"mesmos passados para :meth:`rotation_filename`."
 
 #: ../../library/logging.handlers.rst:232
 msgid ""
@@ -349,6 +392,10 @@ msgid ""
 "every time for a given input, otherwise the rollover behaviour may not work "
 "as expected."
 msgstr ""
+"A função namer é chamada muitas vezes durante a rotação, portanto deve ser a "
+"mais simples e rápida possível. Ela também deve retornar sempre o mesmo "
+"resultado para uma dada entrada; caso contrário, o comportamento da rotação "
+"pode não funcionar como esperado."
 
 #: ../../library/logging.handlers.rst:237
 msgid ""
@@ -366,36 +413,58 @@ msgid ""
 "`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with the "
 "custom naming scheme.)"
 msgstr ""
+"Também vale observar que é preciso ter cuidado ao usar um namer para "
+"preservar certos atributo no nome do arquivo que são usados durante a "
+"rotação. Por exemplo, :class:`RotatingFileHandler` espera ter um conjunto de "
+"arquivos de log cujos nomes contenham inteiros sucessivos, para que a "
+"rotação funcione como esperado, e :class:`TimedRotatingFileHandler` remova "
+"arquivos de log antigos (com base no parâmetro ``backupCount`` passado ao "
+"inicializador do manipulador) determinando quais são os arquivos mais "
+"antigos a serem excluídos. Para que isso funcione, os nomes dos arquivos "
+"devem ser ordenáveis usando a porção de data/hora do nome, e um namer "
+"precisa respeitar isso. (Se for desejado um namer que não respeite esse "
+"esquema, ele deverá ser usado em uma subclasse de :class:"
+"`TimedRotatingFileHandler` que substitua o método :meth:"
+"`~TimedRotatingFileHandler.getFilesToDelete` para se adequar ao esquema de "
+"nomeação personalizado.)"
 
 #: ../../library/logging.handlers.rst:255
 msgid ""
 "If this attribute is set to a callable, the :meth:`rotate` method delegates "
 "to this callable.  The parameters passed to the callable are those passed "
 "to :meth:`rotate`."
 msgstr ""
+"Se este atributo estiver definido como um chamável, o método :meth:`rotate` "
+"delega a esse chamável. Os parâmetros passados ao chamável são os mesmos "
+"passados para :meth:`rotate`."
 
 #: ../../library/logging.handlers.rst:263
 msgid "Modify the filename of a log file when rotating."
-msgstr ""
+msgstr "Modifica o nome do arquivo de log durante a rotação."
 
 #: ../../library/logging.handlers.rst:265
 msgid "This is provided so that a custom filename can be provided."
 msgstr ""
+"Isso é fornecido para que um nome de arquivo personalizado possa ser "
+"providenciado."
 
 #: ../../library/logging.handlers.rst:267
 msgid ""
 "The default implementation calls the 'namer' attribute of the handler, if "
 "it's callable, passing the default name to it. If the attribute isn't "
 "callable (the default is ``None``), the name is returned unchanged."
 msgstr ""
+"A implementação padrão chama o atributo namer do manipulador, se ele for "
+"chamável, passando o nome padrão para ele. Se o atributo não for chamável (o "
+"padrão é ``None``), o nome é devolvido sem alterações."
 
 #: ../../library/logging.handlers.rst:271
 msgid "The default name for the log file."
-msgstr ""
+msgstr "O nome padrão para o arquivo de log."
 
 #: ../../library/logging.handlers.rst:278
 msgid "When rotating, rotate the current log."
-msgstr ""
+msgstr "Quando ocorre a rotação, rotaciona o log atual."
 
 #: ../../library/logging.handlers.rst:280
 msgid ""
@@ -404,17 +473,25 @@ msgid ""
 "isn't callable (the default is ``None``), the source is simply renamed to "
 "the destination."
 msgstr ""
+"A implementação padrão chama o atributo rotator do manipulador, se ele for "
+"chamável, passando os argumentos source e dest para ele. Se o atributo não "
+"for chamável (o padrão é ``None``), o arquivo de origem é simplesmente "
+"renomeado para o destino."
 
 #: ../../library/logging.handlers.rst:285
 msgid ""
 "The source filename. This is normally the base filename, e.g. 'test.log'."
 msgstr ""
+"O nome do arquivo de origem. Normalmente, este é o nome base do arquivo, por "
+"exemplo, 'test.log'."
 
 #: ../../library/logging.handlers.rst:287
 msgid ""
 "The destination filename. This is normally what the source is rotated to, e."
 "g. 'test.log.1'."
 msgstr ""
+"O nome do arquivo de destino. Normalmente, é para onde o arquivo de origem é "
+"rotacionado, por exemplo, 'test.log.1'."
 
 #: ../../library/logging.handlers.rst:292
 msgid ""
@@ -425,26 +502,36 @@ msgid ""
 "exception during an :meth:`emit` call, i.e. via the :meth:`handleError` "
 "method of the handler."
 msgstr ""
+"O motivo da existência desses atributos é evitar que você precise criar "
+"subclasses — é possível usar os mesmos chamáveis para instâncias de :class:"
+"`RotatingFileHandler` e :class:`TimedRotatingFileHandler`. Se o chamável "
+"namer ou rotator levantar uma exceção, ela será tratada da mesma forma que "
+"qualquer outra exceção durante uma chamada a :meth:`emit`, isto é, por meio "
+"do método :meth:`handleError` do manipulador."
 
 #: ../../library/logging.handlers.rst:299
 msgid ""
 "If you need to make more significant changes to rotation processing, you can "
 "override the methods."
 msgstr ""
+"Se precisar fazer alterações mais significativas no processamento de "
+"rotação, você pode substituir os métodos."
 
 #: ../../library/logging.handlers.rst:302
 msgid "For an example, see :ref:`cookbook-rotator-namer`."
-msgstr ""
+msgstr "Para um exemplo, consulte :ref:`cookbook-rotator-namer`."
 
 #: ../../library/logging.handlers.rst:308
 msgid "RotatingFileHandler"
-msgstr ""
+msgstr "RotatingFileHandler"
 
 #: ../../library/logging.handlers.rst:310
 msgid ""
 "The :class:`RotatingFileHandler` class, located in the :mod:`logging."
 "handlers` module, supports rotation of disk log files."
 msgstr ""
+"A classe :class:`RotatingFileHandler`, localizada no módulo :mod:`logging."
+"handlers`, oferece suporte à rotação de arquivos de log em disco."
 
 #: ../../library/logging.handlers.rst:316
 msgid ""
@@ -456,6 +543,13 @@ msgid ""
 "grows indefinitely. If *errors* is provided, it determines how encoding "
 "errors are handled."
 msgstr ""
+"Retorna uma nova instância da classe :class:`RotatingFileHandler`. O arquivo "
+"especificado é aberto e usado como o stream para logging. Se *mode* não for "
+"especificado, ``'a'`` é usado. Se *encoding* não for ``None``, ele é usado "
+"para abrir o arquivo com essa codificação. Se *delay* for verdadeiro, a "
+"abertura do arquivo é adiada até a primeira chamada a :meth:`emit`.  Por "
+"padrão, o arquivo cresce indefinidamente. Se *errors* for fornecido, ele é "
+"usado para determinar como erros de codificação são tratados."
 
 #: ../../library/logging.handlers.rst:323
 msgid ""
@@ -474,27 +568,47 @@ msgid ""
 "log.1`, and if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then "
 "they are renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively."
 msgstr ""
+"Você pode usar os valores *maxBytes* e *backupCount* para permitir que o "
+"arquivo faça :dfn:`rollover` em um tamanho predeterminado. Quando o tamanho "
+"está prestes a ser excedido, o arquivo é fechado e um novo arquivo é aberto "
+"silenciosamente para saída. O rollover ocorre sempre que o arquivo de log "
+"atual está próximo de *maxBytes* em comprimento; mas, se *maxBytes* ou "
+"*backupCount* for zero, o rollover nunca ocorre, portanto, em geral, você "
+"deve definir *backupCount* como pelo menos 1 e usar um *maxBytes* diferente "
+"de zero. Quando *backupCount* é diferente de zero, o sistema salva arquivos "
+"de log antigos acrescentando as extensões '.1', '.2' etc. ao nome do "
+"arquivo. Por exemplo, com um *backupCount* de 5 e um nome de arquivo base :"
+"file:`app.log`, você terá :file:`app.log`, :file:`app.log.1`, :file:`app."
+"log.2`, até :file:`app.log.5`. O arquivo no qual se escreve é sempre :file:"
+"`app.log`. Quando esse arquivo é preenchido, ele é fechado e renomeado para :"
+"file:`app.log.1` e, se existirem os arquivos :file:`app.log.1`, :file:`app."
+"log.2` etc., eles são renomeados para :file:`app.log.2`, :file:`app.log.3` "
+"etc., respectivamente."
 
 #: ../../library/logging.handlers.rst:347
 #: ../../library/logging.handlers.rst:457
 msgid "Does a rollover, as described above."
-msgstr ""
+msgstr "Realiza um rollover, conforme descrito acima."
 
 #: ../../library/logging.handlers.rst:352
 msgid ""
 "Outputs the record to the file, catering for rollover as described "
 "previously."
 msgstr ""
+"Grava o registro no arquivo, tratando a rotação conforme descrito "
+"anteriormente."
 
 #: ../../library/logging.handlers.rst:357
 msgid ""
 "See if the supplied record would cause the file to exceed the configured "
 "size limit."
 msgstr ""
+"Verifica se o registro fornecido faria o arquivo exceder o limite de tamanho "
+"configurado."
 
 #: ../../library/logging.handlers.rst:362
 msgid "TimedRotatingFileHandler"
-msgstr ""
+msgstr "TimedRotatingFileHandler"
 
 #: ../../library/logging.handlers.rst:364
 msgid ""

potodo.md

@@ -1,5 +1,5 @@
-1 directory  62.30% done
-└── 3.14/  62.30% done
+1 directory  62.37% done
+└── 3.14/  62.37% done
     ├── c-api/  55.08% done
     │   ├── exceptions.po                 66.0% translated 175/262
     │   ├── frame.po                      66.0% translated   34/51
@@ -34,7 +34,7 @@
     │   ├── sorting.po                    54.0% translated   50/92
     │   └── unicode.po                    20.0% translated  30/145
     ├── installing/  100.00% done
-    ├── library/  62.37% done
+    ├── library/  62.52% done
     │   ├── argparse.po                   99.0% translated 399/400
     │   ├── asyncio-dev.po                66.0% translated   36/54
     │   ├── asyncio-eventloop.po          73.0% translated 308/417
@@ -87,7 +87,7 @@
     │   ├── io.po                         21.0% translated  61/284
     │   ├── itertools.po                  77.0% translated 155/201
     │   ├── logging.config.po             90.0% translated 155/172
-    │   ├── logging.handlers.po           25.0% translated  72/277
+    │   ├── logging.handlers.po           39.0% translated 110/277
     │   ├── logging.po                    28.0% translated 107/371
     │   ├── mailbox.po                     6.0% translated  21/307
     │   ├── marshal.po                    64.0% translated   36/56

stats.json

@@ -1 +1 @@
-{"completion": "62.3%", "translated": 53862, "entries": 81985, "updated_at": "2025-12-11T23:09:34+00:00Z"}
+{"completion": "62.37%", "translated": 53900, "entries": 81985, "updated_at": "2025-12-12T23:10:00+00:00Z"}