\d dZddlmZGddeZGddZGddZGd d ZGd d eZ Gd deZ Gdde Z Gdde Z dS)zf Twisted Python Roots: an abstract hierarchy representation for Twisted. Maintainer: Glyph Lefkowitz )reflectceZdZdZdS)NotSupportedErrorzv An exception meaning that the tree-manipulation operation you're attempting to perform is not supported. N__name__ __module__ __qualname____doc__4lib/python3.11/site-packages/twisted/python/roots.pyrrsr rc"eZdZdZdZdZdZdS)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(). NcTtdtj|jz)z.Add some data to the response to this request.z%s.writeNotImplementedErrorrqual __class__)selfdatas r writez Request.write"s!!*w|DN/K/K"KLLLr cTtdtj|jz)zOThe response to this request is finished; flush all data to the network stream.z %s.finishrrs r finishzRequest.finish&s!!+ T^0L0L"LMMMr )rrr r wireProtocolrrr r r rrsKLMMMNNNNNr rceZdZdZdZdS)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. cTtdtj|jz)zw I produce a stream of bytes for the request, by calling request.write() and request.finish(). z %s.renderrrrequests r renderz Entity.render6s# "+ T^0L0L"LMMMr N)rrr r r!r r r rr+s2NNNNNr rcheZdZdZddZdZdZdZdZdZ d Z d Z d Z d Z d ZdZdZdZdS) CollectionzI represent a static collection of entities. I contain methods designed to represent collections that can be dynamically created. Nc*| ||_dSi|_dS)zInitialize me.Nentities)rr&s r __init__zCollection.__init__Es  $DMMMDMMMr c6|j|S)zqGet an entity that was added to me using putEntity. This method will return 'None' if it fails. )r&getrnames r getStaticEntityzCollection.getStaticEntityLs }  &&&r cdS)znSubclass this to generate an entity on demand. This method should return 'None' if it fails. Nr rr+r s r getDynamicEntityzCollection.getDynamicEntitySsr cl||}||S|||}||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+r ents r getEntityzCollection.getEntityYsE""4(( ?J##D'22 ?Jtr c||j|<dS)zlStore a static reference on 'name' for 'entity'. Raises a KeyError if the operation fails. Nr%rr+entitys r putEntityzCollection.putEntityjs % dr c|j|=dS)zaRemove a static reference for 'name'. Raises a KeyError if the operation fails. Nr%r*s r delEntityzCollection.delEntityqs M$   r cTtdtj|jz)z>Store an entity for 'name', based on the content of 'request'.z%s.storeEntityrrrrr.s r storeEntityzCollection.storeEntityxs" 07<3O3O OPPPr cTtdtj|jz)z?Remove an entity for 'name', based on the content of 'request'.z%s.removeEntityr:r.s r removeEntityzCollection.removeEntity|s" 1GL4P4P PQQQr c4|jS)zlRetrieve a list of all name, entity pairs that I store references to. See getStaticEntity. )r&itemsrs r listStaticEntitieszCollection.listStaticEntitiess }""$$$r cgS)zaA list of all name, entity that I can generate on demand. See getDynamicEntity. r rs r listDynamicEntitieszCollection.listDynamicEntities  r cV|||zS)zURetrieve a list of all name, entity pairs I contain. See getEntity. )r@rBrs r listEntitieszCollection.listEntitiess) &&((4+C+CG+L+LLLr c4|jS)zkRetrieve a list of the names of entities that I store references to. See getStaticEntity. )r&keysrs r listStaticNameszCollection.listStaticNamess }!!###r cgS)zlRetrieve a list of the names of entities that I store references to. See getDynamicEntity. r rs r listDynamicNameszCollection.listDynamicNamesrCr c*|S)zZRetrieve a list of all names for entities that I contain. See getEntity. )rHrs r listNameszCollection.listNamess ##%%%r N)rrr r r'r,r/r2r6r8r;r=r@rBrErHrJrLr r r r#r#>s '''   "%%%   QQQRRR%%%MMM$$$&&&&&r r#ceZdZdZdS)ConstraintViolationz2An exception raised when a constraint is violated.Nrr r r rOrOs<<<t|||dSrM)r#r6r4s r reallyPutEntityzConstrained.reallyPutEntitys T400000r c||r<||r|||dStdtd)zfStore an entity if it meets both constraints. Otherwise raise a ConstraintViolation. zEntity constraint violated.zName constraint violated.N)rTrXrZrOr4s r r6zConstrained.putEntitysl   t $ $ C$$V,, I$$T622222)*GHHH%&ABB Br N)rrr r rTrXrZr6r r r rQrQs[II111 C C C C Cr rQc"eZdZdZdZdZdZdS)Lockedz5A collection that can be locked from adding entities.rcd|_dS)NrSlockedrs r lockz Locked.locks  r c|j SrMr_rWs r rXzLocked.entityConstraints ;r N)rrr r r`rarXr r r r]r]s=?? Fr r]c(eZdZdZeZdZdZdZdS) HomogenouszA homogenous collection of entities. I will only contain entities that are an instance of the class or type specified by my 'entityType' attribute. cdt||jrdSt|d|jd)NrSz of incorrect type ()) isinstance entityTyperOrWs r rXzHomogenous.entityConstraints= fdo . . Y1%&W&WT_&W&W&WXX Xr cdS)NNamer rs r getNameTypezHomogenous.getNameTypesvr c|jjSrM)rhrrs r getEntityTypezHomogenous.getEntityTypes ''r N) rrr r objectrhrXrkrmr r r rdrdsU JYYY (((((r rdN) r twisted.pythonrrrrrr# ExceptionrOrQr]rdr r r rqs #"""""+NNNNNNNN*NNNNNNNN&j&j&j&j&j&j&j&j&Z=====)===!C!C!C!C!C*!C!C!CH     [   ((((((((((r