o poi@sddlZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z de de ddfddZ d#d e d ed e de de de de fddZde dee fddZde de de ede fddZ  d$de de de e ee fd ee deddf d!d"ZdS)%N)Iterable)OptionalUnionpath_inpath_outreturncCst| }|}Wdn1swYd}t|D]*\}}|dr5|dddd}q|drH|dd|d }|||<qt|d }||WddS1s_wYdS) zAdjust changelog titles so not to be duplicated. Args: path_in: input MD file path_out: output also MD file Nz## -rz### z###z -w)open readlines enumerate startswithsplitstripreplace writelines)rrfp chlog_lines chlog_verilnrW/home/ubuntu/.local/lib/python3.10/site-packages/lightning_utilities/docs/formatting.py_transform_changelogs      "rmasterrelease/stabledomaininfo github_user github_repo main_branch stable_branchc sdttttfffdd }|dksdsdSzd|}Wnty3ddd d }Ynw|d d }|d ||}d |g|d d d}d|d |d|S)Nrcstjd}ddD]}t||}qtt|tfdddDr?tj tj ddd}ttj j |dnd tj j tj ddt |\}}||t|d fS) Nmodulefullname.c3s|]}|vVqdS)Nr).0sfnamerr 5sz9_linkcode_resolve..find_source..) readthedocsrtfd checkoutsz..)start/)sysmodulesrgetattrstrinspect getsourcefileanyospathabspathjoinrelpathgetsourcelineslen)objpartpath_topsource line_startrr"r)r find_source-s "z&_linkcode_resolve..find_sourcepyr$rz %s#L%d-L%dr&r0.pyr)lateststabler1zhttps://github.com/z/blob/)tupler5int Exceptionrrgetr<) rrr r!r"r#rFfilenamebranchrrEr_linkcode_resolve%s rQ package_namecCsXddlm}ddl}d|d}|j|dd}|d}d d |D}t||d S) zLoad the versions of the package from PyPI. >>> _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', ...] r) LooseVersionNzhttps://pypi.org/pypi/z/json )timeoutreleasescSsh|] }td|r|qS)z ^\d+(\.\d+)*$)rematch)r'krrr asz&_load_pypi_versions..)key)distutils.versionrSrequestsrNjsonkeyssorted)rRrSr]urldataversionsrrr_load_pypi_versionsPs    rdlinkpkg_verversion_digitsc Cs|d}z t|dd}Wnty+td|dd}t||d}Ynw|dd}d|dd|}|d|d|S)a2Adjust the linked external docs to be local. Args: link: the source link to be replaced pkg_ver: the target link to be replaced, if ``{package.version}`` is included it will be replaced accordingly version_digits: for semantic versioning, how many digits to be considered r&rN+{})rrdrM importlib import_moduler<r4r)rerfrgpkg_attverr$rrr#_update_link_based_imported_packagees  rpz.rstrHr source_link target_link browse_folderfile_extensionsc Csg}t|tr |g}|D]}|D]}|tjtj|dd|dd7}qq |s6td|d|ddSt d |}|D]} t || |}q>t |D]y} t | d d  } | } Wdn1sbwYd \} }t| D]&\}}tjd |vr}d}|s||vr|||| |<d} |rd|vrd}qo| sqKtd| d|d|dt | dd d  }|| Wdn1swYqKdS)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 ) isinstancer5globr9r:r<loggingwarningrWfindallrpsetr r radjust_linked_external_docs__name__rdebugr)rrrsrtrurg list_filesfolderext pkg_ver_allrffpathfopenlinesfoundskiprrfwrrrr~sF &      r)rr)rqr )r}rlr6r~r9rWr2collections.abcrtypingrrr5rdictrQlistrdrLrprrrrrsX  +