OwlCyberSecurity - MANAGER
Edit File: selectors.cpython-310.pyc
o �?OgPL � @ s� d Z ddlmZmZ ddlmZ ddlmZ ddlZddl Z ddl Z dZ dZ dd � Z ed g d ��Zd e_ e jd krIdej_ dej_ dej_ dej_ G dd� de�ZG dd� ded�ZG dd� de�ZG dd� de�ZG dd � d e�Zee d �rG d d � d e�Zee d �r�G d!d"� d"e�Zee d#�r�G d$d%� d%e�Z ee d&�r�G d'd(� d(e�Z d)d*� Z e d&�r�e Z dS e d �r�eZ dS e d#�r�e Z dS e d �r�eZ dS eZ dS )+z|Selectors module. This module allows high-level and efficient I/O multiplexing, built upon the `select` module primitives. � )�ABCMeta�abstractmethod)� namedtuple)�MappingN� � c C s` t | t�r| }nzt| �� �}W n tttfy" td�| ��d�w |dk r.td�|���|S )z�Return a file descriptor from a file object. Parameters: fileobj -- file object or file descriptor Returns: corresponding file descriptor Raises: ValueError if the object is invalid zInvalid file object: {!r}Nr zInvalid file descriptor: {})� isinstance�int�fileno�AttributeError� TypeError� ValueError�format)�fileobj�fd� r �0/opt/alt/python310/lib64/python3.10/selectors.py�_fileobj_to_fd s ���r � SelectorKey)r r �events�dataz�SelectorKey(fileobj, fd, events, data) Object used to associate a file object to its backing file descriptor, selected event mask, and attached data. )� � zFile object registered.zUnderlying file descriptor.z3Events that must be waited for on this file object.zzOptional opaque data associated to this file object. For example, this could be used to store a per-client session ID.c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �_SelectorMappingz)Mapping of file objects to selector keys.c C s || _ d S �N)� _selector)�self�selectorr r r �__init__@ � z_SelectorMapping.__init__c C � t | jj�S r )�lenr � _fd_to_key�r r r r �__len__C � z_SelectorMapping.__len__c C s: z | j �|�}| j j| W S ty td�|��d �w �N�{!r} is not registered)r �_fileobj_lookupr" �KeyErrorr )r r r r r r � __getitem__F s �z _SelectorMapping.__getitem__c C r r )�iterr r" r# r r r �__iter__M r% z_SelectorMapping.__iter__N)�__name__� __module__� __qualname__�__doc__r r$ r* r, r r r r r = s r c @ sn e Zd ZdZeddd��Zedd� �Zddd�Zedd d ��Zd d � Z d d� Z edd� �Z dd� Z dd� Z dS )� BaseSelectora- Selector abstract base class. A selector supports registering file objects to be monitored for specific I/O events. A file object is a file descriptor or any object with a `fileno()` method. An arbitrary object can be attached to the file object, which can be used for example to store context information, a callback, etc. A selector can use various implementations (select(), poll(), epoll()...) depending on the platform. The default `Selector` class uses the most efficient implementation on the current platform. Nc C � t �)a3 Register a file object. Parameters: fileobj -- file object or file descriptor events -- events to monitor (bitwise mask of EVENT_READ|EVENT_WRITE) data -- attached data Returns: SelectorKey instance Raises: ValueError if events is invalid KeyError if fileobj is already registered OSError if fileobj is closed or otherwise is unacceptable to the underlying system call (if a system call is made) Note: OSError may or may not be raised ��NotImplementedError�r r r r r r r �register` s zBaseSelector.registerc C r2 )aj Unregister a file object. Parameters: fileobj -- file object or file descriptor Returns: SelectorKey instance Raises: KeyError if fileobj is not registered Note: If fileobj is registered but has since been closed this does *not* raise OSError (even if the wrapped syscall does) r3 )r r r r r � unregisterw � zBaseSelector.unregisterc C s | � |� | �|||�S )ay Change a registered file object monitored events or attached data. Parameters: fileobj -- file object or file descriptor events -- events to monitor (bitwise mask of EVENT_READ|EVENT_WRITE) data -- attached data Returns: SelectorKey instance Raises: Anything that unregister() or register() raises )r7 r6 r5 r r r �modify� s zBaseSelector.modifyc C r2 )aq Perform the actual selection, until some monitored file objects are ready or a timeout expires. Parameters: timeout -- if timeout > 0, this specifies the maximum wait time, in seconds if timeout <= 0, the select() call won't block, and will report the currently ready file objects if timeout is None, select() will block until a monitored file object becomes ready Returns: list of (key, events) for ready file objects `events` is a bitwise mask of EVENT_READ|EVENT_WRITE r3 )r �timeoutr r r �select� r8 zBaseSelector.selectc C s dS )zmClose the selector. This must be called to make sure that any underlying resource is freed. Nr r# r r r �close� s zBaseSelector.closec C sB | � � }|du r td��z|| W S ty td�|��d�w )zzReturn the key associated to a registered file object. Returns: SelectorKey for this file object NzSelector is closedr' )�get_map� RuntimeErrorr) r )r r �mappingr r r �get_key� s �zBaseSelector.get_keyc C r2 )z2Return a mapping of file objects to selector keys.r3 r# r r r r= � s zBaseSelector.get_mapc C s | S r r r# r r r � __enter__� s zBaseSelector.__enter__c G s | � � d S r )r< )r �argsr r r �__exit__� r% zBaseSelector.__exit__r )r- r. r/ r0 r r6 r7 r9 r; r< r@ r= rA rC r r r r r1 Q s r1 )� metaclassc @ sT e Zd ZdZdd� Zdd� Zddd�Zd d � Zdd d �Zd d� Z dd� Z dd� Z dS )�_BaseSelectorImplz Base selector implementation.c C s i | _ t| �| _d S r )r" r �_mapr# r r r r � s z_BaseSelectorImpl.__init__c C sD zt |�W S ty! | j�� D ]}|j|u r |j Y S q� w )al Return a file descriptor from a file object. This wraps _fileobj_to_fd() to do an exhaustive search in case the object is invalid but we still have it in our map. This is used by unregister() so we can unregister an object that was previously registered even if it is closed. It is also used by _SelectorMapping. )r r r" �valuesr r �r r �keyr r r r( � s ��z!_BaseSelectorImpl._fileobj_lookupNc C sb |r |t tB @ rtd�|���t|| �|�||�}|j| jv r)td�||j���|| j|j< |S )NzInvalid events: {!r}z"{!r} (FD {}) is already registered) � EVENT_READ� EVENT_WRITEr r r r( r r" r) �r r r r rI r r r r6 � s � z_BaseSelectorImpl.registerc C s8 z | j �| �|��}W |S ty td�|��d �w r& )r" �popr( r) r rH r r r r7 � s ��z _BaseSelectorImpl.unregisterc C s� z | j | �|� }W n ty td�|��d �w ||jkr-| �|� | �|||�}|S ||jkr>|j|d�}|| j |j < |S )Nr' )r ) r" r( r) r r r7 r6 r �_replacer rL r r r r9 � s � � z_BaseSelectorImpl.modifyc C s | j �� d | _d S r )r" �clearrF r# r r r r< s z_BaseSelectorImpl.closec C s | j S r )rF r# r r r r= s z_BaseSelectorImpl.get_mapc C s" z| j | W S ty Y dS w )z�Return the key associated to a given file descriptor. Parameters: fd -- file descriptor Returns: corresponding key, or None if not found N)r" r) )r r r r r � _key_from_fd s �z _BaseSelectorImpl._key_from_fdr ) r- r. r/ r0 r r( r6 r7 r9 r< r= rP r r r r rE � s rE c s` e Zd ZdZ� fdd�Zd� fdd� Z� fdd�Zejd kr$dd d �Z ne j Z dd d �Z � Z S )�SelectSelectorzSelect-based selector.c s t � �� t� | _t� | _d S r )�superr �set�_readers�_writersr# �� __class__r r r & s zSelectSelector.__init__Nc s@ t � �|||�}|t@ r| j�|j� |t@ r | j�|j� |S r )rR r6 rJ rT �addr rK rU rL rV r r r6 + s zSelectSelector.registerc s, t � �|�}| j�|j� | j�|j� |S r )rR r7 rT �discardr rU rH rV r r r7 3 s zSelectSelector.unregisterZwin32c C s$ t � ||||�\}}}||| g fS r )r; )r �r�w�_r: �xr r r �_select: s zSelectSelector._selectc C s� |d u rd nt |d�}g }z| �| j| jg |�\}}}W n ty' | Y S w t|�}t|�}||B D ]%}d}||v r@|tO }||v rH|tO }| �|�}|rY|� |||j @ f� q4|S �Nr ) �maxr^ rT rU �InterruptedErrorrS rJ rK rP �appendr ) r r: �readyrZ r[ r\ r r rI r r r r; @ s( � �zSelectSelector.selectr ) r- r. r/ r0 r r6 r7 �sys�platformr^ r; � __classcell__r r rV r rQ # s rQ c s^ e Zd ZdZdZdZdZ� fdd�Zd � fdd� Z� fdd�Z d � fd d � Z d d d �Z � Z S )�_PollLikeSelectorz<Base class shared between poll, epoll and devpoll selectors.Nc s t � �� | �� | _d S r )rR r � _selector_clsr r# rV r r r \ � z_PollLikeSelector.__init__c sd t � �|||�}d}|t@ r|| jO }|t@ r || jO }z | j�|j|� W |S t � �|� � r_ ) rR r6 rJ � _EVENT_READrK � _EVENT_WRITEr r r7 )r r r r rI Z poller_eventsrV r r r6 ` s � z_PollLikeSelector.registerc s6 t � �|�}z | j�|j� W |S ty Y |S w r )rR r7 r r �OSErrorrH rV r r r7 n s ��z _PollLikeSelector.unregisterc s� z | j | �|� }W n ty t|�d��d �w d}||jkrLd}|t@ r,|| jO }|t@ r5|| jO }z | j� |j |� W n t � � |� � d}||j krSd}|rb|j||d�}|| j |j < |S )Nz is not registeredFr T)r r )r" r( r) r rJ rj rK rk r r9 r rR r7 r rN )r r r r rI ZchangedZselector_eventsrV r r r9 x s0 � z_PollLikeSelector.modifyc C s� |d u rd }n|dkrd}nt �|d �}g }z| j�|�}W n ty* | Y S w |D ]+\}}d}|| j @ r=|tO }|| j @ rG|tO }| � |�}|rX|� |||j @ f� q-|S )Nr � @�@) �math�ceilr �pollra rj rK rk rJ rP rb r )r r: rc � fd_event_listr �eventr rI r r r r; � s, � �z_PollLikeSelector.selectr ) r- r. r/ r0 rh rj rk r r6 r7 r9 r; rf r r rV r rg V s rg rp c @ s" e Zd ZdZejZejZej Z dS )� PollSelectorzPoll-based selector.N) r- r. r/ r0 r; rp rh �POLLINrj �POLLOUTrk r r r r rs � s rs �epollc sD e Zd ZdZejZejZej Z dd� Z d dd�Z� fdd�Z � Z S ) � EpollSelectorzEpoll-based selector.c C � | j �� S r �r r r# r r r r � r zEpollSelector.filenoNc C s� |d u rd}n|dkrd}n t �|d �d }tt| j�d�}g }z | j�||�}W n ty5 | Y S w |D ]+\}}d}|tj @ rH|t O }|tj @ rR|t O }| � |�}|rc|�|||j@ f� q8|S )N���r rm g����MbP?r )rn ro r` r! r" r rp ra r; �EPOLLINrK �EPOLLOUTrJ rP rb r ) r r: �max_evrc rq r rr r rI r r r r; � s. � �zEpollSelector.selectc � | j �� t� �� d S r �r r< rR r# rV r r r< � ri zEpollSelector.closer )r- r. r/ r0 r; rv rh r{ rj r| rk r r< rf r r rV r rw � s rw �devpollc s: e Zd ZdZejZejZej Z dd� Z � fdd�Z � Z S )�DevpollSelectorzSolaris /dev/poll selector.c C rx r ry r# r r r r � r zDevpollSelector.filenoc r~ r r r# rV r r r< � ri zDevpollSelector.close)r- r. r/ r0 r; r� rh rt rj ru rk r r< rf r r rV r r� � s r� �kqueuec sX e Zd ZdZ� fdd�Zdd� Zd� fdd� Z� fd d �Zdd d �Z� fd d�Z � Z S )�KqueueSelectorzKqueue-based selector.c s t � �� t�� | _d S r )rR r r; r� r r# rV r r r � ri zKqueueSelector.__init__c C rx r ry r# r r r r r zKqueueSelector.filenoNc s� t � �|||�}z4|t@ r t�|jtjtj�}| j� |gdd� |t @ r:t�|jtj tj�}| j� |gdd� W |S W |S t � � |� � r_ ) rR r6 rJ r; �keventr �KQ_FILTER_READZ KQ_EV_ADDr �controlrK �KQ_FILTER_WRITEr7 )r r r r rI �kevrV r r r6 s$ � ��� zKqueueSelector.registerc s� t � �|�}|jt@ r*t�|jtjtj�}z | j � |gdd� W n t y) Y nw |jt @ rPt�|jtj tj�}z | j � |gdd� W |S t yO Y |S w |S r_ )rR r7 r rJ r; r� r r� Z KQ_EV_DELETEr r� rl rK r� )r r rI r� rV r r r7 s, � � � ��zKqueueSelector.unregisterc C s� |d u rd nt |d�}t t| j�d�}g }z | j�d ||�}W n ty* | Y S w |D ]-}|j}|j}d}|tj kr@|t O }|tj krI|t O }| � |�} | rZ|�| || j@ f� q-|S )Nr r )r` r! r" r r� ra Zident�filterr; r� rJ r� rK rP rb r ) r r: r} rc Zkev_listr� r �flagr rI r r r r; * s* � �zKqueueSelector.selectc r~ r r r# rV r r r< C ri zKqueueSelector.closer ) r- r. r/ r0 r r r6 r7 r; r< rf r r rV r r� � s r� c C sZ t t| d�}|du r dS z|� }| dkr |�d� W dS |�� W dS ty, Y dS w )zJCheck if we can use the selector depending upon the operating system. NFrp r T)�getattrr; rp r< rl )�methodr Z selector_objr r r �_can_useH s � �r� ) r0 �abcr r � collectionsr Zcollections.abcr rn r; rd rJ rK r r � version_infor r r r r r1 rE rQ rg �hasattrrs rw r� r� r� ZDefaultSelectorr r r r �<module> sP ~T3 Z . M