[XMc@sdZddlZddlmZdefdYZdddYZddd YZd dd YZd e fd YZ defdYZ de fdYZ de fdYZ dS(sf Twisted Python Roots: an abstract hierarchy representation for Twisted. Maintainer: Glyph Lefkowitz iN(treflecttNotSupportedErrorcBseZdZRS(sv An exception meaning that the tree-manipulation operation you're attempting to perform is not supported. (t__name__t __module__t__doc__(((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pyRstRequestcBs&eZdZdZdZdZRS(sI 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(). cCs tdtj|jdS(s7Add some data to the response to this request. s%s.writeN(tNotImplementedErrorRtqualt __class__(tselftdata((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pytwrite scCs tdtj|jdS(sXThe response to this request is finished; flush all data to the network stream. s %s.finishN(RRRR(R ((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pytfinish%sN(RRRtNonet wireProtocolR R (((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pyRs tEntitycBseZdZdZRS(sZI 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. cCs tdtj|jdS(sw I produce a stream of bytes for the request, by calling request.write() and request.finish(). s %s.renderN(RRRR(R trequest((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pytrender5s(RRRR(((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pyR+s t CollectioncBseZdZddZdZdZdZdZdZ dZ dZ d Z d Z d Zd Zd ZdZRS(sI represent a static collection of entities. I contain methods designed to represent collections that can be dynamically created. cCs%|dk r||_n i|_dS(sInitialize me. N(R tentities(R R((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pyt__init__Ds  cCs|jj|S(sqGet an entity that was added to me using putEntity. This method will return 'None' if it fails. (Rtget(R tname((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pytgetStaticEntityLscCsdS(snSubclass this to generate an entity on demand. This method should return 'None' if it fails. N((R RR((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pytgetDynamicEntitySscCsE|j|}|dk r|S|j||}|dk rA|SdS(sRetrieve 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(RR R(R RRtent((s8/usr/lib/python2.7/dist-packages/twisted/python/roots.pyt getEntityYs   cCs||j| s r$