forked from AFPy/python-docs-fr
455 lines
13 KiB
Plaintext
455 lines
13 KiB
Plaintext
# 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: 2023-02-12 11:56+0100\n"
|
||
"PO-Revision-Date: 2019-09-06 13:48+0200\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"
|
||
|
||
#: 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:58
|
||
msgid ""
|
||
"Establish a network connection and return a pair of ``(reader, writer)`` "
|
||
"objects."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:61
|
||
msgid ""
|
||
"The returned *reader* and *writer* objects are instances of :class:"
|
||
"`StreamReader` and :class:`StreamWriter` classes."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:109
|
||
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:68
|
||
msgid ""
|
||
"The rest of the arguments are passed directly to :meth:`loop."
|
||
"create_connection`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:147
|
||
msgid ""
|
||
"The *sock* argument transfers ownership of the socket to the :class:"
|
||
"`StreamWriter` created. To close the socket, call its :meth:`~asyncio."
|
||
"StreamWriter.close` method."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:77
|
||
msgid "Added the *ssl_handshake_timeout* parameter."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:80
|
||
msgid "Added *happy_eyeballs_delay* and *interleave* parameters."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:125 library/asyncio-stream.rst:187
|
||
msgid "Removed the *loop* parameter."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:128 library/asyncio-stream.rst:190
|
||
msgid "Added the *ssl_shutdown_timeout* parameter."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:98
|
||
msgid "Start a socket server."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:100
|
||
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:105
|
||
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 ""
|
||
|
||
#: library/asyncio-stream.rst:113
|
||
msgid ""
|
||
"The rest of the arguments are passed directly to :meth:`loop.create_server`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:177
|
||
msgid ""
|
||
"The *sock* argument transfers ownership of the socket to the server created. "
|
||
"To close the socket, call the server's :meth:`~asyncio.Server.close` method."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:122
|
||
msgid "Added the *ssl_handshake_timeout* and *start_serving* parameters."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:133
|
||
msgid "Unix Sockets"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:138
|
||
msgid ""
|
||
"Establish a Unix socket connection and return a pair of ``(reader, writer)``."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:141
|
||
msgid "Similar to :func:`open_connection` but operates on Unix sockets."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:143
|
||
msgid "See also the documentation of :meth:`loop.create_unix_connection`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:181
|
||
msgid ":ref:`Availability <availability>`: Unix."
|
||
msgstr ":ref:`Disponibilité <availability>` : Unix."
|
||
|
||
#: library/asyncio-stream.rst:153
|
||
msgid ""
|
||
"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "
|
||
"a :term:`path-like object`"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:169
|
||
msgid "Start a Unix socket server."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:171
|
||
msgid "Similar to :func:`start_server` but works with Unix sockets."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:173
|
||
msgid "See also the documentation of :meth:`loop.create_unix_server`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:183
|
||
msgid ""
|
||
"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* "
|
||
"parameter can now be a :term:`path-like object`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:195
|
||
msgid "StreamReader"
|
||
msgstr "StreamReader"
|
||
|
||
#: library/asyncio-stream.rst:199
|
||
msgid ""
|
||
"Represents a reader object that provides APIs to read data from the IO "
|
||
"stream. As an :term:`asynchronous iterable`, the object supports the :"
|
||
"keyword:`async for` statement."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:203
|
||
msgid ""
|
||
"It is not recommended to instantiate *StreamReader* objects directly; use :"
|
||
"func:`open_connection` and :func:`start_server` instead."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:209
|
||
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:212
|
||
msgid ""
|
||
"If EOF was received and the internal buffer is empty, return an empty "
|
||
"``bytes`` object."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:217
|
||
msgid ""
|
||
"Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:220
|
||
msgid ""
|
||
"If EOF is received and ``\\n`` was not found, the method returns partially "
|
||
"read data."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:223
|
||
msgid ""
|
||
"If EOF is received and the internal buffer is empty, return an empty "
|
||
"``bytes`` object."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:228
|
||
msgid "Read exactly *n* bytes."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:230
|
||
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:236
|
||
msgid "Read data from the stream until *separator* is found."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:238
|
||
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:242
|
||
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:246
|
||
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:255
|
||
msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:260
|
||
msgid "StreamWriter"
|
||
msgstr "StreamWriter"
|
||
|
||
#: library/asyncio-stream.rst:264
|
||
msgid ""
|
||
"Represents a writer object that provides APIs to write data to the IO stream."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:267
|
||
msgid ""
|
||
"It is not recommended to instantiate *StreamWriter* objects directly; use :"
|
||
"func:`open_connection` and :func:`start_server` instead."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:273
|
||
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:289
|
||
msgid "The method should be used along with the ``drain()`` method::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:284
|
||
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:296
|
||
msgid "The method closes the stream and the underlying socket."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:298
|
||
msgid ""
|
||
"The method should be used, though not mandatory, along with the "
|
||
"``wait_closed()`` method::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:306
|
||
msgid ""
|
||
"Return ``True`` if the underlying transport supports the :meth:`write_eof` "
|
||
"method, ``False`` otherwise."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:311
|
||
msgid ""
|
||
"Close the write end of the stream after the buffered write data is flushed."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:316
|
||
msgid "Return the underlying asyncio transport."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:320
|
||
msgid ""
|
||
"Access optional transport information; see :meth:`BaseTransport."
|
||
"get_extra_info` for details."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:325
|
||
msgid "Wait until it is appropriate to resume writing to the stream. Example::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:331
|
||
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:341
|
||
msgid "Upgrade an existing stream-based connection to TLS."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:343
|
||
msgid "Parameters:"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:345
|
||
msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:347
|
||
msgid ""
|
||
"*server_hostname*: sets or overrides the host name that the target server's "
|
||
"certificate will be matched against."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:350
|
||
msgid ""
|
||
"*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake "
|
||
"to complete before aborting the connection. ``60.0`` seconds if ``None`` "
|
||
"(default)."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:358
|
||
msgid ""
|
||
"Return ``True`` if the stream is closed or in the process of being closed."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:365
|
||
msgid "Wait until the stream is closed."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:367
|
||
msgid ""
|
||
"Should be called after :meth:`close` to wait until the underlying connection "
|
||
"is closed, ensuring that all data has been flushed before e.g. exiting the "
|
||
"program."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:375
|
||
msgid "Examples"
|
||
msgstr "Exemples"
|
||
|
||
#: library/asyncio-stream.rst:380
|
||
msgid "TCP echo client using streams"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:382
|
||
msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:406
|
||
msgid ""
|
||
"The :ref:`TCP echo client protocol "
|
||
"<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
|
||
"`loop.create_connection` method."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:413
|
||
msgid "TCP echo server using streams"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:415
|
||
msgid "TCP echo server using the :func:`asyncio.start_server` function::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:449
|
||
msgid ""
|
||
"The :ref:`TCP echo server protocol "
|
||
"<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
|
||
"create_server` method."
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:454
|
||
msgid "Get HTTP headers"
|
||
msgstr "Récupère les en-têtes HTTP"
|
||
|
||
#: library/asyncio-stream.rst:456
|
||
msgid ""
|
||
"Simple example querying HTTP headers of the URL passed on the command line::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:495
|
||
msgid "Usage::"
|
||
msgstr "Utilisation ::"
|
||
|
||
#: library/asyncio-stream.rst:499
|
||
msgid "or with HTTPS::"
|
||
msgstr "ou avec HTTPS ::"
|
||
|
||
#: library/asyncio-stream.rst:507
|
||
msgid "Register an open socket to wait for data using streams"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:509
|
||
msgid ""
|
||
"Coroutine waiting until a socket receives data using the :func:"
|
||
"`open_connection` function::"
|
||
msgstr ""
|
||
|
||
#: library/asyncio-stream.rst:544
|
||
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 ""
|
||
|
||
#: library/asyncio-stream.rst:548
|
||
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 ""
|