|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/asgiref/__pycache__/ |
Upload File : |
o
�6�au � @ sH d dl Z d dlZd dlZd dlZddlmZ e�e�ZG dd� d�Z dS )� N� )�guarantee_single_callablec @ s^ e Zd ZdZdZddd�Zdd� Zdd � Zd
d � Zd d
� Z dd� Z
dd� Z dd� Z dd� Z
dS )�StatelessServerax
Base server class that handles basic concepts like application instance
creation/pooling, exception handling, and similar, for stateless protocols
(i.e. ones without actual incoming connections to the process)
Your code should override the handle() method, doing whatever it needs to,
and calling get_or_create_application_instance with a unique `scope_id`
and `scope` for the scope it wants to get.
If an application instance is found with the same `scope_id`, you are
given its input queue, otherwise one is made for you with the scope provided
and you are given that fresh new input queue. Either way, you should do
something like:
input_queue = self.get_or_create_application_instance(
"user-123456",
{"type": "testprotocol", "user_id": "123456", "username": "andrew"},
)
input_queue.put_nowait(message)
If you try and create an application instance and there are already
`max_application` instances, the oldest/least recently used one will be
reclaimed and shut down to make space.
Application coroutines that error will be found periodically (every 100ms
by default) and have their exceptions printed to the console. Override
application_exception() if you want to do more when this happens.
If you override run(), make sure you handle things like launching the
application checker.
g�������?�� c C s || _ || _i | _d S �N)� application�max_applications�application_instances)�selfr r � r �0/usr/lib/python3/dist-packages/asgiref/server.py�__init__. s
zStatelessServer.__init__c C sJ t �� }t �| �� � z
|�| �� � W dS ty$ t�d� Y dS w )zD
Runs the asyncio event loop with our handler loop.
z Exiting due to Ctrl-C/interruptN) �asyncio�get_event_loop�
ensure_future�application_checker�run_until_complete�handle�KeyboardInterrupt�logger�info)r
�
event_loopr r r �run7 s �zStatelessServer.runc � �
�t d��)NzYou must implement handle()��NotImplementedError)r
r r r r B s �zStatelessServer.handlec � r )zM
Receives outbound sends from applications and handles them.
z%You must implement application_send()r )r
�scope�messager r r �application_sendE s �z StatelessServer.application_sendc s� |�j v rt�� �j | d< �j | d S t�j ��jkr)��� t�j ��jks t�� }t�j�}t� |� |j
� �fdd�d��}||� t�� d��j |< |S )zH
Creates an application instance and returns its queue.
� last_used� input_queuec s �� � | �S r )r )r �r r
r r �<lambda>_ s zDStatelessServer.get_or_create_application_instance.<locals>.<lambda>)r �receive�send)r �futurer r ) r �time�lenr �"delete_oldest_application_instancer �Queuer r r �get)r
�scope_idr r �application_instancer% r r! r �"get_or_create_application_instanceM s*
�
�� �z2StatelessServer.get_or_create_application_instancec C sL t dd� | j�� D ��}| j�� D ]\}}|d |kr#| �|� dS qdS )zC
Finds and deletes the oldest application instance
c s s � | ]}|d V qdS )r Nr )�.0�detailsr r r � <genexpr>n s �
�zEStatelessServer.delete_oldest_application_instance.<locals>.<genexpr>r N)�minr �values�items�delete_application_instance)r
� oldest_timer+ r/ r r r r( j s �
��z2StatelessServer.delete_oldest_application_instancec C s2 | j | }| j |= |d �� s|d �� dS dS )z�
Removes an application instance (makes sure its task is stopped,
then removes it from the current set)
r% N)r �done�cancel)r
r+ r/ r r r r4 x s
�z+StatelessServer.delete_application_instancec � s~ � t �| j�I dH t| j�� �D ]+\}}|d �� r=|d �� }|r-| �||�I dH z| j|= W q t y< Y qw qq)z�
Goes through the set of current application instance Futures and cleans up
any that are done/prints exceptions for any that errored.
TNr% )
r �sleep� application_checker_interval�listr r3 r6 � exception�application_exception�KeyError)r
r+ r/ r; r r r r � s � ���z#StatelessServer.application_checkerc � s* �t �d|d�t�|j��d|� �� dS )zL
Called whenever an application coroutine has an exception.
z%Exception inside application: %s
%s%s� z N)�logging�error�join� traceback� format_tb�
__traceback__)r
r; �application_detailsr r r r< � s ��z%StatelessServer.application_exceptionN)r )�__name__�
__module__� __qualname__�__doc__r9 r
r r r r- r( r4 r r< r r r r r s
r )
r r? r& rB �
compatibilityr � getLoggerrF r r r r r r �<module> s