Update translation

github-actions[bot] · github-actions[bot] · commit a4fdd697bc6c · 2025-12-12T00:30:38.000Z
Co-Authored-By: Rainer Terroso
diff --git a/library/logging.handlers.po b/library/logging.handlers.po
@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-12-09 17:26+0000\n"
+"POT-Creation-Date: 2025-12-11 17:58+0000\n"
 "PO-Revision-Date: 2025-09-22 15:58+0000\n"
 "Last-Translator: Rainer Terroso, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -228,31 +228,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:`biblioteca-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 ""
@@ -261,6 +268,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 ""
@@ -271,6 +282,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 ""
@@ -280,6 +298,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 ""
@@ -298,16 +321,21 @@ msgid ""
 "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 ""
@@ -317,17 +345,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 ""
@@ -336,6 +372,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 ""
@@ -353,36 +393,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 sobrescreva 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 ""
@@ -391,17 +453,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 ""
@@ -412,26 +482,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 ""
@@ -443,6 +523,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 ""
@@ -461,21 +548,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  60.47% done
-└── 3.10/  60.47% done
+1 directory  60.56% done
+└── 3.10/  60.56% done
     ├── c-api/  51.44% done
     │   ├── allocation.po                 88.0% translated     8/9
     │   ├── arg.po                        98.0% translated 193/195
@@ -56,7 +56,7 @@
     ├── install/  72.62% done
     │   └── index.po                      74.0% translated 168/226
     ├── installing/  100.00% done
-    ├── library/  55.19% done
+    ├── library/  55.35% done
     │   ├── _thread.po                    95.0% translated   39/41
     │   ├── argparse.po                   88.0% translated 256/290
     │   ├── array.po                      98.0% translated   81/82
@@ -149,7 +149,7 @@
     │   ├── ipaddress.po                  98.0% translated 155/158
     │   ├── itertools.po                  83.0% translated 128/153
     │   ├── logging.config.po             81.0% translated 109/133
-    │   ├── logging.handlers.po           25.0% translated  68/268
+    │   ├── logging.handlers.po           38.0% translated 104/268
     │   ├── logging.po                    28.0% translated  96/334
     │   ├── mailbox.po                     8.0% translated  23/282
     │   ├── mailcap.po                    13.0% translated    2/15
diff --git a/stats.json b/stats.json
@@ -1 +1 @@
-{"completion": "60.47%", "translated": 34730, "entries": 51688, "updated_at": "2025-12-11T00:31:16+00:00Z"}
+{"completion": "60.56%", "translated": 34766, "entries": 51688, "updated_at": "2025-12-12T00:30:35+00:00Z"}

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "60.47%", "translated": 34730, "entries": 51688, "updated_at": "2025-12-11T00:31:16+00:00Z"}`
	`1`	`+{"completion": "60.56%", "translated": 34766, "entries": 51688, "updated_at": "2025-12-12T00:30:35+00:00Z"}`