-PhWdZddlZddlZddlZddlmZmZmZmZm Z m Z m Z ddl m Z ddlmZddlmZmZdedeeeffd Zded edefd Zd e d e eefdee fdZdedefdZejeZdefdZdedededdfdZ ddedeeefde e efdede e ede ef dZdedeee efde efdZ dedefdZ!dS)z8General helpers for the management of config parameters.N)AnyCallableDictIterableListOptionalUnion)Node)Sphinx)loggingmatchingappreturnct|jdr |jjSt|jdr |jjSiS)aReturn theme options for the application w/ a fallback if they don't exist. The "top-level" mapping (the one we should usually check first, and modify if desired) is ``app.builder.theme_options``. It is created by Sphinx as a copy of ``app.config.html_theme_options`` (containing user-configs from their ``conf.py``); sometimes that copy never occurs though which is why we check both. theme_optionshtml_theme_options)hasattrbuilderrconfigr)rs Y/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/pydata_sphinx_theme/utils.pyget_theme_options_dictrsHs{O,,{(( 1 2 2z,, keycftfd|jj|jjfDS)z3Check if the user has manually provided the config.c3 K|]}|vV dSN).0iirs r z*config_provided_by_user..!s'RRRsbyRRRRRRr)anyr overrides _raw_config)rrs `rconfig_provided_by_userr$s5 RRRRCJ$8#*:P#QRRR R RRrnode conditionc Zt|dr|j|fi|n |j|fi|S)zTriage node.traverse (docutils <0.18.1) vs node.findall. TODO: This check can be removed when the minimum supported docutils version for numpydoc is docutils>=0.18.1. findall)rr(traverse)r%r&kwargss rtraverse_or_findallr+$sK 4 # # 0  Y))&))) T]9 / / / /rstringcVtjd}|d|S)z=Helper function to remove ansi coloring from sphinx warnings.z(\x9B|\x1B\[)[0-?]*[ -\/]*[@-~])recompilesub)r, ansi_escapes r escape_ansir33s&*?@@K ??2v & &&rct|}|dd}|rtj|g|Ri|dStj|g|Ri|dS)z5Wraps the Sphinx logger to allow warning suppression.surface_warningsFN)rget SPHINX_LOGGERwarninginfo)rmsgargsr*r should_warns r maybe_warnr=<s{*3//M##$6>>K1c3D333F333333000000000rpagename templatenamecd|vrD|d}t|trt||}t|||d|d<dSdS)zASet the secondary sidebar items to render for the given pagename.theme_secondary_sidebar_itemssecondary_sidebar_itemsN) isinstancedict_get_matching_sidebar_items_update_and_remove_templates)rr>r?contextdoctree templatess rset_secondary_sidebar_itemsrJFsk''11;< i & & I3HiHHI-I    + . . )*** 21rrGrIsectiontemplates_skip_empty_checkc |g}t|trd|dD}g}|D]U tj dr| =| dVtj|}|||ig}|D] t fd|Dr| 3|j j |}t|dkr| |S)a Update templates to include html suffix if needed; remove templates which render empty. Args: app: Sphinx application passed to the html page context context: The html page context; dictionary of values passed to the templating engine templates: A list of template names, or a string of comma separated template names section: Name of the template section where the templates are to be rendered. Valid section names include any of the ``sphinx`` or ``html_theme_options`` that take templates or lists of templates as arguments, for example: ``theme_navbar_start``, ``theme_primary_sidebar_end``, ``theme_secondary_sidebar_items``, ``sidebars``, etc. For a complete list of valid section names, see the source for :py:func:`pydata_sphinx_theme.update_and_remove_templates` and :py:func:`pydata_sphinx_theme.utils.set_secondary_sidebar_items`, both of which call this function. templates_skip_empty_check: Names of any templates which should never be removed from the list of filtered templates returned by this function. These templates aren't checked if they render empty, which can save time if the template is slow to render. Returns: A list of template names (including '.html' suffix) to render into the section Nc6g|]}|Sr)strip)rtemplates r z0_update_and_remove_templates..~s"KKK(X^^%%KKKr,z.htmlc3BK|]}|VdSr)endswith)ritemrPs rr z/_update_and_remove_templates..s1NN4x  &&NNNNNNrr)rCstrsplitospathsplitextappendcopyupdater!rrIrenderlenrO) rrGrIrKrLsuffixed_templatesctxfiltered_templatesrenderedrPs @rrFrFWs~D")%'")S!!LKKiooc6J6JKKK :: 7  H % %a ( :  % %h / / / /  % %&8&8&8 9 9 9 9 )G  CJJ+,---&44 NNNN3MNNN N N 4  % %h / / / /{,33HcBBH8>>##$$))"))(333 rsidebarscd}g}|D]\\}}tj||rB|rrematchedrBpattern sidebar_itemss rrErEsG "*.."2"2 4 4  Xw / / 4 =11 mG6L6L !))e  G&3 # ""rrkc:tfddDS)zwCheck whether the pattern contains a wildcard. Taken from sphinx.builders.StandaloneHTMLBuilder.add_sidebars. c3 K|]}|vV dSrr)rcharrks rr z _has_wildcard..s'114tw111111rz*?[)r!)rks`rriris( 11115111 1 11rr)"__doc__r]rYr/typingrrrrrrr docutils.nodesr sphinx.applicationr sphinx.utilr r rWrboolr$typer+r3 getLogger__name__r7r=rJrFrErirrrrys>> GGGGGGGGGGGGGGGGGG%%%%%%))))))))4S>"SScSdSSSS    40  d^    '''''' "!(++ 1F1111   .1      ,7; ?? ? #s(^?T3Y? ? !)c 3 ?  #Y ????D##!#tCy.1# #Y####:2324222222r