Файловый менеджер - Редактировать - /opt/imh-python/lib/python3.9/site-packages/zmq/eventloop/minitornado/__pycache__/stack_context.cpython-39.pyc
Ðазад
a a�ho3 � @ s� d Z ddlmZmZmZmZ ddlZddlZddlm Z G dd� de �ZG dd � d ej�Z e � ZG d d� de�ZG dd � d e�ZG dd� de�Zdd� Zdd� Zdd� Zdd� ZdS )a `StackContext` allows applications to maintain threadlocal-like state that follows execution as it moves to other execution contexts. The motivating examples are to eliminate the need for explicit ``async_callback`` wrappers (as in `tornado.web.RequestHandler`), and to allow some additional context to be kept for logging. This is slightly magic, but it's an extension of the idea that an exception handler is a kind of stack-local state and when that stack is suspended and resumed in a new context that state needs to be preserved. `StackContext` shifts the burden of restoring that state from each call site (e.g. wrapping each `.AsyncHTTPClient` callback in ``async_callback``) to the mechanisms that transfer control from one context to another (e.g. `.AsyncHTTPClient` itself, `.IOLoop`, thread pools, etc). Example usage:: @contextlib.contextmanager def die_on_error(): try: yield except Exception: logging.error("exception in asynchronous operation",exc_info=True) sys.exit(1) with StackContext(die_on_error): # Any exception thrown here *or in callback and its descendants* # will cause the process to exit instead of spinning endlessly # in the ioloop. http_client.fetch(url, callback) ioloop.start() Most applications shouldn't have to work with `StackContext` directly. Here are a few rules of thumb for when it's necessary: * If you're writing an asynchronous library that doesn't rely on a stack_context-aware library like `tornado.ioloop` or `tornado.iostream` (for example, if you're writing a thread pool), use `.stack_context.wrap()` before any asynchronous operations to capture the stack context from where the operation was started. * If you're writing an asynchronous library that has some shared resources (such as a connection pool), create those shared resources within a ``with stack_context.NullContext():`` block. This will prevent ``StackContexts`` from leaking from one request to another. * If you want to write something like an exception handler that will persist across asynchronous calls, create a new `StackContext` (or `ExceptionStackContext`), and make your asynchronous calls in a ``with`` block that references your `StackContext`. � )�absolute_import�division�print_function�with_statementN� )�raise_exc_infoc @ s e Zd ZdS )�StackContextInconsistentErrorN)�__name__� __module__�__qualname__� r r ��/root/rpmbuild/BUILDROOT/imh-python39-modules-3.9.7-92.el8.x86_64/opt/imh-python/lib/python3.9/site-packages/zmq/eventloop/minitornado/stack_context.pyr N s r c @ s e Zd Zdd� ZdS )�_Statec C s t � d f| _d S �N)�tuple�contexts��selfr r r �__init__S s z_State.__init__N)r r r r r r r r r R s r c @ s@ e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d� Zdd � Z dS )�StackContexta Establishes the given context as a StackContext that will be transferred. Note that the parameter is a callable that returns a context manager, not the context itself. That is, where for a non-transferable context manager you would say:: with my_context(): StackContext takes the function itself rather than its result:: with StackContext(my_context): The result of ``with StackContext() as cb:`` is a deactivation callback. Run this callback when the StackContext is no longer needed to ensure that it is not propagated any further (note that deactivating a context does not affect any instances of that context that are currently pending). This is an advanced feature and not necessary in most applications. c C s || _ g | _d| _d S �NT)�context_factoryr �active)r r r r r r l s zStackContext.__init__c C s d| _ d S �NF�r r r r r �_deactivateq s zStackContext._deactivatec C s | � � }| j�|� |�� d S r )r r �append� __enter__)r �contextr r r �enteru s zStackContext.enterc C s | j �� }|�|||� d S r )r �pop�__exit__)r �type�value� tracebackr r r r �exitz s zStackContext.exitc C sP t j| _| jd | f | f| _| jt _z| �� W n | jt _� Y n0 | jS �Nr )�_stater �old_contexts�new_contextsr r r r r r r � s zStackContext.__enter__c C sf z8| � |||� W tj}| jt_|| jur2td��d | _n(tj}| jt_|| jurZtd��d | _0 d S �NzWstack_context inconsistency (may be caused by yield within a "with StackContext" block))r% r'