ó öÀ„\c@@s"dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZmZdd lmZdd lmZerdd lmZmZmZmZmZmZmZmZddl m Z dd lmZnd Z dZ!ed„ƒZ"e"j#iej$d6ej$d6ej%d6ej&d6ej'd6e!d6ej(d6ƒed„ƒZ)e)j#iej'd6e!d6ej(d6ƒed„ƒZ*e*j#idej%6dej&6dej(6ƒd„Z+d„Z,d ej-fd!„ƒYZ.d"e.fd#„ƒYZ/d$e.fd%„ƒYZ0d&ej1fd'„ƒYZ2d(ej3fd)„ƒYZ4d*ej3fd+„ƒYZ5d,ej3fd-„ƒYZ6er­e5Z7ne6Z7d.ej8j9fd/„ƒYZ:ed0„ƒZ;ed1„ƒZ<ee=d2„ƒZ>d3e?fd4„ƒYZ@d5ejAfd6„ƒYZBd7„ZCd8ejAfd9„ƒYZDd:ejAfd;„ƒYZEd<ejAfd=„ƒYZFd>ejAfd?„ƒYZGd@eGfdA„ƒYZHdBeGfdC„ƒYZIdD„ZJdEejKfdF„ƒYZLdGe?fdH„ƒYZMdIe?fdJ„ƒYZNdK„ZOdS(LsÎ sphinx.util.logging ~~~~~~~~~~~~~~~~~~~ Logging utility functions for Sphinx. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. i(tabsolute_importN(t defaultdict(tcontextmanager(tnodes(tget_source_line(tPY2tStringIO(t SphinxWarning(tcolorize(tAnytDictt GeneratortIOtListtTupletTypetUnion(tSphinxtsphinxicC@stjS(N(tloggingtWARNING(((s2lib/python2.7/site-packages/sphinx/util/logging.pyt#stCRITICALtSEVEREtERRORRtINFOtVERBOSEtDEBUGcC@sdS(Ni((((s2lib/python2.7/site-packages/sphinx/util/logging.pyR.siicC@sdS(Ntblue((((s2lib/python2.7/site-packages/sphinx/util/logging.pyR5stdarkredtredtdarkgraycC@s-tjtd|ƒ}t|_t|iƒS(süGet logger wrapped by :class:`sphinx.util.logging.SphinxLoggerAdapter`. Sphinx logger always uses ``sphinx.*`` namespace to be independent from settings of root logger. It ensures logging is consistent even if a third-party extension or imported application resets logger settings. Example usage:: >>> from sphinx.util import logging >>> logger = logging.getLogger(__name__) >>> logger.info('Hello, this is an extension!') Hello, this is an extension! t.(Rt getLoggert NAMESPACEtFalsetdisabledtSphinxLoggerAdapter(tnametlogger((s2lib/python2.7/site-packages/sphinx/util/logging.pyR!=s cC@scx\|D]T}|jƒ|_d|_t|ddƒ}t|tjƒrt|ƒ|_ qqWdS(sConvert LogRecord serializable.tlocationN(( t getMessagetmsgtargstgetattrtNonet isinstanceRtNodetget_node_locationR((trecordstrR(((s2lib/python2.7/site-packages/sphinx/util/logging.pytconvert_serializableTs   tSphinxLogRecordcB@s#eZdZdZdZd„ZRS(s$Log record class supporting locationtcC@sitt|ƒjƒ}t|ddƒ}|rFd||j|f}n|j|kre|j|}n|S(NR(s%s: %s%s(tsuperR4R)R,R-tprefix(tselftmessageR(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR)fsN(t__name__t __module__t__doc__R7R-R(R)(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR4astSphinxInfoLogRecordcB@seZdZdZRS(s)Info log record class supporting locationR5(R:R;R<R7(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR=rstSphinxWarningLogRecordcB@seZdZdZRS(s,Warning log record class supporting locations WARNING: (R:R;R<R7(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR>wsR%cB@s2eZdZd„Zd„Zd„Zd„ZRS(s9LoggerAdapter allowing ``type`` and ``subtype`` keywords.cO@s^t|tƒr1tt|ƒj||||Žn)t|}tt|ƒj||||ŽdS(N(R.tintR6R%tlogt LEVEL_NAMES(R8tlevelR*R+tkwargstlevelno((s2lib/python2.7/site-packages/sphinx/util/logging.pyR@s" cO@s|jt|||ŽdS(N(R@R(R8R*R+RC((s2lib/python2.7/site-packages/sphinx/util/logging.pytverbose‡scC@sÆ|jdiƒ}d|kr4|jdƒ|d|jD]2}t|tƒr<|j |ƒ|j |ƒq<q<W|j |ƒ|VWd|j |ƒx|D]}|j |ƒqœW|j |ƒXdS(s`Contextmanager to pend logging warnings temporary. Similar to :func:`pending_logging`. N( RR!R"R[tsetLevelRthandlersR.RPt removeHandlertappendt addHandlerR_(R't memhandlerRbthandler((s2lib/python2.7/site-packages/sphinx/util/logging.pytpending_warningsës      cc@s£tjtƒ}tƒ}zKg}x,|jD] }|j|ƒ|j|ƒq,W|j|ƒ|VWd|j|ƒx|D]}|j|ƒqzW|j|ƒXdS(sContextmanager to pend logging all logs temporary. For example:: >>> with pending_logging(): >>> logger.warning('Warning message!') # not flushed yet >>> some_long_process() >>> Warning message! # the warning is flushed here N( RR!R"R[RbRcRdReR_(R'RfRbRg((s2lib/python2.7/site-packages/sphinx/util/logging.pytpending_loggings       cc@s…tjtƒ}|tkr#dVn^z9tƒ}x$|jD]}|jjd|ƒq9WdVWdx|jD]}|j|ƒqiWXdS(s8contextmanager to skip WarningIsErrorFilter for a while.Ni( RR!R"R#tDisableWarningIsErrorFilterRbtfilterstinsertt removeFilter(tskipR'tdisablerRg((s2lib/python2.7/site-packages/sphinx/util/logging.pytskip_warningiserror)s   t LogCollectorcB@s eZd„Zed„ƒZRS(cC@s g|_dS(N(tlogs(R8((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\?scc@s*tƒ}dV|jƒ|_WdQXdS(N(RiR`Rr(R8Rf((s2lib/python2.7/site-packages/sphinx/util/logging.pytcollectCs (R:R;R\RRs(((s2lib/python2.7/site-packages/sphinx/util/logging.pyRq>s t InfoFiltercB@seZdZd„ZRS(s"Filter error and warning messages.cC@s|jtjkrtStSdS(N(RDRRtTrueR#(R8RO((s2lib/python2.7/site-packages/sphinx/util/logging.pytfilterOs(R:R;R<Rv(((s2lib/python2.7/site-packages/sphinx/util/logging.pyRtLscC@sœ|dkrtSx…|D]}}d|krD|jddƒ\}}n |d}}||kr|dks|dks||ks|dkr”tSqqWtS(s'Check the warning is suppressed or not.R it*N(R-R#tsplitRu(RGRHtsuppress_warningst warning_typettargett subtarget((s2lib/python2.7/site-packages/sphinx/util/logging.pytis_suppressed_warningWs      tWarningSuppressorcB@s eZdZd„Zd„ZRS(s#Filter logs by `suppress_warnings`.cC@s ||_tt|ƒjƒdS(N(tappR6R~R\(R8R((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\ns cC@st|ddƒ}t|ddƒ}y|jjj}Wntk rPg}nXt|||ƒrgtS|jjd7_t SdS(NRGRHi( R,R-RtconfigRytAttributeErrorR}R#t _warncountRu(R8RORGRHRy((s2lib/python2.7/site-packages/sphinx/util/logging.pyRvss  (R:R;R<R\Rv(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR~ks tWarningIsErrorFiltercB@s eZdZd„Zd„ZRS(s#Raise exception if warning emitted.cC@s ||_tt|ƒjƒdS(N(RR6RƒR\(R8R((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\ˆs cC@sŸt|dtƒrtS|jjr—t|ddƒ}y|j|j}Wn ttfk rj|j}nX|rˆt |d|ƒ‚q›t |ƒ‚ntSdS(Ntskip_warningsiserrorR(R5t:( R,R#RuRtwarningiserrorR*R+t TypeErrort ValueErrorR(R8ROR(R9((s2lib/python2.7/site-packages/sphinx/util/logging.pyRvs  (R:R;R<R\Rv(((s2lib/python2.7/site-packages/sphinx/util/logging.pyRƒ…s RjcB@seZdZd„ZRS(s6Disable WarningIsErrorFilter if this filter installed.cC@s t|_tS(N(RuR„(R8RO((s2lib/python2.7/site-packages/sphinx/util/logging.pyRv¤s (R:R;R<Rv(((s2lib/python2.7/site-packages/sphinx/util/logging.pyRj¡stSphinxLogRecordTranslatorcB@s&eZdZdZd„Zd„ZRS(s‚Converts a log record to one Sphinx expects * Make a instance of SphinxLogRecord * docname to path if location given cC@s ||_tt|ƒjƒdS(N(RR6R‰R\(R8R((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\²s cC@s t|tjƒr!|j|_nt|ddƒ}t|tƒr°|\}}|r|rd|jj j |ƒ|f|_ q|r¤d|jj j |ƒ|_ qd|_ nUt|t j ƒrÔt|ƒ|_ n1|rd|krd|jj j |ƒ|_ ntS(NR(s%s:%ss%sR…(R.Rt LogRecordtLogRecordClasst __class__R,R-ttupleRtenvtdoc2pathR(RR/R0Ru(R8ROR(tdocnametlineno((s2lib/python2.7/site-packages/sphinx/util/logging.pyRv·s  % N(R:R;R<R-R‹R\Rv(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR‰ªs tInfoLogRecordTranslatorcB@seZdZeZRS(s/LogRecordTranslator for INFO level log records.(R:R;R<R=R‹(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR’ÎstWarningLogRecordTranslatorcB@seZdZeZRS(s2LogRecordTranslator for WARNING level log records.(R:R;R<R>R‹(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR“ÓscC@sPt|ƒ\}}|r,|r,d||fS|r:d|S|rHd|SdSdS(Ns%s:%ss%s:s :%s(RR-(tnodetsourcetline((s2lib/python2.7/site-packages/sphinx/util/logging.pyR0Øs tColorizeFormattercB@seZd„ZRS(cC@sftt|ƒj|ƒ}t|ddƒ}|dkrKtj|jƒ}n|r^t||ƒS|SdS(NRJ( R6R—tformatR,R-t COLOR_MAPtgetRDR(R8ROR9RJ((s2lib/python2.7/site-packages/sphinx/util/logging.pyR˜æs  (R:R;R˜(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR—åstSafeEncodingWritercB@s)eZdZd„Zd„Zd„ZRS(s7Stream writer which ignores UnicodeEncodeError silentlycC@s(||_t|ddƒpd|_dS(Ntencodingtascii(RSR,Rœ(R8RS((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\õs cC@sWy|jj|ƒWn<tk rR|jj|j|jdƒj|jƒƒnXdS(Ntreplace(RSRUtUnicodeEncodeErrortencodeRœtdecode(R8tdata((s2lib/python2.7/site-packages/sphinx/util/logging.pyRUús cC@s&t|jdƒr"|jjƒndS(NRW(thasattrRSRW(R8((s2lib/python2.7/site-packages/sphinx/util/logging.pyRWs(R:R;R<R\RURW(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR›ós  tLastMessagesWritercB@s eZdZd„Zd„ZRS(s?Stream writer which memories last 10 messages to save trackbackcC@s ||_dS(N(R(R8RRS((s2lib/python2.7/site-packages/sphinx/util/logging.pyR\ scC@s|jjj|ƒdS(N(Rt messagelogRd(R8R¢((s2lib/python2.7/site-packages/sphinx/util/logging.pyRUs(R:R;R<R\RU(((s2lib/python2.7/site-packages/sphinx/util/logging.pyR¤ s cC@s…tjtƒ}|jtjƒt|_x|jD]}|j|ƒq3Wt t |ƒƒ}|j t ƒƒ|j t |ƒƒ|jt|jƒ|jtƒƒtt |ƒƒ}|j t|ƒƒ|j t|ƒƒ|j t|ƒƒ|jtjƒ|jtƒƒtjt||ƒƒ}|j t ƒƒ|jt|jƒ|jtƒƒ|j|ƒ|j|ƒ|j|ƒdS(sSetup root logger for SphinxN(RR!R"RaRR#t propagateRbRctNewLineStreamHandlerR›t addFilterRtR’t VERBOSITY_MAPt verbosityt setFormatterR—RPR~R“RƒRt StreamHandlerR¤Re(RtstatustwarningR'Rgt info_handlertwarning_handlertmessagelog_handler((s2lib/python2.7/site-packages/sphinx/util/logging.pytsetups.   (PR<t __future__RRtlogging.handlerst collectionsRt contextlibRtdocutilsRtdocutils.utilsRtsixRRt sphinx.errorsRtsphinx.util.consoleRR#ttypingR R R R R RRRtsphinx.applicationRR"RRAtupdateRRRRRR©R™R!R3RŠR4R=R>t LoggerAdapterR%R¬RPRQRYR§RbtBufferingHandlerR[RhRiRuRptobjectRqtFilterRtR}R~RƒRjR‰R’R“R0t FormatterR—R›R¤R²(((s2lib/python2.7/site-packages/sphinx/util/logging.pyt s„  :             $ !  $