ieddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z de de ddfdZ dde d ed e d e d e d e de fdZde dee fdZde de de ede fdZ dde de de e ee fdee deddf dZy)N)Iterable)OptionalUnionpath_inpath_outreturnct|5}|j}dddd}tD]i\}}|jdr&|ddj ddj }=|jdsO|j dd|d }|||<kt|d 5}|j|dddy#1swYxYw#1swYyxYw) zAdjust changelog headers to avoid duplication of short subtitles. Args: path_in: Input Markdown file path. path_out: Output Markdown file path. Nz## -rz### z###z -w)open readlines enumerate startswithsplitstripreplace writelines)rrfp chlog_lines chlog_verilns x/Volumes/fast/ai/experiments/voice-extract-mac/.venv/lib/python3.12/site-packages/lightning_utilities/docs/formatting.py_transform_changelogrs g"lln  I;'2 == 12 S)!,224I ]]6 "ET)B#78BKN ( h  k"     sC*CCCdomaininfo github_user github_repo main_branch stable_branchcrdttttfffd }|dk7sdsy d|z}|j dd }|d j ||}dj|g|j dd d}d |d|d|S#t$rdj ddd z}Y}wxYw)Nrctjd}djdD]}t||}t t j |tfddDritjjtjjddd}t tjj|nCdtjjtjjdt j|\}}||t|zd z fS) Nmodulefullname.c3&K|]}|v yw)N).0sfnames r z9_linkcode_resolve..find_source..5sH#GaqEz#Gs) readthedocsrtfd checkoutsz..)start/)sysmodulesrgetattrstrinspect getsourcefileanyospathabspathjoinrelpathgetsourcelineslen)objpartpath_topsource line_startr,rr!s @r find_sourcez&_linkcode_resolve..find_source-skk$x.)$**3/D#t$C0G))#./ H#GH Hwwrww||D$'EFHX>?E#m1RWW__U"''//RVBW_%X$YZE$33C8 j*s6{":Q">>>pyr%r z %s#L%d-L%dr'r2.pyr)lateststabler3zhttps://github.com/z/blob/)tupler7int Exceptionrrgetr>) rrrr r!r"rGfilenamebranchs ` ` r_linkcode_resolverS%s?sC}-?&~T(^<+-/ ^^C  #F#} = A A&& QFxx:(.."5ab"9:;H  Q{m6( LL <>))#s3e;>> _load_pypi_versions("numpy") # doctest: +ELLIPSIS ['0.9.6', '0.9.8', '1.0', ...] >>> _load_pypi_versions("scikit-learn") # doctest: +ELLIPSIS ['0.9', '0.10', '0.11', '0.12', ...] rN)Versionzhttps://pypi.org/pypi/z/json )timeoutreleasesz ^\d+(\.\d+)*$)key) requestspackaging.versionrVrPjsonkeysrematchsorted)rTr[rVurldataversionsks r_load_pypi_versionsrfPs{) "<. 6C <<R< ( - - /DJ$$&H#E8arxx0@!'D8HE ( ((Fs A8%A8linkpkg_verversion_digitscl|jd} t|dd}|jdd}dj |jdd|}|jd|d|S#t$r9tjdj |dd}t ||d}YwxYw)aResolve a ``{package.version}`` placeholder in a link using the latest available version. Args: link: The link template containing a ``{...}`` placeholder to replace. pkg_ver: A dotted path to resolve the version (e.g., ``"numpy.__version__"``). version_digits: Number of version components to keep (e.g., ``2`` -> ``"1.26"``). If ``None``, keep all. Returns: The link with the ``{...}`` placeholder replaced by a version string. r'rN+{})rrfrO importlib import_moduler>r6r)rgrhripkg_attverr%s r#_update_link_based_imported_packagersdsmmC G*!'!*-b1 ))C. C ((399S>/>2 3C <<"WIR(# .. *(('#2,)?@fgaj) *sA11?B32B3 source_link target_link browse_folderfile_extensionsc 0g}t|tr|g}|D]E}|D]>}|tjtjj |dd|dz }@G|st jd|d|dytjd |}|D]} t|| |}t|D]} t| d 5} | j} dddd \} }t D]C\}}tj d |vrd}|s||vr|j#||| |<d} |s=d|vsBd}E| st j$d| d|d|dt| dd 5}|j'| dddy#1swYxYw#1swYxYw)a|Adjust the linked external docs to be local. Args: source_link: the link to be replaced target_link: the link to be replaced, if ``{package.version}`` is included it will be replaced accordingly browse_folder: the location of the browsable folder file_extensions: what kind of files shall be scanned version_digits: for semantic versioning, how many digits to be considered Examples: >>> adjust_linked_external_docs( ... "https://numpy.org/doc/stable/", ... "https://numpy.org/doc/{numpy.__version__}/", ... "docs/source", ... ) z***T) recursivez No files were listed in folder "z" and pattern ""Nz{(.+)}zUTF-8)encoding)FF()Fzlinks adjusting in z: "z" -> "r ) isinstancer7globr;r<r>loggingwarningr_findallrssetrrradjust_linked_external_docs__name__rdebugr)rtrurvrwri list_filesfolderext pkg_ver_allrhfpathfopenlinesfoundskiprrfws rrrs0J-%& "C $))BGGLL3%y$IUYZ ZJ#  :=/YhXiijkl**Y 4K9+wP^_ Z %' *eOO%E+" tu%EAr-667q9R?K2-::k;?ar &  +E7#k]& UVWX %w /2 MM% 0 /%! * *"0 /sF#F F F )masterzrelease/stable))z.rstrJr )rror8rr;r_r4collections.abcrtypingrrr7rdictrSlistrfrNrsrr)rHrrs,  $"#####6 ) (M (M (M(M (M  (M  (M (MV)c)d3i)(/c/C/QYZ]Q^/cf/@&5 ;!;!;!hsm+,;!c] ;!  ;!  ;!rH