o bp@s0dZddlmZGdddZGdddZdS)z6 Generic sentence handling tools: hopefully reusable. )Setc@sNeZdZUdZeZeeed<ddZ e ddZ ddZ d efd d Z d S) _BaseSentencea- A base sentence class for a particular protocol. Using this base class, specific sentence classes can almost automatically be created for a particular protocol. To do this, fill the ALLOWED_ATTRIBUTES class attribute using the C{getSentenceAttributes} class method of the producer:: class FooSentence(BaseSentence): """ A sentence for integalactic transmodulator sentences. @ivar transmogrificationConstant: The value used in the transmogrifier while producing this sentence, corrected for gravitational fields. @type transmogrificationConstant: C{Tummy} """ ALLOWED_ATTRIBUTES = FooProtocol.getSentenceAttributes() @ivar presentAttributes: An iterable containing the names of the attributes that are present in this sentence. @type presentAttributes: iterable of C{str} @cvar ALLOWED_ATTRIBUTES: A set of attributes that are allowed in this sentence. @type ALLOWED_ATTRIBUTES: C{set} of C{str} ALLOWED_ATTRIBUTEScCs ||_dS)z Initializes a sentence with parsed sentence data. @param sentenceData: The parsed sentence data. @type sentenceData: C{dict} (C{str} -> C{str} or L{None}) N) _sentenceData)self sentenceDatar?/usr/lib/python3/dist-packages/twisted/positioning/_sentence.py__init__(s z_BaseSentence.__init__cCs t|jS)z An iterable containing the names of the attributes that are present in this sentence. @return: The iterable of names of present attributes. @rtype: iterable of C{str} )iterr)rrrr presentAttributes1s z_BaseSentence.presentAttributescCs8||jvr |j|dS|jj}|d|d}t|)z5 Gets an attribute of this sentence. Nz sentences have no z attributes)rrget __class____name__AttributeError)rname classNamemsgrrr __getattr__<s z_BaseSentence.__getattr__returncCsV|j}ddt|D}d|}|jdpd}|jj}d|d|d|d S) z Returns a textual representation of this sentence. @return: A textual representation of this sentence. @rtype: C{str} cSs&g|]\}}|dkr|d|qS)typez: r).0kvrrr Os&z*_BaseSentence.__repr__..z, rz unknown type)ritemssortedjoinr rr)rrdatadataReprtypeReprrrrr __repr__Gs  z_BaseSentence.__repr__N)r __module__ __qualname____doc__setrrstr__annotations__r propertyr rr"rrrr r s    rc@seZdZdZeddZdS)!_PositioningSentenceProducerMixina A mixin for certain protocols that produce positioning sentences. This mixin helps protocols that store the layout of sentences that they consume in a C{_SENTENCE_CONTENTS} class variable provide all sentence attributes that can ever occur. It does this by providing a class method, C{getSentenceAttributes}, which iterates over all sentence types and collects the possible sentence attributes. cCs8dh}|jD]}|D] }|durq ||q q|S)aR Returns a set of all attributes that might be found in the sentences produced by this protocol. This is basically a set of all the attributes of all the sentences that this protocol can produce. @return: The set of all possible sentence attribute names. @rtype: C{set} of C{str} rN)_SENTENCE_CONTENTSvaluesadd)cls attributes attributeList attributerrr getSentenceAttributescs  z7_PositioningSentenceProducerMixin.getSentenceAttributesN)rr#r$r% classmethodr2rrrr r*Xs r*N)r%typingrrr*rrrr s O