-Phq@dZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z e dZd Zd Zd ZejeezejZed zZed zZejededejZdZdZdZedgdZddZdZdZdS)zParser for python source files.N) namedtuple)BytesIO)dedent)ExtensionError) getLoggerzsphinx-galleryzD SyntaxError =========== Example script with invalid Python syntax z ^[\ \t]*#\s*z6sphinx_gallery_([A-Za-z0-9_]+)(\s*=\s*(.+))?[\ \t]*\n?sphinx_gallery_start_ignoresphinx_gallery_end_ignorez (?:[\s\S]*?)z\n?ct|dd5}|}dddn #1swxYwY tj|}||fS#t$rd|fcYSwxYw)zParse source file into AST node. Parameters ---------- filename : str File path Returns ------- node : AST node content : utf-8 encoded string rzutf-8)encodingN)openreadastparse SyntaxError)filenamefidcontentnodes _/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx_gallery/py_source_parser.pyparse_source_filer.s hg . . .#((**y!!W} W}s488AA)(A)c^t|\}}| t|d|fSt|tjs,t d|jj|j rOt|j dtj r*t|j dj tj s"t d|tj |}|J|j dj j dddkrd|z}tjt|j}|D]}|jdkr |j\}}nd}d|d|d}|dz }||||fS)aSeparate ``filename`` content between docstring and the rest. Strongly inspired from ast.get_docstring. Returns ------- docstring : str docstring of ``filename`` rest : str ``filename`` content without the docstring lineno : int The line number. node : ast.Module The ast node. When `filename` parsed with `mode='exec'` node should be of type `ast.Module`. Nz4This function only supports modules. You provided {}rzCould not find docstring in file "{}". A docstring is required by sphinx-gallery unless the file is ignored by "ignore_pattern" )rSYNTAX_ERROR_DOCSTRING isinstancerModulerformat __class____name__bodyExprvalueConstant get_docstringtokenizerencodereadline exact_typeendjoinsplit) rrr docstringtstklineno_rests r_get_docstring_and_restr4Fs"&h//MD' |%w477 dCJ ' '  B I I'       ty|SX . .   ty|)3< 8 8   ==CVH=M=M   !$''I   y|#t++9$  77>>#3#344= > >B =A  IFA E  99W]]4((1 2 2D aKF dFD ((c8i}tjt|D]|}|d}|d}|/ t j|}|||<J#t tf$rt d||YywxYw|S)z=Pull out the file-specific config specified in the docstring.rrNz4Sphinx-gallery option %s was passed invalid value %s) refinditerINFILE_CONFIG_PATTERNgroupr literal_evalr ValueErrorloggerwarning)r file_confmatchnamer$s rextract_file_configrBsI2G<< $ ${{1~~ A =  $$U++E $IdOO Z(    NNFe       s A''-BBBlock)typerr1Fct|\}}}}td|dg}t|}tjdtj}tjdtj} d} tj||D]"} || | } | r$| td| ||| dz }|dz }| d } ttj | d | }|r$| td|||| dz }| } $|| d }|r$| td||||f}|r||fz }|S) a~Return list with source file separated into code and text blocks. Parameters ---------- source_file : str Path to the source file. return_node : bool If True, return the ast node. Returns ------- file_conf : dict File-specific settings given in source file comments as: ``# sphinx_gallery_ = `` blocks : list (label, content, line_number) List where each element is a tuple with the label ('text' or 'code'), the corresponding content string of block and the leading line number. node : ast.Module The parsed ast node. textrzC(?P^#{20,}.*|^# ?%%.*)\s(?P(?:^#.*\s?)*))flagsz^#rcoder text_contentN)r4rCrBr7compileMr8startstripappendcountr:rsublstripr+) source_file return_noder.rest_of_contentr1rblocksr?patternsub_pat pos_so_farr@code_block_contentrItext_block_contentremaining_contentouts rsplit_code_and_text_blocksr^s,0G{/S/S,IFIq)) *F#O44IjNdGjRT***GJWo66 ! !,Z%++---GH  # # % % E MM%(:FCC D D D$**4000! {{>22 #BF7B $E$EFFMMOO  # # % % E MM%(:FCC D D D,$$T***YY[[ ' 4  @ eF$5v>>??? f C w Jr5c6ttjt|tj}ttjt |tj}||krt dtjtd|dS)al Return the content of *code_block* with ignored areas removed. An ignore block starts with # sphinx_gallery_start_ignore, and ends with # sphinx_gallery_end_ignore. These lines and anything in between them will be removed, but surrounding empty lines are preserved. Parameters ---------- code_block : str A code segment. z^All "sphinx_gallery_start_ignore" flags must have a matching "sphinx_gallery_end_ignore" flag!rJr) lenr7findallSTART_IGNORE_FLAG MULTILINEEND_IGNORE_FLAGrsubnIGNORE_BLOCK_PATTERN) code_blocknum_start_flags num_end_flagss rremove_ignore_blocksrjs}"*%6 BLQQRRO ?J MMNNM-'' 0    7'Z 8 8 ;;r5cBtjtd|\}}|S)a  Return the content of *code_block* with in-file config comments removed. Comment lines of the pattern '# sphinx_gallery_[option] = [val]' are removed, but surrounding empty lines are preserved. Parameters ---------- code_block : str A code segment. rJ)r7rer9)rg parsed_coder2s rremove_config_commentsrms"W2B CCNK r5)F)__doc__rr7r' collectionsriortextwrapr sphinx.errorsrsphinx.util.loggingrr=r FLAG_START FLAG_BODYrKrcr9rbrdrfrr4rBrCr^rjrmr5rrws&&  """"""(((((()))))) # $ $" E " : #92<HH!>>::!rz;;;;;R\ 0;););)|&  7999:: 8888v<<<0     r5