python
diff --git a/‎library/pkgutil.po
Lines changed: 89 additions & 11 deletions b/‎library/pkgutil.po
Lines changed: 89 additions & 11 deletions
@@ -5,16 +5,16 @@
 #
 # Translators:
 # Raphael Mendonça, 2017
-# Rafael Fontenelle <rffontenelle@gmail.com>, 2020
+# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
 #
 #, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.9\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-01-03 16:35+0000\n"
+"POT-Creation-Date: 2025-06-13 17:30+0000\n"
 "PO-Revision-Date: 2017-02-16 23:22+0000\n"
-"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2020\n"
+"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
 "teams/5390/pt_BR/)\n"
 "Language: pt_BR\n"
@@ -77,6 +77,10 @@ msgid ""
 "returned unchanged.  The input path is not modified; an extended copy is "
 "returned.  Items are only appended to the copy at the end."
 msgstr ""
+"Se o caminho de entrada não for uma lista (como é o caso de pacotes "
+"congelados), ele será retornado inalterado. O caminho de entrada não é "
+"modificado; uma cópia estendida é retornada. Os itens são anexados à cópia "
+"apenas no final."
 
 #: ../../library/pkgutil.rst:45
 msgid ""
@@ -86,6 +90,11 @@ msgid ""
 "may cause this function to raise an exception (in line with :func:`os.path."
 "isdir` behavior)."
 msgstr ""
+"Presume-se que :data:`sys.path` seja uma sequência. Itens de :data:`sys."
+"path` que não sejam strings referentes a diretórios existentes são "
+"ignorados. Itens Unicode em :data:`sys.path` que causam erros quando usados "
+"como nomes de arquivo podem fazer com que esta função levante uma exceção "
+"(em linha com o comportamento de :func:`os.path.isdir`)."
 
 #: ../../library/pkgutil.rst:54
 msgid ":pep:`302` Finder that wraps Python's \"classic\" import algorithm."
@@ -134,26 +143,32 @@ msgid ""
 "Updated to be based directly on :mod:`importlib` rather than relying on the "
 "package internal :pep:`302` import emulation."
 msgstr ""
+"Atualizado para ser baseado diretamente em :mod:`importlib` em vez de "
+"depender da emulação de importação interna do pacote da :pep:`302`."
 
 #: ../../library/pkgutil.rst:91 ../../library/pkgutil.rst:123
 msgid "Updated to be based on :pep:`451`"
 msgstr ""
 
 #: ../../library/pkgutil.rst:96
 msgid "Retrieve a :term:`finder` for the given *path_item*."
-msgstr ""
+msgstr "Recupera um :term:`localizador` para o *path_item* fornecido."
 
 #: ../../library/pkgutil.rst:98
 msgid ""
 "The returned finder is cached in :data:`sys.path_importer_cache` if it was "
 "newly created by a path hook."
 msgstr ""
+"O localizador retornado é armazenado em cache em :data:`sys."
+"path_importer_cache` se ele foi criado recentemente por um gancho de caminho."
 
 #: ../../library/pkgutil.rst:101
 msgid ""
 "The cache (or part of it) can be cleared manually if a rescan of :data:`sys."
 "path_hooks` is necessary."
 msgstr ""
+"O cache (ou parte dele) pode ser limpo manualmente se uma nova varredura de :"
+"data:`sys.path_hooks` for necessária."
 
 #: ../../library/pkgutil.rst:111
 msgid "Get a :term:`loader` object for *module_or_name*."
@@ -170,40 +185,53 @@ msgstr ""
 
 #: ../../library/pkgutil.rst:129
 msgid "Yield :term:`finder` objects for the given module name."
-msgstr ""
+msgstr "Produz objetos :term:`localizador` para o nome do módulo fornecido."
 
 #: ../../library/pkgutil.rst:131
 msgid ""
 "If fullname contains a ``'.'``, the finders will be for the package "
 "containing fullname, otherwise they will be all registered top level finders "
 "(i.e. those on both :data:`sys.meta_path` and :data:`sys.path_hooks`)."
 msgstr ""
+"Se fullname contiver ``'.'``, os localizadores serão para o pacote que "
+"contém fullname, caso contrário, serão todos os localizadores de nível "
+"superior registrados (ou seja, aqueles em :data:`sys.meta_path` e :data:`sys."
+"path_hooks`)."
 
 #: ../../library/pkgutil.rst:135
 msgid ""
 "If the named module is in a package, that package is imported as a side "
 "effect of invoking this function."
 msgstr ""
+"Se o módulo nomeado estiver em um pacote, esse pacote será importado como um "
+"efeito colateral da invocação desta função."
 
 #: ../../library/pkgutil.rst:138
 msgid "If no module name is specified, all top level finders are produced."
 msgstr ""
+"Se nenhum nome de módulo for especificado, todos os localizadores de nível "
+"superior serão produzidos."
 
 #: ../../library/pkgutil.rst:147
 msgid ""
 "Yields :class:`ModuleInfo` for all submodules on *path*, or, if *path* is "
 "``None``, all top-level modules on :data:`sys.path`."
 msgstr ""
+"Levanta :class:`ModuleInfo` para todos os submódulos em *path* ou, se *path* "
+"for ``None``, todos os módulos de nível superior em :data:`sys.path`."
 
 #: ../../library/pkgutil.rst:150 ../../library/pkgutil.rst:171
 msgid ""
 "*path* should be either ``None`` or a list of paths to look for modules in."
 msgstr ""
+"*path* deve ser ``None`` ou uma lista de caminhos para procurar módulos."
 
 #: ../../library/pkgutil.rst:152 ../../library/pkgutil.rst:173
 msgid ""
 "*prefix* is a string to output on the front of every module name on output."
 msgstr ""
+"*prefix* é uma string a ser exibida na frente de cada nome de módulo na "
+"saída."
 
 #: ../../library/pkgutil.rst:156 ../../library/pkgutil.rst:195
 msgid ""
@@ -212,19 +240,28 @@ msgid ""
 "for :class:`importlib.machinery.FileFinder` and :class:`zipimport."
 "zipimporter`."
 msgstr ""
+"Funciona apenas para um :term:`localizador` que define um método "
+"``iter_modules()``. Esta interface não é padrão, portanto, o módulo também "
+"fornece implementações para :class:`importlib.machinery.FileFinder` e :class:"
+"`zipimport.zipimporter`."
 
 #: ../../library/pkgutil.rst:168
 msgid ""
 "Yields :class:`ModuleInfo` for all modules recursively on *path*, or, if "
 "*path* is ``None``, all accessible modules."
 msgstr ""
+"Levanta :class:`ModuleInfo` para todos os módulos recursivamente em *path*, "
+"ou, se *path* for ``None``, todos os módulos acessíveis."
 
 #: ../../library/pkgutil.rst:175
 msgid ""
 "Note that this function must import all *packages* (*not* all modules!) on "
 "the given *path*, in order to access the ``__path__`` attribute to find "
 "submodules."
 msgstr ""
+"Observe que esta função deve importar todos os *pacotes* (*não* todos os "
+"módulos!) no caminho *path* fornecido, para acessar o atributo ``__path__`` "
+"para encontrar submódulos."
 
 #: ../../library/pkgutil.rst:179
 msgid ""
@@ -234,14 +271,19 @@ msgid ""
 "`ImportError`\\s are caught and ignored, while all other exceptions are "
 "propagated, terminating the search."
 msgstr ""
+"*onerror* é uma função que é chamada com um argumento (o nome do pacote que "
+"estava sendo importado) caso ocorra alguma exceção durante a tentativa de "
+"importação de um pacote. Se nenhuma função *onerror* for fornecida, :exc:"
+"`ImportError`\\s são capturadas e ignoradas, enquanto todas as outras "
+"exceções são propagadas, encerrando a busca."
 
 #: ../../library/pkgutil.rst:185
 msgid "Examples::"
 msgstr "Exemplos::"
 
 #: ../../library/pkgutil.rst:207
 msgid "Get a resource from a package."
-msgstr ""
+msgstr "Obtém um recurso de um pacote."
 
 #: ../../library/pkgutil.rst:209
 msgid ""
@@ -252,18 +294,27 @@ msgid ""
 "separator.  The parent directory name ``..`` is not allowed, and nor is a "
 "rooted name (starting with a ``/``)."
 msgstr ""
+"Este é um invólucro para a API :meth:`get_data <importlib.abc.ResourceLoader."
+"get_data>` do :term:`carregador`. O argumento *package* deve ser o nome de "
+"um pacote, no formato de módulo padrão (``foo.bar``). O argumento *resource* "
+"deve estar no formato de um nome de arquivo relativo, usando ``/`` como "
+"separador de caminho. O nome do diretório pai ``..`` não é permitido, nem um "
+"nome raiz (começando com ``/``)."
 
 #: ../../library/pkgutil.rst:216
 msgid ""
 "The function returns a binary string that is the contents of the specified "
 "resource."
 msgstr ""
+"A função retorna uma string binária que é o conteúdo do recurso especificado."
 
 #: ../../library/pkgutil.rst:219
 msgid ""
 "For packages located in the filesystem, which have already been imported, "
 "this is the rough equivalent of::"
 msgstr ""
+"Para pacotes localizados no sistema de arquivos, que já foram importados, "
+"isso é o equivalente aproximado de::"
 
 #: ../../library/pkgutil.rst:225
 msgid ""
@@ -273,32 +324,43 @@ msgid ""
 "for :term:`namespace packages <namespace package>` does not support :meth:"
 "`get_data <importlib.abc.ResourceLoader.get_data>`."
 msgstr ""
+"Se o pacote não puder ser localizado ou carregado, ou se usar um :term:"
+"`carregador` que não oferece suporte a :meth:`get_data <importlib.abc."
+"ResourceLoader.get_data>`, ``None`` será retornado. Em particular, o :term:"
+"`carregador` para :term:`pacotes de espaço de nomes <namespace package>` não "
+"oferece suporte a :meth:`get_data <importlib.abc.ResourceLoader.get_data>`."
 
 #: ../../library/pkgutil.rst:234
 msgid "Resolve a name to an object."
-msgstr ""
+msgstr "Resolve um nome a um objeto."
 
 #: ../../library/pkgutil.rst:236
 msgid ""
 "This functionality is used in numerous places in the standard library (see :"
 "issue:`12915`) - and equivalent functionality is also in widely used third-"
 "party packages such as setuptools, Django and Pyramid."
 msgstr ""
+"Essa funcionalidade é usada em vários lugares na biblioteca padrão (veja :"
+"issue:`12915`) - e funcionalidades equivalentes também estão amplamente "
+"utilizadas em pacotes de terceiros, como setuptools, Django e Pyramid."
 
 #: ../../library/pkgutil.rst:240
 msgid ""
 "It is expected that *name* will be a string in one of the following formats, "
 "where W is shorthand for a valid Python identifier and dot stands for a "
 "literal period in these pseudo-regexes:"
 msgstr ""
+"Espera-se que *name* seja uma string em um dos seguintes formatos, onde W é "
+"uma abreviação para um identificador Python válido e ponto representa um "
+"ponto literal nessas pseudo-regexes:"
 
 #: ../../library/pkgutil.rst:244
 msgid "``W(.W)*``"
-msgstr ""
+msgstr "``W(.W)*``"
 
 #: ../../library/pkgutil.rst:245
 msgid "``W(.W)*:(W(.W)*)?``"
-msgstr ""
+msgstr "``W(.W)*:(W(.W)*)?``"
 
 #: ../../library/pkgutil.rst:247
 msgid ""
@@ -309,6 +371,12 @@ msgid ""
 "inferred by inspection, repeated attempts to import must be done with this "
 "form."
 msgstr ""
+"A primeira forma destina-se apenas à retrocompatibilidade. Ela presume que "
+"parte do nome pontilhado seja um pacote e o restante seja um objeto em algum "
+"lugar dentro desse pacote, possivelmente aninhado dentro de outros objetos. "
+"Como o ponto onde o pacote termina e a hierarquia de objetos começa não pode "
+"ser inferido por inspeção, tentativas repetidas de importação devem ser "
+"feitas com esta forma."
 
 #: ../../library/pkgutil.rst:254
 msgid ""
@@ -318,23 +386,33 @@ msgid ""
 "hierarchy within that package. Only one import is needed in this form. If it "
 "ends with the colon, then a module object is returned."
 msgstr ""
+"Na segunda forma, o chamador deixa claro o ponto de divisão por meio de um "
+"caractere de dois pontos: o nome pontilhado à esquerda do caractere de dois "
+"pontos representa um pacote a ser importado, e o nome pontilhado à direita "
+"representa a hierarquia de objetos dentro desse pacote. Apenas uma "
+"importação é necessária nesta forma. Se terminar com caractere de dois "
+"pontos, um objeto de módulo será retornado."
 
 #: ../../library/pkgutil.rst:260
 msgid ""
 "The function will return an object (which might be a module), or raise one "
 "of the following exceptions:"
 msgstr ""
+"A função retornará um objeto (que pode ser um módulo) ou levantará uma das "
+"seguintes exceções:"
 
 #: ../../library/pkgutil.rst:263
 msgid ":exc:`ValueError` -- if *name* isn't in a recognised format."
-msgstr ""
+msgstr ":exc:`ValueError` -- se *name* não estiver em um formato reconhecido."
 
 #: ../../library/pkgutil.rst:265
 msgid ":exc:`ImportError` -- if an import failed when it shouldn't have."
-msgstr ""
+msgstr ":exc:`ImportError` -- se uma importação falhou quando não deveria."
 
 #: ../../library/pkgutil.rst:267
 msgid ""
 ":exc:`AttributeError` -- If a failure occurred when traversing the object "
 "hierarchy within the imported package to get to the desired object."
 msgstr ""
+":exc:`AttributeError` -- Se ocorrer uma falha ao percorrer a hierarquia de "
+"objetos dentro do pacote importado para chegar ao objeto desejado."