← Back
Editing: failure.cpython-38.pyc
U ��W[h � @ s d Z ddlmZmZmZ ddlZddlZddlZddlZddl Z ddlm Z ddl m Z ddl mZmZ dadZG dd � d e�Zd$d d �Zd ZG dd� de�Zdd� ZG dd� de�ZG dd� de�ZG dd� de�Z g Z dd� Z G dd� de �Z d d � Z!d Z"dddd e j#fd d!�Z$d"d#� Z%dS )%z9 Asynchronous-friendly error mechanism. See L{Failure}. � )�division�absolute_import�print_functionN)�getmro)�reflect)�_PY3�NativeStringIO� c @ s e Zd ZdS )�DefaultExceptionN)�__name__� __module__� __qualname__� r r �8/usr/lib/python3/dist-packages/twisted/python/failure.pyr s r �defaultc C sX |dkrt d|f ��|}|dkrL| D ] \}}}}}|d|||f � q&�n|dkr�| D ]8\}}}}}|d|||f � |dt�||��� � qXn�|dkr�| D ] \}}}}}|d |||f � q�|d � n�|d k�rT| D ]x\}}}}}|d |||f � |d � |D ] \} } |d | t| �f � �q|d� |D ] \} } |d | t| �f � �q2q�dS )a� 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 �brief�verbose�verbose-vars-not-capturedzNDetail must be default, brief, verbose, or verbose-vars-not-captured. (not %r)r z %s:%s:%s r z File "%s", line %s, in %s z %s r z%s:%d: %s(...) zA [Capture of Locals and Globals disabled (use captureVars=True)] r z [ Locals ] z %s : %s z ( Globals ) N)� ValueError� linecache�getline�strip�repr) �frames�write�detail�w�method�filename�linenoZ localVarsZ globalVars�name�valr r r � format_frames# s6 �� r" z --- <exception caught here> ---c @ s e Zd ZdZdS )�NoCurrentExceptionErrorz� Raised when trying to create a Failure from the current interpreter exception state and there is no current exception state. N)r r r �__doc__r r r r r# V s r# c C s4 t | �dkstd��d}t| �D ]}t||�}q |S )aE 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 frames: [(methodname, filename, lineno, locals, globals), ...] r zMust pass some framesN)�len�AssertionError�reversed�_TracebackFrame)r �tb�framer r r � _Traceback^ s r+ c @ s e Zd ZdZdd� ZdS )r( zq Fake traceback object which can be passed to functions in the standard library L{traceback} module. c C s* |\}}}}}t ||�| _|| _|| _dS )z� @param frame: (methodname, filename, lineno, locals, globals) @param tb_next: next inner _TracebackFrame object, or None if this is the innermost frame. N)�_Frame�tb_frame� tb_lineno�tb_next)�selfr* r/ r r r �localz�globalzr r r �__init__w s z_TracebackFrame.__init__N�r r r r$ r3 r r r r r( q s r( c @ s e Zd ZdZdd� ZdS )r, z� A fake frame object, used by L{_Traceback}. @ivar f_code: fake L{code<types.CodeType>} object @ivar f_globals: fake f_globals dictionary (usually empty) @ivar f_locals: fake f_locals dictionary (usually empty) c C s t ||�| _i | _i | _dS )z� @param name: method/function name for this frame. @type name: C{str} @param filename: filename for this frame. @type name: C{str} N)�_Code�f_code� f_globals�f_locals�r0 r r r r r r3 � s z_Frame.__init__Nr4 r r r r r, � s r, c @ s e Zd ZdZdd� ZdS )r5 zB A fake code object, used by L{_Traceback} via L{_Frame}. c C s || _ || _d S �N)�co_name� co_filenamer9 r r r r3 � s z_Code.__init__Nr4 r r r r r5 � s r5 c C s t �| j� | S )a 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 )�_inlineCallbacksExtraneous�append�__code__)�fr r r � _extraneous� s rA c @ s� e Zd ZdZdZdZer$ejd Z ne ejd �Z d.dd�Z dd � Z d d � Z d d � Zeedd�rjdd� Zned� de_edd� �Zdd� Zee�Zdd� Zdd� Zdd � Zd d � Zd d � Zd!d"� Z d#d$� Z d/d&d'�Z d0d(d)�Z d1d*d+�Z d2d,d-�Z!dS )3�Failurea� 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. r NZ YIELD_VALUEFc C s t d a t | _ d | _ | _}|| _t|t�r>|dkr>td��d}|dkrR| �� }|dkr�t� � \| _| _}| jdkr|t � �d}n:|dkr�t|t �r�|j | _n t|�| _|| _n || _|| _t| jt �r�| �| j� dS t| jd�r�| �| jj� | j`dS |dk�r*|�r|}nt| jdd��r*| jj}g }| _g }| _|| _|�rR|j} nt| jt ��shd } }|�r�| �r�| j} |d8 }�qh| �r |�r�| j�� } | j| jk�r�i } n | j�� } | | fD ]} d| k�r�| d= �q�| �� } | �� } nd } } |� d| j j | j j | j | | f� | j} �q�|dk �r�|j} |�r�| j�� } | j| jk�rRi } n | j�� } | | fD ]} d| k�rd| d= �qdt!| �� �} t!| �� �} nd } } |�"| j j | j j |j#| | f� |j$}�q t%�&| j��r t'| jt ��r t(| j�} t!t)t*j+| ��| _,n | jg| _,dS ) a- 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}. � Nz$Strings are not supported by Failurer � __failure__� __traceback__� __builtins__r )-�count�type�value� captureVars� isinstance�str� TypeError� _findFailure�sys�exc_infor# � Exception� __class__rB � _extrapolate�hasattrrD �getattrrE r �stackr) r- �f_backr8 �copyr7 �items�insertr6 r; r< �f_lineno�listr> r. r/ �inspect�isclass� issubclassr �mapr �qual�parents)r0 � exc_value�exc_type�exc_tbrJ r) Z stackOffsetr rV r@ r1 r2 �dZparentCsr r r r3 � s� � � zFailure.__init__c C st t � |j�| _t�� \}}}g }|dk r^|j}|jtkrV|�|jj|jj |j ddf� |j }q |� | j � || _ dS )a, 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} Nr )rX �__dict__rO rP r- r6 r= r> r; r< r. r/ �extendr )r0 Z otherFailure�_r) r r@ r r r rS | s � zFailure._extrapolatec G s$ | j |� }|s tr | �� n| �|S )a� 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} )�checkr �raiseException)r0 � errorTypes�errorr r r �trap� s z Failure.trapc G sB |D ]8}|}t �|�r*t|t�r*t�|�}|| jkr| S qdS )a 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_ rQ r ra rb )r0 rl rm �errr r r rj � s z Failure.check�with_tracebackc C s | j �| j��d S r: )rI rp r) �r0 r r r rk � s zFailure.raiseExceptionzBdef raiseException(self): raise self.type, self.value, self.tbzf raise the original exception, preserving traceback information if available. c C s |� | j| j| j�S )aJ 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. )�throwrH rI r) )r0 �gr r r �throwExceptionIntoGenerator� s z#Failure.throwExceptionIntoGeneratorc C s� t �� d }|sdS d}|}|jr.|}|j}q |j}|j| jjkrN|j�d�S |jj rj|jj |j | j krndS |r�|j}|j| j jkr�|j�d�S |jj }|r�|j| j jkr�|j�d�S dS )zV Find the failure that represents the exception currently in context. ���Nr0 )rO rP r/ r- r6 rk r? r8 �get�co_code�tb_lasti� _yieldOpcodert rW )�clsr) Z secondLastTbZlastTbZ lastFramer* r r r rN � s, � zFailure._findFailurec C s" dt �| j�t �| j�| �� f S )Nz <%s %s: %s>)r ra rR rH �getErrorMessagerq r r r �__repr__) s �zFailure.__repr__c C s d| � � S )Nz[Failure instance: %s])�getBriefTracebackrq r r r �__str__/ s zFailure.__str__c C s\ | j r | jS | j�� }dd� | jD �|d< d|d< | jdk rPdd� | jD �|d< d|d < |S ) z1Avoid pickling objects in the traceback. c S s6 g | ].}|d |d |d t |d �t |d �g�qS �r rC � � r �� _safeReprVars��.0�vr r r � <listcomp>: s � �z(Failure.__getstate__.<locals>.<listcomp>r Nr) c S s6 g | ].}|d |d |d t |d �t |d �g�qS r r� r� r r r r� H s � �rV rC �pickled)r� rg rX r rV )r0 �cr r r � __getstate__3 s � � zFailure.__getstate__c C s$ | � � | _t| jdd�r d| j_dS )z� 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}. rE N)r� rg rU rI rE rq r r r � cleanFailureT s zFailure.cleanFailurec C s0 | j dk r| j S t| j�dkr(t| j�S dS dS )a� 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. Nr )r) r% r r+ rq r r r �getTracebackObjecta s zFailure.getTracebackObjectc C s" t | jt�r| j�� S t�| j�S )zJ Get a string of the exception which caused this Failure. )rK rI rB r{ r �safe_strrq r r r r{ s s zFailure.getErrorMessagec C s t � }| j|d� |�� S )N)�file)�StringIO�printBriefTraceback�getvalue)r0 �ior r r r} | s zFailure.getBriefTracebackr c C s t � }| j|||d� |�� S )N)r� �elideFrameworkCoder )r� �printTracebackr� )r0 r� r r� r r r � getTraceback� s �zFailure.getTracebackc C s` |dkrddl m} |j}|j}|dkr4| js4d}n|}|dkr^|d| j| jrRdpTdf � nD|d kr�| jrrd }nd }|d |t� | j �t� | j �f � n|d � | jr�|s�t | j t d� ||� |dtf � t | j||� n|d ks�|d� |d k�s |dt�| j �t� | j �f � t| j t��rD|�d� | j �|||� |dk�r\|d| j � dS )a 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'}. Nr )�logr r z*--- Failure #%d%s--- z (pickled) � r � Tracebackz"Traceback (failure with no frames)z %s: %s: %s z#Traceback (most recent call last): z%s z Failure: z%s: %s z (chained Failure) z *--- End of Failure #%d --- )�twisted.pythonr� Zlogerrr rJ rG r� r r r� rH rI r" rV � traceupLength�EXCEPTION_CAUGHT_HEREra rK rB r� )r0 r� r� r r� r Z formatDetailZ hasFramesr r r r� � sN �� � � zFailure.printTracebackc C s | j ||dd� dS )z; Print a traceback as densely as possible. r �r N�r� �r0 r� r� r r r r� � s zFailure.printBriefTracebackc C s | j ||dd� dS )zQ Print a traceback with detailed locals and globals information. r r� Nr� r� r r r �printDetailedTraceback� s z Failure.printDetailedTraceback)NNNF)r r )NFr )Nr )Nr )"r r r r$ r� rV r �opcodeZopmapry �chrr3 rS rn rj rU � BaseExceptionrk �execrA rt rN � classmethodr| r~ r� r� r� r{ r} r� r� r� r� r r r r rB � sF � $ ! � 9! � F rB c C s dd� | D �S )aq 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. c S s g | ]\}}|t �|�f�qS r )r Z safe_repr)r� r �objr r r r� � s z!_safeReprVars.<locals>.<listcomp>r )Z varsDictItemsr r r r� � s r� TFc C s� |||fdkrnt �� }|d | jksntrnzt|d �}W n d}Y nX td|f � ddl}|�|d � || ||||� dS )z; Initialize failure object, possibly spawning pdb. )NNNr rC z broken strz8Jumping into debugger for post-mortem of exception '%s':Nr� )rO rP rR �DO_POST_MORTEMrL �print�pdbZ post_mortem) r0 rc rd re rJ ZFailure__init__�excZstrreprr� r r r � _debuginit� s �r� c C s t t_dS )z* Enable debug hooks for Failures. N)r� rB r3 r r r r �startDebugMode s r� )r )&r$ Z __future__r r r rX rO r r] r� r r� r Ztwisted.python.compatr r r� rG r� rQ r r" r� r# r+ �objectr( r, r5 r= rA r� rB r� r� r3 r� r� r r r r �<module> sB / +�
Save File
Cancel