# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2018-09-15 21:52+0200\n" "PO-Revision-Date: 2018-07-27 23:20+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" #: ../Doc/library/asyncio-stream.rst:7 msgid "Streams (coroutine based API)" msgstr "" #: ../Doc/library/asyncio-stream.rst:9 msgid "**Source code:** :source:`Lib/asyncio/streams.py`" msgstr "" #: ../Doc/library/asyncio-stream.rst:12 msgid "Stream functions" msgstr "" #: ../Doc/library/asyncio-stream.rst:16 msgid "" "The top-level functions in this module are meant as convenience wrappers " "only; there's really nothing special there, and if they don't do exactly " "what you want, feel free to copy their code." msgstr "" #: ../Doc/library/asyncio-stream.rst:23 msgid "" "A wrapper for :meth:`~AbstractEventLoop.create_connection()` returning a " "(reader, writer) pair." msgstr "" #: ../Doc/library/asyncio-stream.rst:26 msgid "" "The reader returned is a :class:`StreamReader` instance; the writer is a :" "class:`StreamWriter` instance." msgstr "" #: ../Doc/library/asyncio-stream.rst:29 ../Doc/library/asyncio-stream.rst:74 msgid "" "When specified, the *loop* argument determines which event loop to use, and " "the *limit* argument determines the buffer size limit used by the returned :" "class:`StreamReader` instance." msgstr "" #: ../Doc/library/asyncio-stream.rst:33 msgid "" "The rest of the arguments are passed directly to :meth:`AbstractEventLoop." "create_connection`." msgstr "" #: ../Doc/library/asyncio-stream.rst:36 ../Doc/library/asyncio-stream.rst:63 #: ../Doc/library/asyncio-stream.rst:81 ../Doc/library/asyncio-stream.rst:113 msgid "This function is a :ref:`coroutine `." msgstr "Cette fonction est une :ref:`coroutine `." #: ../Doc/library/asyncio-stream.rst:40 ../Doc/library/asyncio-stream.rst:87 msgid "The *ssl_handshake_timeout* parameter." msgstr "" #: ../Doc/library/asyncio-stream.rst:44 msgid "" "Start a socket server, with a callback for each client connected. The return " "value is the same as :meth:`~AbstractEventLoop.create_server()`." msgstr "" #: ../Doc/library/asyncio-stream.rst:47 ../Doc/library/asyncio-stream.rst:97 msgid "" "The *client_connected_cb* callback is called whenever a new client " "connection is established. It receives a reader/writer pair as two " "arguments, the first is a :class:`StreamReader` instance, and the second is " "a :class:`StreamWriter` instance." msgstr "" #: ../Doc/library/asyncio-stream.rst:52 ../Doc/library/asyncio-stream.rst:102 msgid "" "*client_connected_cb* accepts a plain callable or a :ref:`coroutine function " "`; if it is a coroutine function, it will be automatically " "converted into a :class:`Task`." msgstr "" #: ../Doc/library/asyncio-stream.rst:56 ../Doc/library/asyncio-stream.rst:106 msgid "" "When specified, the *loop* argument determines which event loop to use, and " "the *limit* argument determines the buffer size limit used by the :class:" "`StreamReader` instance passed to *client_connected_cb*." msgstr "" #: ../Doc/library/asyncio-stream.rst:60 msgid "" "The rest of the arguments are passed directly to :meth:`~AbstractEventLoop." "create_server()`." msgstr "" #: ../Doc/library/asyncio-stream.rst:67 ../Doc/library/asyncio-stream.rst:119 msgid "The *ssl_handshake_timeout* and *start_serving* parameters." msgstr "" #: ../Doc/library/asyncio-stream.rst:71 msgid "" "A wrapper for :meth:`~AbstractEventLoop.create_unix_connection()` returning " "a (reader, writer) pair." msgstr "" #: ../Doc/library/asyncio-stream.rst:78 msgid "" "The rest of the arguments are passed directly to :meth:`~AbstractEventLoop." "create_unix_connection()`." msgstr "" #: ../Doc/library/asyncio-stream.rst:83 ../Doc/library/asyncio-stream.rst:115 msgid "Availability: UNIX." msgstr "Disponible sur : UNIX." #: ../Doc/library/asyncio-stream.rst:91 msgid "The *path* parameter can now be a :term:`path-like object`" msgstr "" #: ../Doc/library/asyncio-stream.rst:95 msgid "" "Start a UNIX Domain Socket server, with a callback for each client connected." msgstr "" #: ../Doc/library/asyncio-stream.rst:110 msgid "" "The rest of the arguments are passed directly to :meth:`~AbstractEventLoop." "create_unix_server()`." msgstr "" #: ../Doc/library/asyncio-stream.rst:123 msgid "The *path* parameter can now be a :term:`path-like object`." msgstr "" #: ../Doc/library/asyncio-stream.rst:127 msgid "StreamReader" msgstr "StreamReader" #: ../Doc/library/asyncio-stream.rst:131 ../Doc/library/asyncio-stream.rst:229 msgid "This class is :ref:`not thread safe `." msgstr "" #: ../Doc/library/asyncio-stream.rst:133 msgid "" "The *limit* argument's default value is set to _DEFAULT_LIMIT which is 2**16 " "(64 KiB)" msgstr "" #: ../Doc/library/asyncio-stream.rst:137 msgid "Get the exception." msgstr "Récupère l'exception." #: ../Doc/library/asyncio-stream.rst:141 msgid "Acknowledge the EOF." msgstr "" #: ../Doc/library/asyncio-stream.rst:145 msgid "" "Feed *data* bytes in the internal buffer. Any operations waiting for the " "data will be resumed." msgstr "" #: ../Doc/library/asyncio-stream.rst:150 msgid "Set the exception." msgstr "" #: ../Doc/library/asyncio-stream.rst:154 msgid "Set the transport." msgstr "" #: ../Doc/library/asyncio-stream.rst:158 msgid "" "Read up to *n* bytes. If *n* is not provided, or set to ``-1``, read until " "EOF and return all read bytes." msgstr "" #: ../Doc/library/asyncio-stream.rst:161 ../Doc/library/asyncio-stream.rst:173 msgid "" "If the EOF was received and the internal buffer is empty, return an empty " "``bytes`` object." msgstr "" #: ../Doc/library/asyncio-stream.rst:164 ../Doc/library/asyncio-stream.rst:176 #: ../Doc/library/asyncio-stream.rst:185 ../Doc/library/asyncio-stream.rst:278 msgid "This method is a :ref:`coroutine `." msgstr "Cette méthode est une :ref:`coroutine `." #: ../Doc/library/asyncio-stream.rst:168 msgid "" "Read one line, where \"line\" is a sequence of bytes ending with ``\\n``." msgstr "" #: ../Doc/library/asyncio-stream.rst:170 msgid "" "If EOF is received, and ``\\n`` was not found, the method will return the " "partial read bytes." msgstr "" #: ../Doc/library/asyncio-stream.rst:180 msgid "" "Read exactly *n* bytes. Raise an :exc:`IncompleteReadError` if the end of " "the stream is reached before *n* can be read, the :attr:`IncompleteReadError." "partial` attribute of the exception contains the partial read bytes." msgstr "" #: ../Doc/library/asyncio-stream.rst:189 msgid "Read data from the stream until ``separator`` is found." msgstr "" #: ../Doc/library/asyncio-stream.rst:191 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 "" #: ../Doc/library/asyncio-stream.rst:195 msgid "" "Configured stream limit is used to check result. Limit sets the maximal " "length of data that can be returned, not counting the separator." msgstr "" #: ../Doc/library/asyncio-stream.rst:199 msgid "" "If an EOF occurs and the complete separator is still not found, an :exc:" "`IncompleteReadError` exception will be raised, and the internal buffer will " "be reset. The :attr:`IncompleteReadError.partial` attribute may contain the " "separator partially." msgstr "" #: ../Doc/library/asyncio-stream.rst:205 msgid "" "If the data cannot be read because of over limit, a :exc:`LimitOverrunError` " "exception will be raised, and the data will be left in the internal buffer, " "so it can be read again." msgstr "" #: ../Doc/library/asyncio-stream.rst:213 msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called." msgstr "" #: ../Doc/library/asyncio-stream.rst:217 msgid "StreamWriter" msgstr "StreamWriter" #: ../Doc/library/asyncio-stream.rst:221 msgid "Wraps a Transport." msgstr "" #: ../Doc/library/asyncio-stream.rst:223 msgid "" "This exposes :meth:`write`, :meth:`writelines`, :meth:`can_write_eof()`, :" "meth:`write_eof`, :meth:`get_extra_info` and :meth:`close`. It adds :meth:" "`drain` which returns an optional :class:`Future` on which you can wait for " "flow control. It also adds a transport attribute which references the :" "class:`Transport` directly." msgstr "" #: ../Doc/library/asyncio-stream.rst:233 msgid "Transport." msgstr "Transport." #: ../Doc/library/asyncio-stream.rst:237 msgid "" "Return :const:`True` if the transport supports :meth:`write_eof`, :const:" "`False` if not. See :meth:`WriteTransport.can_write_eof`." msgstr "" #: ../Doc/library/asyncio-stream.rst:242 msgid "Close the transport: see :meth:`BaseTransport.close`." msgstr "" #: ../Doc/library/asyncio-stream.rst:246 msgid "Return ``True`` if the writer is closing or is closed." msgstr "" #: ../Doc/library/asyncio-stream.rst:252 msgid "Wait until the writer is closed." msgstr "" #: ../Doc/library/asyncio-stream.rst:254 msgid "" "Should be called after :meth:`close` to wait until the underlying " "connection (and the associated transport/protocol pair) is closed." msgstr "" #: ../Doc/library/asyncio-stream.rst:261 msgid "" "Let the write buffer of the underlying transport a chance to be flushed." msgstr "" #: ../Doc/library/asyncio-stream.rst:263 msgid "The intended use is to write::" msgstr "" #: ../Doc/library/asyncio-stream.rst:268 msgid "" "When the size of the transport buffer reaches the high-water limit (the " "protocol is paused), block until the size of the buffer is drained down to " "the low-water limit and the protocol is resumed. When there is nothing to " "wait for, the yield-from continues immediately." msgstr "" #: ../Doc/library/asyncio-stream.rst:273 msgid "" "Yielding from :meth:`drain` gives the opportunity for the loop to schedule " "the write operation and flush the buffer. It should especially be used when " "a possibly large amount of data is written to the transport, and the " "coroutine does not yield-from between calls to :meth:`write`." msgstr "" #: ../Doc/library/asyncio-stream.rst:282 msgid "" "Return optional transport information: see :meth:`BaseTransport." "get_extra_info`." msgstr "" #: ../Doc/library/asyncio-stream.rst:287 msgid "" "Write some *data* bytes to the transport: see :meth:`WriteTransport.write`." msgstr "" #: ../Doc/library/asyncio-stream.rst:292 msgid "" "Write a list (or any iterable) of data bytes to the transport: see :meth:" "`WriteTransport.writelines`." msgstr "" #: ../Doc/library/asyncio-stream.rst:297 msgid "" "Close the write end of the transport after flushing buffered data: see :meth:" "`WriteTransport.write_eof`." msgstr "" #: ../Doc/library/asyncio-stream.rst:302 msgid "StreamReaderProtocol" msgstr "StreamReaderProtocol" #: ../Doc/library/asyncio-stream.rst:306 msgid "" "Trivial helper class to adapt between :class:`Protocol` and :class:" "`StreamReader`. Subclass of :class:`Protocol`." msgstr "" #: ../Doc/library/asyncio-stream.rst:309 msgid "" "*stream_reader* is a :class:`StreamReader` instance, *client_connected_cb* " "is an optional function called with (stream_reader, stream_writer) when a " "connection is made, *loop* is the event loop instance to use." msgstr "" #: ../Doc/library/asyncio-stream.rst:313 msgid "" "(This is a helper class instead of making :class:`StreamReader` itself a :" "class:`Protocol` subclass, because the :class:`StreamReader` has other " "potential uses, and to prevent the user of the :class:`StreamReader` from " "accidentally calling inappropriate methods of the protocol.)" msgstr "" #: ../Doc/library/asyncio-stream.rst:320 msgid "IncompleteReadError" msgstr "IncompleteReadError" #: ../Doc/library/asyncio-stream.rst:324 msgid "Incomplete read error, subclass of :exc:`EOFError`." msgstr "" #: ../Doc/library/asyncio-stream.rst:328 msgid "Total number of expected bytes (:class:`int`)." msgstr "Nombre total d'octets attendus (:class:`int`)." #: ../Doc/library/asyncio-stream.rst:332 msgid "" "Read bytes string before the end of stream was reached (:class:`bytes`)." msgstr "" #: ../Doc/library/asyncio-stream.rst:336 msgid "LimitOverrunError" msgstr "" #: ../Doc/library/asyncio-stream.rst:340 msgid "Reached the buffer limit while looking for a separator." msgstr "" #: ../Doc/library/asyncio-stream.rst:344 msgid "Total number of to be consumed bytes." msgstr "" #: ../Doc/library/asyncio-stream.rst:348 msgid "Stream examples" msgstr "" #: ../Doc/library/asyncio-stream.rst:353 msgid "TCP echo client using streams" msgstr "" #: ../Doc/library/asyncio-stream.rst:355 msgid "TCP echo client using the :func:`asyncio.open_connection` function::" msgstr "" #: ../Doc/library/asyncio-stream.rst:379 msgid "" "The :ref:`TCP echo client protocol ` " "example uses the :meth:`AbstractEventLoop.create_connection` method." msgstr "" #: ../Doc/library/asyncio-stream.rst:386 msgid "TCP echo server using streams" msgstr "" #: ../Doc/library/asyncio-stream.rst:388 msgid "TCP echo server using the :func:`asyncio.start_server` function::" msgstr "" #: ../Doc/library/asyncio-stream.rst:423 msgid "" "The :ref:`TCP echo server protocol ` " "example uses the :meth:`AbstractEventLoop.create_server` method." msgstr "" #: ../Doc/library/asyncio-stream.rst:428 msgid "Get HTTP headers" msgstr "Récupère les en-têtes HTTP" #: ../Doc/library/asyncio-stream.rst:430 msgid "" "Simple example querying HTTP headers of the URL passed on the command line::" msgstr "" #: ../Doc/library/asyncio-stream.rst:464 msgid "Usage::" msgstr "" #: ../Doc/library/asyncio-stream.rst:468 msgid "or with HTTPS::" msgstr "ou avec HTTPS ::" #: ../Doc/library/asyncio-stream.rst:475 msgid "Register an open socket to wait for data using streams" msgstr "" #: ../Doc/library/asyncio-stream.rst:477 msgid "" "Coroutine waiting until a socket receives data using the :func:" "`open_connection` function::" msgstr "" #: ../Doc/library/asyncio-stream.rst:509 msgid "" "The :ref:`register an open socket to wait for data using a protocol ` example uses a low-level protocol created by the :meth:" "`AbstractEventLoop.create_connection` method." msgstr "" #: ../Doc/library/asyncio-stream.rst:513 msgid "" "The :ref:`watch a file descriptor for read events ` example uses the low-level :meth:`AbstractEventLoop.add_reader` " "method to register the file descriptor of a socket." msgstr ""