Skip to content

Commit a94f7eb

Browse files
github-actions[bot]github-actions[bot]
committed
Update translation
Co-Authored-By: python-doc bot
1 parent 383edee commit a94f7eb

1 file changed

Lines changed: 384 additions & 2 deletions

File tree

‎library/asyncore.po‎

Lines changed: 384 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,388 @@
1+
# SOME DESCRIPTIVE TITLE.
2+
# Copyright (C) 2001-2026, Python Software Foundation
3+
# This file is distributed under the same license as the Python package.
4+
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
15
#
6+
# Translators:
7+
# python-doc bot, 2026
8+
#
9+
#, fuzzy
210
msgid ""
311
msgstr ""
4-
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/teams/5390/pt_BR/)\n"
12+
"Project-Id-Version: Python 3.11\n"
13+
"Report-Msgid-Bugs-To: \n"
14+
"POT-Creation-Date: 2026-05-25 19:40+0000\n"
15+
"PO-Revision-Date: 2025-09-22 16:49+0000\n"
16+
"Last-Translator: python-doc bot, 2026\n"
17+
"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"
18+
"teams/5390/pt_BR/)\n"
519
"Language: pt_BR\n"
6-
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n"
20+
"MIME-Version: 1.0\n"
21+
"Content-Type: text/plain; charset=UTF-8\n"
22+
"Content-Transfer-Encoding: 8bit\n"
23+
"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "
24+
"1000000 == 0 ? 1 : 2;\n"
25+
26+
#: ../../library/asyncore.rst:2
27+
msgid ":mod:`asyncore` --- Asynchronous socket handler"
28+
msgstr ""
29+
30+
#: ../../library/asyncore.rst:14
31+
msgid "**Source code:** :source:`Lib/asyncore.py`"
32+
msgstr "**Código-fonte:** :source:`Lib/asyncore.py`"
33+
34+
#: ../../library/asyncore.rst:20
35+
msgid ""
36+
"The :mod:`asyncore` module is deprecated (see :pep:`PEP 594 <594#asyncore>` "
37+
"for details). Please use :mod:`asyncio` instead."
38+
msgstr ""
39+
40+
#: ../../library/asyncore.rst:25
41+
msgid ""
42+
"This module exists for backwards compatibility only. For new code we "
43+
"recommend using :mod:`asyncio`."
44+
msgstr ""
45+
46+
#: ../../library/asyncore.rst:28
47+
msgid ""
48+
"This module provides the basic infrastructure for writing asynchronous "
49+
"socket service clients and servers."
50+
msgstr ""
51+
52+
#: ../../includes/wasm-notavail.rst:3
53+
msgid ":ref:`Availability <availability>`: not Emscripten, not WASI."
54+
msgstr ":ref:`Disponibilidade <availability>`: não Emscripten, não WASI."
55+
56+
#: ../../includes/wasm-notavail.rst:5
57+
msgid ""
58+
"This module does not work or is not available on WebAssembly platforms "
59+
"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for "
60+
"more information."
61+
msgstr ""
62+
"Este módulo não funciona ou não está disponível em plataformas WebAssembly "
63+
"``wasm32-emscripten`` e ``wasm32-wasi``. Veja :ref:`wasm-availability` para "
64+
"mais informações."
65+
66+
#: ../../library/asyncore.rst:33
67+
msgid ""
68+
"There are only two ways to have a program on a single processor do \"more "
69+
"than one thing at a time.\" Multi-threaded programming is the simplest and "
70+
"most popular way to do it, but there is another very different technique, "
71+
"that lets you have nearly all the advantages of multi-threading, without "
72+
"actually using multiple threads. It's really only practical if your "
73+
"program is largely I/O bound. If your program is processor bound, then pre-"
74+
"emptive scheduled threads are probably what you really need. Network "
75+
"servers are rarely processor bound, however."
76+
msgstr ""
77+
78+
#: ../../library/asyncore.rst:42
79+
msgid ""
80+
"If your operating system supports the :c:func:`select` system call in its I/"
81+
"O library (and nearly all do), then you can use it to juggle multiple "
82+
"communication channels at once; doing other work while your I/O is taking "
83+
"place in the \"background.\" Although this strategy can seem strange and "
84+
"complex, especially at first, it is in many ways easier to understand and "
85+
"control than multi-threaded programming. The :mod:`asyncore` module solves "
86+
"many of the difficult problems for you, making the task of building "
87+
"sophisticated high-performance network servers and clients a snap. For "
88+
"\"conversational\" applications and protocols the companion :mod:`asynchat` "
89+
"module is invaluable."
90+
msgstr ""
91+
92+
#: ../../library/asyncore.rst:53
93+
msgid ""
94+
"The basic idea behind both modules is to create one or more network "
95+
"*channels*, instances of class :class:`asyncore.dispatcher` and :class:"
96+
"`asynchat.async_chat`. Creating the channels adds them to a global map, "
97+
"used by the :func:`loop` function if you do not provide it with your own "
98+
"*map*."
99+
msgstr ""
100+
101+
#: ../../library/asyncore.rst:59
102+
msgid ""
103+
"Once the initial channel(s) is(are) created, calling the :func:`loop` "
104+
"function activates channel service, which continues until the last channel "
105+
"(including any that have been added to the map during asynchronous service) "
106+
"is closed."
107+
msgstr ""
108+
109+
#: ../../library/asyncore.rst:66
110+
msgid ""
111+
"Enter a polling loop that terminates after count passes or all open channels "
112+
"have been closed. All arguments are optional. The *count* parameter "
113+
"defaults to ``None``, resulting in the loop terminating only when all "
114+
"channels have been closed. The *timeout* argument sets the timeout "
115+
"parameter for the appropriate :func:`~select.select` or :func:`~select.poll` "
116+
"call, measured in seconds; the default is 30 seconds. The *use_poll* "
117+
"parameter, if true, indicates that :func:`~select.poll` should be used in "
118+
"preference to :func:`~select.select` (the default is ``False``)."
119+
msgstr ""
120+
121+
#: ../../library/asyncore.rst:75
122+
msgid ""
123+
"The *map* parameter is a dictionary whose items are the channels to watch. "
124+
"As channels are closed they are deleted from their map. If *map* is "
125+
"omitted, a global map is used. Channels (instances of :class:`asyncore."
126+
"dispatcher`, :class:`asynchat.async_chat` and subclasses thereof) can freely "
127+
"be mixed in the map."
128+
msgstr ""
129+
130+
#: ../../library/asyncore.rst:84
131+
msgid ""
132+
"The :class:`dispatcher` class is a thin wrapper around a low-level socket "
133+
"object. To make it more useful, it has a few methods for event-handling "
134+
"which are called from the asynchronous loop. Otherwise, it can be treated "
135+
"as a normal non-blocking socket object."
136+
msgstr ""
137+
138+
#: ../../library/asyncore.rst:89
139+
msgid ""
140+
"The firing of low-level events at certain times or in certain connection "
141+
"states tells the asynchronous loop that certain higher-level events have "
142+
"taken place. For example, if we have asked for a socket to connect to "
143+
"another host, we know that the connection has been made when the socket "
144+
"becomes writable for the first time (at this point you know that you may "
145+
"write to it with the expectation of success). The implied higher-level "
146+
"events are:"
147+
msgstr ""
148+
149+
#: ../../library/asyncore.rst:98
150+
msgid "Event"
151+
msgstr "Evento"
152+
153+
#: ../../library/asyncore.rst:98
154+
msgid "Description"
155+
msgstr "Descrição"
156+
157+
#: ../../library/asyncore.rst:100
158+
msgid "``handle_connect()``"
159+
msgstr "``handle_connect()``"
160+
161+
#: ../../library/asyncore.rst:100
162+
msgid "Implied by the first read or write event"
163+
msgstr ""
164+
165+
#: ../../library/asyncore.rst:103
166+
msgid "``handle_close()``"
167+
msgstr "``handle_close()``"
168+
169+
#: ../../library/asyncore.rst:103
170+
msgid "Implied by a read event with no data available"
171+
msgstr ""
172+
173+
#: ../../library/asyncore.rst:106
174+
msgid "``handle_accepted()``"
175+
msgstr "``handle_accepted()``"
176+
177+
#: ../../library/asyncore.rst:106
178+
msgid "Implied by a read event on a listening socket"
179+
msgstr ""
180+
181+
#: ../../library/asyncore.rst:110
182+
msgid ""
183+
"During asynchronous processing, each mapped channel's :meth:`readable` and :"
184+
"meth:`writable` methods are used to determine whether the channel's socket "
185+
"should be added to the list of channels :c:func:`select`\\ ed or :c:func:"
186+
"`poll`\\ ed for read and write events."
187+
msgstr ""
188+
189+
#: ../../library/asyncore.rst:115
190+
msgid ""
191+
"Thus, the set of channel events is larger than the basic socket events. The "
192+
"full set of methods that can be overridden in your subclass follows:"
193+
msgstr ""
194+
195+
#: ../../library/asyncore.rst:121
196+
msgid ""
197+
"Called when the asynchronous loop detects that a :meth:`read` call on the "
198+
"channel's socket will succeed."
199+
msgstr ""
200+
201+
#: ../../library/asyncore.rst:127
202+
msgid ""
203+
"Called when the asynchronous loop detects that a writable socket can be "
204+
"written. Often this method will implement the necessary buffering for "
205+
"performance. For example::"
206+
msgstr ""
207+
208+
#: ../../library/asyncore.rst:138
209+
msgid ""
210+
"Called when there is out of band (OOB) data for a socket connection. This "
211+
"will almost never happen, as OOB is tenuously supported and rarely used."
212+
msgstr ""
213+
"Chamado quando há dados fora da banda (00B) para uma conexão socket. Isso "
214+
"quase nunca acontece, como a 00B é suportada com tenacidade e raramente "
215+
"usada."
216+
217+
#: ../../library/asyncore.rst:144
218+
msgid ""
219+
"Called when the active opener's socket actually makes a connection. Might "
220+
"send a \"welcome\" banner, or initiate a protocol negotiation with the "
221+
"remote endpoint, for example."
222+
msgstr ""
223+
224+
#: ../../library/asyncore.rst:151
225+
msgid "Called when the socket is closed."
226+
msgstr ""
227+
228+
#: ../../library/asyncore.rst:156
229+
msgid ""
230+
"Called when an exception is raised and not otherwise handled. The default "
231+
"version prints a condensed traceback."
232+
msgstr ""
233+
234+
#: ../../library/asyncore.rst:162
235+
msgid ""
236+
"Called on listening channels (passive openers) when a connection can be "
237+
"established with a new remote endpoint that has issued a :meth:`connect` "
238+
"call for the local endpoint. Deprecated in version 3.2; use :meth:"
239+
"`handle_accepted` instead."
240+
msgstr ""
241+
242+
#: ../../library/asyncore.rst:172
243+
msgid ""
244+
"Called on listening channels (passive openers) when a connection has been "
245+
"established with a new remote endpoint that has issued a :meth:`connect` "
246+
"call for the local endpoint. *sock* is a *new* socket object usable to send "
247+
"and receive data on the connection, and *addr* is the address bound to the "
248+
"socket on the other end of the connection."
249+
msgstr ""
250+
251+
#: ../../library/asyncore.rst:183
252+
msgid ""
253+
"Called each time around the asynchronous loop to determine whether a "
254+
"channel's socket should be added to the list on which read events can "
255+
"occur. The default method simply returns ``True``, indicating that by "
256+
"default, all channels will be interested in read events."
257+
msgstr ""
258+
259+
#: ../../library/asyncore.rst:191
260+
msgid ""
261+
"Called each time around the asynchronous loop to determine whether a "
262+
"channel's socket should be added to the list on which write events can "
263+
"occur. The default method simply returns ``True``, indicating that by "
264+
"default, all channels will be interested in write events."
265+
msgstr ""
266+
267+
#: ../../library/asyncore.rst:197
268+
msgid ""
269+
"In addition, each channel delegates or extends many of the socket methods. "
270+
"Most of these are nearly identical to their socket partners."
271+
msgstr ""
272+
273+
#: ../../library/asyncore.rst:203
274+
msgid ""
275+
"This is identical to the creation of a normal socket, and will use the same "
276+
"options for creation. Refer to the :mod:`socket` documentation for "
277+
"information on creating sockets."
278+
msgstr ""
279+
280+
#: ../../library/asyncore.rst:207
281+
msgid "*family* and *type* arguments can be omitted."
282+
msgstr ""
283+
284+
#: ../../library/asyncore.rst:213
285+
msgid ""
286+
"As with the normal socket object, *address* is a tuple with the first "
287+
"element the host to connect to, and the second the port number."
288+
msgstr ""
289+
290+
#: ../../library/asyncore.rst:219
291+
msgid "Send *data* to the remote end-point of the socket."
292+
msgstr ""
293+
294+
#: ../../library/asyncore.rst:224
295+
msgid ""
296+
"Read at most *buffer_size* bytes from the socket's remote end-point. An "
297+
"empty bytes object implies that the channel has been closed from the other "
298+
"end."
299+
msgstr ""
300+
301+
#: ../../library/asyncore.rst:228
302+
msgid ""
303+
"Note that :meth:`recv` may raise :exc:`BlockingIOError` , even though :func:"
304+
"`select.select` or :func:`select.poll` has reported the socket ready for "
305+
"reading."
306+
msgstr ""
307+
308+
#: ../../library/asyncore.rst:235
309+
msgid ""
310+
"Listen for connections made to the socket. The *backlog* argument specifies "
311+
"the maximum number of queued connections and should be at least 1; the "
312+
"maximum value is system-dependent (usually 5)."
313+
msgstr ""
314+
315+
#: ../../library/asyncore.rst:242
316+
msgid ""
317+
"Bind the socket to *address*. The socket must not already be bound. (The "
318+
"format of *address* depends on the address family --- refer to the :mod:"
319+
"`socket` documentation for more information.) To mark the socket as re-"
320+
"usable (setting the :const:`SO_REUSEADDR` option), call the :class:"
321+
"`dispatcher` object's :meth:`set_reuse_addr` method."
322+
msgstr ""
323+
324+
#: ../../library/asyncore.rst:251
325+
msgid ""
326+
"Accept a connection. The socket must be bound to an address and listening "
327+
"for connections. The return value can be either ``None`` or a pair ``(conn, "
328+
"address)`` where *conn* is a *new* socket object usable to send and receive "
329+
"data on the connection, and *address* is the address bound to the socket on "
330+
"the other end of the connection. When ``None`` is returned it means the "
331+
"connection didn't take place, in which case the server should just ignore "
332+
"this event and keep listening for further incoming connections."
333+
msgstr ""
334+
335+
#: ../../library/asyncore.rst:263
336+
msgid ""
337+
"Close the socket. All future operations on the socket object will fail. The "
338+
"remote end-point will receive no more data (after queued data is flushed). "
339+
"Sockets are automatically closed when they are garbage-collected."
340+
msgstr ""
341+
342+
#: ../../library/asyncore.rst:271
343+
msgid ""
344+
"A :class:`dispatcher` subclass which adds simple buffered output capability, "
345+
"useful for simple clients. For more sophisticated usage use :class:`asynchat."
346+
"async_chat`."
347+
msgstr ""
348+
349+
#: ../../library/asyncore.rst:277
350+
msgid ""
351+
"A file_dispatcher takes a file descriptor or :term:`file object` along with "
352+
"an optional map argument and wraps it for use with the :c:func:`poll` or :c:"
353+
"func:`loop` functions. If provided a file object or anything with a :c:func:"
354+
"`fileno` method, that method will be called and passed to the :class:"
355+
"`file_wrapper` constructor."
356+
msgstr ""
357+
358+
#: ../../library/asyncore.rst:283 ../../library/asyncore.rst:292
359+
msgid ":ref:`Availability <availability>`: Unix."
360+
msgstr ":ref:`Disponibilidade <availability>`: Unix."
361+
362+
#: ../../library/asyncore.rst:287
363+
msgid ""
364+
"A file_wrapper takes an integer file descriptor and calls :func:`os.dup` to "
365+
"duplicate the handle so that the original handle may be closed independently "
366+
"of the file_wrapper. This class implements sufficient methods to emulate a "
367+
"socket for use by the :class:`file_dispatcher` class."
368+
msgstr ""
369+
370+
#: ../../library/asyncore.rst:298
371+
msgid "asyncore Example basic HTTP client"
372+
msgstr ""
373+
374+
#: ../../library/asyncore.rst:300
375+
msgid ""
376+
"Here is a very basic HTTP client that uses the :class:`dispatcher` class to "
377+
"implement its socket handling::"
378+
msgstr ""
379+
380+
#: ../../library/asyncore.rst:337
381+
msgid "asyncore Example basic echo server"
382+
msgstr ""
383+
384+
#: ../../library/asyncore.rst:339
385+
msgid ""
386+
"Here is a basic echo server that uses the :class:`dispatcher` class to "
387+
"accept connections and dispatches the incoming connections to a handler::"
388+
msgstr ""

0 commit comments

Comments
 (0)