+ IicsRt^RIHt^RIHt^RIHt^RIHtH t ^RI H t ]!RR44t ]!R4t R tR tR t]RR l4tRRltR #)z NOTE: All classes and functions in this module are considered private and are subject to abrupt breaking changes. Please do not use them directly. )contextmanager) ContextVar)deepcopy) dataclassfieldwrapscsBa]tRt^toRt]!]R7tV3RltRt Vt R#) ClientContextz Encapsulation of objects tracked within the ``_context`` context variable. ``features`` is a set responsible for storing features used during preparation of an AWS request. ``botocore.useragent.register_feature_id`` is used to add to this set. )Zdefault_factorycs6<V^8dQh/S[S[,;R&#)ifeatures)setZstr)Zformat __classdict__s"5/usr/lib/python3.14/site-packages/botocore/context.pyZ __annotate__ZClientContext.__annotate__s#h3N) Z__name__Z __module__Z __qualname__Z__firstlineno____doc__rr rZ__annotate_func__Z__static_attributes__Z__classdictcell__)r s@r rrss3Hr r_contextcs,\PR4#)z@Get the current ``_context`` context variable if set, else None.N)rZgetr r r get_contextr)s << r cs0\PV4pV#)aSet the current ``_context`` context variable. :type ctx: ClientContext :param ctx: Client context object to set as the current context variable. :rtype: contextvars.Token :returns: Token object used to revert the context variable to what it was before the corresponding set. )rr )ctxtokens& r set_contextr.s LL E Lr cs0\PV4R#)zReset the current ``_context`` context variable. :type token: contextvars.Token :param token: Token object to reset the context variable. N)rZreset)rs&r reset_contextr<s  NN5r Nc#s"T;'g \4pVf \4pM \V4p\V4pRx\ V4R# \ T4i;i5i)aO Context manager that copies the passed or current context object and sets it as the current context variable. If no context is found, a new ``ClientContext`` object is created. It mainly ensures the context variable is reset to the previous value once the executed code returns. Example usage: def my_feature(): with start_as_current_context(): register_feature_id('MY_FEATURE') pass :type ctx: ClientContext :param ctx: The client context object to set as the new context variable. If not provided, the current or a new context variable is used. N)rrrrr)rZcurrentZnewrs& r start_as_current_contextrEsN&""[]Gow  E e es:AA A AAcsaV3RlpV#)a Decorator that wraps ``start_as_current_context`` and optionally invokes a hook within the newly-set context. This is just syntactic sugar to avoid indenting existing code under the context manager. Example usage: @with_current_context(partial(register_feature_id, 'MY_FEATURE')) def my_feature(): pass :type hook: callable :param hook: A callable that will be invoked within the scope of the ``start_as_current_context`` context manager. cs4<a\S4VV3Rl4pV#)cs<\4;_uu_4S'dS!4S!V/VBuuRRR4# +'giR#;iN)r)ZargsZkwargsfunchooks*,r wrapperZ8with_current_context..decorator..wrappervs0)++FT,V,,+++s 6 A r)rrrsf r decoratorZ'with_current_context..decoratorus t -  - r r )rrsf r with_current_contextrds" r r)rZ contextlibrZ contextvarsrZcopyrZ dataclassesrrZ functoolsrrrrrrrrr r r rsh &"(  4 4  4 j ! <r