python
diff --git a/‎howto/urllib2.po
Copy file name to clipboardExpand all lines: howto/urllib2.po
+102-11Lines changed: 102 additions & 11 deletions b/‎howto/urllib2.po
Copy file name to clipboardExpand all lines: howto/urllib2.po
+102-11Lines changed: 102 additions & 11 deletions
diff --git a/‎potodo.md
Copy file name to clipboardExpand all lines: potodo.md
+3-3Lines changed: 3 additions & 3 deletions b/‎potodo.md
Copy file name to clipboardExpand all lines: potodo.md
+3-3Lines changed: 3 additions & 3 deletions
diff --git a/‎stats.json
Copy file name to clipboard
+1-1Lines changed: 1 addition & 1 deletion b/‎stats.json
Copy file name to clipboard
+1-1Lines changed: 1 addition & 1 deletion
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.10\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-01-03 16:02+0000\n"
+"POT-Creation-Date: 2025-05-09 17:01+0000\n"
 "PO-Revision-Date: 2022-11-05 17:21+0000\n"
 "Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2024\n"
 "Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
@@ -184,10 +184,16 @@ msgid ""
 "request itself, to the server - this information is sent as HTTP "
 "\"headers\".  Let's look at each of these in turn."
 msgstr ""
+"No caso do HTTP, há duas coisas extras que os objetos Request permitem que "
+"você faça: primeiro, você pode passar dados a serem enviados ao servidor. "
+"Segundo, você pode passar informações extras (\"metadados\") *sobre* os "
+"dados ou sobre a própria solicitação para o servidor — essas informações são "
+"enviadas como \"cabeçalhos\" HTTP. Vamos analisar cada um deles "
+"separadamente."
 
 #: ../../howto/urllib2.rst:105
 msgid "Data"
-msgstr ""
+msgstr "Dados"
 
 #: ../../howto/urllib2.rst:107
 msgid ""
@@ -201,13 +207,27 @@ msgid ""
 "Request object as the ``data`` argument. The encoding is done using a "
 "function from the :mod:`urllib.parse` library. ::"
 msgstr ""
+"Às vezes, você deseja enviar dados para uma URL (geralmente a URL se refere "
+"a um script CGI (Common Gateway Interface) ou outra aplicação web). Com "
+"HTTP, isso geralmente é feito usando o que é conhecido como uma solicitação "
+"**POST**. Isso geralmente é o que seu navegador faz quando você envia um "
+"formulário HTML preenchido na web. Nem todos os POSTs precisam vir de "
+"formulários: você pode usar um POST para transmitir dados arbitrários para "
+"sua própria aplicação. No caso comum de formulários HTML, os dados precisam "
+"ser codificados de forma padrão e, em seguida, passados para o objeto "
+"Request como o argumento ``data``. A codificação é feita usando uma função "
+"da biblioteca :mod:`urllib.parse`. ::"
 
 #: ../../howto/urllib2.rst:131
 msgid ""
 "Note that other encodings are sometimes required (e.g. for file upload from "
 "HTML forms - see `HTML Specification, Form Submission <https://www.w3.org/TR/"
 "REC-html40/interact/forms.html#h-17.13>`_ for more details)."
 msgstr ""
+"Observe que outras codificações às vezes são necessárias (por exemplo, para "
+"envio de arquivos de formulários HTML - consulte `HTML Specification, Form "
+"Submission <https://www.w3.org/TR/REC-html40/interact/forms.html#h-17.13>`_ "
+"para mais detalhes)."
 
 #: ../../howto/urllib2.rst:136
 msgid ""
@@ -221,6 +241,16 @@ msgid ""
 "side-effects, nor a POST requests from having no side-effects. Data can also "
 "be passed in an HTTP GET request by encoding it in the URL itself."
 msgstr ""
+"Se você não passar o argumento ``data``, o urllib usará uma requisição "
+"**GET**. Uma diferença entre requisições GET e POST é que as requisições "
+"POST frequentemente têm \"efeitos colaterais\": elas alteram o estado do "
+"sistema de alguma forma (por exemplo, ao fazer um pedido ao site para que "
+"cem libras de spam enlatado sejam entregues em sua porta). Embora o padrão "
+"HTTP deixe claro que os POSTs devem *sempre* causar efeitos colaterais, e as "
+"requisições GET *nunca* causar efeitos colaterais, nada impede que uma "
+"requisição GET tenha efeitos colaterais, nem que uma requisição POST não "
+"tenha efeitos colaterais. Dados também podem ser passados em uma requisição "
+"HTTP GET codificando-os na própria URL."
 
 #: ../../howto/urllib2.rst:146
 msgid "This is done as follows::"
@@ -236,13 +266,15 @@ msgstr ""
 
 #: ../../howto/urllib2.rst:165
 msgid "Headers"
-msgstr ""
+msgstr "Cabeçalhos"
 
 #: ../../howto/urllib2.rst:167
 msgid ""
 "We'll discuss here one particular HTTP header, to illustrate how to add "
 "headers to your HTTP request."
 msgstr ""
+"Discutiremos aqui um cabeçalho HTTP específico para ilustrar como adicionar "
+"cabeçalhos à sua solicitação HTTP."
 
 #: ../../howto/urllib2.rst:170
 msgid ""
@@ -256,13 +288,25 @@ msgid ""
 "the same request as above, but identifies itself as a version of Internet "
 "Explorer [#]_. ::"
 msgstr ""
+"Alguns sites [#]_ não gostam de ser navegados por programas ou enviam "
+"versões diferentes para navegadores diferentes [#]_. Por padrão, urllib se "
+"identifica como ``Python-urllib/x.y`` (onde ``x`` e ``y`` são os números de "
+"versão principal e secundária da versão do Python, por exemplo, ``Python-"
+"urllib/2.5``), o que pode confundir o site ou simplesmente não funcionar. A "
+"forma como um navegador se identifica é através do cabeçalho ``User-Agent`` "
+"[#]_. Ao criar um objeto Request, você pode passar um dicionário de "
+"cabeçalhos. O exemplo a seguir faz a mesma solicitação acima, mas se "
+"identifica como uma versão do Internet Explorer [#]_. ::"
 
 #: ../../howto/urllib2.rst:197
 msgid ""
 "The response also has two useful methods. See the section on `info and "
 "geturl`_ which comes after we have a look at what happens when things go "
 "wrong."
 msgstr ""
+"A resposta também possui dois métodos úteis. Veja a seção sobre `info e "
+"geturl`_, que vem depois de analisarmos o que acontece quando as coisas dão "
+"errado."
 
 #: ../../howto/urllib2.rst:202
 msgid "Handling Exceptions"
@@ -283,7 +327,7 @@ msgstr ""
 
 #: ../../howto/urllib2.rst:211
 msgid "The exception classes are exported from the :mod:`urllib.error` module."
-msgstr ""
+msgstr "As classes de exceção são exportadas do módulo :mod:`urllib.error`."
 
 #: ../../howto/urllib2.rst:214
 msgid "URLError"
@@ -296,10 +340,14 @@ msgid ""
 "case, the exception raised will have a 'reason' attribute, which is a tuple "
 "containing an error code and a text error message."
 msgstr ""
+"Frequentemente, URLError é levantada porque não há conexão de rede (nenhuma "
+"rota para o servidor especificado) ou o servidor especificado não existe. "
+"Nesse caso, a exceção gerada terá um atributo \"reason\", que é uma tupla "
+"contendo um código de erro e uma mensagem de erro em texto."
 
 #: ../../howto/urllib2.rst:221
 msgid "e.g. ::"
-msgstr ""
+msgstr "Por exemplo ::"
 
 #: ../../howto/urllib2.rst:232
 msgid "HTTPError"
@@ -321,6 +369,8 @@ msgstr ""
 msgid ""
 "See section 10 of :rfc:`2616` for a reference on all the HTTP error codes."
 msgstr ""
+"Veja a seção 10 de :rfc:`2616` para uma referência sobre todos os códigos de "
+"erro HTTP."
 
 #: ../../howto/urllib2.rst:244
 msgid ""
@@ -330,21 +380,27 @@ msgstr ""
 
 #: ../../howto/urllib2.rst:248
 msgid "Error Codes"
-msgstr ""
+msgstr "Códigos de erro"
 
 #: ../../howto/urllib2.rst:250
 msgid ""
 "Because the default handlers handle redirects (codes in the 300 range), and "
 "codes in the 100--299 range indicate success, you will usually only see "
 "error codes in the 400--599 range."
 msgstr ""
+"Como os tratadores padrão controlam redirecionamentos (códigos no intervalo "
+"300) e códigos no intervalo 100-299 indicam sucesso, normalmente você verá "
+"apenas códigos de erro no intervalo 400-599."
 
 #: ../../howto/urllib2.rst:254
 msgid ""
 ":attr:`http.server.BaseHTTPRequestHandler.responses` is a useful dictionary "
 "of response codes in that shows all the response codes used by :rfc:`2616`. "
 "The dictionary is reproduced here for convenience ::"
 msgstr ""
+":attr:`http.server.BaseHTTPRequestHandler.responses` é um dicionário útil de "
+"códigos de resposta que mostra todos os códigos de resposta usados por :rfc:"
+"`2616`. O dicionário é reproduzido aqui para facilitar ::"
 
 #: ../../howto/urllib2.rst:326
 msgid ""
@@ -367,7 +423,7 @@ msgstr ""
 
 #: ../../howto/urllib2.rst:352
 msgid "Number 1"
-msgstr ""
+msgstr "Número 1"
 
 #: ../../howto/urllib2.rst:374
 msgid ""
@@ -377,11 +433,11 @@ msgstr ""
 
 #: ../../howto/urllib2.rst:378
 msgid "Number 2"
-msgstr ""
+msgstr "Número 2"
 
 #: ../../howto/urllib2.rst:399
 msgid "info and geturl"
-msgstr ""
+msgstr "info e geturl"
 
 #: ../../howto/urllib2.rst:401
 msgid ""
@@ -397,13 +453,20 @@ msgid ""
 "redirect. The URL of the page fetched may not be the same as the URL "
 "requested."
 msgstr ""
+"**geturl** - Isso retorna a URL real da página recuperada. Isso é útil "
+"porque ``urlopen`` (ou o objeto de abertura utilizado) pode ter seguido um "
+"redirecionamento. A URL da página recuperada pode não ser a mesma que a URL "
+"solicitada."
 
 #: ../../howto/urllib2.rst:409
 msgid ""
 "**info** - this returns a dictionary-like object that describes the page "
 "fetched, particularly the headers sent by the server. It is currently an :"
 "class:`http.client.HTTPMessage` instance."
 msgstr ""
+"**info** - Isso retorna um objeto semelhante a um dicionário que descreve a "
+"página recuperada, particularmente os cabeçalhos enviados pelo servidor. "
+"Atualmente, é uma instância de :class:`http.client.HTTPMessage`."
 
 #: ../../howto/urllib2.rst:413
 msgid ""
@@ -412,10 +475,14 @@ msgid ""
 "useful listing of HTTP headers with brief explanations of their meaning and "
 "use."
 msgstr ""
+"Cabeçalhos típicos incluem 'Content-length', 'Content-type' e assim por "
+"diante. Consulte a \"Referência rápida para cabeçalhos HTTP <https://"
+"jkorpela.fi/http.html>\" para obter uma lista útil de cabeçalhos HTTP com "
+"breves explicações sobre seu significado e uso."
 
 #: ../../howto/urllib2.rst:420
 msgid "Openers and Handlers"
-msgstr ""
+msgstr "Abridores e tratadores"
 
 #: ../../howto/urllib2.rst:422
 msgid ""
@@ -427,19 +494,31 @@ msgid ""
 "(http, ftp, etc.), or how to handle an aspect of URL opening, for example "
 "HTTP redirections or HTTP cookies."
 msgstr ""
+"Ao buscar uma URL, você usa um abridor (uma instância do talvez confuso "
+"nome :class:`urllib.request.OpenerDirector`). Normalmente, usamos o abridor "
+"padrão - via ``urlopen`` -, mas você pode criar abridores personalizados. Os "
+"abridores usam manipuladores. Todo o \"trabalho pesado\" é feito pelos "
+"manipuladores. Cada manipulador sabe como abrir URLs para um esquema de URL "
+"específico (http, ftp, etc.) ou como lidar com um aspecto da abertura de "
+"URL, por exemplo, redirecionamentos HTTP ou cookies HTTP."
 
 #: ../../howto/urllib2.rst:430
 msgid ""
 "You will want to create openers if you want to fetch URLs with specific "
 "handlers installed, for example to get an opener that handles cookies, or to "
 "get an opener that does not handle redirections."
 msgstr ""
+"Você vai querer criar abridores se quiser buscar URLs com manipuladores "
+"específicos instalados, por exemplo, para obter um abridor que manipule "
+"cookies ou para obter um abridor que não manipule redirecionamentos."
 
 #: ../../howto/urllib2.rst:434
 msgid ""
 "To create an opener, instantiate an ``OpenerDirector``, and then call ``."
 "add_handler(some_handler_instance)`` repeatedly."
 msgstr ""
+"Para criar um abridor, instancie um ``OpenerDirector`` e então chame ``."
+"add_handler(some_handler_instance)`` repetidamente."
 
 #: ../../howto/urllib2.rst:437
 msgid ""
@@ -448,26 +527,38 @@ msgid ""
 "adds several handlers by default, but provides a quick way to add more and/"
 "or override the default handlers."
 msgstr ""
+"Como alternativa, você pode usar ``build_opener``, que é uma função "
+"conveniente para criar objetos de abertura com uma única chamada de função. "
+"``build_opener`` adiciona vários tratadores por padrão, mas fornece uma "
+"maneira rápida de adicionar mais e/ou substituir os tratadores padrão."
 
 #: ../../howto/urllib2.rst:442
 msgid ""
 "Other sorts of handlers you might want to can handle proxies, "
 "authentication, and other common but slightly specialised situations."
 msgstr ""
+"Outros tipos de manipuladores que você pode querer podem lidar com proxies, "
+"autenticação e outras situações comuns, mas um pouco especializadas."
 
 #: ../../howto/urllib2.rst:445
 msgid ""
 "``install_opener`` can be used to make an ``opener`` object the (global) "
 "default opener. This means that calls to ``urlopen`` will use the opener you "
 "have installed."
 msgstr ""
+"``install_opener`` pode ser usado para tornar um objeto ``opener`` o abridor "
+"padrão (global). Isso significa que chamadas para ``urlopen`` usarão o "
+"abridor que você instalou."
 
 #: ../../howto/urllib2.rst:449
 msgid ""
 "Opener objects have an ``open`` method, which can be called directly to "
 "fetch urls in the same way as the ``urlopen`` function: there's no need to "
 "call ``install_opener``, except as a convenience."
 msgstr ""
+"Objetos abridores têm um método ``open``, que pode ser chamado diretamente "
+"para buscar URLs da mesma forma que a função ``urlopen``: não há necessidade "
+"de chamar ``install_opener``, exceto por conveniência."
 
 #: ../../howto/urllib2.rst:455
 msgid "Basic Authentication"
@@ -595,7 +686,7 @@ msgstr "Notas de rodapé"
 
 #: ../../howto/urllib2.rst:588
 msgid "This document was reviewed and revised by John Lee."
-msgstr ""
+msgstr "Este documento foi revisado e revisado por John Lee."
 
 #: ../../howto/urllib2.rst:590
 msgid "Google for example."
 
@@ -60,7 +60,7 @@
 - programming.po                 383 / 388 ( 98.0% translated).
 
 
-# howto (53.96% done)
+# howto (55.27% done)
 
 - annotations.po                  44 /  45 ( 97.0% translated).
 - argparse.po                     81 /  84 ( 96.0% translated).
@@ -75,7 +75,7 @@
 - regex.po                       283 / 286 ( 98.0% translated).
 - sockets.po                      35 /  58 ( 60.0% translated).
 - unicode.po                      30 / 121 ( 24.0% translated).
-- urllib2.po                      24 /  85 ( 28.0% translated).
+- urllib2.po                      55 /  85 ( 64.0% translated).
 
 
 # install (74.34% done)
@@ -324,5 +324,5 @@
 - 3.7.po                         243 / 555 ( 43.0% translated).
 
 
-# TOTAL (64.66% done)
+# TOTAL (64.72% done)
 
@@ -1 +1 @@
-{"completion": "64.66%", "translated": 33401, "entries": 51659, "updated_at": "2025-05-15T00:34:06+00:00Z"}
+{"completion": "64.72%", "translated": 33432, "entries": 51659, "updated_at": "2025-05-16T00:35:41+00:00Z"}
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-{"completion": "64.66%", "translated": 33401, "entries": 51659, "updated_at": "2025-05-15T00:34:06+00:00Z"}`
	`1`	`+{"completion": "64.72%", "translated": 33432, "entries": 51659, "updated_at": "2025-05-16T00:35:41+00:00Z"}`