python-docs-fr/library/asyncio-stream.po

665 lines
20 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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: 2019-09-04 11:33+0200\n"
"PO-Revision-Date: 2018-11-29 18:28+0100\n"
"Last-Translator: Julien Palard <julien@palard.fr>\n"
"Language-Team: FRENCH <traductions@lists.afpy.org>\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"
msgstr "Streams"
#: ../Doc/library/asyncio-stream.rst:9
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 ""
#: ../Doc/library/asyncio-stream.rst:15
msgid "Here is an example of a TCP echo client written using asyncio streams::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:31
msgid "See also the `Examples`_ section below."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:35
msgid "Stream Functions"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:36
msgid ""
"The following top-level asyncio functions can be used to create and work "
"with streams:"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:46
msgid ""
"Connect to TCP socket on *host* : *port* address and return a :class:"
"`Stream` object of mode :attr:`StreamMode.READWRITE`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:50 ../Doc/library/asyncio-stream.rst:164
msgid ""
"*limit* determines the buffer size limit used by the returned :class:"
"`Stream` instance. By default the *limit* is set to 64 KiB."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:53 ../Doc/library/asyncio-stream.rst:84
msgid ""
"The rest of the arguments are passed directly to :meth:`loop."
"create_connection`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:55 ../Doc/library/asyncio-stream.rst:169
msgid "The function can be used with ``await`` to get a connected stream::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:59 ../Doc/library/asyncio-stream.rst:173
msgid "The function can also be used as an async context manager::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:71
msgid ""
"Establish a network connection and return a pair of ``(reader, writer)`` "
"objects."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:74
msgid ""
"The returned *reader* and *writer* objects are instances of :class:"
"`StreamReader` and :class:`StreamWriter` classes."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:77
msgid ""
"The *loop* argument is optional and can always be determined automatically "
"when this function is awaited from a coroutine."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:80 ../Doc/library/asyncio-stream.rst:117
msgid ""
"*limit* determines the buffer size limit used by the returned :class:"
"`StreamReader` instance. By default the *limit* is set to 64 KiB."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:89 ../Doc/library/asyncio-stream.rst:197
msgid "The *ssl_handshake_timeout* parameter."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:93
msgid "`open_connection()` is deprecated in favor of :func:`connect`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:103
msgid "Start a socket server."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:105
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 ""
#: ../Doc/library/asyncio-stream.rst:110 ../Doc/library/asyncio-stream.rst:249
#: ../Doc/library/asyncio-stream.rst:316
msgid ""
"*client_connected_cb* can be a plain callable or a :ref:`coroutine function "
"<coroutine>`; if it is a coroutine function, it will be automatically "
"scheduled as a :class:`Task`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:114
msgid ""
"The *loop* argument is optional and can always be determined automatically "
"when this method is awaited from a coroutine."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:121 ../Doc/library/asyncio-stream.rst:257
msgid ""
"The rest of the arguments are passed directly to :meth:`loop.create_server`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:126 ../Doc/library/asyncio-stream.rst:223
msgid "The *ssl_handshake_timeout* and *start_serving* parameters."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:130
msgid "`start_server()` is deprecated if favor of :class:`StreamServer`"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:134
msgid ""
"Takes a :term:`file-like object <file object>` *pipe* to return a :class:"
"`Stream` object of the mode :attr:`StreamMode.READ` that has similar API of :"
"class:`StreamReader`. It can also be used as an async context manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:138 ../Doc/library/asyncio-stream.rst:149
msgid ""
"*limit* determines the buffer size limit used by the returned :class:"
"`Stream` instance. By default the limit is set to 64 KiB."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:145
msgid ""
"Takes a :term:`file-like object <file object>` *pipe* to return a :class:"
"`Stream` object of the mode :attr:`StreamMode.WRITE` that has similar API "
"of :class:`StreamWriter`. It can also be used as an async context manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:155
msgid "Unix Sockets"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:160
msgid ""
"Establish a Unix socket connection to socket with *path* address and return "
"an awaitable :class:`Stream` object of the mode :attr:`StreamMode.READWRITE` "
"that can be used as a reader and a writer."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:167
msgid ""
"The rest of the arguments are passed directly to :meth:`loop."
"create_unix_connection`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:179 ../Doc/library/asyncio-stream.rst:194
#: ../Doc/library/asyncio-stream.rst:220 ../Doc/library/asyncio-stream.rst:360
msgid ":ref:`Availability <availability>`: Unix."
msgstr ":ref:`Disponibilité <availability>` : Unix."
#: ../Doc/library/asyncio-stream.rst:186
msgid ""
"Establish a Unix socket connection and return a pair of ``(reader, writer)``."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:189
msgid "Similar to :func:`open_connection` but operates on Unix sockets."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:191
msgid "See also the documentation of :meth:`loop.create_unix_connection`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:201
msgid "The *path* parameter can now be a :term:`path-like object`"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:205
msgid ""
"``open_unix_connection()`` is deprecated if favor of :func:`connect_unix`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:213
msgid "Start a Unix socket server."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:215
msgid "Similar to :func:`start_server` but works with Unix sockets."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:217
msgid "See also the documentation of :meth:`loop.create_unix_server`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:227
msgid "The *path* parameter can now be a :term:`path-like object`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:231
msgid ""
"``start_unix_server()`` is deprecated in favor of :class:`UnixStreamServer`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:237
#, fuzzy
msgid "StreamServer"
msgstr "StreamReader"
#: ../Doc/library/asyncio-stream.rst:245 ../Doc/library/asyncio-stream.rst:312
msgid ""
"The *client_connected_cb* callback is called whenever a new client "
"connection is established. It receives a :class:`Stream` object of the "
"mode :attr:`StreamMode.READWRITE`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:253 ../Doc/library/asyncio-stream.rst:320
msgid ""
"*limit* determines the buffer size limit used by the returned :class:"
"`Stream` instance. By default the *limit* is set to 64 KiB."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:262 ../Doc/library/asyncio-stream.rst:329
msgid "Binds to the given host and port to start the server."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:266
msgid ""
"Start accepting connections until the coroutine is cancelled. Cancellation "
"of ``serve_forever`` task causes the server to be closed."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:270
msgid ""
"This method can be called if the server is already accepting connections. "
"Only one ``serve_forever`` task can exist per one *Server* object."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:276 ../Doc/library/asyncio-stream.rst:333
msgid "Returns ``True`` if the server is bound and currently serving."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:280
msgid ""
"Bind the server to the given *host* and *port*. This method is automatically "
"called during ``__aenter__`` when :class:`StreamServer` is used as an async "
"context manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:286 ../Doc/library/asyncio-stream.rst:343
msgid "Return ``True`` if the server is bound."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:290 ../Doc/library/asyncio-stream.rst:347
msgid "Closes the connection and cancels all pending tasks."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:294
msgid ""
"Closes the connection. This method is automatically called during "
"``__aexit__`` when :class:`StreamServer` is used as an async context manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:300 ../Doc/library/asyncio-stream.rst:357
msgid "Returns a tuple of socket objects the server is bound to."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:306
#, fuzzy
msgid "UnixStreamServer"
msgstr "StreamReader"
#: ../Doc/library/asyncio-stream.rst:324
msgid ""
"The rest of the arguments are passed directly to :meth:`loop."
"create_unix_server`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:337
msgid ""
"Bind the server to the given *host* and *port*. This method is automatically "
"called during ``__aenter__`` when :class:`UnixStreamServer` is used as an "
"async context manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:351
msgid ""
"Closes the connection. This method is automatically called during "
"``__aexit__`` when :class:`UnixStreamServer` is used as an async context "
"manager."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:364
#, fuzzy
msgid "Stream"
msgstr "Streams"
#: ../Doc/library/asyncio-stream.rst:368
msgid ""
"Represents a Stream object that provides APIs to read and write data to the "
"IO stream . It includes the API provided by :class:`StreamReader` and :class:"
"`StreamWriter`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:372
msgid ""
"Do not instantiate *Stream* objects directly; use API like :func:`connect` "
"and :class:`StreamServer` instead."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:379
#, fuzzy
msgid "StreamMode"
msgstr "StreamReader"
#: ../Doc/library/asyncio-stream.rst:383
msgid ""
"A subclass of :class:`enum.Flag` that defines a set of values that can be "
"used to determine the ``mode`` of :class:`Stream` objects."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:388
msgid ""
"The stream object is readable and provides the API of :class:`StreamReader`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:392
msgid ""
"The stream object is writeable and provides the API of :class:`StreamWriter`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:396
msgid ""
"The stream object is readable and writeable and provides the API of both :"
"class:`StreamReader` and :class:`StreamWriter`."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:403
msgid "StreamReader"
msgstr "StreamReader"
#: ../Doc/library/asyncio-stream.rst:407
msgid ""
"Represents a reader object that provides APIs to read data from the IO "
"stream."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:410
msgid ""
"It is not recommended to instantiate *StreamReader* objects directly; use :"
"func:`open_connection` and :func:`start_server` instead."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:416
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:419
msgid ""
"If EOF was received and the internal buffer is empty, return an empty "
"``bytes`` object."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:424
msgid ""
"Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:427
msgid ""
"If EOF is received and ``\\n`` was not found, the method returns partially "
"read data."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:430
msgid ""
"If EOF is received and the internal buffer is empty, return an empty "
"``bytes`` object."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:435
msgid "Read exactly *n* bytes."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:437
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 ""
#: ../Doc/library/asyncio-stream.rst:443
msgid "Read data from the stream until *separator* is found."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:445
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:449
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 ""
#: ../Doc/library/asyncio-stream.rst:453
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 ""
#: ../Doc/library/asyncio-stream.rst:462
msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:467
msgid "StreamWriter"
msgstr "StreamWriter"
#: ../Doc/library/asyncio-stream.rst:471
msgid ""
"Represents a writer object that provides APIs to write data to the IO stream."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:474
msgid ""
"It is not recommended to instantiate *StreamWriter* objects directly; use :"
"func:`open_connection` and :func:`start_server` instead."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:480
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 ""
#: ../Doc/library/asyncio-stream.rst:484 ../Doc/library/asyncio-stream.rst:507
msgid ""
"Starting with Python 3.8, it is possible to directly await on the `write()` "
"method::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:489 ../Doc/library/asyncio-stream.rst:512
msgid ""
"The ``await`` pauses the current coroutine until the data is written to the "
"socket."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:492 ../Doc/library/asyncio-stream.rst:515
#: ../Doc/library/asyncio-stream.rst:535
msgid "Below is an equivalent code that works with Python <= 3.7::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:497
msgid "Support ``await stream.write(...)`` syntax."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:502
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 ""
#: ../Doc/library/asyncio-stream.rst:520
msgid "Support ``await stream.writelines()`` syntax."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:525
msgid "The method closes the stream and the underlying socket."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:527
msgid ""
"Starting with Python 3.8, it is possible to directly await on the `close()` "
"method::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:532
msgid ""
"The ``await`` pauses the current coroutine until the stream and the "
"underlying socket are closed (and SSL shutdown is performed for a secure "
"connection)."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:540
msgid "Support ``await stream.close()`` syntax."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:545
msgid ""
"Return *True* if the underlying transport supports the :meth:`write_eof` "
"method, *False* otherwise."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:550
msgid ""
"Close the write end of the stream after the buffered write data is flushed."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:555
msgid "Return the underlying asyncio transport."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:559
msgid ""
"Access optional transport information; see :meth:`BaseTransport."
"get_extra_info` for details."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:564
msgid "Wait until it is appropriate to resume writing to the stream. Example::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:570
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 ""
#: ../Doc/library/asyncio-stream.rst:579
msgid ""
"Return ``True`` if the stream is closed or in the process of being closed."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:586
msgid "Wait until the stream is closed."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:588
msgid ""
"Should be called after :meth:`close` to wait until the underlying connection "
"is closed."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:595
msgid "Examples"
msgstr "Exemples"
#: ../Doc/library/asyncio-stream.rst:600
msgid "TCP echo client using streams"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:602
msgid "TCP echo client using the :func:`asyncio.connect` function::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:619
msgid ""
"The :ref:`TCP echo client protocol "
"<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
"`loop.create_connection` method."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:626
msgid "TCP echo server using streams"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:628
msgid "TCP echo server using the :class:`asyncio.StreamServer` class::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:657
msgid ""
"The :ref:`TCP echo server protocol "
"<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
"create_server` method."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:662
msgid "Get HTTP headers"
msgstr "Récupère les en-têtes HTTP"
#: ../Doc/library/asyncio-stream.rst:664
msgid ""
"Simple example querying HTTP headers of the URL passed on the command line::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:696
msgid "Usage::"
msgstr "Utilisation ::"
#: ../Doc/library/asyncio-stream.rst:700
msgid "or with HTTPS::"
msgstr "ou avec HTTPS ::"
#: ../Doc/library/asyncio-stream.rst:708
msgid "Register an open socket to wait for data using streams"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:710
msgid ""
"Coroutine waiting until a socket receives data using the :func:`asyncio."
"connect` function::"
msgstr ""
#: ../Doc/library/asyncio-stream.rst:742
msgid ""
"The :ref:`register an open socket to wait for data using a protocol "
"<asyncio_example_create_connection>` example uses a low-level protocol and "
"the :meth:`loop.create_connection` method."
msgstr ""
#: ../Doc/library/asyncio-stream.rst:746
msgid ""
"The :ref:`watch a file descriptor for read events "
"<asyncio_example_watch_fd>` example uses the low-level :meth:`loop."
"add_reader` method to watch a file descriptor."
msgstr ""
#~ msgid "This function is a :ref:`coroutine <coroutine>`."
#~ msgstr "Cette fonction est une :ref:`coroutine <coroutine>`."
#~ msgid "Get the exception."
#~ msgstr "Récupère l'exception."
#~ msgid "This method is a :ref:`coroutine <coroutine>`."
#~ msgstr "Cette méthode est une :ref:`coroutine <coroutine>`."
#~ msgid "Transport."
#~ msgstr "Transport."
#~ msgid "StreamReaderProtocol"
#~ msgstr "StreamReaderProtocol"
#~ msgid "IncompleteReadError"
#~ msgstr "IncompleteReadError"
#~ msgid "Total number of expected bytes (:class:`int`)."
#~ msgstr "Nombre total d'octets attendus (:class:`int`)."