U «`”[¤ã@s8dZddlmZmZGdd„deƒZGdd„deƒZdS)z6 Generic sentence handling tools: hopefully reusable. é)Úabsolute_importÚdivisionc@s:eZdZdZeƒZdd„Zedd„ƒZdd„Z dd „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} cCs ||_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)ÚselfZ sentenceData©rú?/usr/lib/python3/dist-packages/twisted/positioning/_sentence.pyÚ__init__)sz_BaseSentence.__init__cCs t|jƒS)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ÚpresentAttributes3s z_BaseSentence.presentAttributescCs8||jkr|j |d¡S|jj}d||f}t|ƒ‚dS)z5 Gets an attribute of this sentence. Nz"%s sentences have no %s attributes)ÚALLOWED_ATTRIBUTESrÚgetÚ __class__Ú__name__ÚAttributeError)rÚnameÚ classNameÚmsgrrrÚ __getattr__?s   z_BaseSentence.__getattr__cCsL|j ¡}dd„t|ƒDƒ}d |¡}|j d¡p4d}|jj}d|||fS)z˜ Returns a textual representation of this sentence. @return: A textual representation of this sentence. @rtype: C{str} cSs$g|]\}}|dkrd||f‘qS)Útypez%s: %sr)Ú.0ÚkÚvrrrÚ Ssz*_BaseSentence.__repr__..z, rz unknown typez<%s (%s) {%s}>)rÚitemsÚsortedÚjoinr rr)rrÚdataZdataReprZtypeReprrrrrÚ__repr__Ks   z_BaseSentence.__repr__N) rÚ __module__Ú __qualname__Ú__doc__Úsetr r Úpropertyr rrrrrrr s   rc@seZdZdZedd„ƒZdS)Ú!_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. cCs<tdgƒ}|j ¡D]"}|D]}|dkr*q| |¡qq|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)r"Z_SENTENCE_CONTENTSÚvaluesÚadd)ÚclsZ attributesZ attributeListZ attributerrrÚgetSentenceAttributesgs z7_PositioningSentenceProducerMixin.getSentenceAttributesN)rrr r!Ú classmethodr(rrrrr$]s r$N)r!Z __future__rrÚobjectrr$rrrrÚsS