U  W[@sdZddlmZmZddlmZddlmZGdddeZ eGdddZ eGd d d Z eGd d d Z Gd dde ZGddde ZGdddeZGdddeZdS)zf Twisted Python Roots: an abstract hierarchy representation for Twisted. Maintainer: Glyph Lefkowitz )absolute_importdivision)reflect) _oldStylec@seZdZdZdS)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.pyrsrc@s$eZdZdZdZddZddZdS)RequestzI 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(). NcCstdt|jdS)z7Add some data to the response to this request. z%s.writeNNotImplementedErrorrqual __class__)selfdatar r r write%sz Request.writecCstdt|jdS)zXThe response to this request is finished; flush all data to the network stream. z %s.finishNrrr r r finish*szRequest.finish)rr r r Z wireProtocolrrr r r r rsrc@seZdZdZddZdS)EntityaZI 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. cCstdt|jdS)zw I produce a stream of bytes for the request, by calling request.write() and request.finish(). z %s.renderNrrrequestr r r render<sz Entity.renderN)rr r r rr r r r r1s rc@seZdZdZdddZddZddZd d Zd d Zd dZ ddZ ddZ ddZ ddZ ddZddZddZddZdS) CollectionzI represent a static collection of entities. I contain methods designed to represent collections that can be dynamically created. NcCs|dk r||_ni|_dS)zInitialize me. Nentities)rrr r r __init__MszCollection.__init__cCs |j|S)zqGet an entity that was added to me using putEntity. This method will return 'None' if it fails. )rgetrnamer r r getStaticEntityUszCollection.getStaticEntitycCsdS)znSubclass this to generate an entity on demand. This method should return 'None' if it fails. Nr rr"rr r r getDynamicEntity\szCollection.getDynamicEntitycCs2||}|dk r|S|||}|dk r.|SdS)aRetrieve 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%)rr"rZentr r r getEntitybs  zCollection.getEntitycCs||j|<dS)zlStore a static reference on 'name' for 'entity'. Raises a KeyError if the operation fails. Nrrr"entityr r r putEntitysszCollection.putEntitycCs |j|=dS)zaRemove a static reference for 'name'. Raises a KeyError if the operation fails. Nrr!r r r delEntityzszCollection.delEntitycCstdt|jdS)zGStore an entity for 'name', based on the content of 'request'. z%s.storeEntityNrrrrr$r r r storeEntityszCollection.storeEntitycCstdt|jdS)zHRemove an entity for 'name', based on the content of 'request'. z%s.removeEntityNr+r$r r r removeEntityszCollection.removeEntitycCs |jS)zlRetrieve a list of all name, entity pairs that I store references to. See getStaticEntity. )ritemsrr r r listStaticEntitiesszCollection.listStaticEntitiescCsgS)zaA list of all name, entity that I can generate on demand. See getDynamicEntity. r rr r r listDynamicEntitiesszCollection.listDynamicEntitiescCs|||S)zURetrieve a list of all name, entity pairs I contain. See getEntity. )r/r0rr r r listEntitiesszCollection.listEntitiescCs |jS)zkRetrieve a list of the names of entities that I store references to. See getStaticEntity. )rkeysrr r r listStaticNamesszCollection.listStaticNamescCsgS)zlRetrieve a list of the names of entities that I store references to. See getDynamicEntity. r rr r r listDynamicNamesszCollection.listDynamicNamescCs|S)zZRetrieve a list of all names for entities that I contain. See getEntity. )r3rr r r listNamesszCollection.listNames)N)rr r r rr#r%r&r)r*r,r-r/r0r1r3r4r5r r r r rEs rc@seZdZdZdS)ConstraintViolationz7An exception raised when a constraint is violated. Nrr r r r r6sr6c@s0eZdZdZddZddZddZdd Zd S) Constrainedz?A collection that has constraints on its names and/or entities.cCsdS)zA 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 nameConstraintszConstrained.nameConstraintcCsdS)zA 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. r8r rr(r r r entityConstraintszConstrained.entityConstraintcCst|||dSN)rr)r'r r r reallyPutEntityszConstrained.reallyPutEntitycCs8||r,||r"|||q4tdntddS)zfStore an entity if it meets both constraints. Otherwise raise a ConstraintViolation. zEntity constraint violated.zName constraint violated.N)r9r;r=r6r'r r r r)s    zConstrained.putEntityN)rr r r r9r;r=r)r r r r r7s r7c@s$eZdZdZdZddZddZdS)Lockedz5A collection that can be locked from adding entities.rcCs d|_dS)Nr8lockedrr r r locksz Locked.lockcCs|j Sr<r?r:r r r r;szLocked.entityConstraintN)rr r r r@rAr;r r r r r>sr>c@s,eZdZdZeZddZddZddZdS) HomogenouszA homogenous collection of entities. I will only contain entities that are an instance of the class or type specified by my 'entityType' attribute. cCs&t||jrdStd||jfdS)Nr8z%s of incorrect type (%s)) isinstance entityTyper6r:r r r r;s  zHomogenous.entityConstraintcCsdS)NNamer rr r r getNameTypeszHomogenous.getNameTypecCs|jjSr<)rDrrr r r getEntityTypeszHomogenous.getEntityTypeN) rr r r objectrDr;rFrGr r r r rBs rBN)r Z __future__rrZtwisted.pythonrZtwisted.python._oldstylerrrrrr Exceptionr6r7r>rBr r r r s  r$