ó öÀ„\c@@s-dZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlm Z ddlZddlmZdd lmZdd lmZmZmZmZdd lmZdd lmZdd lmZddlmZddlm Z ddl!m"Z"e"j#e$ƒZ%ej&dƒZ'e(rÛddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/ddlm0Z0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ne8e ej9ƒj:ƒZ;e<ƒZ=e d„ƒZ>d„Z?d„Z@d„ZAe d„ƒZBe d„ƒZCe dd„ƒZEdeFfd„ƒYZGd eHfd!„ƒYZId"eHfd#„ƒYZJd$efd%„ƒYZKd&efd'„ƒYZLd(„ZMddd)„ZNe d*„ƒZOd+efd,„ƒYZPd-efd.„ƒYZQdaRdd/„ZSdS(0sÊ sphinx.util.docutils ~~~~~~~~~~~~~~~~~~~~ Utility functions for docutils. :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. i(tabsolute_importN(tcontextmanager(tcopy(t LooseVersion(tpath(tnodes(t FileOutput(t Directivet directivestrolestconvert_directive_function(t StateMachine(tReporter(tRemovedInSphinx30Warning(tExtensionError(t__(tloggings>^(.+?:(?:\d+)?): \((DEBUG|INFO|WARNING|ERROR|SEVERE)/(\d+)?\) (tAnytCallablet GeneratortListtSettTuple(tStatetViewList(tConfig(tBuildEnvironment(tSphinxFileInputcc@soz'ttjƒ}ttjƒ}dVWd|t_|t_x+ttƒD]}t|ƒtj|ƒqIWXdS(s"Create namespace for reST parsers.N( RRt _directivesR t_rolestlisttadditional_nodestunregister_nodetdiscard(RRtnode((s3lib/python2.7/site-packages/sphinx/util/docutils.pytdocutils_namespace3s    cC@sttjd|jƒS(s'Check the *node* is already registered.tvisit_(thasattrRtGenericNodeVisitort__name__(R"((s3lib/python2.7/site-packages/sphinx/util/docutils.pytis_node_registeredEscC@s@ttjd|jƒs<tj|jgƒtj|ƒndS(s­Register a node to docutils. This modifies global state of some visitors. So it is better to use this inside ``docutils_namespace()`` to prevent side-effects. R$N(R%RR&R't_add_node_class_namesRtadd(R"((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt register_nodeKscC@s|ttjd|jƒrxttjd|jƒttjd|jƒttjd|jƒttjd|jƒndS(saUnregister a node from docutils. This is inverse of ``nodes._add_nodes_class_names()``. R$tdepart_N(R%RR&R'tdelattrtSparseNodeVisitor(R"((s3lib/python2.7/site-packages/sphinx/util/docutils.pyR Ws c#@sKddlm‰d‡fd†}z|tj_dVWdˆtj_XdS(s½Patch docutils.languages.get_language() temporarily. This ignores the second argument ``reporter`` to suppress warnings. refs: https://github.com/sphinx-doc/sphinx/issues/3788 i(t get_languagec@s ˆ|ƒS(N((t language_codetreporter(R/(s3lib/python2.7/site-packages/sphinx/util/docutils.pytpatched_get_languagensN(tdocutils.languagesR/tNonetdocutilst languages(R2((R/s3lib/python2.7/site-packages/sphinx/util/docutils.pyR2ds   cc@s€zItjjddƒ}|rCtjtj|ƒdƒtjd((s3lib/python2.7/site-packages/sphinx/util/docutils.pytpatch_docutils‹s tElementLookupErrorcB@seZRS((R't __module__(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRB“stsphinx_domainscB@sVeZdZd„Zd„Zd„Zd„Zd„Zd„Zd„Z d„Z RS( scMonkey-patch directive and role dispatch, so that domain-specific markup takes precedence. cC@s||_d|_d|_dS(N(tenvR4tdirective_funct roles_func(tselfRE((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt__init__›s  cC@s|jƒdS(N(tenable(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt __enter__¡scC@s|jƒdS(N(tdisable(RHttypetvaluet traceback((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt__exit__¥scC@s4tj|_tj|_|jt_|jt_dS(N(Rt directiveRFR trolet role_functlookup_directivet lookup_role(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRJ©s   cC@s|jt_|jt_dS(N(RFRRQRSR RR(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRL±s cC@s|jƒ}d|kr…|jddƒ\}}||jjkrÔ|jj|ƒ}t||ƒ|ƒ}|dk r‚|gfSqÔnO|jjjdƒ}|dk rÔt||ƒ|ƒ}|dk rÔ|gfSnt|jjdƒ|ƒ|ƒ}|dk r |gfSt ‚dS(stLookup a markup element (directive or role), given its name which can be a full name (with domain). t:itdefault_domaintstdN( tlowertsplitREtdomainst get_domaintgetattrR4t temp_dataR:RB(RHRMtnamet domain_nametdomaintelementt def_domain((s3lib/python2.7/site-packages/sphinx/util/docutils.pytlookup_domain_element¶s"      !  cC@s<y|jd|ƒSWn!tk r7|j|||ƒSXdS(NRQ(RdRBRF(RHR_t lang_moduletdocument((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRTÓs cC@s?y|jd|ƒSWn$tk r:|j||||ƒSXdS(NRR(RdRBRS(RHR_RetlinenoR1((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRUÚs ( R'RCt__doc__RIRKRPRJRLRdRTRU(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRD—s       t WarningStreamcB@seZd„ZRS(cC@sutj|ƒ}|s.tj|jdƒƒnC|jƒ\}}}tjd|ƒjƒ}tj||d|ƒdS(Ns ttlocation(t report_retsearchtloggertwarningtrstriptgroupstsubtlog(RHttexttmatchedRkRMtleveltmessage((s3lib/python2.7/site-packages/sphinx/util/docutils.pytwriteãs (R'RCRx(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRiâstLoggingReportercB@s2eZed„ƒZejejedd„ZRS(cC@s%||j|j|j|j|jƒS(sACreate an instance of LoggingReporter from other reporter object.(tsourcet report_levelt halt_levelt debug_flagt error_handler(tclsR1((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt from_reporterïstbackslashreplacec C@s/tƒ}tj||||||d|ƒdS(NR~(RiR RI(RHRzR{R|tdebugR~tstream((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRIös ( R'RCt classmethodR€R t WARNING_LEVELt SEVERE_LEVELtFalseRI(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRyîs t NullReportercB@seZdZd„ZRS(s A dummy reporter; write nothing.cC@stj|dddƒdS(NRjiçi(R RI(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRIs(R'RCRhRI(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRˆÿscC@s tdkS(Nii (ii i(t__version_info__(((s3lib/python2.7/site-packages/sphinx/util/docutils.pytis_html5_writer_availablescK@sŽtjdtƒt|tjtjfƒr_||_|pFddtf|_ ||_ t |ƒS|sq|sq|r†t t dƒƒ‚n|SdS(NsVfunction based directive support is now deprecated. Use class based directive instead.isCwhen adding directive classes, no additional arguments may be given(twarningstwarnR t isinstancettypest FunctionTypet MethodTypetcontentR‡t argumentstoptionsR RR(tobjt has_contentt argument_spect option_spec((s3lib/python2.7/site-packages/sphinx/util/docutils.pytdirective_helper s    cc@sYzB|jjj}tgdƒ}||_|j|jj_dVWd||jj_XdS(s1Switch current source input of state temporarily.N(tmemoR1tget_source_and_lineR R4t input_lines(tstateR‘Ršt state_machine((s3lib/python2.7/site-packages/sphinx/util/docutils.pytswitch_source_inputs  tSphinxFileOutputcB@s eZdZd„Zd„ZRS(s#Better FileOutput class for Sphinx.cK@s)|jdtƒ|_tj||dS(Ntoverwrite_if_changed(R=R‡R RRI(RHtkwargs((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRI4scC@sŒ|jr||jr|d|jkr||jr|tjj|jƒr|tj|jd|j ƒ}|j ƒ|krs|SWdQXnt j ||ƒS(Ntbtencoding( tdestination_patht autoclosetmodeR R8RtexiststcodecstopenR£treadRRx(RHtdatatf((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRx9s ! (R'RCRhRIRx(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRŸ1s tSphinxDirectivecB@s,eZdZed„ƒZed„ƒZRS(sëA base class for Sphinx directives. This class provides helper methods for Sphinx directives. .. note:: The subclasses of this class might not work with docutils. This class is strongly coupled with Sphinx. cC@s|jjjjS(s3Reference to the :class:`.BuildEnvironment` object.(RœRftsettingsRE(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyRENscC@s |jjS(s)Reference to the :class:`.Config` object.(REtconfig(RH((s3lib/python2.7/site-packages/sphinx/util/docutils.pyR¯Ts(R'RCRhtpropertyRER¯(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyR­EscC@sntdkr!tjj|ƒan|dkr?ttjƒ}ntj|tj d|ƒ}|j |dƒ|S(s&Return a new empty document object. This is an alternative of docutils'. This is a simple wrapper for ``docutils.utils.new_document()``. It caches the result of docutils' and use it on second call for instanciation. This makes an instantiation of document nodes much faster. RziÿÿÿÿN( t__document_cache__R4R5tutilst new_documentRR®RRfR1t note_source(t source_pathR®Rf((s3lib/python2.7/site-packages/sphinx/util/docutils.pyR³`s  (TRht __future__RR¨R8treRŽR‹t contextlibRRtdistutils.versionRRR5Rt docutils.ioRtdocutils.parsers.rstRRR R tdocutils.statemachineR tdocutils.utilsR tsphinx.deprecationR t sphinx.errorsRt sphinx.localeRt sphinx.utilRt getLoggerR'RntcompileRlR‡ttypingRRRRRRRRt sphinx.configRtsphinx.environmentRt sphinx.ioRttuplet __version__tversionR‰tsetRR#R(R+R R2R@R4RAt ExceptionRBtobjectRDRiRyRˆRŠR˜RžRŸR­R±R³(((s3lib/python2.7/site-packages/sphinx/util/docutils.pyt sd      ".   K