:j{ ddlZddlZddlZddlZddlZdededefdZdeededeefdZd ed ed ee eefddfd Z dd ed edededdf dZ y)Nfile_urlfolderreturnctjj|}tjj||}tjj |rt j d|d|tj|d}t|d5}|j|jddd|S#1swY|SxYw)a*Download a file from a URL into the given folder. If a file with the same name already exists, it will be overwritten. Returns the basename of the downloaded file. Network-related exceptions from ``requests.get`` (e.g., timeouts or connection errors) may propagate to the caller. z given file "z." already exists and will be overwritten with )timeoutwbN) ospathbasenamejoinisfileloggingwarningrequestsgetopenwritecontent)rrfname file_pathrqoutfiles w/home/mcse/projects/srt_converter/srt-converter-venv/lib/python3.12/site-packages/lightning_utilities/docs/retriever.py_download_filer s GG  X &E VU+I ww~~i ,yk1_`h_ijk h +B i "' bjj!" L" Ls CC  list_filespatterncg}|D]C}t|d5}|j}dddtj|}||z }E|S#1swY(xYw)aASearch for all occurrences of a regular-expression pattern across files. Args: list_files: The list of file paths to scan. pattern: A regular-expression pattern to search for in each file. Returns: A list with all matches found across the provided files (order preserved per file). UTF-8encodingN)rreadrefindall)rr collectedrfopembodyfounds r_search_all_occurrencesr)sfI )g . %::qA> ?E i' *ezz|$( U funGGGLL1'151E||C' ( iw /2 ?s$ D(DD ,D DD! assets_folder file_patternretrieve_patternc tjtjj|d|d}|st j d|d|dyt ||}|st jd |d |ytjj||}tj|d g}tt|D]i\}} t jd |d t|d| t| |} |j| tjj|| fk|D]} t| ||y)aFind S3 (or HTTP) asset URLs in docs, download them locally, and rewrite references to local paths. Args: docs_folder: The documentation root relative to the project. assets_folder: Subfolder inside ``docs_folder`` used to store downloaded assets (created if missing). file_pattern: Glob pattern of files to scan. retrieve_pattern: Regular-expression pattern used to find remote asset URLs. z**T) recursivez no files were listed in folder "z" and pattern ""N)rz"no resources/assets were match in z for )exist_okz >> downloading (/z): )globr r r rrr)infomakedirs enumeratesetr1rappendr<) r*r=r>r?rurls target_folderpairs_url_fileir8rr9s rfetch_external_assetsrOKs0277<< T<HTXYJ :;-WcVddefg ":7G HD  9+eL\K]^_GGLLmrUs  S##&S CDI(#CQUV[\_ad\dVeQfko2%,T !G!G!G!G !G  !GrP