← Back
Editing: roots.cpython-38.pyc
U W[� � @ s� d Z ddlmZmZ ddlmZ ddlmZ G dd� de�Z eG dd� d��Z eG d d � d ��Z eG d d � d ��Z G d d� de �ZG dd� de �ZG dd� de�ZG dd� de�ZdS )zf Twisted Python Roots: an abstract hierarchy representation for Twisted. Maintainer: Glyph Lefkowitz � )�absolute_import�division)�reflect)� _oldStylec @ s 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 s 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 s t dt�| j� ��dS )z7Add some data to the response to this request. z%s.writeN��NotImplementedErrorr �qual� __class__)�self�datar r r �write% s z Request.writec C s t dt�| j� ��dS )zXThe response to this request is finished; flush all data to the network stream. z %s.finishNr �r r r r �finish* s zRequest.finish)r r r r Z 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 s t dt�| j� ��dS )zw I produce a stream of bytes for the request, by calling request.write() and request.finish(). z %s.renderNr �r �requestr r r �render< s z Entity.renderN)r r r r r r r r r r 1 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 |dk r|| _ ni | _ dS )zInitialize me. N��entities)r r r r r �__init__M 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 �getStaticEntityU s zCollection.getStaticEntityc C s dS )znSubclass this to generate an entity on demand. This method should return 'None' if it fails. Nr �r r" r r r r �getDynamicEntity\ s zCollection.getDynamicEntityc C s2 | � |�}|dk r|S | �||�}|dk r.|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 Zentr r r � getEntityb 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 � putEntitys 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 � delEntityz s zCollection.delEntityc C s t dt�| j� ��dS )zGStore an entity for 'name', based on the content of 'request'. z%s.storeEntityN�r r r r r$ r r r � storeEntity� s zCollection.storeEntityc C s t dt�| j� ��dS )zHRemove an entity for 'name', based on the content of 'request'. z%s.removeEntityNr+ r$ r r r � removeEntity� s zCollection.removeEntityc C s | j �� S )zlRetrieve a list of all name, entity pairs that I store references to. See getStaticEntity. )r �itemsr r r r �listStaticEntities� s z Collection.listStaticEntitiesc C s g S )zaA list of all name, entity that I can generate on demand. See getDynamicEntity. r r r r r �listDynamicEntities� s z Collection.listDynamicEntitiesc C s | � � | �|� S )zURetrieve a list of all name, entity pairs I contain. See getEntity. )r/ r0 r r r r � listEntities� s zCollection.listEntitiesc C s | j �� S )zkRetrieve a list of the names of entities that I store references to. See getStaticEntity. )r �keysr r r r �listStaticNames� s zCollection.listStaticNamesc C s g S )zlRetrieve a list of the names of entities that I store references to. See getDynamicEntity. r r r r r �listDynamicNames� s zCollection.listDynamicNamesc C s | � � S )zZRetrieve a list of all names for entities that I contain. See getEntity. )r3 r r r r � listNames� s zCollection.listNames)N)r r r r r r# r% r& r) r* r, r- r/ r0 r1 r3 r4 r5 r r r r r E s r c @ s e Zd ZdZdS )�ConstraintViolationz7An exception raised when a constraint is violated. Nr r r r r r6 � s r6 c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) � Constrainedz?A collection that has constraints on its names and/or entities.c C s dS )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� s zConstrained.nameConstraintc C s dS )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. r8 r �r r( r r r �entityConstraint� s z Constrained.entityConstraintc C s t �| ||� d S �N)r r) r' r r r �reallyPutEntity� s zConstrained.reallyPutEntityc C s8 | � |�r,| �|�r"| �||� q4td��ntd��dS )zfStore an entity if it meets both constraints. Otherwise raise a ConstraintViolation. zEntity constraint violated.zName constraint violated.N)r9 r; r= r6 r' r r r r) � s zConstrained.putEntityN)r r r r r9 r; r= r) r r r r r7 � s r7 c @ s$ e Zd ZdZdZdd� Zdd� ZdS )�Lockedz5A collection that can be locked from adding entities.r c C s d| _ d S )Nr8 ��lockedr r r r �lock� s z Locked.lockc C s | j S r< r? r: r r r r; � s zLocked.entityConstraintN)r r r r r@ rA r; r r r r r> � s r> 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 td|| jf ��d S )Nr8 z%s of incorrect type (%s))� isinstance� entityTyper6 r: r r r r; � s �zHomogenous.entityConstraintc C s dS )N�Namer r r r r � getNameType� s zHomogenous.getNameTypec C s | j jS r< )rD r r r r r � getEntityType s zHomogenous.getEntityTypeN) r r r r �objectrD r; rF rG r r r r rB � s rB N)r Z __future__r r Ztwisted.pythonr Ztwisted.python._oldstyler r r r r r � Exceptionr6 r7 r> rB r r r r �<module> s r$
Save File
Cancel