§
    >²¸jŽ)  ã            	       óŒ  — d 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	 ddl
mZ ddlmZmZ dedeeef         fd	„Zd
edededee         fd„Zdededee         fd„Zdedee         fd„Zddedee         dee         fd„Zdedefd„Zdedee         fd„Ze	deded         fd„¦   «         Zdedefd„Zdedefd„ZdS )a‘  Package and filesystem helpers for pyDeprecate's CLI.

Internal utilities that resolve a package's version, locate package directories, and manage ``sys.path`` for scanning.

Version resolution uses a local ``pyproject.toml`` (development checkout) when available, falling back to installed
distribution metadata via ``importlib.metadata``.

TOML parsing uses ``tomllib`` (stdlib on Python 3.11+) or ``tomli`` (backport, via ``pip install 'pyDeprecate[audit]'``
on Python 3.10). When not available the helpers return ``None`` and callers fall back to ``importlib.metadata``.

This module is private (no ``__all__``); its surface may change without notice.

é    N)Ú	Generator)Úcontextmanager)ÚPath)ÚAnyÚOptionalÚpathÚreturnc                 óô   — 	 	 ddl }n# t          $ r ddl}Y nw xY wt          | d¦  «        5 }t	          |                     |¦  «        ¦  «        cddd¦  «         S # 1 swxY w Y   dS # t          $ r i cY S w xY w)a  Load a TOML file using ``tomllib`` (Python 3.11+) or ``tomli`` (Python 3.10 backport).

    Returns an empty dict on any failure (missing library, parse error, IO).

    Examples:
        >>> import os, tempfile
        >>> with tempfile.NamedTemporaryFile(suffix=".toml", mode="w", delete=False) as f:
        ...     _ = f.write('[project]\nname = "mypkg"\nversion = "1.2.3"\n')
        ...     name = f.name
        >>> _load_toml(name).get("project", {}).get("version")
        '1.2.3'
        >>> os.unlink(name)

    r   NÚrb)ÚtomllibÚImportErrorÚtomliÚopenÚdictÚloadÚ	Exception)r   r   Úfhs      ú^/root/private/project/pallet_detection_v2/.venv/lib/python3.11/site-packages/deprecate/_pkg.pyÚ
_load_tomlr      sò   € ð	ð	$ØˆNˆNˆNˆNøÝð 	$ð 	$ð 	$Ø#Ð#Ð#Ð#Ð#Ð#ð	$øøøõ �$˜ÑÔð 	* Ý˜Ÿš RÑ(Ô(Ñ)Ô)ð	*ð 	*ð 	*ð 	*ñ 	*ô 	*ð 	*ð 	*ð 	*ð 	*ð 	*ð 	*øøøð 	*ð 	*ð 	*ð 	*ð 	*ð 	*øåð ð ð Øˆ	ˆ	ˆ	ðøøøsJ   ƒ ‡A( ˆ–A( ˜™A( ¬"AÁA( ÁAÁA( Á"AÁ#A( Á(A7Á6A7Úpkg_nameÚ	scan_pathÚpyproject_dirc                 óz  — t           j                             |¦  «        rt           j                             |¦  «        n;t           j                             t           j                             |¦  «        ¦  «        }t          t          j        ¦  «        }g }|t           j                             |¦  «        |t           j                             |d¦  «        fD ]\}|rXt           j                             |¦  «        r9||vr5|                     |¦  «         t          j         	                    d|¦  «         Œ]	 t          j        | ¦  «        }t          |dd¦  «        }t          |t          ¦  «        r|nd	 |t          j        dd…<   S # t          $ r Y |t          j        dd…<   dS w xY w# |t          j        dd…<   w xY w)ax  Import *pkg_name* and return its ``__version__``, or ``None`` on any failure.

    Adds candidate import roots (scan dir, its parent, pyproject dir, ``src/``
    sub-dir) to ``sys.path`` before importing, then restores the original
    ``sys.path`` unconditionally via ``finally``.

    Args:
        pkg_name: Importable package name declared in ``[project].name``.
        scan_path: File-system path originally passed to the CLI (used to
            locate the package root).
        pyproject_dir: Directory containing the ``pyproject.toml`` file.

    Returns:
        Version string from ``pkg.__version__`` or ``None``.

    Úsrcr   Ú__version__N)Úosr   ÚisdirÚabspathÚdirnameÚlistÚsysÚjoinÚappendÚinsertÚ	importlibÚimport_moduleÚgetattrÚ
isinstanceÚstrr   )	r   r   r   Ú	scan_rootÚoriginalÚaddedÚrootÚmoduleÚversions	            r   Ú_version_from_dynamicr0   5   s�  € õ" /1¬g¯mªm¸IÑ.FÔ.FÐw•”—’ 	Ñ*Ô*Ð*ÍBÌGÏOÊOÕ\^Ô\c×\kÒ\kÐluÑ\vÔ\vÑLwÔLw€IÝ•C”H‰~Œ~€HØ€EØ�BœGŸOšO¨IÑ6Ô6¸ÅrÄwÇ|Â|ÐTaÐchÑGiÔGiÐjð %ð %ˆØð 	%•B”G—M’M $Ñ'Ô'ð 	%¨D¸Ð,=Ð,=Ø�LŠL˜ÑÔÐÝŒH�OŠO˜A˜tÑ$Ô$Ð$øðÝÔ(¨Ñ2Ô2ˆÝ˜& -°Ñ6Ô6ˆÝ$ W­cÑ2Ô2Ð<ˆwˆw¸Ð<ð �Œ���‰ˆøõ ð ð ð Øà�Œ���‰ˆˆðøøøøð �Œ���‰ÐÐÐÐs$   Ä5=F Æ
F$ÆF' Æ#F$Æ$F' Æ'F:Ú	toml_pathc                 ó”  — t          | ¦  «        }|                     di ¦  «        }|sdS |                     d¦  «        }t          |t          ¦  «        r|S d|                     dg ¦  «        v rZ|                     d¦  «        }t          |t          ¦  «        r0|r.t	          ||t
          j                             | ¦  «        ¦  «        S dS )a·  Extract ``[project].version`` from *toml_path*, or ``None``.

    Falls back to importing the package for ``dynamic = ["version"]`` projects.

    Args:
        toml_path: Absolute path to a ``pyproject.toml`` file.
        scan_path: Original file-system path passed to the CLI (forwarded to
            :func:`_version_from_dynamic` for import-root resolution).

    Returns:
        Version string or ``None`` when not resolvable.

    ÚprojectNr/   ÚdynamicÚname)r   Úgetr(   r)   r0   r   r   r   )r1   r   Údatar3   r/   r   s         r   Ú_version_from_tomlr8   W   sÃ   € õ �iÑ Ô €DØ�hŠh�y "Ñ%Ô%€GØð Øˆtà�kŠk˜)Ñ$Ô$€GÝ�'�3ÑÔð Øˆà�G—K’K 	¨2Ñ.Ô.Ð.Ð.Ø—;’;˜vÑ&Ô&ˆÝ�h¥Ñ$Ô$ð 	Z¨ð 	ZÝ(¨°9½b¼g¿oºoÈiÑ>XÔ>XÑYÔYÐYàˆ4ó    c                 óà  — t           j                             | ¦  «        }t           j                             |¦  «        st           j                             |¦  «        }t          d¦  «        D ]€}t           j                             |d¦  «        }t           j                             |¦  «        rt          || ¦  «        }|�|c S t           j                             |¦  «        }||k    r n|}Œ�dS )u“  Return ``[project].version`` from the nearest ``pyproject.toml`` up to 2 levels above *path*.

    Searches the directory itself, its parent, and its grandparent â€” stops
    as soon as a resolvable version is found or the limit is reached.

    Args:
        path: File-system path to start the upward search from.

    Returns:
        Version string or ``None`` when not found within 2 levels.

    é   zpyproject.tomlN)	r   r   r   r   r   Úranger"   Úisfiler8   )r   Ú	candidateÚ_r1   r/   Úparents         r   Ú_read_pyproject_versionrA   v   sÎ   € õ ”—’ Ñ%Ô%€IÝŒ7�=Š=˜Ñ#Ô#ð /Ý”G—O’O IÑ.Ô.ˆ	Ý�1‰XŒXð 	ð 	ˆÝ”G—L’L Ð,<Ñ=Ô=ˆ	ÝŒ7�>Š>˜)Ñ$Ô$ð 	Ý(¨°DÑ9Ô9ˆGØÐ"Ø���Ý”—’ Ñ+Ô+ˆØ�YÒÐØˆEØˆ	ˆ	Øˆ4r9   Úmodule_namec                 óŽ   — |�t          |¦  «        }|�|S 	 t          j                             | ¦  «        S # t          $ r Y dS w xY w)uò  Return the version for *module_name*, or ``None`` on any failure.

    Priority order:

    1. ``[project].version`` in the nearest ``pyproject.toml`` above *path* (reflects
       local development checkouts whose version may differ from the installed dist).
    2. ``importlib.metadata.version(module_name)`` â€” the installed distribution.

    Args:
        module_name: Importable package name whose installed version to look up.
        path: Optional file-system path used to locate a local ``pyproject.toml``.
            When provided, the local file takes precedence over installed metadata.

    Returns:
        Version string (e.g. ``"1.2.3"``) or ``None`` when the package is not
        installed or the version cannot be determined.

    N)rA   r%   Úmetadatar/   r   )rB   r   Ú	local_vers      r   Ú_auto_detect_versionrF   “   sa   € ð& ÐÝ+¨DÑ1Ô1ˆ	ØÐ ØÐðÝÔ!×)Ò)¨+Ñ6Ô6Ð6øÝð ð ð Øˆtˆtðøøøs   —6 ¶
AÁAÚpthc                 ó0   — | dz                        ¦   «         S )zSReturn True if *pth* is an importable package directory (contains ``__init__.py``).z__init__.py)Úexists)rG   s    r   Ú_is_package_dirrJ   °   s   € à�-Ñ×'Ò'Ñ)Ô)Ð)r9   c                 ó´   — | dz  }|                      ¦   «         r"d„ |                     ¦   «         D ¦   «         }|r|S d„ |                      ¦   «         D ¦   «         S )aÜ  Return package sub-directories of *pth*, checking ``src/`` when none found directly.

    Resolution order:
    1. Immediate child directories of ``pth/src/`` that contain ``__init__.py``
       (standard ``src/``-layout projects take precedence).
    2. If none, immediate child directories of *pth* that contain ``__init__.py``.

    Args:
        pth: Directory to search.

    Returns:
        List of :class:`~pathlib.Path` objects for each package directory found.

    r   c                 óX   — g | ]'}|                      ¦   «         ¯t          |¦  «        ¯%|‘Œ(S © ©Úis_dirrJ   ©Ú.0Úcs     r   ú
<listcomp>z(_find_child_packages.<locals>.<listcomp>Æ   s3   € ÐTÐTÐT˜°!·(²(±*´*ÐTÅÐQRÑASÔASÐT�!ÐTÐTÐTr9   c                 óX   — g | ]'}|                      ¦   «         ¯t          |¦  «        ¯%|‘Œ(S rM   rN   rP   s     r   rS   z(_find_child_packages.<locals>.<listcomp>É   s2   € ÐJÐJÐJ�!¨¯ª©
¬
ÐJµÀqÑ7IÔ7IÐJˆAÐJÐJÐJr9   )rO   Úiterdir)rG   Úsrc_dirÚin_srcs      r   Ú_find_child_packagesrX   µ   se   € ð �E‰k€GØ‡~‚~ÑÔð ØTÐT˜WŸ_š_Ñ.Ô.ÐTÑTÔTˆØð 	ØˆMØJÐJ�s—{’{‘}”}ÐJÑJÔJÐJr9   )NNNc              #   ó  K  — t          | ¦  «                             ¦   «         }t          t          j        ¦  «        }|                     ¦   «         r¨t          |¦  «        rt          |j        ¦  «        }nd|dz  }|                     ¦   «         o*t          d„ | 
                    ¦   «         D ¦   «         ¦  «        }|rt          |¦  «        nt          |¦  «        }t          j                             d|¦  «         	 t          j        ¦   «         5  t          j        dt          d¬¦  «         t          j        dt           d¬¦  «         dV — ddd¦  «         n# 1 swxY w Y   |t          j        dd…<   dS # |t          j        dd…<   w xY w)aP  Context manager that prepends the import root to ``sys.path`` and restores it after scanning.

    For package directories (containing ``__init__.py``), inserts the parent directory so the package name resolves as
    an importable module. For plain directories, inserts the directory itself. Importable module name strings are passed
    through unchanged.

    Warning:
        Not thread-safe. ``sys.path`` is a process-global list; concurrent use from multiple threads will corrupt
        the restored state. Each scan should run in a dedicated process or be serialized via a lock.

    r   c              3   ó\   K  — | ]'}|                      ¦   «         ot          |¦  «        V — Œ(d S ©NrN   rP   s     r   ú	<genexpr>z$_managed_sys_path.<locals>.<genexpr>à   s8   è è € Ð-kÐ-kÐTU¨a¯hªh©j¬jÐ.O½_ÈQÑ=OÔ=OÐ-kÐ-kÐ-kÐ-kÐ-kÐ-kr9   r   Úignorezdeprecate.*)Úcategoryr.   N)r   Úresolver    r!   r   rO   rJ   r)   r@   ÚanyrU   r$   ÚwarningsÚcatch_warningsÚfilterwarningsÚDeprecationWarningÚFutureWarning)r   Úabs_pathr+   Úimport_rootrV   rW   s         r   Ú_managed_sys_pathrh   Ì   s¦  è è € õ ˜$‘Z”Z×'Ò'Ñ)Ô)€HÝ•C”H‰~Œ~€HØ‡‚ÑÔð (Ý˜8Ñ$Ô$ð 	DÝ˜hœoÑ.Ô.ˆKˆKà Ñ&ˆGØ—^’^Ñ%Ô%Ðk­#Ð-kÐ-kÐY`×YhÒYhÑYjÔYjÐ-kÑ-kÔ-kÑ*kÔ*kˆFØ*0ÐC�#˜g™,œ,˜,µc¸(±m´mˆKÝŒ�Š˜˜;Ñ'Ô'Ð'ðÝÔ$Ñ&Ô&ð 	ð 	ÝÔ# HÕ7IÐR_Ð`Ñ`Ô`Ð`ÝÔ# Hµ}È]Ð[Ñ[Ô[Ð[ØˆEˆEˆEð	ð 	ð 	ñ 	ô 	ð 	ð 	ð 	ð 	ð 	ð 	øøøð 	ð 	ð 	ð 	ð
 �Œ���‰ˆˆø�h�Œ���‰ÐÐÐÐs0   Ã:E4 Ä=EÅ
E4 ÅEÅE4 ÅEÅE4 Å4Fc                 ó  — t          | ¦  «        }|                     ¦   «         rt          d| ›d�¦  «        ‚|                     ¦   «         r¿t	          |¦  «        r|                     ¦   «         j        S t          |¦  «        }t          |¦  «        dk    r|d         j        S t          |¦  «        dk    rBd 	                    t          d„ |D ¦   «         ¦  «        ¦  «        }t          d| ›d|› d	�¦  «        ‚t          d
| ›d�¦  «        ‚| S )a›  Convert a filesystem path to an importable module name.

    Accepts a package directory (with ``__init__.py``) or an importable module
    name string. Plain directories and individual ``.py`` files are not supported
    because ``validate_deprecation_expiry`` and ``validate_deprecation_chains``
    require an importable module name, not a filesystem path.

    Args:
        path: Package directory path or importable module name string.

    Returns:
        Importable module name string.

    Raises:
        ValueError: If path is a plain directory without ``__init__.py``, a ``.py``
            file, or cannot be resolved to an importable module name.

    zFile paths are not supported: z@. Pass an importable module/package name or a directory instead.é   r   z, c              3   ó$   K  — | ]}|j         V — Œd S r[   )r5   rP   s     r   r\   z'_resolve_module_name.<locals>.<genexpr>  s$   è è € Ð$@Ð$@° Q¤VÐ$@Ð$@Ð$@Ð$@Ð$@Ð$@r9   z
Directory z contains multiple packages (z3). Pass the specific package sub-directory instead.zVPlain directories without '__init__.py' are not supported for expiry or chain checks: za. Use an importable package layout with '__init__.py', or pass an importable module name instead.)r   Úis_fileÚ
ValueErrorrO   rJ   r_   r5   rX   Úlenr"   Úsorted)r   rG   Ú
child_pkgsÚnamess       r   Ú_resolve_module_namerr   ì   sF  € õ& ˆt‰*Œ*€CØ
‡{‚{�}„}ð 
ÝØu¨TÐuÐuÐuñ
ô 
ð 	
ð ‡z‚z�|„|ð 
Ý˜3ÑÔð 	&Ø—;’;‘=”=Ô%Ð%å)¨#Ñ.Ô.ˆ
Ýˆz‰?Œ?˜aÒÐØ˜a”=Ô%Ð%Ýˆz‰?Œ?˜QÒÐØ—I’I�fÐ$@Ð$@°ZÐ$@Ñ$@Ô$@Ñ@Ô@ÑAÔAˆEÝðC˜Tð Cð CÀ%ð Cð Cð Cñô ð õ ðnÐeið nð nð nñ
ô 
ð 	
ð €Kr9   c                 óF   — 	 t          | ¦  «        S # t          $ r | cY S w xY w)zLReturn the importable module name for *path*, falling back to *path* itself.)rr   rm   )r   s    r   Ú_safe_module_namert     s9   € ðÝ# DÑ)Ô)Ð)øÝð ð ð Øˆˆˆðøøøs   ‚ ‘ Ÿ r[   )Ú__doc__r%   Úimportlib.metadatar   r!   ra   Úcollections.abcr   Ú
contextlibr   Úpathlibr   Útypingr   r   r)   r   r   r0   r8   rA   rF   ÚboolrJ   r    rX   rh   rr   rt   rM   r9   r   ú<module>r|      sO  ððð ð Ð Ð Ð Ø Ð Ð Ð Ø 	€	€	€	Ø 
€
€
€
Ø €€€Ø %Ð %Ð %Ð %Ð %Ð %Ø %Ð %Ð %Ð %Ð %Ð %Ø Ð Ð Ð Ð Ð Ø  Ð  Ð  Ð  Ð  Ð  Ð  Ð  ð�Sð ˜T # s (œ^ð ð ð ð ð6 Cð °Cð Èð ÐPXÐY\ÔP]ð ð ð ð ðD #ð °#ð ¸(À3¼-ð ð ð ð ð> #ð ¨(°3¬-ð ð ð ð ð:ð  cð °¸#´ð È(ÐSVÌ-ð ð ð ð ð:*˜ð * $ð *ð *ð *ð *ð
K˜dð K t¨D¤zð Kð Kð Kð Kð. ð˜Cð  IÐ.>Ô$?ð ð ð ñ „ðð>)˜sð ) sð )ð )ð )ð )ðX˜Cð  Cð ð ð ð ð ð r9   