OwlCyberSecurity - MANAGER
Edit File: failure.pyc
� `��ac @` s� d Z d d l m Z 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 m Z d d l m Z d d l m Z m Z d a d Z d e f d � � YZ d d � Z d Z d e f d � � YZ d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ g Z d � Z d e f d � � YZ d � Z! e" Z# e$ e$ e$ e% e j& d � Z' d � Z( d S( s9 Asynchronous-friendly error mechanism. See L{Failure}. i ( t divisiont absolute_importt print_functionN( t getmro( t reflect( t _PY3t NativeStringIOi t DefaultExceptionc B` s e Z RS( ( t __name__t __module__( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR s t defaultc C` s� | d k r" t d | f � � n | } | d k rn x�| D], \ } } } } } | d | | | f � q; Wnr| d k r� xc| D]L \ } } } } } | d | | | f � | d t j | | � j � � q� Wn | d k r$x4 | D], \ } } } } } | d | | | f � q� W| d � n� | d k r�x� | D]� \ } } } } } | d | | | f � | d � x. | D]& \ } } | d | t | � f � qtW| d � x. | D]& \ } } | d | t | � f � q�Wq7Wn d S( s� Format and write frames. @param frames: is a list of frames as used by Failure.frames, with each frame being a list of (funcName, fileName, lineNumber, locals.items(), globals.items()) @type frames: list @param write: this will be called with formatted strings. @type write: callable @param detail: Four detail levels are available: default, brief, verbose, and verbose-vars-not-captured. C{Failure.printDetailedTraceback} uses the latter when the caller asks for verbose, but no vars were captured, so that an explicit warning about the missing data is shown. @type detail: string R t brieft verboses verbose-vars-not-capturedsN Detail must be default, brief, verbose, or verbose-vars-not-captured. (not %r)s %s:%s:%s s File "%s", line %s, in %s s %s s %s:%d: %s(...) sA [Capture of Locals and Globals disabled (use captureVars=True)] s [ Locals ] s %s : %s s ( Globals ) N( R R R s verbose-vars-not-captured( t ValueErrort linecachet getlinet stript repr( t framest writet detailt wt methodt filenamet linenot localVarst globalVarst namet val( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt format_frames# s4 ' s --- <exception caught here> ---t NoCurrentExceptionErrorc B` s e Z d Z RS( s� Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state. ( R R t __doc__( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR V s c C` s� t | � d k s t d � � d } x | D] } t | | � } q+ Wt | d | � } t | � } } x9 | d D]- } t | | � } t | � | _ | j } qr W| S( s� Construct a fake traceback object using a list of frames. Note that although frames generally include locals and globals, this information is not kept by this method, since locals and globals are not used in standard tracebacks. @param stackFrames: [(methodname, filename, lineno, locals, globals), ...] @param tbFrames: [(methodname, filename, lineno, locals, globals), ...] i s Must pass some framesi N( t lent AssertionErrort Nonet _Framet _TracebackFramet tb_next( t stackFramest tbFramest stackt sft firstTbt tb( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt _Traceback^ s R$ c B` s e Z d Z d � Z RS( sq Fake traceback object which can be passed to functions in the standard library L{traceback} module. c C` s" | | _ | j | _ d | _ d S( s- @param frame: _Frame object N( t tb_framet f_linenot tb_linenoR" R% ( t selft frame( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt __init__� s ( R R R R2 ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR$ � s R# c B` s e Z d Z d � Z RS( sD A fake frame object, used by L{_Traceback}. @ivar f_code: fake L{code<types.CodeType>} object @ivar f_lineno: line number @ivar f_globals: fake f_globals dictionary (usually empty) @ivar f_locals: fake f_locals dictionary (usually empty) @ivar f_back: previous stack frame (towards the caller) c C` sO | \ } } } } } t | | � | _ | | _ i | _ i | _ | | _ d S( s� @param frameinfo: (methodname, filename, lineno, locals, globals) @param back: previous (older) stack frame @type back: C{frame} N( t _Codet f_codeR. t f_globalst f_localst f_back( R0 t frameinfot backR R R t localzt globalz( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR2 � s ( R R R R2 ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR# � s R3 c B` s e Z d Z d � Z RS( sB A fake code object, used by L{_Traceback} via L{_Frame}. c C` s | | _ | | _ d S( N( t co_namet co_filename( R0 R R ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR2 � s ( R R R R2 ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR3 � s c C` s t j | j � | S( s Mark the given callable as extraneous to inlineCallbacks exception reporting; don't show these functions. @param f: a function that you NEVER WANT TO SEE AGAIN in ANY TRACEBACK reported by Failure. @type f: function @return: f ( t _inlineCallbacksExtraneoust appendt __code__( t f( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt _extraneous� s t Failurec B` sD e Z d Z d Z d Z e r. e j d Z n e e j d � Z d d d e d � Z d � Z d � Z d � Z e e d d � r� d � Z n d d Ud e _ e d � � Z d � Z e e � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d d d � Z d e d d � Z d d d � Z d d d � Z! RS( s� A basic abstraction for an error that has occurred. This is necessary because Python's built-in error mechanisms are inconvenient for asynchronous communication. The C{stack} and C{frame} attributes contain frames. Each frame is a tuple of (funcName, fileName, lineNumber, localsItems, globalsItems), where localsItems and globalsItems are the contents of C{locals().items()}/C{globals().items()} for that frame, or an empty tuple if those details were not captured. @ivar value: The exception instance responsible for this failure. @ivar type: The exception's class. @ivar stack: list of frames, innermost last, excluding C{Failure.__init__}. @ivar frames: list of frames, innermost first. i t YIELD_VALUEc C` sW t d a t | _ d | _ | _ } | | _ t | t � rZ | d k rZ t d � � n d } | d k r{ | j � } n | d k r� t j � \ | _ | _ } | j d k r� t � � n d } nW | d k r t | t � r� | j | _ n t | � | _ | | _ n | | _ | | _ t | j t � rC| j | j � d St | j d � ru| j | j j � | j ` d S| d k r�| r�| } q�t | j d d � r�| j j } q�n g } | _ g } | _ | | _ | r�| j } n t | j t � s d } } n x# | r0| r0| j } | d 8} qWx� | r| r�| j j � } | j | j k rji } n | j j � } x* | | f D] } d | k r�| d =q�q�W| j � } | j � } n d } } | j d | j j | j j | j! | | f � | j } q4Wx� | d k r�| j } | r�| j j � } | j | j k rNi } n | j j � } x* | | f D] } d | k rj| d =qjqjWt" | j � � } t" | j � � } n d } } | j# | j j | j j | j$ | | f � | j% } q Wt& j' | j � rDt( | j t � rDt) | j � } t" t* t+ j, | � � | _- n | j g | _- d S( s- Initialize me with an explanation of the error. By default, this will use the current C{exception} (L{sys.exc_info}()). However, if you want to specify a particular kind of failure, you can pass an exception as an argument. If no C{exc_value} is passed, then an "original" C{Failure} will be searched for. If the current exception handler that this C{Failure} is being constructed in is handling an exception raised by L{raiseException}, then this C{Failure} will act like the original C{Failure}. For C{exc_tb} only L{traceback} instances or L{None} are allowed. If L{None} is supplied for C{exc_value}, the value of C{exc_tb} is ignored, otherwise if C{exc_tb} is L{None}, it will be found from execution context (ie, L{sys.exc_info}). @param captureVars: if set, capture locals and globals of stack frames. This is pretty slow, and makes no difference unless you are going to use L{printDetailedTraceback}. i s$ Strings are not supported by Failurei Nt __failure__t __traceback__t __builtins__( ( (. t countR" t typet valuet captureVarst isinstancet strt TypeErrort _findFailuret syst exc_infoR t Exceptiont __class__RC t _extrapolatet hasattrRE t getattrRF R R( R+ R- R7 R6 t copyR5 t itemst insertR4 R< R= R. t listR? R/ R% t inspectt isclasst issubclassR t mapR t qualt parents( R0 t exc_valuet exc_typet exc_tbRK R+ t stackOffsetR R( RA R: R; t dt parentCs( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR2 � s� $ c C` s� t j | j � | _ t j � \ } } } g } x_ | d k r� | j } | j t k r� | j | j j | j j | j d d f � n | j } q3 W| j | j � | | _ d S( s, Extrapolate from one failure into another, copying its stack frames. @param otherFailure: Another L{Failure}, whose traceback information, if any, should be preserved as part of the stack presented by this one. @type otherFailure: L{Failure} N( ( ( RW t __dict__RP RQ R" R- R4 R> R? R< R= R/ R% t extendR ( R0 t otherFailuret _R+ R RA ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyRT � s c G` s5 | j | � } | s1 t r( | j � q1 | � n | S( s� Trap this failure if its type is in a predetermined list. This allows you to trap a Failure in an error callback. It will be automatically re-raised if it is not a type that you expect. The reason for having this particular API is because it's very useful in Deferred errback chains:: def _ebFoo(self, failure): r = failure.trap(Spam, Eggs) print('The Failure is due to either Spam or Eggs!') if r == Spam: print('Spam did it!') elif r == Eggs: print('Eggs did it!') If the failure is not a Spam or an Eggs, then the Failure will be 'passed on' to the next errback. In Python 2 the Failure will be raised; in Python 3 the underlying exception will be re-raised. @type errorTypes: L{Exception} ( t checkR t raiseException( R0 t errorTypest error( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt trap� s c G` s^ xW | D]O } | } t j | � rC t | t � rC t j | � } n | | j k r | Sq Wd S( s Check if this failure's type is in a predetermined list. @type errorTypes: list of L{Exception} classes or fully-qualified class names. @returns: the matching L{Exception} type, or None if no match. N( R[ R\ R] RR R R_ R` R" ( R0 Rm Rn t err( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyRk � s t with_tracebackc C` s | j j | j � � d S( N( RJ Rq R+ ( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyRl � s sB def raiseException(self): raise self.type, self.value, self.tbNsf raise the original exception, preserving traceback information if available. c C` s | j | j | j | j � S( sJ Throw the original exception into the given generator, preserving traceback information if available. @return: The next value yielded from the generator. @raise StopIteration: If there are no more values in the generator. @raise anything else: Anything that the generator raises. ( t throwRI RJ R+ ( R0 t g( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt throwExceptionIntoGenerator� s c C` s t j � d } | s d Sd } | } x | j rD | } | j } q) W| j } | j | j j k rs | j j d � S| j j s� | j j | j | j k r� d S| r� | j } | j | j j k r� | j j d � Sn | j j } | r| j | j j k r| j j d � Sd S( sV Find the failure that represents the exception currently in context. i����NR0 ( RP RQ R" R% R- R4 Rl R@ R6 t gett co_codet tb_lastit _yieldOpcodeRt R7 ( t clsR+ t secondLastTbt lastTbt lastFrameR1 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyRO s* c C` s/ d t j | j � t j | j � | j � f S( Ns <%s %s: %s>( R R_ RS RI t getErrorMessage( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt __repr__> s c C` s d | j � S( Ns [Failure instance: %s]( t getBriefTraceback( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt __str__D s c C` s� | j r | j S| j j � } g | j D]; } | d | d | d t | d � t | d � g ^ q) | d <d | d <| j d k r� g | j D]; } | d | d | d t | d � t | d � g ^ q� | d <n d | d <| S( s1 Avoid pickling objects in the traceback. i i i i i R R+ R( t pickledN( R� Rg RW R t _safeReprVarsR" R( ( R0 t ct v( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt __getstate__H s L O c C` s7 | j � | _ t | j d d � r3 d | j _ n d S( s� Remove references to other objects, replacing them with strings. On Python 3, this will also set the C{__traceback__} attribute of the exception instance to L{None}. RF N( R� Rg RV RJ R" RF ( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt cleanFailurei s c C` sF | j d k r | j St | j � d k r> t | j | j � Sd Sd S( s� Get an object that represents this Failure's stack that can be passed to traceback.extract_tb. If the original traceback object is still present, return that. If this traceback object has been lost but we still have the information, return a fake traceback object (see L{_Traceback}). If there is no traceback information at all, return None. i N( R+ R" R R R, R( ( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt getTracebackObjectv s c C` s/ t | j t � r | j j � St j | j � S( sJ Get a string of the exception which caused this Failure. ( RL RJ RC R} R t safe_str( R0 ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR} � s c C` s# t � } | j d | � | j � S( Nt file( t StringIOt printBriefTracebackt getvalue( R0 t io( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR � s R c C` s/ t � } | j d | d | d | � | j � S( NR� t elideFrameworkCodeR ( R� t printTracebackR� ( R0 R� R R� ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt getTraceback� s c C` s� | d k r( d d l m } | j } n | j } | d k rP | j rP d } n | } | d k r� | d | j | j r} d p� d f � n` | d k r� | j r� d } n d } | d | t j | j � t j | j � f � n | d � | j r<| s&t | j t | | � | d t f � n t | j | | � n | d k sU| d � n | d k s�| d t j | j � t j | j � f � n t | j t � r�| j d � | j j | | | � n | d k r�| d | j � n d S( s Emulate Python's standard error reporting mechanism. @param file: If specified, a file-like object to which to write the traceback. @param elideFrameworkCode: A flag indicating whether to attempt to remove uninteresting frames from within Twisted itself from the output. @param detail: A string indicating how much information to include in the traceback. Must be one of C{'brief'}, C{'default'}, or C{'verbose'}. i ( t logR s verbose-vars-not-captureds *--- Failure #%d%s--- s (pickled) t R t Tracebacks" Traceback (failure with no frames)s %s: %s: %s s# Traceback (most recent call last): s %s s Failure: s %s: %s s (chained Failure) s *--- End of Failure #%d --- N( R" t twisted.pythonR� t logerrR RK RH R� R R R� RI RJ R R( t traceupLengtht EXCEPTION_CAUGHT_HERER_ RL RC R� ( R0 R� R� R R� R t formatDetailt hasFrames( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR� � sF c C` s | j | | d d �d S( s; Print a traceback as densely as possible. R R N( R� ( R0 R� R� ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR� � s c C` s | j | | d d �d S( sQ Print a traceback with detailed locals and globals information. R R N( R� ( R0 R� R� ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt printDetailedTraceback� s (" R R R R� R" R( R t opcodet opmapRx t chrt FalseR2 RT Ro Rk RV t BaseExceptionRl RB Rt RO t classmethodR~ R� R� R� R� R} R R� R� R� R� ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyRC � s< � ! 9 ! Ec C` s, g | D]! \ } } | t j | � f ^ q S( sq Convert a list of (name, object) pairs into (name, repr) pairs. L{twisted.python.reflect.safe_repr} is used to generate the repr, so no exceptions will be raised by faulty C{__repr__} methods. @param varsDictItems: a sequence of (name, value) pairs as returned by e.g. C{locals().items()}. @returns: a sequence of (name, repr) pairs. ( R t safe_repr( t varsDictItemsR t obj( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyR� � s c C` s� | | | f d k r� t j � } | d | j k r� t r� y t | d � } Wn d } n Xt d | f � d d l } | j | d � q� n | | | | | | � d S( s; Initialize failure object, possibly spawning pdb. i i s broken strs8 Jumping into debugger for post-mortem of exception '%s':Ni ( NNN( R" RP RQ RS t DO_POST_MORTEMRM t printt pdbt post_mortem( R0 Ra Rb Rc RK t Failure__init__t exct strreprR� ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt _debuginit s c C` s t t _ d S( s* Enable debug hooks for Failures. N( R� RC R2 ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt startDebugMode s () R t __future__R R R RW RP R R[ R� R R� R t twisted.python.compatR R R� RH R� RR R R R� R R, t objectR$ R# R3 R> RB R� RC R� t TrueR� R" R� R2 R� R� ( ( ( sY /opt/cpanel-ccs/.develop/virtualenv/lib/python2.7/site-packages/twisted/python/failure.pyt <module> s< / ' � � )