python-docs-fr/library/contextvars.po at 3.12 · python/python-docs-fr

456 lines (405 loc) · 16.5 KB
# Copyright (C) 2001-2018, Python Software Foundation
# For licence information, see README file.
"Project-Id-Version: Python 3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-10-29 21:40+0100\n"
"PO-Revision-Date: 2023-04-08 19:57+0200\n"
"Last-Translator: Martin Chlumsky <martin.chlumsky@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.1\n"
#: library/contextvars.rst:2
msgid ":mod:`!contextvars` --- Context Variables"
msgstr ":mod:`contextvars` — Variables de contexte"
#: library/contextvars.rst:11
"This module provides APIs to manage, store, and access context-local state.  "
"The :class:`~contextvars.ContextVar` class is used to declare and work with "
"*Context Variables*.  The :func:`~contextvars.copy_context` function and "
"the :class:`~contextvars.Context` class should be used to manage the current "
"context in asynchronous frameworks."
"Ce module fournit des API pour gérer, stocker et accéder à l'état local de "
"contexte. La classe :class:`~contextvars.ContextVar` est utilisée pour "
"déclarer et travailler avec les *Variables de contexte*. La fonction :func:"
"`~contextvars.copy_context` et la classe :class:`~contextvars.Context` "
"doivent être utilisées pour la gestion du contexte actuel dans les "
"cadriciels asynchrones."
#: library/contextvars.rst:17
"Context managers that have state should use Context Variables instead of :"
"func:`threading.local` to prevent their state from bleeding to other code "
"unexpectedly, when used in concurrent code."
"Les gestionnaires de contexte, quand ils ont un état et quand ils sont "
"utilisés dans du code s'exécutant de manière concurrente, doivent utiliser "
"les variables de contexte au lieu de :func:`threading.local()` pour empêcher "
"que leur état ne perturbe un autre fil de manière inattendue."
#: library/contextvars.rst:21
msgid "See also :pep:`567` for additional details."
msgstr "Voir aussi :pep:`567` pour plus de détails."
#: library/contextvars.rst:27
msgid "Context Variables"
msgstr "Variables de contexte"
#: library/contextvars.rst:31
msgid "This class is used to declare a new Context Variable, e.g.::"
"Cette classe est utilisée pour déclarer une nouvelle variable de contexte, "
#: library/contextvars.rst:33
msgid "var: ContextVar[int] = ContextVar('var', default=42)"
#: library/contextvars.rst:35
"The required *name* parameter is used for introspection and debug purposes."
"Le paramètre requis *name* est utilisé à des fins d'introspection et de "
"débogage."
#: library/contextvars.rst:38
"The optional keyword-only *default* parameter is returned by :meth:"
"`ContextVar.get` when no value for the variable is found in the current "
"Le paramètre nommé *default* est renvoyé par :meth:`ContextVar.get` quand "
"aucune valeur n'est trouvée dans le contexte actuel pour la variable."
#: library/contextvars.rst:42
"**Important:** Context Variables should be created at the top module level "
"and never in closures.  :class:`Context` objects hold strong references to "
"context variables which prevents context variables from being properly "
"garbage collected."
"**Important :** les variables de contexte doivent être créées au plus haut "
"niveau du module et jamais dans des fermetures (*closures*). Les objets :"
"class:`Context` maintiennent des références fortes aux variables de contexte "
"ce qui empêche que les variables de contexte soient correctement nettoyées "
"par le ramasse-miette."
#: library/contextvars.rst:49
msgid "The name of the variable.  This is a read-only property."
msgstr "Nom de la variable. Cette propriété est en lecture seule."
#: library/contextvars.rst:55
msgid "Return a value for the context variable for the current context."
msgstr "Renvoie la valeur de la variable de contexte pour le contexte actuel."
#: library/contextvars.rst:57
"If there is no value for the variable in the current context, the method "
"S'il n'y a pas de valeur pour la variable dans le contexte actuel, la "
"méthode :"
#: library/contextvars.rst:60
"return the value of the *default* argument of the method, if provided; or"
"renvoie la valeur de l'argument *default* passé à la méthode, s'il a été "
#: library/contextvars.rst:63
"return the default value for the context variable, if it was created with "
"ou renvoie la valeur par défaut de la variable de contexte, si elle a été "
"créée avec une valeur par défaut ;"
# padpo se plaint ici pour le verbe lever mais on peut l'ignorer pour
# préserver le présent de l'indicatif en accord avec les "renvoie" dans les
# autres items de la liste.
#: library/contextvars.rst:66
msgid "raise a :exc:`LookupError`."
msgstr "ou lève une erreur :exc:`LookupError`."
#: library/contextvars.rst:70
"Call to set a new value for the context variable in the current context."
"Assigne une nouvelle valeur à la variable de contexte dans le contexte "
#: library/contextvars.rst:73
"The required *value* argument is the new value for the context variable."
"L'argument requis *value* est la nouvelle valeur pour la variable de "
"contexte."
#: library/contextvars.rst:76
"Returns a :class:`~contextvars.Token` object that can be used to restore the "
"variable to its previous value via the :meth:`ContextVar.reset` method."
"Renvoie un objet :class:`~contextvars.Token` qui peut être utilisé pour "
"rétablir la variable à sa valeur précédente par la méthode :meth:`ContextVar."
#: library/contextvars.rst:82
"Reset the context variable to the value it had before the :meth:`ContextVar."
"set` that created the *token* was used."
"Réinitialise la variable de contexte à la valeur qu'elle avait avant l'appel "
"de :meth:`ContextVar.set` qui a créé le *token*."
#: library/contextvars.rst:85
msgid "For example::"
msgstr "Par exemple ::"
#: library/contextvars.rst:87
"var = ContextVar('var')\n"
"token = var.set('new value')\n"
"# code that uses 'var'; var.get() returns 'new value'.\n"
"var.reset(token)\n"
"# After the reset call the var has no value again, so\n"
"# var.get() would raise a LookupError."
#: library/contextvars.rst:99
"*Token* objects are returned by the :meth:`ContextVar.set` method. They can "
"be passed to the :meth:`ContextVar.reset` method to revert the value of the "
"variable to what it was before the corresponding *set*."
"Les objets *Token* sont renvoyés par la méthode :meth:`ContextVar.set`. Ils "
"peuvent être passés à la méthode :meth:`ContextVar.reset` pour réaffecter la "
"valeur de la variable à ce qu'elle était avant le *set* correspondant."
#: library/contextvars.rst:106
"A read-only property.  Points to the :class:`ContextVar` object that created "
"the token."
"Propriété en lecture seule. Pointe vers l'objet :class:`ContextVar` qui a "
"créé le token."
#: library/contextvars.rst:111
"A read-only property.  Set to the value the variable had before the :meth:"
"`ContextVar.set` method call that created the token. It points to :attr:"
"`Token.MISSING` if the variable was not set before the call."
"Propriété en lecture seule. Sa valeur est celle que la variable avait avant "
"l'appel à la méthode :meth:`ContextVar.set` qui a créé le jeton. Elle pointe "
"à :attr:`Token.MISSING` si la variable n'est pas définie avant l'appel."
#: library/contextvars.rst:118
msgid "A marker object used by :attr:`Token.old_value`."
msgstr "Objet marqueur utilisé par :attr:`Token.old_value`."
#: library/contextvars.rst:122
msgid "Manual Context Management"
msgstr "Gestion de contexte manuelle"
#: library/contextvars.rst:126
msgid "Returns a copy of the current :class:`~contextvars.Context` object."
msgstr "Renvoie une copie de l'objet :class:`~contextvars.Context` actuel."
#: library/contextvars.rst:128
"The following snippet gets a copy of the current context and prints all "
"variables and their values that are set in it::"
"Le fragment de code qui suit obtient une copie du contexte actuel et affiche "
"toutes les variables avec leurs valeurs définies dans ce contexte ::"
#: library/contextvars.rst:131
"ctx: Context = copy_context()\n"
"print(list(ctx.items()))"
#: library/contextvars.rst:134
"The function has an *O*\\ (1) complexity, i.e. works equally fast for "
"contexts with a few context variables and for contexts that have a lot of "
"La fonction a une complexité O(1), c.-à-d. qu'elle fonctionne aussi "
"rapidement pour des contextes avec peu de variables de contexte que pour des "
"contextes qui en ont beaucoup."
#: library/contextvars.rst:141
msgid "A mapping of :class:`ContextVars <ContextVar>` to their values."
"Tableau associatif entre :class:`ContextVars <ContextVar>` et leurs valeurs."
#: library/contextvars.rst:143
"``Context()`` creates an empty context with no values in it. To get a copy "
"of the current context use the :func:`~contextvars.copy_context` function."
"``Context()`` crée un contexte vide ne contenant aucune valeur. Pour obtenir "
"une copie du contexte actuel, utilisez la fonction :func:`~contextvars."
"copy_context`."
#: library/contextvars.rst:147
"Every thread will have a different top-level :class:`~contextvars.Context` "
"object. This means that a :class:`ContextVar` object behaves in a similar "
"fashion to :func:`threading.local` when values are assigned in different "
#: library/contextvars.rst:152
msgid "Context implements the :class:`collections.abc.Mapping` interface."
msgstr "*Context* implémente l'interface :class:`collections.abc.Mapping`."
# padpo lance 3 warnings ici, mais en fait tout semble correct. Si on enlève
# les * de args/kwargs, il n'y a plus de warnings. Je suspecte un bug dans
# library/contextvars.po:238: warning: Incohérence : l’espace insécable à côté
# de l’espace sécable n’a pas d’effet. => ###ntexte sur lequel est appelée la
# méthode  »run*. Ren###
# library/contextvars.po:238: warning: Il manque un espace. => ###xte sur
# lequel est appelée la méthode  »run*. Renvoie###
# library/contextvars.po:238: warning: Mot inconnu : run => ###xte sur lequel
# est appelée la méthode  »run*. Renvoie###
#: library/contextvars.rst:156
"Execute ``callable(*args, **kwargs)`` code in the context object the *run* "
"method is called on.  Return the result of the execution or propagate an "
"exception if one occurred."
"Exécute le code ``callable(*args, **kwargs)`` dans le contexte défini par "
"l'objet. Renvoie le résultat de l'exécution ou propage une exception s'il y "
"en a une qui s'est produite."
#: library/contextvars.rst:160
"Any changes to any context variables that *callable* makes will be contained "
"in the context object::"
"Tout changement apporté aux variables de contexte effectué par *callable* "
"sera contenu dans l'objet de contexte ::"
#: library/contextvars.rst:163
"var = ContextVar('var')\n"
"var.set('spam')\n"
"def main():\n"
"    # 'var' was set to 'spam' before\n"
"    # calling 'copy_context()' and 'ctx.run(main)', so:\n"
"    # var.get() == ctx[var] == 'spam'\n"
"    var.set('ham')\n"
"    # Now, after setting 'var' to 'ham':\n"
"    # var.get() == ctx[var] == 'ham'\n"
"ctx = copy_context()\n"
"# Any changes that the 'main' function makes to 'var'\n"
"# will be contained in 'ctx'.\n"
"ctx.run(main)\n"
"# The 'main()' function was run in the 'ctx' context,\n"
"# so changes to 'var' are contained in it:\n"
"# ctx[var] == 'ham'\n"
"# However, outside of 'ctx', 'var' is still set to 'spam':\n"
"# var.get() == 'spam'"
#: library/contextvars.rst:189
"The method raises a :exc:`RuntimeError` when called on the same context "
"object from more than one OS thread, or when called recursively."
"La méthode lève une :exc:`RuntimeError` quand elle est appelée sur le même "
"objet de contexte depuis plus qu'un fil d'exécution ou quand elle est "
"appelée récursivement."
#: library/contextvars.rst:195
msgid "Return a shallow copy of the context object."
msgstr "Renvoie une copie superficielle de l'objet de contexte."
#: library/contextvars.rst:199
"Return ``True`` if the *context* has a value for *var* set; return ``False`` "
"otherwise."
"Renvoie ``True`` si le *context* a une valeur pour *var* ; sinon renvoie "
"``False``."
#: library/contextvars.rst:204
"Return the value of the *var* :class:`ContextVar` variable. If the variable "
"is not set in the context object, a :exc:`KeyError` is raised."
"Renvoie la valeur de la variable :class:`ContextVar` *var*. Si la variable "
"n'est pas définie dans l'objet de contexte, une :exc:`KeyError` est levée."
#: library/contextvars.rst:210
"Return the value for *var* if *var* has the value in the context object.  "
"Return *default* otherwise.  If *default* is not given, return ``None``."
"Renvoie la valeur de *var* si *var* possède une valeur dans l'objet de "
"contexte. Renvoie *default* sinon (ou ``None`` si *default* n'est pas donné)."
#: library/contextvars.rst:216
msgid "Return an iterator over the variables stored in the context object."
"Renvoie un itérateur sur les variables stockées dans l'objet de contexte."
#: library/contextvars.rst:221
msgid "Return the number of variables set in the context object."
msgstr "Renvoie le nombre de variables définies dans l'objet de contexte."
#: library/contextvars.rst:225
msgid "Return a list of all variables in the context object."
msgstr "Renvoie une liste de toutes les variables dans l'objet de contexte."
#: library/contextvars.rst:229
msgid "Return a list of all variables' values in the context object."
"Renvoie une liste de toutes les valeurs des variables dans l'objet de "
"contexte."
#: library/contextvars.rst:234
"Return a list of 2-tuples containing all variables and their values in the "
"context object."
"Renvoie une liste de paires contenant toutes les variables et leurs valeurs "
"dans l'objet de contexte."
#: library/contextvars.rst:239
msgid "asyncio support"
msgstr "Gestion avec *asyncio*"
#: library/contextvars.rst:241
"Context variables are natively supported in :mod:`asyncio` and are ready to "
"be used without any extra configuration.  For example, here is a simple echo "
"server, that uses a context variable to make the address of a remote client "
"available in the Task that handles that client::"
":mod:`asyncio` gère nativement les variables de contexte et elles sont "
"prêtes à être utilisées sans configuration supplémentaire. Par exemple, "
"voici un serveur *echo* simple qui utilise une variable de contexte pour que "
"l’adresse d'un client distant soit disponible dans le *Task* qui gère ce "
"client ::"
#: library/contextvars.rst:247
"import asyncio\n"
"import contextvars\n"
"client_addr_var = contextvars.ContextVar('client_addr')\n"
"def render_goodbye():\n"
"    # The address of the currently handled client can be accessed\n"
"    # without passing it explicitly to this function.\n"
"    client_addr = client_addr_var.get()\n"
"    return f'Good bye, client @ {client_addr}\\r\\n'.encode()\n"
"async def handle_request(reader, writer):\n"
"    addr = writer.transport.get_extra_info('socket').getpeername()\n"
"    client_addr_var.set(addr)\n"
"    # In any code that we call is now possible to get\n"
"    # client's address by calling 'client_addr_var.get()'.\n"
"    while True:\n"
"        line = await reader.readline()\n"
"        print(line)\n"
"        if not line.strip():\n"
"            break\n"
"    writer.write(b'HTTP/1.1 200 OK\\r\\n')  # status line\n"
"    writer.write(b'\\r\\n')  # headers\n"
"    writer.write(render_goodbye())  # body\n"
"    writer.close()\n"
"async def main():\n"
"    srv = await asyncio.start_server(\n"
"        handle_request, '127.0.0.1', 8081)\n"
"    async with srv:\n"
"        await srv.serve_forever()\n"
"asyncio.run(main())\n"
"# To test it you can use telnet or curl:\n"
"#     telnet 127.0.0.1 8081\n"
"#     curl 127.0.0.1:8081"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

contextvars.po

Latest commit

History

contextvars.po

File metadata and controls
