§
    ’©ºje  ã                   ó&  — d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZ d dl	m
Z
mZ dededdfd„Z	 	 dd
ededededededefd„Zdedee         fd„Zdedede
e         defd„Z	 	 ddededeeee         f         dee         deddfd„ZdS ) é    N)ÚIterable)ÚOptionalÚUnionÚpath_inÚpath_outÚreturnc                 ó$  — t          | ¦  «        5 }|                     ¦   «         }ddd¦  «         n# 1 swxY w Y   d}t          |¦  «        D ]„\  }}|                     d¦  «        r6|dd…                              d¦  «        d                              ¦   «         }ŒP|                     d¦  «        r|                     dd|› d	�¦  «        }|||<   Œ…t          |d
¦  «        5 }|                     |¦  «         ddd¦  «         dS # 1 swxY w Y   dS )zªAdjust changelog headers to avoid duplication of short subtitles.

    Args:
        path_in: Input Markdown file path.
        path_out: Output Markdown file path.

    NÚ z## é   ú-r   z### z###z -Úw)ÚopenÚ	readlinesÚ	enumerateÚ
startswithÚsplitÚstripÚreplaceÚ
writelines)r   r   ÚfpÚchlog_linesÚ	chlog_verÚiÚlns          ús/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/lightning_utilities/docs/formatting.pyÚ_transform_changelogr      s‘  € õ 
ˆg‰Œð %˜"Ø—l’l‘n”nˆð%ð %ð %ñ %ô %ð %ð %ð %ð %ð %ð %øøøð %ð %ð %ð %ð €IÝ˜;Ñ'Ô'ð  ð  ‰ˆˆ2Ø�=Š=˜ÑÔð 	 Ø˜1˜2˜2œŸš SÑ)Ô)¨!Ô,×2Ò2Ñ4Ô4ˆIˆIØ�]Š]˜6Ñ"Ô"ð 	 Ø—’˜EÐ#7¨)Ð#7Ð#7Ð#7Ñ8Ô8ˆBØˆK˜‰NøÝ	ˆh˜Ñ	Ô	ð # Ø
�Š�kÑ"Ô"Ð"ð#ð #ð #ñ #ô #ð #ð #ð #ð #ð #ð #ð #øøøð #ð #ð #ð #ð #ð #s   �1±5¸5Ã"DÄD	ÄD	Úmasterúrelease/stableÚdomainÚinfoÚgithub_userÚgithub_repoÚmain_branchÚstable_branchc                 óÒ  ‡‡— dt           t          t          t          f         fˆˆfd„}| dk    s‰d         sdS 	 d |¦   «         z  }n/# t          $ r" ‰d                              dd¦  «        d	z   }Y nw xY w|                     d¦  «        d
         }‰|dœ                     ||¦  «        }d                     |g|                     d¦  «        dd …         ¢¦  «        }d|› d|› d|› �S )Nr   c                  óÈ  •‡— t           j        ‰d                  } ‰d                              d¦  «        D ]}t          | |¦  «        } Œt	          t          j        | ¦  «        ¦  «        Št          ˆfd„dD ¦   «         ¦  «        rmt          j	         
                    t          j	                             ddd¦  «        ¦  «        }t	          t          j	                             ‰|¬¦  «        ¦  «        ŠnC‰› dt          j	                             ‰t          j	         
                    d¦  «        ¬¦  «        › �Št          j        | ¦  «        \  }}‰||t          |¦  «        z   d	z
  fS )
NÚmoduleÚfullnameú.c              3   ó    •K  — | ]}|‰v V — Œ	d S )N© )Ú.0ÚsÚfnames     €r   ú	<genexpr>z9_linkcode_resolve.<locals>.find_source.<locals>.<genexpr>5   s'   øè è € ÐHÐH˜aˆq�EˆzÐHÐHÐHÐHÐHÐHó    )ÚreadthedocsÚrtfdÚ	checkoutsz..)Ústartú/é   )ÚsysÚmodulesr   ÚgetattrÚstrÚinspectÚgetsourcefileÚanyÚosÚpathÚabspathÚjoinÚrelpathÚgetsourcelinesÚlen)ÚobjÚpartÚpath_topÚsourceÚ
line_startr.   r    r#   s        @€€r   Úfind_sourcez&_linkcode_resolve.<locals>.find_source-   s8  øø€ õ Œk˜$˜xœ.Ô)ˆØ˜Ô$×*Ò*¨3Ñ/Ô/ð 	%ð 	%ˆDÝ˜#˜tÑ$Ô$ˆCˆCÝ•GÔ)¨#Ñ.Ô.Ñ/Ô/ˆåÐHÐHÐHÐHÐ#GÐHÑHÔHÑHÔHð 	[õ ”w—’¥r¤w§|¢|°D¸$ÀÑ'EÔ'EÑFÔFˆHÝ�œŸš¨°X˜Ñ>Ô>Ñ?Ô?ˆEˆEð #ÐZÐZ¥R¤W§_¢_°UÅ"Ä'Ç/Â/ÐRVÑBWÔBW _Ñ%XÔ%XÐZÐZˆEÝ$Ô3°CÑ8Ô8Ñˆ�
Ø�j *­s°6©{¬{Ñ":¸QÑ">Ð>Ð>r0   Úpyr'   r
   z
%s#L%d-L%dr)   r5   ú.pyr   )ÚlatestÚstabler6   zhttps://github.com/z/blob/)Útupler:   ÚintÚ	Exceptionr   r   ÚgetrA   )	r   r    r!   r"   r#   r$   rJ   ÚfilenameÚbranchs	    `  `    r   Ú_linkcode_resolverU   %   s&  øø€ ð?��s¥C­˜}Ô-ð ?ð ?ð ?ð ?ð ?ð ?ð ?ð& �‚~€~˜T (œ^€~Øˆrð<Ø + +¡-¤-Ñ/ˆˆøÝð <ð <ð <Ø˜”>×)Ò)¨#¨sÑ3Ô3°eÑ;ˆˆˆð<øøøð
 �^Š^˜CÑ Ô  Ô#€Fà#¨}Ð=Ð=×AÒAÀ&È&ÑQÔQ€FØ�xŠx˜Ð: (§.¢.°Ñ"5Ô"5°a°b°bÔ"9Ð:Ñ;Ô;€HØL ÐLÐL¨{ÐLÐLÀ(ÐLÐLÐLs   ºA Á)A4Á3A4Úpackage_namec                 óâ   — ddl }ddlm} d| › d�}|                     |d¬¦  «                             ¦   «         }|d                              ¦   «         }d	„ |D ¦   «         }t          ||¬
¦  «        S )zûLoad 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   N)ÚVersionzhttps://pypi.org/pypi/z/jsoné
   )ÚtimeoutÚreleasesc                 ó<   — h | ]}t          j        d |¦  «        ¯|’ŒS )z^\d+(\.\d+)*$)ÚreÚmatch)r,   Úks     r   ú	<setcomp>z&_load_pypi_versions.<locals>.<setcomp>`   s*   € ÐEÐEÐE�a¥r¤xÐ0@À!Ñ'DÔ'DÐE�ÐEÐEÐEr0   )Úkey)ÚrequestsÚpackaging.versionrX   rR   ÚjsonÚkeysÚsorted)rV   rb   rX   ÚurlÚdataÚversionss         r   Ú_load_pypi_versionsrj   P   sŒ   € ð €O€O€OØ)Ð)Ð)Ð)Ð)Ð)à
6 <Ð
6Ð
6Ð
6€CØ�<Š<˜ Rˆ<Ñ(Ô(×-Ò-Ñ/Ô/€DØ�JÔ×$Ò$Ñ&Ô&€HàEÐE˜8ÐEÑEÔE€HÝ�( Ð(Ñ(Ô(Ð(r0   ÚlinkÚpkg_verÚversion_digitsc                 óÚ  — |                      d¦  «        }	 t          |d         ¦  «        d         }nU# t          $ rH t          j        d                     |dd…         ¦  «        ¦  «        }t          ||d         ¦  «        }Y nw xY w|                      d¦  «        d         }d                     |                      d¦  «        d|…         ¦  «        }|                      d|› d�|¦  «        S )aÝ  Resolve 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)   r   éÿÿÿÿNú+Ú{Ú})r   rj   rQ   Ú	importlibÚimport_modulerA   r9   r   )rk   rl   rm   Úpkg_attÚverr'   s         r   Ú#_update_link_based_imported_packagerw   d   sâ   € ð �mŠm˜CÑ Ô €Gð*Ý! '¨!¤*Ñ-Ô-¨bÔ1ˆˆøÝð *ð *ð *åÔ(¨¯ª°'¸#¸2¸#´,Ñ)?Ô)?Ñ@Ô@ˆå�f˜g aœjÑ)Ô)ˆˆˆð	*øøøð �)Š)�C‰.Œ.˜Ô
€Cà
�(Š(�3—9’9˜S‘>”> / > /Ô2Ñ
3Ô
3€Cà�<Š<Ð(˜WÐ(Ð(Ð(¨#Ñ.Ô.Ð.s   —3 ³ABÂB©z.rstrL   r   Úsource_linkÚtarget_linkÚbrowse_folderÚfile_extensionsc                 ób  — g }t          |t          ¦  «        r|g}|D ]B}|D ]=}|t          j        t          j                             |dd|› �¦  «        d¬¦  «        z  }Œ>ŒC|st          j        d|› d|› d�¦  «         dS t          j	        d	|¦  «        }|D ]}	t          ||	|¦  «        }Œt          |¦  «        D ]õ}
t          |
d
¬¦  «        5 }|                     ¦   «         }ddd¦  «         n# 1 swxY w Y   d\  }}t          |¦  «        D ]A\  }}t          j        › d�|v rd}|s| |v r|                     | |¦  «        ||<   d}|rd|v rd}ŒB|sŒ˜t          j        d|
› d| › d|› d�¦  «         t          |
dd
¬¦  «        5 }|                     |¦  «         ddd¦  «         n# 1 swxY w Y   ŒödS )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{(.+)}zUTF-8)Úencoding)FFú(ú)Fzlinks adjusting in z: "z" -> "r   )Ú
isinstancer:   Úglobr>   r?   rA   ÚloggingÚwarningr]   Úfindallrw   Úsetr   r   r   Úadjust_linked_external_docsÚ__name__r   Údebugr   )ry   rz   r{   r|   rm   Ú
list_filesÚfolderÚextÚpkg_ver_allrl   ÚfpathÚfopenÚlinesÚfoundÚskipr   r   Úfws                     r   rŠ   rŠ   €   s²  € ð0 €JÝ�-¥Ñ%Ô%ð (Ø&˜ˆØð [ð [ˆØ"ð 	[ð 	[ˆCØ�$œ)¥B¤G§L¢L°¸¸yÀ3¸y¸yÑ$IÔ$IÐUYÐZÑZÔZÑZˆJˆJð	[àð ÝŒÐk¸=ÐkÐkÐYhÐkÐkÐkÑlÔlÐlØˆõ ”*˜Y¨Ñ4Ô4€KØð `ð `ˆÝ9¸+ÀwÐP^Ñ_Ô_ˆˆõ �Z‘”ð !ð !ˆÝ�% 'Ð*Ñ*Ô*ð 	&¨eØ—O’OÑ%Ô%ˆEð	&ð 	&ð 	&ñ 	&ô 	&ð 	&ð 	&ð 	&ð 	&ð 	&ð 	&øøøð 	&ð 	&ð 	&ð 	&à"‰ˆˆtÝ˜uÑ%Ô%ð 
	ð 
	‰EˆAˆrå-Ô6Ð9Ð9Ð9¸RÐ?Ð?Ø�Øð ˜K¨2Ð-Ð-àŸ:š: k°;Ñ?Ô?��a‘à�Øð ˜˜r˜	˜	Ø�øØð 	ØÝŒÐW¨EÐWÐW°kÐWÐWÈÐWÐWÐWÑXÔXÐXÝ�%˜ wÐ/Ñ/Ô/ð 	!°2Ø�MŠM˜%Ñ Ô Ð ð	!ð 	!ð 	!ñ 	!ô 	!ð 	!ð 	!ð 	!ð 	!ð 	!ð 	!øøøð 	!ð 	!ð 	!ð 	!øð%!ð !s$   ÃC-Ã-C1	Ã4C1	ÆF#Æ#F'	Æ*F'	)r   r   )rx   r   )r…   rs   r;   r†   r>   r]   r7   Úcollections.abcr   Útypingr   r   r:   r   ÚdictrU   Úlistrj   rP   rw   rŠ   r+   r0   r   ú<module>r›      sà  ðð €€€Ø Ð Ð Ð Ø €€€Ø €€€Ø 	€	€	€	Ø 	€	€	€	Ø 
€
€
€
Ø $Ð $Ð $Ð $Ð $Ð $Ø "Ð "Ð "Ð "Ð "Ð "Ð "Ð "ð# #ð #°ð #¸ð #ð #ð #ð #ð6  Ø)ð(Mð (MØð(Mà
ð(Mð ð(Mð ð	(Mð
 ð(Mð ð(Mð 	ð(Mð (Mð (Mð (MðV) cð )¨d°3¬ið )ð )ð )ð )ð(/¨cð /¸Cð /ÐQYÐZ]ÔQ^ð /Ðcfð /ð /ð /ð /ð@ &5Øð;!ð ;!Øð;!àð;!ð ˜˜h sœmÐ+Ô,ð;!ð ˜c”]ð	;!ð
 ð;!ð 
ð;!ð ;!ð ;!ð ;!ð ;!ð ;!r0   