CasperSecurity
o
�b
� @ s� d Z ddlmZ G dd� de�ZG dd� d�ZG dd� d�ZG d d
� d
�ZG d d � d e�Z G d
d� de�Z
G dd� de
�Z G dd� de
�Z dS )zf
Twisted Python Roots: an abstract hierarchy representation for Twisted.
Maintainer: Glyph Lefkowitz
� )�reflectc @ � e Zd ZdZdS )�NotSupportedErrorzv
An exception meaning that the tree-manipulation operation
you're attempting to perform is not supported.
N��__name__�
__module__� __qualname__�__doc__� r
r
�6/usr/lib/python3/dist-packages/twisted/python/roots.pyr � r c @ s$ e Zd ZdZdZdd� Zdd� ZdS )�Requestz�I am an abstract representation of a request for an entity.
I also function as the response. The request is responded to by calling
self.write(data) until there is no data left and then calling
self.finish().
Nc C � t dt�| j� ��)z.Add some data to the response to this request.z%s.write��NotImplementedErrorr �qual� __class__)�self�datar
r
r �write" � z
Request.writec C r )zOThe response to this request is finished; flush all data to the network stream.z %s.finishr �r r
r
r �finish& r zRequest.finish)r r r r � wireProtocolr r r
r
r
r r
s
r
c @ s e Zd ZdZdd� ZdS )�EntityaZ I am a terminal object in a hierarchy, with no children.
I represent a null interface; certain non-instance objects (strings and
integers, notably) are Entities.
Methods on this class are suggested to be implemented, but are not
required, and will be emulated on a per-protocol basis for types which do
not handle them.
c C r )zw
I produce a stream of bytes for the request, by calling request.write()
and request.finish().
z %s.renderr �r �requestr
r
r �render6 s z
Entity.renderN)r r r r r r
r
r
r r + s
r c @ s� e Zd ZdZd dd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd � Zd d � ZdS ) �
Collectionz�I represent a static collection of entities.
I contain methods designed to represent collections that can be dynamically
created.
Nc C s |dur || _ dS i | _ dS )zInitialize me.N��entities)r r r
r
r �__init__E s
zCollection.__init__c C s | j �|�S )zqGet an entity that was added to me using putEntity.
This method will return 'None' if it fails.
)r �get�r �namer
r
r �getStaticEntityL � zCollection.getStaticEntityc C � dS )znSubclass this to generate an entity on demand.
This method should return 'None' if it fails.
Nr
�r r$ r r
r
r �getDynamicEntityS s zCollection.getDynamicEntityc C s2 | � |�}|dur |S | �||�}|dur|S dS )a Retrieve an entity from me.
I will first attempt to retrieve an entity statically; static entities
will obscure dynamic ones. If that fails, I will retrieve the entity
dynamically.
If I cannot retrieve an entity, I will return 'None'.
N)r% r) )r r$ r �entr
r
r � getEntityY s
zCollection.getEntityc C s || j |< dS )zlStore a static reference on 'name' for 'entity'.
Raises a KeyError if the operation fails.
Nr �r r$ �entityr
r
r � putEntityj s zCollection.putEntityc C s | j |= dS )zaRemove a static reference for 'name'.
Raises a KeyError if the operation fails.
Nr r# r
r
r � delEntityq r& zCollection.delEntityc C r )z>Store an entity for 'name', based on the content of 'request'.z%s.storeEntity�r r r r r( r
r
r � storeEntityx r zCollection.storeEntityc C r )z?Remove an entity for 'name', based on the content of 'request'.z%s.removeEntityr0 r( r
r
r � removeEntity| r zCollection.removeEntityc C �
| j �� S )zlRetrieve a list of all name, entity pairs that I store references to.
See getStaticEntity.
)r �itemsr r
r
r �listStaticEntities� �
z Collection.listStaticEntitiesc C � g S )zaA list of all name, entity that I can generate on demand.
See getDynamicEntity.
r
r r
r
r �listDynamicEntities� � z Collection.listDynamicEntitiesc C s | � � | �|� S )zURetrieve a list of all name, entity pairs I contain.
See getEntity.
)r5 r8 r r
r
r � listEntities� s zCollection.listEntitiesc C r3 )zkRetrieve a list of the names of entities that I store references to.
See getStaticEntity.
)r �keysr r
r
r �listStaticNames� r6 zCollection.listStaticNamesc C r7 )zlRetrieve a list of the names of entities that I store references to.
See getDynamicEntity.
r
r r
r
r �listDynamicNames� r9 zCollection.listDynamicNamesc C s | � � S )zZRetrieve a list of all names for entities that I contain.
See getEntity.
)r< r r
r
r � listNames� s zCollection.listNames�N)r r r r r! r% r) r+ r. r/ r1 r2 r5 r8 r: r< r= r> r
r
r
r r > s
r c @ r )�ConstraintViolationz2An exception raised when a constraint is violated.Nr r
r
r
r r@ � r r@ c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
S ) � Constrainedz?A collection that has constraints on its names and/or entities.c C r' )z�A method that determines whether an entity may be added to me with a given name.
If the constraint is satisfied, return 1; if the constraint is not
satisfied, either return 0 or raise a descriptive ConstraintViolation.
� r
r# r
r
r �nameConstraint� � zConstrained.nameConstraintc C r' )z�A method that determines whether an entity may be added to me.
If the constraint is satisfied, return 1; if the constraint is not
satisfied, either return 0 or raise a descriptive ConstraintViolation.
rB r
�r r- r
r
r �entityConstraint� rD z Constrained.entityConstraintc C s t �| ||� d S r? )r r. r, r
r
r �reallyPutEntity� s zConstrained.reallyPutEntityc C s4 | � |�r| �|�r| �||� dS td��td��)zfStore an entity if it meets both constraints.
Otherwise raise a ConstraintViolation.
zEntity constraint violated.zName constraint violated.N)rC rF rG r@ r, r
r
r r. � s
zConstrained.putEntityN)r r r r rC rF rG r. r
r
r
r rA � s rA c @ s$ e Zd ZdZdZdd� Zdd� ZdS )�Lockedz5A collection that can be locked from adding entities.r c C s
d| _ d S )NrB ��lockedr r
r
r �lock� s
z Locked.lockc C s | j S r? rI rE r
r
r rF � � zLocked.entityConstraintN)r r r r rJ rK rF r
r
r
r rH � s
rH c @ s, e Zd ZdZeZdd� Zdd� Zdd� ZdS ) �
Homogenousz�A homogenous collection of entities.
I will only contain entities that are an instance of the class or type
specified by my 'entityType' attribute.
c C s& t || j�rdS t|� d| j� d���)NrB z of incorrect type (�))�
isinstance�
entityTyper@ rE r
r
r rF � s zHomogenous.entityConstraintc C r' )N�Namer
r r
r
r � getNameType� s zHomogenous.getNameTypec C s | j jS r? )rP r r r
r
r �
getEntityType� rL zHomogenous.getEntityTypeN) r r r r �objectrP rF rR rS r
r
r
r rM � s rM N)
r �twisted.pythonr r r r
r r � Exceptionr@ rA rH rM r
r
r
r �<module> s m$