Update translation

github-actions[bot] · github-actions[bot] · commit 8da39456b0a5 · 2025-12-12T23:39:59.000Z
Co-Authored-By: Rainer Terroso
diff --git a/library/logging.handlers.po b/library/logging.handlers.po
@@ -248,23 +248,27 @@ 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 ""
@@ -273,6 +277,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 ""
@@ -283,6 +291,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 ""
@@ -292,6 +307,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 ""
@@ -303,23 +323,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 ""
@@ -329,17 +361,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 ""
@@ -348,6 +388,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 ""
@@ -365,36 +409,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 ""
@@ -403,17 +469,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 ""
@@ -424,26 +498,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 ""
@@ -455,6 +539,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 ""
@@ -473,21 +564,39 @@ 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:453
 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:358
 msgid "TimedRotatingFileHandler"
-msgstr ""
+msgstr "TimedRotatingFileHandler"
 
 #: ../../library/logging.handlers.rst:360
 msgid ""
diff --git a/potodo.md b/potodo.md
@@ -1,5 +1,5 @@
-1 directory  66.40% done
-└── 3.12/  66.40% done
+1 directory  66.48% done
+└── 3.12/  66.48% done
     ├── c-api/  52.74% done
     │   ├── exceptions.po                 63.0% translated 232/366
     │   ├── frame.po                      80.0% translated   29/36
@@ -38,7 +38,7 @@
     │   ├── sorting.po                    66.0% translated   50/75
     │   └── unicode.po                    20.0% translated  30/145
     ├── installing/  100.00% done
-    ├── library/  59.97% done
+    ├── library/  60.12% done
     │   ├── 2to3.po                       91.0% translated 121/132
     │   ├── array.po                      95.0% translated   80/84
     │   ├── ast.po                        83.0% translated 255/306
@@ -100,7 +100,7 @@
     │   ├── io.po                         21.0% translated  59/271
     │   ├── itertools.po                  77.0% translated 149/193
     │   ├── logging.config.po             89.0% translated 153/171
-    │   ├── logging.handlers.po           26.0% translated  72/270
+    │   ├── logging.handlers.po           39.0% translated 107/270
     │   ├── logging.po                    28.0% translated 106/368
     │   ├── mailbox.po                     7.0% translated  21/290
     │   ├── mailcap.po                    12.0% translated    2/16
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "66.4%", "translated": 44490, "entries": 62010, "updated_at": "2025-12-11T23:40:53+00:00Z"}
+{"completion": "66.48%", "translated": 44525, "entries": 62010, "updated_at": "2025-12-12T23:39:56+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "66.4%", "translated": 44490, "entries": 62010, "updated_at": "2025-12-11T23:40:53+00:00Z"}`
	`1`	`+{"completion": "66.48%", "translated": 44525, "entries": 62010, "updated_at": "2025-12-12T23:39:56+00:00Z"}`