B lU\@s~dZddlZddlZddlmZmZmZmZmZm Z m Z m Z m Z m Z ddlmZddlmZGdddZGd d d eZdS) a Some utility classes for exception handling of exceptions raised within listeners: - TracebackInfo: convenient way of getting stack trace of latest exception raised. The handler can create the instance to retrieve the stack trace and then log it, present it to user, etc. - ExcPublisher: example handler that publishes a message containing traceback info :copyright: Copyright since 2006 by Oliver Schoenborn, all rights reserved. :license: BSD, see LICENSE_BSD_Simple.txt for details. N) TupleListSequenceMappingDictCallableAnyOptionalUnionTextIO)IListenerExcHandler) TopicManagerc@s@eZdZdZddZeedddZedddZd d Z d S) TracebackInfoaR Represent the traceback information for when an exception is raised -- but not caught -- in a listener. The complete traceback cannot be stored since this leads to circular references (see docs for sys.exc_info()) which keeps listeners alive even after the application is no longer referring to them. Instances of this object are given to listeners of the 'uncaughtExcInListener' topic as the excTraceback kwarg. The instance calls sys.exc_info() to get the traceback info but keeps only the following info: * self.ExcClass: the class of exception that was raised and not caught * self.excArg: the argument given to exception when raised * self.traceback: list of quadruples as returned by traceback.extract_tb() Normally you just need to call one of the two getFormatted() methods. cCsft}|d|_|d|_t|d}d}ddl}|d||ddsRt||d|_~dS)Nrr zpubsub.core.listener\.py) sysexc_infoExcClassexcArg traceback extract_tbresearchAssertionError)selfZtmpInfoZtb_listZ IGNORE_FRAMESrr7lib/python3.7/site-packages/pubsub/utils/exchandling.py__init__,s  zTracebackInfo.__init__)returncCs&t|j}|t|j|j|S)z Get a list of strings as returned by the traceback module's format_list() and format_exception_only() functions. )r format_listextendformat_exception_onlyrr)rZtmprrrgetFormattedList:s zTracebackInfo.getFormattedListcCsd|S)z Get a string similar to the stack trace that gets printed to stdout by Python interpreter when an exception is not caught. )joinr")rrrrgetFormattedStringCsz TracebackInfo.getFormattedStringcCs|S)N)r%)rrrr__str__JszTracebackInfo.__str__N) __name__ __module__ __qualname____doc__rrstrr"r%r&rrrrrs  rc@s@eZdZdZdZd edddZedddZed d d Z dS) ExcPublisherz Example exception handler that simply publishes the exception traceback. The messages will have topic name given by topicUncaughtExc. ZuncaughtExcInListenerN)topicMgrcCs|dk r||dS)z If topic manager is specified, will automatically call init(). Otherwise, caller must call init() after pubsub imported. See pub.setListenerExcHandler(). N)init)rr-rrrrWszExcPublisher.__init__cCs2||j}|d|tddd||_dS)zw Must be called only after pubsub has been imported since this handler creates a pubsub topic. z-generated when a listener raises an exceptionz!string representation of listenerz3instance of TracebackInfo containing exception info) listenerStr excTracebackN)ZgetOrCreateTopictopicUncaughtExcZsetDescriptionZ setMsgArgSpecdict_ExcPublisher__topicObj)rr-objrrrr.`s    zExcPublisher.init) listenerIDcCst}|jj||ddS)z Handle the exception raised by given listener. Send the Traceback to all subscribers of topic self.topicUncaughtExc. )r/r0N)rr3Zpublish)rr5ZtopicObjZtbInforrr__call__lszExcPublisher.__call__)N) r'r(r)r*r1rrr.r+r6rrrrr,Ns   r,)r*rrtypingrrrrrrrr r r Z core.listenerr Z core.topicmgrrrr,rrrrs 0  7