# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-10-01 16:00+0200\n" "PO-Revision-Date: 2019-09-06 13:48+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: library/asyncio-stream.rst:7 msgid "Streams" msgstr "Streams" #: library/asyncio-stream.rst:9 #, fuzzy msgid "**Source code:** :source:`Lib/asyncio/streams.py`" msgstr "**Code source :** :source:`Lib/asyncore.py`" #: library/asyncio-stream.rst:13 msgid "" "Streams are high-level async/await-ready primitives to work with network " "connections. Streams allow sending and receiving data without using " "callbacks or low-level protocols and transports." msgstr "" #: library/asyncio-stream.rst:19 msgid "Here is an example of a TCP echo client written using asyncio streams::" msgstr "" #: library/asyncio-stream.rst:42 msgid "See also the `Examples`_ section below." msgstr "" #: library/asyncio-stream.rst:46 msgid "Stream Functions" msgstr "" #: library/asyncio-stream.rst:47 msgid "" "The following top-level asyncio functions can be used to create and work " "with streams:" msgstr "" #: library/asyncio-stream.rst:56 msgid "" "Establish a network connection and return a pair of ``(reader, writer)`` " "objects." msgstr "" #: library/asyncio-stream.rst:59 msgid "" "The returned *reader* and *writer* objects are instances of :class:" "`StreamReader` and :class:`StreamWriter` classes." msgstr "" #: library/asyncio-stream.rst:62 msgid "" "The *loop* argument is optional and can always be determined automatically " "when this function is awaited from a coroutine." msgstr "" #: library/asyncio-stream.rst:98 msgid "" "*limit* determines the buffer size limit used by the returned :class:" "`StreamReader` instance. By default the *limit* is set to 64 KiB." msgstr "" #: library/asyncio-stream.rst:69 msgid "" "The rest of the arguments are passed directly to :meth:`loop." "create_connection`." msgstr "" #: library/asyncio-stream.rst:127 msgid "The *ssl_handshake_timeout* parameter." msgstr "" #: library/asyncio-stream.rst:84 msgid "Start a socket server." msgstr "" #: library/asyncio-stream.rst:86 msgid "" "The *client_connected_cb* callback is called whenever a new client " "connection is established. It receives a ``(reader, writer)`` pair as two " "arguments, instances of the :class:`StreamReader` and :class:`StreamWriter` " "classes." msgstr "" #: library/asyncio-stream.rst:91 msgid "" "*client_connected_cb* can be a plain callable or a :ref:`coroutine function " "`; if it is a coroutine function, it will be automatically " "scheduled as a :class:`Task`." msgstr "" #: library/asyncio-stream.rst:95 msgid "" "The *loop* argument is optional and can always be determined automatically " "when this method is awaited from a coroutine." msgstr "" #: library/asyncio-stream.rst:102 msgid "" "The rest of the arguments are passed directly to :meth:`loop.create_server`." msgstr "" #: library/asyncio-stream.rst:149 msgid "The *ssl_handshake_timeout* and *start_serving* parameters." msgstr "" #: library/asyncio-stream.rst:111 msgid "Unix Sockets" msgstr "" #: library/asyncio-stream.rst:116 msgid "" "Establish a Unix socket connection and return a pair of ``(reader, writer)``." msgstr "" #: library/asyncio-stream.rst:119 msgid "Similar to :func:`open_connection` but operates on Unix sockets." msgstr "" #: library/asyncio-stream.rst:121 msgid "See also the documentation of :meth:`loop.create_unix_connection`." msgstr "" #: library/asyncio-stream.rst:146 msgid ":ref:`Availability `: Unix." msgstr ":ref:`Disponibilité ` : Unix." #: library/asyncio-stream.rst:131 msgid "The *path* parameter can now be a :term:`path-like object`" msgstr "" #: library/asyncio-stream.rst:139 msgid "Start a Unix socket server." msgstr "" #: library/asyncio-stream.rst:141 msgid "Similar to :func:`start_server` but works with Unix sockets." msgstr "" #: library/asyncio-stream.rst:143 msgid "See also the documentation of :meth:`loop.create_unix_server`." msgstr "" #: library/asyncio-stream.rst:153 msgid "The *path* parameter can now be a :term:`path-like object`." msgstr "" #: library/asyncio-stream.rst:157 msgid "StreamReader" msgstr "StreamReader" #: library/asyncio-stream.rst:161 msgid "" "Represents a reader object that provides APIs to read data from the IO " "stream." msgstr "" #: library/asyncio-stream.rst:164 msgid "" "It is not recommended to instantiate *StreamReader* objects directly; use :" "func:`open_connection` and :func:`start_server` instead." msgstr "" #: library/asyncio-stream.rst:170 msgid "" "Read up to *n* bytes. If *n* is not provided, or set to ``-1``, read until " "EOF and return all read bytes." msgstr "" #: library/asyncio-stream.rst:173 msgid "" "If EOF was received and the internal buffer is empty, return an empty " "``bytes`` object." msgstr "" #: library/asyncio-stream.rst:178 msgid "" "Read one line, where \"line\" is a sequence of bytes ending with ``\\n``." msgstr "" #: library/asyncio-stream.rst:181 msgid "" "If EOF is received and ``\\n`` was not found, the method returns partially " "read data." msgstr "" #: library/asyncio-stream.rst:184 msgid "" "If EOF is received and the internal buffer is empty, return an empty " "``bytes`` object." msgstr "" #: library/asyncio-stream.rst:189 msgid "Read exactly *n* bytes." msgstr "" #: library/asyncio-stream.rst:191 msgid "" "Raise an :exc:`IncompleteReadError` if EOF is reached before *n* can be " "read. Use the :attr:`IncompleteReadError.partial` attribute to get the " "partially read data." msgstr "" #: library/asyncio-stream.rst:197 msgid "Read data from the stream until *separator* is found." msgstr "" #: library/asyncio-stream.rst:199 msgid "" "On success, the data and separator will be removed from the internal buffer " "(consumed). Returned data will include the separator at the end." msgstr "" #: library/asyncio-stream.rst:203 msgid "" "If the amount of data read exceeds the configured stream limit, a :exc:" "`LimitOverrunError` exception is raised, and the data is left in the " "internal buffer and can be read again." msgstr "" #: library/asyncio-stream.rst:207 msgid "" "If EOF is reached before the complete separator is found, an :exc:" "`IncompleteReadError` exception is raised, and the internal buffer is " "reset. The :attr:`IncompleteReadError.partial` attribute may contain a " "portion of the separator." msgstr "" #: library/asyncio-stream.rst:216 msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called." msgstr "" #: library/asyncio-stream.rst:221 msgid "StreamWriter" msgstr "StreamWriter" #: library/asyncio-stream.rst:225 msgid "" "Represents a writer object that provides APIs to write data to the IO stream." msgstr "" #: library/asyncio-stream.rst:228 msgid "" "It is not recommended to instantiate *StreamWriter* objects directly; use :" "func:`open_connection` and :func:`start_server` instead." msgstr "" #: library/asyncio-stream.rst:234 msgid "" "The method attempts to write the *data* to the underlying socket " "immediately. If that fails, the data is queued in an internal write buffer " "until it can be sent." msgstr "" #: library/asyncio-stream.rst:250 msgid "The method should be used along with the ``drain()`` method::" msgstr "" #: library/asyncio-stream.rst:245 msgid "" "The method writes a list (or any iterable) of bytes to the underlying socket " "immediately. If that fails, the data is queued in an internal write buffer " "until it can be sent." msgstr "" #: library/asyncio-stream.rst:257 msgid "The method closes the stream and the underlying socket." msgstr "" #: library/asyncio-stream.rst:259 msgid "The method should be used along with the ``wait_closed()`` method::" msgstr "" #: library/asyncio-stream.rst:266 msgid "" "Return ``True`` if the underlying transport supports the :meth:`write_eof` " "method, ``False`` otherwise." msgstr "" #: library/asyncio-stream.rst:271 msgid "" "Close the write end of the stream after the buffered write data is flushed." msgstr "" #: library/asyncio-stream.rst:276 msgid "Return the underlying asyncio transport." msgstr "" #: library/asyncio-stream.rst:280 msgid "" "Access optional transport information; see :meth:`BaseTransport." "get_extra_info` for details." msgstr "" #: library/asyncio-stream.rst:285 msgid "Wait until it is appropriate to resume writing to the stream. Example::" msgstr "" #: library/asyncio-stream.rst:291 msgid "" "This is a flow control method that interacts with the underlying IO write " "buffer. When the size of the buffer reaches the high watermark, *drain()* " "blocks until the size of the buffer is drained down to the low watermark and " "writing can be resumed. When there is nothing to wait for, the :meth:" "`drain` returns immediately." msgstr "" #: library/asyncio-stream.rst:300 msgid "" "Return ``True`` if the stream is closed or in the process of being closed." msgstr "" #: library/asyncio-stream.rst:307 msgid "Wait until the stream is closed." msgstr "" #: library/asyncio-stream.rst:309 msgid "" "Should be called after :meth:`close` to wait until the underlying connection " "is closed." msgstr "" #: library/asyncio-stream.rst:316 msgid "Examples" msgstr "Exemples" #: library/asyncio-stream.rst:321 msgid "TCP echo client using streams" msgstr "" #: library/asyncio-stream.rst:323 msgid "TCP echo client using the :func:`asyncio.open_connection` function::" msgstr "" #: library/asyncio-stream.rst:345 msgid "" "The :ref:`TCP echo client protocol " "` example uses the low-level :meth:" "`loop.create_connection` method." msgstr "" #: library/asyncio-stream.rst:352 msgid "TCP echo server using streams" msgstr "" #: library/asyncio-stream.rst:354 msgid "TCP echo server using the :func:`asyncio.start_server` function::" msgstr "" #: library/asyncio-stream.rst:387 msgid "" "The :ref:`TCP echo server protocol " "` example uses the :meth:`loop." "create_server` method." msgstr "" #: library/asyncio-stream.rst:392 msgid "Get HTTP headers" msgstr "Récupère les en-têtes HTTP" #: library/asyncio-stream.rst:394 msgid "" "Simple example querying HTTP headers of the URL passed on the command line::" msgstr "" #: library/asyncio-stream.rst:432 msgid "Usage::" msgstr "Utilisation ::" #: library/asyncio-stream.rst:436 msgid "or with HTTPS::" msgstr "ou avec HTTPS ::" #: library/asyncio-stream.rst:444 msgid "Register an open socket to wait for data using streams" msgstr "" #: library/asyncio-stream.rst:446 msgid "" "Coroutine waiting until a socket receives data using the :func:" "`open_connection` function::" msgstr "" #: library/asyncio-stream.rst:480 msgid "" "The :ref:`register an open socket to wait for data using a protocol " "` example uses a low-level protocol and " "the :meth:`loop.create_connection` method." msgstr "" #: library/asyncio-stream.rst:484 msgid "" "The :ref:`watch a file descriptor for read events " "` example uses the low-level :meth:`loop." "add_reader` method to watch a file descriptor." msgstr ""