# Copyright (C) 2001-2018, Python Software Foundation # For licence information, see README file. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2018-06-28 15:29+0200\n" "PO-Revision-Date: 2018-07-03 10:53+0200\n" "Last-Translator: Julien Palard \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/contextvars.rst:2 msgid ":mod:`contextvars` --- Context Variables" msgstr "" #: ../Doc/library/contextvars.rst:11 msgid "" "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." msgstr "" #: ../Doc/library/contextvars.rst:17 msgid "" "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." msgstr "" #: ../Doc/library/contextvars.rst:21 msgid "See also :pep:`567` for additional details." msgstr "" #: ../Doc/library/contextvars.rst:27 msgid "Context Variables" msgstr "" #: ../Doc/library/contextvars.rst:31 msgid "This class is used to declare a new Context Variable, e.g.::" msgstr "" #: ../Doc/library/contextvars.rst:35 msgid "" "The required *name* parameter is used for introspection and debug purposes." msgstr "" #: ../Doc/library/contextvars.rst:38 msgid "" "The optional keyword-only *default* parameter is returned by :meth:" "`ContextVar.get` when no value for the variable is found in the current " "context." msgstr "" #: ../Doc/library/contextvars.rst:42 msgid "" "**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." msgstr "" #: ../Doc/library/contextvars.rst:49 msgid "The name of the variable. This is a read-only property." msgstr "" #: ../Doc/library/contextvars.rst:53 msgid "Return a value for the context variable for the current context." msgstr "" #: ../Doc/library/contextvars.rst:55 msgid "" "If there is no value for the variable in the current context, the method " "will:" msgstr "" #: ../Doc/library/contextvars.rst:58 msgid "" "return the value of the *default* argument of the method, if provided; or" msgstr "" #: ../Doc/library/contextvars.rst:61 msgid "" "return the default value for the context variable, if it was created with " "one; or" msgstr "" #: ../Doc/library/contextvars.rst:64 msgid "raise a :exc:`LookupError`." msgstr "" #: ../Doc/library/contextvars.rst:68 msgid "" "Call to set a new value for the context variable in the current context." msgstr "" #: ../Doc/library/contextvars.rst:71 msgid "" "The required *value* argument is the new value for the context variable." msgstr "" #: ../Doc/library/contextvars.rst:74 msgid "" "Returns a :class:`~contextvars.Token` object that can be used to restore the " "variable to its previous value via the :meth:`ContextVar.reset` method." msgstr "" #: ../Doc/library/contextvars.rst:80 msgid "" "Reset the context variable to the value it had before the :meth:`ContextVar." "set` that created the *token* was used." msgstr "" #: ../Doc/library/contextvars.rst:83 msgid "For example::" msgstr "Par exemple ::" #: ../Doc/library/contextvars.rst:97 msgid "" "*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*." msgstr "" #: ../Doc/library/contextvars.rst:104 msgid "" "A read-only property. Points to the :class:`ContextVar` object that created " "the token." msgstr "" #: ../Doc/library/contextvars.rst:109 msgid "" "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` is the variable was not set before the call." msgstr "" #: ../Doc/library/contextvars.rst:116 msgid "A marker object used by :attr:`Token.old_value`." msgstr "" #: ../Doc/library/contextvars.rst:120 msgid "Manual Context Management" msgstr "" #: ../Doc/library/contextvars.rst:124 msgid "Returns a copy of the current :class:`~contextvars.Context` object." msgstr "" #: ../Doc/library/contextvars.rst:126 msgid "" "The following snippet gets a copy of the current context and prints all " "variables and their values that are set in it::" msgstr "" #: ../Doc/library/contextvars.rst:132 msgid "" "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 them." msgstr "" #: ../Doc/library/contextvars.rst:139 msgid "A mapping of :class:`ContextVars ` to their values." msgstr "" #: ../Doc/library/contextvars.rst:141 msgid "" "``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." msgstr "" #: ../Doc/library/contextvars.rst:145 msgid "Context implements the :class:`collections.abc.Mapping` interface." msgstr "" #: ../Doc/library/contextvars.rst:149 msgid "" "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." msgstr "" #: ../Doc/library/contextvars.rst:153 msgid "" "Any changes to any context variables that *callable* makes will be contained " "in the context object::" msgstr "" #: ../Doc/library/contextvars.rst:182 msgid "" "The method raises a :exc:`RuntimeError` when called on the same context " "object from more than one OS thread, or when called recursively." msgstr "" #: ../Doc/library/contextvars.rst:188 msgid "Return a shallow copy of the context object." msgstr "" #: ../Doc/library/contextvars.rst:192 msgid "" "Return ``True`` if the *context* has a value for *var* set; return ``False`` " "otherwise." msgstr "" #: ../Doc/library/contextvars.rst:197 msgid "" "Return the value of the *var* :class:`ContextVar` variable. If the variable " "is not set in the context object, a :exc:`KeyError` is raised." msgstr "" #: ../Doc/library/contextvars.rst:203 msgid "" "Return the value for *var* if *var* has the value in the context object. " "Return *default* otherwise. If *default* is not given, return ``None``." msgstr "" #: ../Doc/library/contextvars.rst:209 msgid "Return an iterator over the variables stored in the context object." msgstr "" #: ../Doc/library/contextvars.rst:214 msgid "Return the number of variables set in the context object." msgstr "" #: ../Doc/library/contextvars.rst:218 msgid "Return a list of all variables in the context object." msgstr "" #: ../Doc/library/contextvars.rst:222 msgid "Return a list of all variables' values in the context object." msgstr "" #: ../Doc/library/contextvars.rst:227 msgid "" "Return a list of 2-tuples containing all variables and their values in the " "context object." msgstr "" #: ../Doc/library/contextvars.rst:232 msgid "asyncio support" msgstr "" #: ../Doc/library/contextvars.rst:234 msgid "" "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::" msgstr ""