๓ pฏ[Rc@`smdZddlmZmZddddddgZdd lmZdd lmZdd l m Z m Z m Z e ƒZeeeƒƒZd e fd „ƒYZdefd„ƒYZdede fiƒfd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZd„Zdefd„ƒYZdefd„ƒYZdS(si Symbolic constant support, including collections and constants with text, numeric, and bit flag values. i(tdivisiontabsolute_importt NamedConstantt ValueConstantt FlagConstanttNamestValuestFlags(tpartial(tcount(tand_tor_txort _ConstantcB`s)eZdZd„Zd„Zd„ZRS(sท @ivar _index: A C{int} allocated from a shared counter in order to keep track of the order in which L{_Constant}s are instantiated. @ivar name: A C{str} giving the name of this constant; only set once the constant is initialized by L{_ConstantsContainer}. @ivar _container: The L{_ConstantsContainer} subclass this constant belongs to; C{None} until the constant is initialized by that subclass. cC`sd|_tƒ|_dS(N(tNonet _containert_constantOrdert_index(tself((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__init__#s cC`sd|jj|jfS(sq Return text identifying both which constant this is and which collection it belongs to. s<%s=%s>(Rt__name__tname(R((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__repr__(scC`s||_||_dS(so Complete the initialization of this L{_Constant}. @param container: The L{_ConstantsContainer} subclass this constant is part of. @param name: The name of this constant in its container. @param value: The value of this constant; not used, as named constants have no value apart from their identity. N(RR(Rt containerRtvalue((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt_realize0s (Rt __module__t__doc__RRR(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR s   t_ConstantsContainerTypecB`seZdZd„ZRS(sa L{_ConstantsContainerType} is a metaclass for creating constants container classes. c C`s!tt|ƒj||||ƒ}t|ddƒ}|dkrC|Sg}xs|jƒD]e\}}t||jƒrV|jdk rŸt d||j fƒ‚n|j |j ||fƒqVqVWi}xLt |ƒD]>\} } }|j| |ƒ} |j|| | ƒ||| ษs(R'tvaluestiterR%(R*R,((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt iterconstantsฝs N( RRRRRRt classmethodR&R5R:(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR1€s   cB`seZdZRS(s L{NamedConstant} defines an attribute to be a named constant within a collection defined by a L{Names} subclass. L{NamedConstant} is only for use in the definition of L{Names} subclasses. Do not instantiate L{NamedConstant} elsewhere and do not subclass it. (RRR(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyRอscB`seZdZeZRS(se A L{Names} subclass contains constants which differ only in their names and identities. (RRRRR(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyRูscB`seZdZd„ZRS(s L{ValueConstant} defines an attribute to be a named constant within a collection defined by a L{Values} subclass. L{ValueConstant} is only for use in the definition of L{Values} subclasses. Do not instantiate L{ValueConstant} elsewhere and do not subclass it. cC`stj|ƒ||_dS(N(R RR(RR((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR๊s (RRRR(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyRโscB`s#eZdZeZed„ƒZRS(sa A L{Values} subclass contains constants which are associated with arbitrary values. cC`s:x'|jƒD]}|j|kr |Sq Wt|ƒ‚dS(s„ Retrieve a constant by its value or raise a C{ValueError} if there is no constant associated with that value. @param value: The value of one of the constants defined by C{cls}. @raise ValueError: If C{value} is not the value of one of the constants defined by C{cls}. @return: The L{ValueConstant} associated with C{value}. N(R:RR#(R*Rtconstant((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt lookupByValue๗s (RRRRRR;R=(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR๐scC`sM||j|jƒ}||j|jƒ}tƒ}|j|j||ƒ|S(s‹ Implement a binary operator for a L{FlagConstant} instance. @param op: A two-argument callable implementing the binary operation. For example, C{operator.or_}. @param left: The left-hand L{FlagConstant} instance. @param right: The right-hand L{FlagConstant} instance. @return: A new L{FlagConstant} instance representing the result of the operation. (RtnamesRRR(toptlefttrightRR>tresult((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt_flagOp s  cB`sheZdZed„Zd„Zd„Zd„Zd„Zd„Z d„Z d„Z d „Z e Z RS( s L{FlagConstant} defines an attribute to be a flag constant within a collection defined by a L{Flags} subclass. L{FlagConstant} is only for use in the definition of L{Flags} subclasses. Do not instantiate L{FlagConstant} elsewhere and do not subclass it. cC`stj|ƒ||_dS(N(R RR(RR((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR(s cC`sŽt|tƒr'|}t|gƒ}n;t|ƒdkrE|\}nddjt|ƒƒd}tj||||ƒ||_||_ dS(sQ Complete the initialization of this L{FlagConstant}. This implementation differs from other C{_realize} implementations in that a L{FlagConstant} may have several names which apply to it, due to flags being combined with various operators. @param container: The L{Flags} subclass this constant is part of. @param names: When a single-flag value is being initialized, a C{str} giving the name of that flag. This is the case which happens when a L{Flags} subclass is being initialized and L{FlagConstant} instances from its body are being realized. Otherwise, a C{set} of C{str} giving names of all the flags set on this L{FlagConstant} instance. This is the case when two flags are combined using C{|}, for example. it{t,t}N( R"tstrtsettlentjoinR%R RRR>(RRR>RR((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR-s  cC`stt||ƒS(sš Define C{|} on two L{FlagConstant} instances to create a new L{FlagConstant} instance with all flags set in either instance set. (RCR (Rtother((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__or__KscC`stt||ƒS(sš Define C{&} on two L{FlagConstant} instances to create a new L{FlagConstant} instance with only flags set in both instances set. (RCR (RRK((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__and__SscC`stt||ƒS(sจ Define C{^} on two L{FlagConstant} instances to create a new L{FlagConstant} instance with only flags set on exactly one instance set. (RCR (RRK((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__xor__[scC`sctƒ}|j|jtƒdƒx:|jjƒD])}|j|j@dkr2||O}q2q2W|S(s™ Define C{~} on a L{FlagConstant} instance to create a new L{FlagConstant} instance with all flags not set on this instance set. i(RRRRHR:R(RRBtflag((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt __invert__ds  c`s‡fd†ˆjDƒS(sI @return: An iterator of flags set on this instance set. c3`s!|]}ˆjj|ƒVqdS(N(RR5(t.0R(R(sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pys us(R>(R((RsJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt__iter__qscC`st||@ƒS(sน @param flag: The flag to test for membership in this instance set. @return: C{True} if C{flag} is in this instance set, else C{False}. (tbool(RRO((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt __contains__xs cC`s t|jƒS(sL @return: C{False} if this flag's value is 0, else C{True}. (RSR(R((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyt __nonzero__„s(RRRR4RRRLRMRNRPRRRTRUt__bool__(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR s      cB`s)eZdZeZdZed„ƒZRS(sต A L{Flags} subclass contains constants which can be combined using the common bitwise operators (C{|}, C{&}, etc) similar to a I{bitvector} from a language like C. icC`sD|jtkr*|j}|jdK_n|j}|d>|_|S(s  For L{FlagConstant} instances with no explicitly defined value, assign the next power of two as its value. @param name: The name of the constant to create. @param descriptor: An instance of a L{FlagConstant} which is assigned to C{name}. @return: Either the value passed to the C{descriptor} constructor, or the next power of 2 value which will be assigned to C{descriptor}, relative to the value of the last defined L{FlagConstant}. i(RR4t_value(R*RR-R((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyR&—s    (RRRRRRWR;R&(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyRsN(Rt __future__RRt__all__t functoolsRt itertoolsR toperatorR R R tobjectR4tnextRR ttypeRR1RRRRRCRR(((sJ/var/www/html/hlstest/hls-proxy/Twisted-13.2.0/twisted/python/constants.pyts$  )?%M   m