@@ -37,6 +37,10 @@ msgid ""
3737"line switch that allows scripts to be located using the Python module "
3838"namespace rather than the filesystem."
3939msgstr ""
40+ "O módulo :mod:`runpy` é usado para localizar e executar módulos Python sem "
41+ "importá-los primeiro. Seu principal uso é implementar a opção de linha de "
42+ "comando :option:`-m` que permite que os scripts sejam localizados usando o "
43+ "espaço de nomes do módulo Python em vez do sistema de arquivos."
4044
4145#: ../../library/runpy.rst:18
4246msgid ""
@@ -55,6 +59,11 @@ msgid ""
5559"that limitation is not acceptable for a given use case, :mod:`importlib` is "
5660"likely to be a more suitable choice than this module."
5761msgstr ""
62+ "Além disso, quaisquer funções e classes definidas pelo código executado não "
63+ "têm garantia de funcionar corretamente após o retorno de uma função "
64+ ":mod:`runpy`. Se essa limitação não for aceitável para um determinado caso "
65+ "de uso, :mod:`importlib` provavelmente será uma escolha mais adequada do que"
66+ " este módulo."
5867
5968#: ../../library/runpy.rst:27
6069msgid "The :mod:`runpy` module provides two functions:"
@@ -67,6 +76,10 @@ msgid ""
6776"import mechanism (refer to :pep:`302` for details) and then executed in a "
6877"fresh module namespace."
6978msgstr ""
79+ "Execute o código do módulo especificado e retorne o dicionário global do "
80+ "módulo resultante. O código do módulo é localizado primeiro usando o "
81+ "mecanismo de importação padrão (consulte :pep:`302` para detalhes) e então "
82+ "executado em um novo espaço de nomes de módulo."
7083
7184#: ../../library/runpy.rst:40
7285msgid ""
@@ -75,6 +88,10 @@ msgid ""
7588"imported and the ``__main__`` submodule within that package is then executed"
7689" and the resulting module globals dictionary returned."
7790msgstr ""
91+ "O argumento *mod_name* deve ser um nome de módulo absoluto. Se o nome do "
92+ "módulo se referir a um pacote ao invés de um módulo normal, então esse "
93+ "pacote é importado e o submódulo ``__main__`` dentro desse pacote é então "
94+ "executado e o dicionário global do módulo resultante retornado."
7895
7996#: ../../library/runpy.rst:46
8097msgid ""
@@ -98,13 +115,21 @@ msgid ""
98115"set of variables - other variables may be set implicitly as an interpreter "
99116"implementation detail)."
100117msgstr ""
118+ "As variáveis globais especiais ``__name__``, ``__spec__``, ``__file__``, "
119+ "``__cached__``, ``__loader__`` e ``__package__`` são definidas no dicionário"
120+ " global antes que o código do módulo seja executado (Observe que este é um "
121+ "conjunto mínimo de variáveis - outras variáveis podem ser definidas "
122+ "implicitamente como um detalhe de implementação do interpretador)."
101123
102124#: ../../library/runpy.rst:58
103125msgid ""
104126"``__name__`` is set to *run_name* if this optional argument is not "
105127":const:`None`, to ``mod_name + '.__main__'`` if the named module is a "
106128"package and to the *mod_name* argument otherwise."
107129msgstr ""
130+ "``__name__`` é definido como *run_name* se este argumento opcional não for "
131+ ":const:`None`, para ``mod_name + '.__main__'`` se o módulo nomeado for um "
132+ "pacote e para o argumento *mod_name* caso contrário ."
108133
109134#: ../../library/runpy.rst:62
110135msgid ""
@@ -121,6 +146,9 @@ msgid ""
121146"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` are "
122147":ref:`set as normal <import-mod-attrs>` based on the module spec."
123148msgstr ""
149+ "``__file__``, ``__cached__``, ``__loader__`` e ``__package__`` são "
150+ ":ref:`definidos como normal <import-mod-attrs>` com base na especificação do"
151+ " módulo."
124152
125153#: ../../library/runpy.rst:69
126154msgid ""
@@ -130,6 +158,12 @@ msgid ""
130158"module being executed. Both ``sys.argv[0]`` and ``sys.modules[__name__]`` "
131159"are restored to their original values before the function returns."
132160msgstr ""
161+ "Se o argumento *alter_sys* for fornecido e for avaliado como :const:`True`, "
162+ "então ``sys.argv[0]`` será atualizado com o valor de ``__file__`` e "
163+ "``sys.modules[__name__]`` é atualizado com um objeto de módulo temporário "
164+ "para o módulo que está sendo executado. Ambos ``sys.argv[0]`` e "
165+ "``sys.modules[__name__]`` são restaurados para seus valores originais antes "
166+ "que a função retorne."
133167
134168#: ../../library/runpy.rst:75
135169msgid ""
@@ -138,6 +172,10 @@ msgid ""
138172"arguments. It is recommended that the :mod:`sys` module be left alone when "
139173"invoking this function from threaded code."
140174msgstr ""
175+ "Note que esta manipulação de :mod:`sys` não é segura para thread. Outras "
176+ "threads podem ver o módulo parcialmente inicializado, bem como a lista "
177+ "alterada de argumentos. É recomendado que o módulo :mod:`sys` seja deixado "
178+ "sozinho ao invocar esta função a partir do código encadeado."
141179
142180#: ../../library/runpy.rst:81
143181msgid ""
@@ -164,6 +202,10 @@ msgid ""
164202"well as ensuring the real module name is always accessible as "
165203"``__spec__.name``."
166204msgstr ""
205+ "Atualizado para aproveitar o recurso de especificação do módulo adicionado "
206+ "por :pep:`451`. Isso permite que ``__cached__`` seja configurado "
207+ "corretamente para módulos executados desta forma, assim como garante que o "
208+ "nome real do módulo esteja sempre acessível como ``__spec__.name``."
167209
168210#: ../../library/runpy.rst:101
169211msgid ""
@@ -173,6 +215,12 @@ msgid ""
173215"compiled bytecode file or a valid sys.path entry containing a ``__main__`` "
174216"module (e.g. a zipfile containing a top-level ``__main__.py`` file)."
175217msgstr ""
218+ "Executa o código no local do sistema de arquivos nomeado e retorna o "
219+ "dicionário global do módulo resultante. Assim como um nome de script "
220+ "fornecido à linha de comando CPython, o caminho fornecido pode se referir a "
221+ "um arquivo de origem Python, um arquivo de bytecode compilado ou uma entrada"
222+ " sys.path válida contendo um módulo ``__main__`` (por exemplo, um arquivo "
223+ "zip contendo um arquivo de topo de nível ``__main__.py``)."
176224
177225#: ../../library/runpy.rst:107
178226msgid ""
@@ -184,6 +232,13 @@ msgid ""
184232":mod:`__main__` entry located elsewhere on ``sys.path`` if there is no such "
185233"module at the specified location."
186234msgstr ""
235+ "Para um script simples, o código especificado é simplesmente executado em um"
236+ " novo espaço de nomes de módulo. Para uma entrada sys.path válida "
237+ "(normalmente um arquivo zip ou diretório), a entrada é primeiro adicionada "
238+ "ao início de ``sys.path``. A função então procura e executa um módulo "
239+ ":mod:`__main__` usando o caminho atualizado. Observe que não há proteção "
240+ "especial contra invocar uma entrada :mod:`__main__` existente localizada em "
241+ "outro lugar em ``sys.path`` se não houver tal módulo no local especificado."
187242
188243#: ../../library/runpy.rst:115
189244msgid ""
@@ -193,12 +248,19 @@ msgid ""
193248"below are defined in the supplied dictionary, those definitions are "
194249"overridden by :func:`run_path`."
195250msgstr ""
251+ "O argumento opcional de dicionário *init_globals* pode ser usado para "
252+ "preencher previamente o dicionário global do módulo antes do código ser "
253+ "executado. O dicionário fornecido não será alterado. Se qualquer uma das "
254+ "variáveis globais especiais abaixo for definida no dicionário fornecido, "
255+ "estas definições serão substituídas por :func:`run_path`."
196256
197257#: ../../library/runpy.rst:127
198258msgid ""
199259"``__name__`` is set to *run_name* if this optional argument is not "
200260":const:`None` and to ``'<run_path>'`` otherwise."
201261msgstr ""
262+ "``__name__`` é definido como *run_name* se este argumento opcional não for "
263+ ":const:`None` e como ``'<run_path>'`` caso contrário."
202264
203265#: ../../library/runpy.rst:130
204266msgid ""
@@ -207,6 +269,10 @@ msgid ""
207269"path, and ``__spec__``, ``__cached__``, ``__loader__`` and ``__package__`` "
208270"will all be set to :const:`None`."
209271msgstr ""
272+ "Se o caminho fornecido referenciar diretamente um arquivo de script (seja "
273+ "como fonte ou como bytecode pré-compilado), então ``__file__`` será definido"
274+ " para o caminho fornecido e ``__spec__``, ``__cached__``, ``__loader__ `` e "
275+ "``__package__`` serão todos definidos como :const:`None`."
210276
211277#: ../../library/runpy.rst:135
212278msgid ""
@@ -216,6 +282,12 @@ msgid ""
216282"``__cached__``, ``__loader__`` and ``__package__`` will be :ref:`set as "
217283"normal <import-mod-attrs>` based on the module spec."
218284msgstr ""
285+ "Se o caminho fornecido for uma referência a uma entrada sys.path válida, "
286+ "então ``__spec__`` será definido apropriadamente para o módulo ``__main__`` "
287+ "importado (ou seja, ``__spec__.name`` sempre será `` __principal__``). "
288+ "``__file__``, ``__cached__``, ``__loader__`` e ``__package__`` serão "
289+ ":ref:`definidos como normal <import-mod-attrs>` com base na especificação do"
290+ " módulo."
219291
220292#: ../../library/runpy.rst:141
221293msgid ""
@@ -235,12 +307,20 @@ msgid ""
235307" still apply, use of this function in threaded code should be either "
236308"serialised with the import lock or delegated to a separate process."
237309msgstr ""
310+ "Note que, diferentemente de :func:`run_module`, as alterações feitas em "
311+ ":mod:`sys` não são opcionais nesta função, pois esses ajustes são essenciais"
312+ " para permitir a execução das entradas do sys.path. Como as limitações de "
313+ "segurança de encadeamento ainda se aplicam, o uso dessa função no código "
314+ "encadeado deve ser serializado com o bloqueio de importação ou delegado a um"
315+ " processo separado."
238316
239317#: ../../library/runpy.rst:155
240318msgid ""
241319":ref:`using-on-interface-options` for equivalent functionality on the "
242320"command line (``python path/to/script``)."
243321msgstr ""
322+ ":ref:`using-on-interface-options` para funcionalidade equivalente na linha "
323+ "de comando (``python path/to/script``)."
244324
245325#: ../../library/runpy.rst:160
246326msgid ""
@@ -249,6 +329,10 @@ msgid ""
249329"``__main__`` is imported from a valid sys.path entry rather than being "
250330"executed directly."
251331msgstr ""
332+ "Atualizado para aproveitar o recurso de especificação do módulo adicionado "
333+ "por :pep:`451`. Isso permite que ``__cached__`` seja definido corretamente "
334+ "no caso em que ``__main__`` é importado de uma entrada sys.path válida em "
335+ "vez de ser executado diretamente."
252336
253337#: ../../library/runpy.rst:169
254338msgid ":pep:`338` -- Executing modules as scripts"
@@ -260,11 +344,11 @@ msgstr "PEP escrita e implementada por Nick Coghlan."
260344
261345#: ../../library/runpy.rst:172
262346msgid ":pep:`366` -- Main module explicit relative imports"
263- msgstr ""
347+ msgstr ":pep:`366` -- Importações relativas explícitas do módulo principal "
264348
265349#: ../../library/runpy.rst:175
266350msgid ":pep:`451` -- A ModuleSpec Type for the Import System"
267- msgstr ""
351+ msgstr ":pep:`451` -- Um tipo ModuleSpec para o sistema de importação "
268352
269353#: ../../library/runpy.rst:175
270354msgid "PEP written and implemented by Eric Snow"