-Ph,dZddlZddlZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZddlZddlmZ ddlmZn#e$r ddlmZYnwxYwejjd Zed d Zd ZdZd)dZdZ d*dZ!d+dddddZ"dZ#dZ$d,dZ%d+dZ&dZ'dZ(dZ)d,d Z*gd!Z+d"Z,d#Z-d$Z.d-d&Z/d'Z0d(Z1dS).z%Utilities. Miscellaneous utilities. N) defaultdict)partial)Path)copyfilemove)ExtensionError)status_iteratorzsphinx-galleryutf-8 )encodingnewlinec ddlm}n=#t$r0} ddl}n #t$rtd|wxYwYd}~nd}~wwxYw|S)Nr)ImagezUCould not import pillow, which is required to rescale images (e.g., for thumbnails): )PILr ImportErrorr)rexcs T/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx_gallery/utils.py _get_imager$s    LLLL    C=@CC   LLLL Ls A>6>Act}||}|j\}}|t|z }|t|z } ||z|kr|} n| } | dkr||krdSt t | |z} t t | |z} |jj} n#t$r |j} YnwxYw| | | f| }| d||fd}|| z dz|| z dzf}| || | |dS#t$r,|d |YdSwxYw)zScales image centered in image box using `max_width` and `max_height`. The same aspect ratio is retained. If `in_fname` == `out_fname` the image can only be scaled down. g?NRGBA)rrrRGB)ropensizefloatintround ResamplingBICUBIC ExceptionresizenewpastesaveOSErrorconvert)in_fname out_fname max_width max_heightrimgwidth_in height_inscale_wscale_hscalewidth_sc height_scbicubicthumb pos_inserts r scale_imager72s LLE **X  C(Hi%//)G5+++G7j(( ||I--5)**++HE%)+,,--I  "*    - **h *G 4 4C IIfy*57I J JEx'A- Y0F1/LMJ KKZ   - 9 --- e!!),,,,,,-s$- B::C C)E2E65E6ct|}|dr` tjdgt |z|gztjtjdS#tjtf$rYdSwxYwdS)a]Optimize a PNG in place. Parameters ---------- fname : str The filename. If it ends with '.png', ``optipng -o7 fname`` will be run. If it fails because the ``optipng`` executable is not found or optipng fails, the function returns. args : tuple Extra command-line arguments, such as ``['-o7']``. z.pngoptipngstdoutstderrN)strendswith subprocess check_calllistPIPECalledProcessErrorr&)fnameargss rr:r:bs JJE ~~f    ! d4jj(E72!!       -w7    DD   sAA((BBc tjddgtjtjdS#t$rYdSwxYw)Nr:z --versionr;TF)r@rArCr&r8r _has_optipngrI|s\  $Z_Z_    t uus -1 ??bc|dkrddd}ni}t|d|fi|5}|}|dkr |jdi|}tj|cdddS#1swxYwYdS)aReturns md5sum of file. Parameters ---------- src_file : str Filename to get md5sum for. mode : 't' or 'b' File mode to open file with. When in text mode, universal line endings are used to ensure consistency in hashes between platforms. tsurrogateescaper )errorsr rNr8)rreadencodehashlibmd5 hexdigest)src_filemodekwargssrc_data src_contents r get_md5sumrZs s{{-7CC h D - -f - -4mmoo 3;;,+,66v66K{;''1133 444444444444444444sA A::A>A>rrS)methodrVcheckct|}|dvsJ|<|dsJtj|d}d}tj|r|dkrt t|}n |dksJd} ||||k}n#t$rd }YnwxYw|rd }|d krtj |n t d |d ||r'|d krt||nt||tj|sJdS) N)rcopy.newrTrSrVjsoncjtjt|dS)Nr )raloadsr read_text)xs rfuncz_replace_md5..funcs&z$q''"3"3G"<"<===rHFrzReplacing stale z with )r>r?ospathsplitextisfilerrZr!removeloggerdebugrr) fname_new fname_oldr[rVr\replacerfequivs r _replace_md5rrsII % % % % %!!&)))))G$$Y//2 G w~~i  J E>>:D111DDF???? > > > DOOttI6EE   EEE   JG )$$$ LLHIHHYHH I I I+ V   I & & & & Y * * * 7>>) $ $$$$$$sB77 CCc^t}t}|D]P}tj|}||vr||;||Qt|dkr*t dt|dSdS)z9Check for duplicate filenames across gallery directories.rzjDuplicate example file name(s) found. Having duplicate file names will break some links. List of files: %sN) setrBrgrhbasenameappendaddlenrlwarningsorted)files used_names dup_names this_file this_fnames rcheck_duplicate_filenamesrsJI'' W%%i00  # #   Y ' ' ' ' NN: & & & & 9~~  9        rHctjd}tt|j|}|r*t dt|dSdS)z9Check for spaces in filenames across example directories.z[\s]zlExample file name(s) with spaces found. Having spaces in file names will break some links. List of files: %sN)recompilerBfiltersearchrlryrz)r{regexfiles_with_spaces rcheck_spaces_in_filenamesrsp Jw  EF5<7788   # $ $        rHFc|d}|rdnd}g}|D]}tj|tj}tj|D]\}} } tj|}|tj|z |krnt| D]p} t| jx} rX| |vrTtj |d| 9| } |r tj || } | | q|rt|t||S)aCollect files with `example_extensions`, accounting for `ignore_pattern`. If `check_filenames` we check one level of sub-folders as well as root `example_dirs` for gallery example files. We then check for duplicate and spaces in full file paths. example_extensionsrignore_pattern)rgrhabspathcountsepwalknormpathrsuffixrrjoinrvrr) examples_dirs gallery_confcheck_filenamesexts max_depthr{ example_dir example_depthroot_ filenamesfilenamesfiles r_collect_gallery_filesrsX , -D$+!I E$ + +  44::26BB "$'+"6"6 + + D!Y7##D))D 26""]2i??% + +h..A+AIIy.>!?JJR'*@#%7<<h#?#?D T***  +)!%(((!%((( LrHc lt|dz}tj|d5}|D]`}|(tj|d|z}||tj||a dddn #1swxYwYt||S)z Creates a zip file with the given files. A zip file named `zipname` will be created containing the files listed in `file_list`. The zip file contents will be stored with their paths stripped to be relative to `relative_to`. r_wr`Nr) r>zipfileZipFilergrhriwriterelpathrr) file_listzipname relative_to extension zipname_newzipfrEs r zip_filesrsg,,'K 3 / / /C4 C CE$((//2Y> JJubgooe[AA B B B B CCCCCCCCCCCCCCCC  NsA$BB!Bcl ddl}|}d|fS#ttf$rYdSwxYw)z$Check if pypandoc package available.rNT)NN)pypandocget_pandoc_versionrr&)rversions r _has_pypandocrsX--//W}  !zzs 33c| ddl}n5#t$r(}td|Yd}~dSd}~wwxYwdS)NrzP`graphviz` required for graphical visualization but could not be imported, got: FT)graphvizrrlinfo)rrs r _has_graphvizrso   5/2 5 5   uuuuu  4s 949c.tjdd|S)z9Remove ANSI terminal formatting characters from a string.z*(?:\x1B[@-_]|[\x80-\x9F])[0-?]*[ -/]*[@-~])rsub)rs r _escape_ansir+s 6?Q G GGrHcxd}|r|dz }|dd|z }|dz }|S)zFormat a toc tree.z .. toctree:: :hidden:z :includehidden: z {} z r )formatr)items includehiddensts r_format_toctreer0s\ B   6',,u%% & &'B$JB IrH) plot_1.py plot_3.py plot_2.pyz plot_5.pyz plot_6.pyz plot_4.pyz plot_8.pyz plot_7.pyz plot_9.pyc6t|S)z6Importable custom sorter func, used in our test suite.)_CUSTOM_EXAMPLE_ORDERindex)rs r_custom_example_sorterrOs & &x 0 00rHc|dddS)zMImportable custom sorter func for subsection folders, used in our test suite.Nr8) foldernames r_custom_subsection_sorterrTs ddd rHcXgd}|t|jS)zLImportable custom sorter for minigallery_sort_order, used in our test suite.)rrr)rrname)rORDERs r$custom_minigallery_sort_order_sorterrYs/   E ;;tDzz ' ''rHrc  t||j|dz}t|dfit5}t j||dddddddn #1swxYwYt|d dS) zWrite dictionary to JSON file.z .json.newrTFr) sort_keys ensure_asciiindentcheck_circularNra)r\)r with_namestemr_W_KWradumprr) target_fileto_saver codeobj_fnamefids r _write_jsonrds%%// 0@dCUCUCU0UVVM mS * *E * * c                      f------sA((A,/A,ct|dd5}tj|}dddn #1swxYwY|S)zRead JSON dictionary from file.rOr )r N)rraload) json_fnamer json_dicts r _read_jsonrss| j# 0 0 0#CIcNN ############### s 488ct|trC|D].\}}||g|/|S)zJCombine backreferences dictionaries, joining lists when keys are the same.) isinstancedictr setdefaultextend)dict_adict_bkeyvalues r_combine_backreferencesrzs]&$5 ,,.. 5 5JC   c2 & & - -e 4 4 4 4 MrH)r8)rJ)N)F)r)2__doc__rRrargrr@r collectionsr functoolsrpathlibrshutilrr sphinx.utilsphinx sphinx.errorsrsphinx.util.displayr r!utillogging getLoggerrlrrrr7r:rIrZrrrrrrrrrrrrrrrrrr8rHrrs ######!!!!!!!!((((((,3333333,,,++++++++,   & &'7 8 8 gt,,,   ------`44444.%f3e%%%%%D   ,    :$      HHH $   111  ((( . . . .sA AA