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

# 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-07-23 14:38+0200\n"
"PO-Revision-Date: 2023-07-04 23:07+0200\n"
"Last-Translator: Christophe Nanteuil <christophe.nanteuil@gmail.com>\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"
"X-Generator: Poedit 3.2.2\n"

#: library/asyncio-stream.rst:7
msgid "Streams"
msgstr "Flux (*streams*)"

#: library/asyncio-stream.rst:9
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 ""
"Les flux sont des primitives de haut niveau compatibles avec *async*/*await* "
"pour utiliser les connexions réseau. Les flux permettent d'envoyer et de "
"recevoir des données sans utiliser de fonctions de rappel ou des protocoles "
"de bas niveau."

#: library/asyncio-stream.rst:19
msgid "Here is an example of a TCP echo client written using asyncio streams::"
msgstr ""
"Voici un exemple de client « écho TCP » écrit en utilisant les flux "
"*asyncio* ::"

#: library/asyncio-stream.rst:42
msgid "See also the `Examples`_ section below."
msgstr "Voir également la section `Exemples`_ ci-dessous."

#: library/asyncio-stream.rst:46
msgid "Stream Functions"
msgstr "Fonctions de flux"

#: library/asyncio-stream.rst:47
msgid ""
"The following top-level asyncio functions can be used to create and work "
"with streams:"
msgstr ""
"Les fonctions *asyncio* de haut niveau suivantes peuvent être utilisées pour "
"créer et utiliser des flux :"

#: library/asyncio-stream.rst:58
msgid ""
"Establish a network connection and return a pair of ``(reader, writer)`` "
"objects."
msgstr ""
"Établit une connexion réseau et renvoie une paire d'objets ``(lecteur, "
"écrivain)``."

#: library/asyncio-stream.rst:61
msgid ""
"The returned *reader* and *writer* objects are instances of :class:"
"`StreamReader` and :class:`StreamWriter` classes."
msgstr ""
"Les objets *lecteur* et *écrivain* renvoyés sont des instances des classes :"
"class:`StreamReader` et :class:`StreamWriter`."

#: 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 ""
"*limit* détermine la limite de taille de tampon utilisée par l'instance :"
"class:`StreamReader` renvoyée. Par défaut, *limit* est fixée à 64 Kio."

#: library/asyncio-stream.rst:68
msgid ""
"The rest of the arguments are passed directly to :meth:`loop."
"create_connection`."
msgstr ""
"Le reste des arguments est passé directement à :meth:`loop."
"create_connection`."

# suit un :
#: 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 ""
"l'argument *sock* transfère la propriété du connecteur réseau au :class:"
"`StreamWriter` créé. Pour fermer le connecteur, appelez sa méthode :meth:"
"`~asyncio.StreamWriter.close`."

# suit un :
#: library/asyncio-stream.rst:77
msgid "Added the *ssl_handshake_timeout* parameter."
msgstr "ajout du paramètre *ssl_handshake_timeout*."

# suit un :
#: library/asyncio-stream.rst:80
msgid "Added *happy_eyeballs_delay* and *interleave* parameters."
msgstr "ajout des paramètres *happy_eyeballs_delay* et *interleave*."

# suit un :
#: library/asyncio-stream.rst:125 library/asyncio-stream.rst:187
msgid "Removed the *loop* parameter."
msgstr "suppression du paramètre *loop*."

# suit un :
#: library/asyncio-stream.rst:128 library/asyncio-stream.rst:190
msgid "Added the *ssl_shutdown_timeout* parameter."
msgstr "ajout du paramètre *ssl_shutdown_timeout*."

#: library/asyncio-stream.rst:98
msgid "Start a socket server."
msgstr "Démarre un serveur de connexions"

#: 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 ""
"La fonction de rappel *client_connected_cb* est appelée chaque fois qu'une "
"nouvelle connexion client est établie. Elle reçoit une paire d'arguments "
"``(lecteur, écrivain)``, instances des classes :class:`StreamReader` et :"
"class:`StreamWriter`."

#: 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 ""
"*client_connected_cb* peut être un simple appelable ou une fonction :ref:"
"`coroutine <coroutine>` ; s'il s'agit d'une fonction coroutine, elle sera "
"automatiquement planifiée en tant que :class:`Task`."

#: library/asyncio-stream.rst:113
msgid ""
"The rest of the arguments are passed directly to :meth:`loop.create_server`."
msgstr ""
"Le reste des arguments est passé directement à :meth:`loop.create_server`."

# suit un :
#: 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 ""
"l'argument *sock* transfère la propriété du connecteur au serveur créé. Pour "
"fermer le connecteur, appelez la méthode :meth:`~asyncio.Server.close` du "
"serveur."

# suit un :
#: library/asyncio-stream.rst:122
msgid "Added the *ssl_handshake_timeout* and *start_serving* parameters."
msgstr "ajout des paramètres *ssl_handshake_timeout* et *start_serving*."

#: library/asyncio-stream.rst:133
msgid "Unix Sockets"
msgstr "Connecteurs Unix (*sockets*)"

#: library/asyncio-stream.rst:138
msgid ""
"Establish a Unix socket connection and return a pair of ``(reader, writer)``."
msgstr ""
"Ouvre un connecteur Unix et renvoie une paire de ``(lecteur, écrivain)``."

#: library/asyncio-stream.rst:141
msgid "Similar to :func:`open_connection` but operates on Unix sockets."
msgstr ""
"Similaire à :func:`open_connection` mais fonctionne sur les connecteurs Unix."

#: library/asyncio-stream.rst:143
msgid "See also the documentation of :meth:`loop.create_unix_connection`."
msgstr "Voir aussi la documentation de :meth:`loop.create_unix_connection`."

#: library/asyncio-stream.rst:181
msgid ":ref:`Availability <availability>`: Unix."
msgstr ":ref:`Disponibilité <availability>` : Unix."

# suit un :
#: library/asyncio-stream.rst:153
msgid ""
"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "
"a :term:`path-like object`"
msgstr ""
"ajout du paramètre *ssl_handshake_timeout*. Le paramètre *path* peut "
"désormais être un :term:`objet simili-chemin <path-like object>`"

#: library/asyncio-stream.rst:169
msgid "Start a Unix socket server."
msgstr "Démarre un connecteur Unix en mode serveur."

#: library/asyncio-stream.rst:171
msgid "Similar to :func:`start_server` but works with Unix sockets."
msgstr ""
"Similaire à :func:`start_server` mais fonctionne avec les connecteurs Unix."

#: library/asyncio-stream.rst:173
msgid "See also the documentation of :meth:`loop.create_unix_server`."
msgstr "Voir aussi la documentation de :meth:`loop.create_unix_server`."

# suit un :
#: 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 ""
"ajout des paramètres *ssl_handshake_timeout* et *start_serving*. Le "
"paramètre *chemin* peut désormais être un :term:`simili-chemin<path-like "
"object>`."

#: library/asyncio-stream.rst:195
msgid "StreamReader"
msgstr "Flux lecteurs (*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 ""
"Représente un objet lecteur qui fournit des API pour lire les données du "
"flux d'entrée-sortie. En tant que :term:`itérable asynchrone <asynchronous "
"iterable>`, l'objet prend en charge l'instruction :keyword:`async for`."

#: 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 ""
"Il n'est pas recommandé d'instancier directement les objets *StreamReader* ; "
"utilisez :func:`open_connection` et :func:`start_server` à la place."

#: library/asyncio-stream.rst:209
msgid "Read up to *n* bytes from the stream."
msgstr "Lit jusqu'à *n* octets du flux."

#: library/asyncio-stream.rst:211
msgid ""
"If *n* is not provided or set to ``-1``, read until EOF, then return all "
"read :class:`bytes`. If EOF was received and the internal buffer is empty, "
"return an empty ``bytes`` object."
msgstr ""
"Si *n* n'est pas fourni ou défini à ``-1``, lit jusqu'à *EOF*, puis renvoie "
"tous les :class:`bytes` lus. Si *EOF* a été reçu et que le tampon interne "
"est vide, renvoie un objet ``bytes`` vide."

#: library/asyncio-stream.rst:216
msgid "If *n* is ``0``, return an empty ``bytes`` object immediately."
msgstr "Si *n* vaut ``0``, renvoie immédiatement un objet ``bytes`` vide."

#: library/asyncio-stream.rst:218
msgid ""
"If *n* is positive, return at most *n* available ``bytes`` as soon as at "
"least 1 byte is available in the internal buffer. If EOF is received before "
"any byte is read, return an empty ``bytes`` object."
msgstr ""
"Si *n* est positif, renvoie au plus *n* ``bytes`` disponibles dès qu'au "
"moins 1 octet est disponible dans le tampon interne. Si *EOF* est reçu avant "
"qu'aucun octet ne soit lu, renvoie un objet ``bytes`` vide."

#: library/asyncio-stream.rst:225
msgid ""
"Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."
msgstr ""
"Lit une ligne, où une « ligne » est une séquence d'octets se terminant par "
"``\\n``."

#: library/asyncio-stream.rst:228
msgid ""
"If EOF is received and ``\\n`` was not found, the method returns partially "
"read data."
msgstr ""
"Si *EOF* est reçu et ``\\n`` n'a pas été trouvé, la méthode renvoie des "
"données partiellement lues."

#: library/asyncio-stream.rst:231
msgid ""
"If EOF is received and the internal buffer is empty, return an empty "
"``bytes`` object."
msgstr ""
"Si *EOF* est reçu et que le tampon interne est vide, renvoie un objet "
"``bytes`` vide."

#: library/asyncio-stream.rst:236
msgid "Read exactly *n* bytes."
msgstr "Lit exactement *n* octets."

#: library/asyncio-stream.rst:238
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 ""
"Lève une :exc:`IncompleteReadError` si *EOF* est atteint avant que *n* "
"octets ne puissent être lus. Utilisez l'attribut :attr:`IncompleteReadError."
"partial` pour obtenir les données partiellement lues."

#: library/asyncio-stream.rst:244
msgid "Read data from the stream until *separator* is found."
msgstr "Lit les données du flux jusqu'à ce que le *separator* soit trouvé."

#: library/asyncio-stream.rst:246
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 ""
"En cas de succès, les données et le séparateur sont supprimés du tampon "
"interne (consommés). Les données renvoyées incluent le séparateur à la fin."

#: library/asyncio-stream.rst:250
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 ""
"Si la quantité de données lues dépasse la limite de flux configurée, une "
"exception :exc:`LimitOverrunError` est levée et les données sont laissées "
"dans le tampon interne et peuvent être lues à nouveau."

#: library/asyncio-stream.rst:254
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 ""
"Si *EOF* est atteint avant que le séparateur complet ne soit trouvé, une "
"exception :exc:`IncompleteReadError` est levée  et le tampon interne est "
"réinitialisé. L'attribut :attr:`IncompleteReadError.partial` peut contenir "
"une partie du séparateur."

#: library/asyncio-stream.rst:263
msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."
msgstr ""
"Renvoie ``True`` si le tampon est vide et que :meth:`feed_eof` a été appelée."

#: library/asyncio-stream.rst:268
msgid "StreamWriter"
msgstr "Flux écrivains (*StreamWriter*)"

#: library/asyncio-stream.rst:272
msgid ""
"Represents a writer object that provides APIs to write data to the IO stream."
msgstr ""
"Représente un objet écrivain qui fournit des API pour écrire des données "
"dans le flux d'entrée-sortie."

#: library/asyncio-stream.rst:275
msgid ""
"It is not recommended to instantiate *StreamWriter* objects directly; use :"
"func:`open_connection` and :func:`start_server` instead."
msgstr ""
"Il n'est pas recommandé d'instancier directement les objets *StreamWriter* ; "
"utilisez :func:`open_connection` et :func:`start_server` à la place."

#: library/asyncio-stream.rst:281
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 ""
"La méthode tente d'écrire immédiatement les *data* dans le connecteur sous-"
"jacent. Si cela échoue, les données sont mises en file d'attente dans un "
"tampon d'écriture interne jusqu'à ce qu'elles puissent être envoyées."

#: library/asyncio-stream.rst:297
msgid "The method should be used along with the ``drain()`` method::"
msgstr "La méthode doit être utilisée avec la méthode ``drain()`` ::"

#: library/asyncio-stream.rst:292
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 ""
"La méthode écrit immédiatement une liste (ou tout itérable) d'octets dans le "
"connecteur sous-jacent. Si cela échoue, les données sont mises en file "
"d'attente dans un tampon d'écriture interne jusqu'à ce qu'elles puissent "
"être envoyées."

#: library/asyncio-stream.rst:304
msgid "The method closes the stream and the underlying socket."
msgstr "La méthode ferme le flux et le connecteur sous-jacent."

#: library/asyncio-stream.rst:306
msgid ""
"The method should be used, though not mandatory, along with the "
"``wait_closed()`` method::"
msgstr ""
"La méthode doit être utilisée, bien que ce ne soit pas obligatoire, avec la "
"méthode ``wait_closed()`` ::"

#: library/asyncio-stream.rst:314
msgid ""
"Return ``True`` if the underlying transport supports the :meth:`write_eof` "
"method, ``False`` otherwise."
msgstr ""
"Renvoie ``True`` si le transport sous-jacent gère la méthode :meth:"
"`write_eof`, ``False`` sinon."

#: library/asyncio-stream.rst:319
msgid ""
"Close the write end of the stream after the buffered write data is flushed."
msgstr ""
"Ferme le flux en écriture après le vidage des données d'écriture en mémoire "
"tampon."

#: library/asyncio-stream.rst:324
msgid "Return the underlying asyncio transport."
msgstr "Renvoie le transport asynchrone sous-jacent."

#: library/asyncio-stream.rst:328
msgid ""
"Access optional transport information; see :meth:`BaseTransport."
"get_extra_info` for details."
msgstr ""
"Donne accès aux informations de transport facultatives ; voir :meth:"
"`BaseTransport.get_extra_info` pour plus de détails."

#: library/asyncio-stream.rst:333
msgid "Wait until it is appropriate to resume writing to the stream. Example::"
msgstr ""
"Attend qu'il soit approprié de reprendre l'écriture dans le flux. Par "
"exemple ::"

#: library/asyncio-stream.rst:339
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 ""
"Il s'agit d'une méthode de contrôle de flux qui interagit avec le tampon "
"d'écriture entrée-sortie sous-jacent. Lorsque la taille du tampon atteint la "
"limite haute, *drain()* bloque jusqu'à ce que la taille du tampon soit "
"drainée jusqu'à la limite basse et que l'écriture puisse reprendre. "
"Lorsqu'il n'y a rien à attendre, :meth:`drain` termine immédiatement."

#: library/asyncio-stream.rst:349
msgid "Upgrade an existing stream-based connection to TLS."
msgstr "Bascule la connexion basée sur le flux existant vers TLS."

#: library/asyncio-stream.rst:351
msgid "Parameters:"
msgstr "Paramètres :"

#: library/asyncio-stream.rst:353
msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."
msgstr "*sslcontext* : une instance configurée de :class:`~ssl.SSLContext`."

#: library/asyncio-stream.rst:355
msgid ""
"*server_hostname*: sets or overrides the host name that the target server's "
"certificate will be matched against."
msgstr ""
"*server_hostname* : définit ou remplace le nom d'hôte auquel le certificat "
"du serveur cible sera comparé."

#: library/asyncio-stream.rst:358
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 ""
"*ssl_handshake_timeout* est le temps en secondes à attendre pour que la "
"poignée de main TLS se termine avant d'abandonner la connexion. ``60.0`` "
"secondes si ``None`` (par défaut)."

#: library/asyncio-stream.rst:366
msgid ""
"Return ``True`` if the stream is closed or in the process of being closed."
msgstr "Renvoie ``True`` si le flux est fermé ou en cours de fermeture."

#: library/asyncio-stream.rst:373
msgid "Wait until the stream is closed."
msgstr "Attend que le flux soit fermé."

#: library/asyncio-stream.rst:375
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 ""
"Doit être appelée après :meth:`close` pour attendre que la connexion sous-"
"jacente soit fermée, en s'assurant que toutes les données ont été vidées "
"avant, par exemple, de quitter le programme."

#: library/asyncio-stream.rst:383
msgid "Examples"
msgstr "Exemples"

#: library/asyncio-stream.rst:388
msgid "TCP echo client using streams"
msgstr "Client d'écho TCP utilisant des flux"

#: library/asyncio-stream.rst:390
msgid "TCP echo client using the :func:`asyncio.open_connection` function::"
msgstr ""
"Client d'écho TCP utilisant la fonction :func:`asyncio.open_connection` ::"

#: library/asyncio-stream.rst:414
msgid ""
"The :ref:`TCP echo client protocol "
"<asyncio_example_tcp_echo_client_protocol>` example uses the low-level :meth:"
"`loop.create_connection` method."
msgstr ""
"L'exemple :ref:`asyncio_example_tcp_echo_client_protocol` utilise la méthode "
"de bas niveau :meth:`loop.create_connection`."

#: library/asyncio-stream.rst:421
msgid "TCP echo server using streams"
msgstr "Serveur d'écho TCP utilisant des flux"

#: library/asyncio-stream.rst:423
msgid "TCP echo server using the :func:`asyncio.start_server` function::"
msgstr ""
"Serveur d'écho TCP utilisant la fonction :func:`asyncio.start_server` ::"

#: library/asyncio-stream.rst:457
msgid ""
"The :ref:`TCP echo server protocol "
"<asyncio_example_tcp_echo_server_protocol>` example uses the :meth:`loop."
"create_server` method."
msgstr ""
"L'exemple de :ref:`asyncio_example_tcp_echo_server_protocol` utilise la "
"méthode :meth:`loop.create_server`."

#: library/asyncio-stream.rst:462
msgid "Get HTTP headers"
msgstr "Récupération des en-têtes HTTP"

#: library/asyncio-stream.rst:464
msgid ""
"Simple example querying HTTP headers of the URL passed on the command line::"
msgstr ""
"Exemple simple d'interrogation des en-têtes HTTP de l'URL transmise sur la "
"ligne de commande ::"

#: library/asyncio-stream.rst:503
msgid "Usage::"
msgstr "Utilisation ::"

#: library/asyncio-stream.rst:507
msgid "or with HTTPS::"
msgstr "ou avec HTTPS ::"

#: library/asyncio-stream.rst:515
msgid "Register an open socket to wait for data using streams"
msgstr "Ouverture d'un connecteur pour attendre les données à l'aide de flux"

#: library/asyncio-stream.rst:517
msgid ""
"Coroutine waiting until a socket receives data using the :func:"
"`open_connection` function::"
msgstr ""
"Coroutine attendant qu'un connecteur reçoive des données en utilisant la "
"fonction :func:`open_connection` ::"

#: library/asyncio-stream.rst:552
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 ""
"L'exemple :ref:`asyncio_example_create_connection` utilise un protocole de "
"bas niveau et la méthode :meth:`loop.create_connection`."

#: library/asyncio-stream.rst:556
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 ""
"L'exemple :ref:`asyncio_example_watch_fd` utilise la méthode de bas niveau :"
"meth:`loop.add_reader` pour surveiller un descripteur de fichier."

#, fuzzy
#~ msgid ""
#~ "*ssl_shutdown_timeout* is the time in seconds to wait for the SSL "
#~ "shutdown to complete before aborting the connection. ``30.0`` seconds if "
#~ "``None`` (default)."
#~ msgstr ""
#~ "*ssl_handshake_timeout* est le temps en secondes à attendre pour que la "
#~ "poignée de main TLS se termine avant d'abandonner la connexion. ``60.0`` "
#~ "secondes si ``None`` (par défaut)."