iframe-proxy | Sunbelt Computer Software

237 lines (204 loc) · 8.27 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2025
"Project-Id-Version: Python 3.9\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-22 21:56+0000\n"
"PO-Revision-Date: 2025-09-22 17:54+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Russian (https://app.transifex.com/python-doc/teams/5390/ru/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: ru\n"
"Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n"
#: ../../library/asynchat.rst:2
msgid ":mod:`asynchat` --- Asynchronous socket command/response handler"
#: ../../library/asynchat.rst:11
msgid "**Source code:** :source:`Lib/asynchat.py`"
#: ../../library/asynchat.rst:13
":mod:`asynchat` will be removed in Python 3.12 (see :pep:`PEP 594 "
"<594#asynchat>` for details). Please use :mod:`asyncio` instead."
#: ../../library/asynchat.rst:22
"This module exists for backwards compatibility only.  For new code we "
"recommend using :mod:`asyncio`."
#: ../../library/asynchat.rst:25
"This module builds on the :mod:`asyncore` infrastructure, simplifying "
"asynchronous clients and servers and making it easier to handle protocols "
"whose elements are terminated by arbitrary strings, or are of variable "
"length. :mod:`asynchat` defines the abstract class :class:`async_chat` that "
"you subclass, providing implementations of the :meth:`collect_incoming_data`"
" and :meth:`found_terminator` methods. It uses the same asynchronous loop as"
" :mod:`asyncore`, and the two types of channel, :class:`asyncore.dispatcher`"
" and :class:`asynchat.async_chat`, can freely be mixed in the channel map. "
"Typically an :class:`asyncore.dispatcher` server channel generates new "
":class:`asynchat.async_chat` channel objects as it receives incoming "
"connection requests."
#: ../../library/asynchat.rst:40
"This class is an abstract subclass of :class:`asyncore.dispatcher`. To make "
"practical use of the code you must subclass :class:`async_chat`, providing "
"meaningful :meth:`collect_incoming_data` and :meth:`found_terminator` "
"methods. The :class:`asyncore.dispatcher` methods can be used, although not "
"all make sense in a message/response context."
#: ../../library/asynchat.rst:47
"Like :class:`asyncore.dispatcher`, :class:`async_chat` defines a set of "
"events that are generated by an analysis of socket conditions after a "
":c:func:`select` call. Once the polling loop has been started the "
":class:`async_chat` object's methods are called by the event-processing "
"framework with no action on the part of the programmer."
#: ../../library/asynchat.rst:53
"Two class attributes can be modified, to improve performance, or possibly "
"even to conserve memory."
#: ../../library/asynchat.rst:59
msgid "The asynchronous input buffer size (default ``4096``)."
#: ../../library/asynchat.rst:64
msgid "The asynchronous output buffer size (default ``4096``)."
#: ../../library/asynchat.rst:66
"Unlike :class:`asyncore.dispatcher`, :class:`async_chat` allows you to "
"define a :abbr:`FIFO (first-in, first-out)` queue of *producers*. A producer"
" need have only one method, :meth:`more`, which should return data to be "
"transmitted on the channel. The producer indicates exhaustion (*i.e.* that "
"it contains no more data) by having its :meth:`more` method return the empty"
" bytes object. At this point the :class:`async_chat` object removes the "
"producer from the queue and starts using the next producer, if any. When the"
" producer queue is empty the :meth:`handle_write` method does nothing. You "
"use the channel object's :meth:`set_terminator` method to describe how to "
"recognize the end of, or an important breakpoint in, an incoming "
"transmission from the remote endpoint."
#: ../../library/asynchat.rst:79
"To build a functioning :class:`async_chat` subclass your  input methods "
":meth:`collect_incoming_data` and :meth:`found_terminator` must handle the "
"data that the channel receives asynchronously. The methods are described "
#: ../../library/asynchat.rst:87
"Pushes a ``None`` on to the producer queue. When this producer is popped off"
" the queue it causes the channel to be closed."
#: ../../library/asynchat.rst:93
"Called with *data* holding an arbitrary amount of received data.  The "
"default method, which must be overridden, raises a "
":exc:`NotImplementedError` exception."
#: ../../library/asynchat.rst:100
"In emergencies this method will discard any data held in the input and/or "
"output buffers and the producer queue."
#: ../../library/asynchat.rst:106
"Called when the incoming data stream  matches the termination condition set "
"by :meth:`set_terminator`. The default method, which must be overridden, "
"raises a :exc:`NotImplementedError` exception. The buffered input data "
"should be available via an instance attribute."
#: ../../library/asynchat.rst:114
msgid "Returns the current terminator for the channel."
#: ../../library/asynchat.rst:119
"Pushes data on to the channel's queue to ensure its transmission. This is "
"all you need to do to have the channel write the data out to the network, "
"although it is possible to use your own producers in more complex schemes to"
" implement encryption and chunking, for example."
#: ../../library/asynchat.rst:127
"Takes a producer object and adds it to the producer queue associated with "
"the channel.  When all currently-pushed producers have been exhausted the "
"channel will consume this producer's data by calling its :meth:`more` method"
" and send the data to the remote endpoint."
#: ../../library/asynchat.rst:135
"Sets the terminating condition to be recognized on the channel.  ``term`` "
"may be any of three types of value, corresponding to three different ways to"
" handle incoming protocol data."
#: ../../library/asynchat.rst:140
msgid "term"
#: ../../library/asynchat.rst:140
msgid "Description"
#: ../../library/asynchat.rst:142
msgid "*string*"
#: ../../library/asynchat.rst:142
"Will call :meth:`found_terminator` when the string is found in the input "
#: ../../library/asynchat.rst:145
msgid "*integer*"
#: ../../library/asynchat.rst:145
"Will call :meth:`found_terminator` when the indicated number of characters "
"have been received"
#: ../../library/asynchat.rst:149
msgid "``None``"
#: ../../library/asynchat.rst:149
msgid "The channel continues to collect data forever"
#: ../../library/asynchat.rst:153
"Note that any data following the terminator will be available for reading by"
" the channel after :meth:`found_terminator` is called."
#: ../../library/asynchat.rst:160
msgid "asynchat Example"
#: ../../library/asynchat.rst:162
"The following partial example shows how HTTP requests can be read with "
":class:`async_chat`.  A web server might create an "
":class:`http_request_handler` object for each incoming client connection. "
"Notice that initially the channel terminator is set to match the blank line "
"at the end of the HTTP headers, and a flag indicates that the headers are "
"being read."
#: ../../library/asynchat.rst:169
"Once the headers have been read, if the request is of type POST (indicating "
"that further data are present in the input stream) then the ``Content-"
"Length:`` header is used to set a numeric terminator to read the right "
"amount of data from the channel."
#: ../../library/asynchat.rst:174
"The :meth:`handle_request` method is called once all relevant input has been"
" marshalled, after setting the channel terminator to ``None`` to ensure that"
" any extraneous data sent by the web client are ignored. ::"
Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Uh oh!

Sunbelt Computer Software

PL/B Language Development and Support

Uh oh!

FilesExpand file tree

asynchat.po

Latest commit

History

asynchat.po

File metadata and controls
