OwlCyberSecurity - MANAGER
Edit File: compat.pyc
� `��ac ) @` s� d Z d d l m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l Z d d l m Z m Z e j dm k r� e Z n e Z e j dn k r� e Z n e Z e j do k r� e Z n e Z e j � d k re Z n e Z d � Z e p2e � Z d d � Z d � Z d � Z y e j Wn e k rzd e _ n Xy e j e j d � Wn/ e e! e j" f k r�e e _ e e _ n Xe# Z$ e r�[$ [ [ n e% Z% e& Z& y d d l' m( Z( Wn e) k re( Z( n Xd d � Z+ y e, Z, Wn e! k rHd � Z, n Xd � Z- e rge. Z/ e0 Z1 n e/ Z/ e1 Z1 e/ d � Z2 d � Z3 d � Z4 e r�d � Z5 n d d Ud e5 _ e r�d d l m6 Z7 n d d l m8 Z7 e rd � Z9 d � Z: d d d � Z; d � Z< n! d � Z9 d! � Z: e= Z; d" � Z< d# e9 _ d$ e: _ d% e< _ y e> Z? Wn e! k roe. Z? n Xy d d& l m@ Z@ Wn e) k r�eA Z@ n Xy d d' l mB ZB Wn e) k r�e ZB n Xe r$d d lC jD ZE d d( lF mG ZG d d) lC mH ZI d d* lC mJ ZK d d+ lL mM ZN nH d d lO ZE d d( lP mG ZG d d) lQ mH ZI d d* lQ mJ ZK d d lN ZN e r�d, � ZR d- � ZS d. � ZT eU ZU eU ZV eW ZX n; d/ � ZR d0 � ZS d1 � ZT eV ZU eV ZV d d2 lY mX ZX eX d3 eR _ d4 eS _ d5 eT _ d6 � ZZ d7 � Z[ d8 � Z\ e r<d d9 l] m^ Z_ d d: l] m` Za n d d; l] mb Z_ d d< l] mc Za d= � Zd y d d> l me Ze Wn e) k r�ee Ze n Xd? � Zf e r�eg Zh ei Zj n eh Zh ej Zj d@ � Zk e r�e j Zl n e jm Zl y d dA ln mo Zo Wn! e) k rd dA lp mo Zo n Xd dB � Zq dC � Zr er � dD dE dF dG dH dI dJ dK dL dM dN dO dP dQ dR dS dT dU dV dW dX dY dZ d[ d\ d] d^ d_ d` da db dc dd de df dg dh di dj dk dl g) Zs d S(p s) Compatibility module to provide backwards compatibility for useful Python features. This is mainly for use of internal Twisted code. We encourage you to use the latest version of Python directly from your code, if possible. @var unicode: The type of Unicode strings, C{unicode} on Python 2 and C{str} on Python 3. @var NativeStringIO: An in-memory file-like object that operates on the native string type (bytes in Python 2, unicode in Python 3). @var urllib_parse: a URL-parsing module (urlparse on Python 2, urllib.parse on Python 3) i ( t absolute_importt divisionN( t MethodType( t TextIOBaset IOBasei i i t PyPyc C` s- t j j d d � } | d k r% t St Sd S( s- Returns whether or not we should enable the new-style conversion of old-style classes. It inspects the environment for C{TWISTED_NEWSTYLE}, accepting an empty string, C{no}, C{false}, C{False}, and C{0} as falsey values and everything else as a truthy value. @rtype: L{bool} t TWISTED_NEWSTYLEt t not falset Falset 0N( R R R R R ( t ost environt getR t True( t value( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _shouldEnableNewStyle= s c C` s4 t j � } x! t | d � D] } | j } q W| S( s� In Python 3, L{inspect.currentframe} does not take a stack-level argument. Restore that functionality from Python 2 so we don't have to re-implement the C{f_back}-walking loop in places where it's called. @param n: The number of stack levels above the caller to walk. @type n: L{int} @return: a frame, n levels up the stack from the caller. @rtype: L{types.FrameType} i ( t inspectt currentframet ranget f_back( t nt ft x( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR Q s c C` s� | s t d � � n | t j k r1 t j | � S| t t d d � k r�d | k r� | j d � d k s | j d � d k r� t d � � n | j d � d } | j d � } | j d � } d | d k } t | � d | k s� | d k r t d � � n | d k rd S| r�d g d t | � | | } | j d � rQ| | d *n< | j d � rm| | d )n | j d � } | | | | d +t | � d | k r�t d � � q�n% t | � d | k r�t d � � n | rW| d j d � d k rt d � � n t j | d � } t j d | � } g | D] } t | � d ^ q4| d )n g | D] } t | d � ^ q^} t j d | � St j d d � � d S( s, Emulator of L{socket.inet_pton}. @param af: An address family to parse; C{socket.AF_INET} or C{socket.AF_INET6}. @type af: L{int} @param addr: An address. @type addr: native L{str} @return: The binary packed version of the passed address. @rtype: L{bytes} s- illegal IP address string passed to inet_ptont AF_INET6t %i i t :R t .i����i i s Syntactically invalid addresss i R s ::i i����s !HHs !8Hia s( Address family not supported by protocolNs ( t ValueErrort sockett AF_INETt inet_atont getattrt countt indext splitt lent startswitht endswitht structt unpackt hext intt packt error( t aft addrt partst elidedt ipv4Componentt zerost idxt rawipv4t unpackedipv4R ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt inet_ptond sH 6" *"c C` s� | t j k r t j | � S| t j k r�t | � d k rL t d � � n t j d | � } d } } x� t d � D]z } | | s� | d k r� | } d } n | d 7} qu | d k ru d } | d k s� | | k r� | } | } n d } qu qu W| d k r&| d k s| | k r&| } | } n g | D] } t | � d ^ q-} | d k rld g | | | | +n | d d k r�| j d d � n | d d k r�| j t | � d d � n d j | � St j d d � � d S( Ni s address length incorrects !8Hi i i i R i����R ia s( Address family not supported by protocol( R R t inet_ntoaR R% R R( R) t NoneR R* t insertt joinR- ( R. R/ R0 t curBaset bestBaset it curLent bestLenR ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt inet_ntop� s> $ # R s ::( t reducec B` sY | d k r | } n e | d � � } | j � } Wd QXe | | d � } | | | Ud S( sz Execute a Python script in the given namespaces. Similar to the execfile builtin, but a namespace is mandatory, partly because that's a sensible thing to require, and because otherwise we'd have to do some frame hacking. This is a compatibility implementation for Python 3 porting, to avoid the use of the deprecated builtin C{execfile} function. t rbNt exec( R9 t opent readt compile( t filenamet globalst localst fint sourcet code( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt execfile� s c C` s( | | k r d S| | k r d Sd Sd S( s� Compare two objects. Returns a negative number if C{a < b}, zero if they are equal, and a positive number if C{a > b}. i����i i N( ( t at b( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt cmp� s c C` sz t s | Sd � } d � } d � } d � } d � } d � } | | _ | | _ | | _ | | _ | | _ | | _ | S( s� Class decorator that ensures support for the special C{__cmp__} method. On Python 2 this does nothing. On Python 3, C{__eq__}, C{__lt__}, etc. methods are added to the class, relying on C{__cmp__} to implement their comparisons. c S` s) | j | � } | t k r | S| d k S( Ni ( t __cmp__t NotImplemented( t selft othert c( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __eq__ s c S` s) | j | � } | t k r | S| d k S( Ni ( RR RS ( RT RU RV ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __ne__" s c S` s) | j | � } | t k r | S| d k S( Ni ( RR RS ( RT RU RV ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __lt__) s c S` s) | j | � } | t k r | S| d k S( Ni ( RR RS ( RT RU RV ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __le__0 s c S` s) | j | � } | t k r | S| d k S( Ni ( RR RS ( RT RU RV ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __gt__7 s c S` s) | j | � } | t k r | S| d k S( Ni ( RR RS ( RT RU RV ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt __ge__> s ( t _PY3RY R[ RZ R\ RW RX ( t klassRW RX RY RZ R[ R\ ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt comparable s c C` s� t | t � r t St | t � r& t St | d d � } d d l } t | | j | j f � rp | ri t St Sn t s� t | t � r� | d k r� t St Sn d d l m } m } d d l m } t | | | | f � r� t Sn | S( s[ Determine the type which will be returned from the given file object's read() and accepted by its write() method as an argument. In other words, determine whether the given file is 'opened in text mode'. @param fileIshObject: Any object, but ideally one which resembles a file. @type fileIshObject: L{object} @param default: A default value to return when the type of C{fileIshObject} cannot be determined. @type default: L{type} @return: There are 3 possible return values: 1. L{unicode}, if the file is unambiguously opened in text mode. 2. L{bytes}, if the file is unambiguously opened in binary mode. 3. L{basestring}, if we are on python 2 (the L{basestring} type does not exist on python 3) and the file is opened in binary mode, but has an encoding and can therefore accept both bytes and text reliably for writing, but will return L{bytes} from read methods. 4. The C{default} parameter, if the given type is not understood. @rtype: L{type} t encodingi N( t InputTypet OutputType( t StringIO( t isinstanceR t unicodeR t bytesR! R9 t codecst StreamReadert StreamWriterR] t filet basestringt cStringIORa Rb Rc ( t fileIshObjectt defaultR` Rg Ra Rb Rc ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt ioTypeW s( c C` s� t | t t f � s( t d | � � n t rZ t | t � rJ | j d � S| j d � n) t | t � rv | j d � S| j d � | S( s Convert C{bytes} or C{unicode} to the native C{str} type, using ASCII encoding if conversion is necessary. @raise UnicodeError: The input string is not ASCII encodable/decodable. @raise TypeError: The input is neither C{bytes} nor C{unicode}. s %r is neither bytes nor unicodet ascii( Rd Rf Re t TypeErrorR] t decodet encode( t s( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt nativeString� s c C` sT t | t � r! | j d � } n | j d � } t | � t | � k rL | S| Sd S( s Some functions, such as C{os.path.join}, operate on string arguments which may be bytes or text, and wish to return a value of the same type. In those cases you may wish to have a string constant (in the case of C{os.path.join}, that constant would be C{os.path.sep}) involved in the parsing or processing, that must be of a matching type in order to use string operations on it. L{_matchingString} will take a constant string (either L{bytes} or L{unicode}) and convert it to the same type as the input string. C{constantString} should contain only characters from ASCII; to ensure this, it will be encoded or decoded regardless. @param constantString: A string literal used in processing. @type constantString: L{unicode} or L{bytes} @param inputString: A byte string or text string provided by the user. @type inputString: L{unicode} or L{bytes} @return: C{constantString} converted into the same type as C{inputString} @rtype: the type of C{inputString} Rp N( Rd Rf Rr Rs t type( t constantStringt inputStringt otherType( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _matchingString� s c C` s | j | � � d S( N( t with_traceback( t exceptiont traceback( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt reraise� s sZ def reraise(exception, traceback): raise exception.__class__, exception, tracebacksZ Re-raise an exception, with an optional traceback, in a way that is compatible with both Python 2 and Python 3. Note that on Python 3, re-raised exceptions will be mutated, with their C{__traceback__} attribute being set. @param exception: The exception instance. @param traceback: The traceback to use, or L{None} indicating a new traceback. ( Rc ( t BytesIOc c` s1 x* t t | � � D] } | | | d !Vq Wd S( Ni ( R R% ( t originalBytesR> ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt iterbytes� s c C` s d | j d � S( Ns %dRp ( Rs ( R> ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt intToBytes� s c C` s3 t | � } | d k r | | S| | | | !Sd S( s� Return a copy of the given bytes-like object. If an offset is given, the copy starts at that offset. If a size is given, the copy will only be of that length. @param object: C{bytes} to be copied. @param offset: C{int}, starting index of copy. @param size: Optional, if an C{int} is given limit the length of copy to this size. N( t memoryviewR9 ( t objectt offsett sizet view( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt lazyByteSlice� s c C` s+ t | t � s t d � � n | j d � S( Ns* Can only convert text to bytes on Python 3Rp ( Rd Re Rq Rs ( Rt ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt networkString s c C` s | S( N( ( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� s c C` s d | S( Ns %d( ( R> ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� s c C` s/ t | t � s t d � � n | j d � | S( Ns' Can only pass-through bytes on Python 2Rp ( Rd t strRq Rr ( Rt ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� s s Return an iterable wrapper for a C{bytes} object that provides the behavior of iterating over C{bytes} on Python 2. In particular, the results of iteration are the individual bytes (rather than integers as on Python 3). @param originalBytes: A C{bytes} object that will be wrapped. s� Convert the given integer into C{bytes}, as ASCII-encoded Arab numeral. In other words, this is equivalent to calling C{bytes} in Python 2 on an integer. @param i: The C{int} to convert to C{bytes}. @rtype: C{bytes} s Convert the native string type to C{bytes} if it is not already C{bytes} using ASCII encoding if conversion is necessary. This is useful for sending text-like bytes that are constructed using string interpolation. For example, this is safe on Python 2 and Python 3: networkString("Hello %d" % (n,)) @param s: A native string to convert to bytes if necessary. @type s: C{str} @raise UnicodeError: The input string is not ASCII encodable/decodable. @raise TypeError: The input is neither C{bytes} nor C{unicode}. @rtype: C{bytes} ( t InstanceType( t FileType( t escape( t quote( t unquote( t cookiejarc C` s | j � S( N( t items( t d( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt iteritemsh s c C` s | j � S( N( t values( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt itervaluesl s c C` s t | j � � S( N( t listR� ( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� p s c C` s | j � S( N( R� ( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� w s c C` s | j � S( N( R� ( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� { s c C` s | j � S( N( R� ( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyR� s ( t izipsM Return an iterable of the items of C{d}. @type d: L{dict} @rtype: iterable sN Return an iterable of the values of C{d}. @type d: L{dict} @rtype: iterable sG Return a list of the items of C{d}. @type d: L{dict} @rtype: L{list} c C` s$ t r t | j � � S| j � Sd S( sV Return a list of the keys of C{d}. @type d: L{dict} @rtype: L{list} N( R] R� t keys( R� ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _keys� s c C` sb t s t t j � St � } x? t j j � D]. \ } } t j j | � | t j j | � <q, W| S( s� Return a L{dict} of L{os.environ} where all text-strings are encoded into L{bytes}. This function is POSIX only; environment variables are always text strings on Windows. ( R] t dictR R R� t encodevaluet encodekey( t targetR t y( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt bytesEnviron� s &c C` s0 | j | } t r t | | � St | | | � S( sj Construct a bound method. @param cls: The class that the method should be bound to. @type cls: L{types.ClassType} or L{type}. @param name: The name of the method. @type name: native L{str} @param self: The object that the method is bound to. @type self: any object @return: a bound method @rtype: L{types.MethodType} ( t __dict__R] t _MethodType( t clst nameRT t func( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _constructMethod� s ( t encodebytes( t decodebytes( t encodestring( t decodestringc C` s! t r t | g � St | � Sd S( s� Like L{chr} but always works on ASCII, returning L{bytes}. @param i: The ASCII code point to return. @type i: L{int} @rtype: L{bytes} N( R] Rf t chr( R> ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _bytesChr� s ( t internc C` sC t | t � r; t r+ t d | f � � q? | j d � Sn | Sd S( sz Coerce ASCII-only byte strings into unicode for Python 2. In Python 2 C{unicode(b'bytes')} returns a unicode string C{'bytes'}. In Python 3, the equivalent C{str(b'bytes')} will return C{"b'bytes'"} instead. This function mimics the behavior for Python 2. It will decode the byte string as ASCII. In Python 3 it simply raises a L{TypeError} when passing a byte string. Unicode strings are returned as-is. @param s: The string to coerce. @type s: L{bytes} or L{unicode} @raise UnicodeError: The input L{bytes} is not ASCII decodable. @raise TypeError: The input is L{bytes} on Python 3. s Expected str not %r (bytes)Rp N( Rd Rf R] Rq Rr ( Rt ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _coercedUnicode� s c C` sG t | t � s% t d | f � � n t r5 t | � Sd t | � Sd S( s Provide a repr for a byte string that begins with 'b' on both Python 2 and 3. @param bytestring: The string to repr. @type bytestring: L{bytes} @raise TypeError: The input is not L{bytes}. @return: The repr with a leading 'b'. @rtype: L{bytes} s Expected bytes not %rRP N( Rd Rf Rq R] t repr( t bytestring( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _bytesRepr s ( t Sequencec K` sh d | k r% t j d t d d �n | d k rO d | k rO | j d � } n | r^ t � n t | � S( s� Provide a backwards-compatible way to get async param value that does not cause a syntax error under Python 3.7. @param isAsync: isAsync param value (should default to None) @type isAsync: L{bool} @param kwargs: keyword arguments of the caller (only async is allowed) @type kwargs: L{dict} @raise TypeError: Both isAsync and async specified. @return: Final isAsync param value @rtype: L{bool} t asyncs: 'async' keyword argument is deprecated, please use isAsynct stackleveli N( t warningst warnt DeprecationWarningR9 t popRq t bool( t isAsynct kwargs( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _get_async_param; s c ` s� y d d l m � m � m � Wn t k r4 d SXt o> t sE d Sd � � � � f d � } t j � � j | j k r d S| t _ d S( s� Work around U{this pypy bug <https://bitbucket.org/pypy/pypy/issues/3051/socketfromfd-sets-sockets-to-blocking-on>} by replacing C{socket.fromfd} with a more conservative version. i ( t fcntlt F_GETFLt F_SETFLNc ` sQ | g | d k } � | � � } z � | | | | � SWd � | � | � Xd S( N( R9 ( t fdt familyRv t protot passprotot flags( R� R� R� t realFromFD( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt fromFDWithoutModifyingFlagsd s ( R� R� R� t ImportErrorR] t _PYPYR9 R t fromfdt __name__( R� ( ( R� R� R� R� sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt _pypy3BlockingHackW s R~ RN t frozensetRB t setRQ R_ t OrderedDictRu t NativeStringIOR� Re R� R� R� t StringTypeR� R� R� R� R� R t xranget urllib_parseR� R� t urlquotet urlunquotet cookielibR� t _b64encodebytest _b64decodebytesR� R� R� R� t unichrt raw_inputt _tokenizeR� R� ( i i ( i i i ( i i i (t t __doc__t __future__R R R R t platformR R( t syst tokenizet typesR R� R� t ioR R t version_infoR R] R t _PY35PLUSt _PY37PLUSt python_implementationR� R t _EXPECT_NEWSTYLER R7 RA R t AttributeErrort NameErrorR- R� t adictR� R� t functoolsRB R� R9 RN RQ R_ R� Re R+ t longRo Ru Rz R~ Rc R� R R� R� R� R� t bufferRk R� R� R� R� t urllib.parset parseR� t htmlR� R� R� R� R� t httpR� R� t urlparset cgit urllibR� R� R� R R� t zipR� t itertoolsR� R� R� t base64R� R� R� R� R� R� R� R� R� R� R� t inputR� R� R� t generate_tokenst collections.abcR� t collectionsR� R� t __all__( ( ( sX /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/compat.pyt <module> s| ? # A =