|
1 | | -# SOME DESCRIPTIVE TITLE. |
2 | | -# Copyright (C) 2001-2025, Python Software Foundation |
3 | | -# This file is distributed under the same license as the Python package. |
4 | | -# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. |
5 | 1 | # |
6 | | -# Translators: |
7 | | -# python-doc bot, 2025 |
8 | | -# |
9 | | -#, fuzzy |
10 | 2 | msgid "" |
11 | 3 | msgstr "" |
12 | | -"Project-Id-Version: Python 3.11\n" |
13 | | -"Report-Msgid-Bugs-To: \n" |
14 | | -"POT-Creation-Date: 2025-09-22 20:37+0000\n" |
15 | | -"PO-Revision-Date: 2025-09-22 16:49+0000\n" |
16 | | -"Last-Translator: python-doc bot, 2025\n" |
17 | | -"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/" |
18 | | -"teams/5390/pt_BR/)\n" |
| 4 | +"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/teams/5390/pt_BR/)\n" |
19 | 5 | "Language: pt_BR\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 "" |
| 6 | +"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % 1000000 == 0 ? 1 : 2;\n" |
0 commit comments