Update translation

github-actions[bot] · github-actions[bot] · commit 628f55acd4ca · 2025-12-12T23:50:33.000Z
Co-Authored-By: Rainer Terroso
diff --git a/library/logging.handlers.po b/library/logging.handlers.po
@@ -261,8 +261,8 @@ msgid ""
 "See :ref:`library-config` for more information on how to use :class:"
 "`NullHandler`."
 msgstr ""
-"Consulte :ref:`biblioteca-config` para obter mais informações sobre como "
-"usar :class:`NullHandler`."
+"Consulte :ref:`library-config` para obter mais informações sobre como usar :"
+"class:`NullHandler`."
 
 #: ../../library/logging.handlers.rst:159
 msgid "WatchedFileHandler"
@@ -344,10 +344,12 @@ 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 ""
@@ -357,17 +359,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 ""
@@ -376,6 +386,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 ""
@@ -393,36 +407,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 ""
@@ -431,17 +467,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 ""
@@ -452,26 +496,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 ""
@@ -483,6 +537,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 ""
@@ -501,21 +562,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  64.56% done
-└── 3.11/  64.56% done
+1 directory  64.63% done
+└── 3.11/  64.63% done
     ├── c-api/  53.46% done
     │   ├── exceptions.po                 63.0% translated 219/347
     │   ├── float.po                      97.0% translated   34/35
@@ -54,7 +54,7 @@
     ├── install/  71.32% done
     │   └── index.po                      73.0% translated 166/226
     ├── installing/  100.00% done
-    ├── library/  57.82% done
+    ├── library/  57.94% done
     │   ├── _thread.po                    96.0% translated   49/51
     │   ├── abc.po                        97.0% translated   48/49
     │   ├── argparse.po                   91.0% translated 305/335
@@ -142,7 +142,7 @@
     │   ├── ipaddress.po                  99.0% translated 155/156
     │   ├── itertools.po                  83.0% translated 131/157
     │   ├── logging.config.po             87.0% translated 117/134
-    │   ├── logging.handlers.po           29.0% translated  80/268
+    │   ├── logging.handlers.po           39.0% translated 106/268
     │   ├── logging.po                    28.0% translated 100/351
     │   ├── mailbox.po                     7.0% translated  20/285
     │   ├── mailcap.po                    13.0% translated    2/15
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "64.56%", "translated": 39293, "entries": 55824, "updated_at": "2025-12-11T23:54:39+00:00Z"}
+{"completion": "64.63%", "translated": 39319, "entries": 55824, "updated_at": "2025-12-12T23:50:30+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "64.56%", "translated": 39293, "entries": 55824, "updated_at": "2025-12-11T23:54:39+00:00Z"}`
	`1`	`+{"completion": "64.63%", "translated": 39319, "entries": 55824, "updated_at": "2025-12-12T23:50:30+00:00Z"}`