^j) TdZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z mZdedeee ffd Zd ed ed edeefd Zded edeefdZdedeefdZddedeedeefdZde defdZde dee fdZe dededfdZdedefdZdedefdZy)aPackage 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)AnyOptionalpathreturnc ddl}t|d5}t |j |cdddS#t$rddl}Y?wxYw#1swYyxYw#t $ricYSwxYw)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) rNrb)tomllib ImportErrortomliopendictload Exception)rr fhs Y/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/deprecate/_pkg.py _load_tomlrso  $ $  * R() * * $ # $ * *  sH7 AA  A AAAA AAA A$#A$pkg_name scan_path pyproject_dircttjj|rtjj|n;tjj tjj|}t t j}g}|tjj ||tjj|dfD][}|stjj|s&||vs+|j|t jjd|] tj|}t|dd}t|tr|nd |t jddS#t$rY|t jddywxYw#|t jddwxYw)axImport *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)osrisdirabspathdirnamelistsysjoinappendinsert importlib import_modulegetattr isinstancestrr) rrr scan_rootoriginaladdedrootmoduleversions r_version_from_dynamicr05s:"/1ggmmI.F *BGGOO\^\c\c\k\klu\vLwICHH~HEBGGOOI6 rww||TachGij% BGGMM$'D,= LL  HHOOAt $%((2&-6$Wc2w<    s$65F F F"FF""F7 toml_pathcLt|}|jdi}|sy|jd}t|tr|Sd|jdgvrM|jd}t|tr,|r*t ||t j j|Sy)aExtract ``[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/dynamicname)rgetr(r)r0rrr)r1rdatar3r/rs r_version_from_tomlr8Ws i Dhhy"%G kk)$G'3GKK 2..;;v& h $(9bggooi>XY Y ctjj|}tjj|stjj |}t dD]{}tjj |d}tjj|rt||}||cStjj |}||k(ry|}}y)uReturn ``[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. zpyproject.tomlN) rrrrrranger"isfiler8)r candidate_r1r/parents r_read_pyproject_versionrAvs%I 77== #GGOOI. 1X GGLL,<= 77>>) $(D9G"+ Y      r9 module_namec|t|}||S tjj|S#t$rYywxYw)uReturn 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)rAr%metadatar/r)rBr local_vers r_auto_detect_versionrFsN& +D1   !!))+66 s 2 >>pthc(|dz jS)zSReturn True if *pth* is an importable package directory (contains ``__init__.py``).z __init__.py)exists)rGs r_is_package_dirrJs -  ' ' ))r9c2|dz }|jr>|jDcgc]!}|jst|s |#}}|r|S|jDcgc]!}|jst|s |#c}Scc}wcc}w)aReturn 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)is_diriterdirrJ)rGsrc_dircin_srcs r_find_child_packagesrQs{EkG~~$__.T!((*QRAS!TT M{{} J! q7IA JJU Ks"B B B&B< BB)NNNc#Kt|j}ttj}|j rt |rt|j}nO|dz }|j xr td|jD}|r t|n t|}tjjd| tj5tjdtdtjdt ddddd|tjddy#1swYxYw#|tjddwxYww)aPContext 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. rc3VK|]!}|jxr t|#ywN)rLrJ.0rOs r z$_managed_sys_path..s$-kTUahhj.O_Q=O.O-ks')rignorez deprecate.*)categoryr.N)rresolver r!rrLrJr)r@anyrMr$warningscatch_warningsfilterwarningsDeprecationWarning FutureWarning)rabs_pathr+ import_rootrNrPs r_managed_sys_pathrcs$Z'')HCHH~H 8 $hoo.K&G^^%k#-kY`YhYhYj-k*kF*0#g,c(mK ;'  $ $ &   # #H7IR_ `  # #H}] [        s6CE'E*=E'E/E'E EE$$E'ct|}|jrtd|d|jrt |r|j j St|}t|dk(r|dj St|dkDr3djtd|D}td|d|d td |d |S) aConvert 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. zFile paths are not supported: z@. Pass an importable module/package name or a directory instead.rz, c34K|]}|jywrT)r5rUs rrWz'_resolve_module_name.. s$@QVV$@sz 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.) ris_file ValueErrorrLrJrZr5rQlenr"sorted)rrG child_pkgsnamess r_resolve_module_namerms& t*C {{},TH4t u   zz| 3 ;;=%% %)#. z?a a=%% % z?Q IIf$@Z$@@AETH$A%ICC deidlmn n   Kr9c< t|S#t$r|cYSwxYw)zLReturn the importable module name for *path*, falling back to *path* itself.)rmrh)rs r_safe_module_nameros&#D))  s rT)__doc__r%importlib.metadatarr!r\collections.abcr contextlibrpathlibrtypingrrr)rrr0r8rArFboolrJr rQrcrmror9rrxs?  %% ST#s(^6CCPXY\P]D##(3->#(3-:c#(SV-:**$* KdKtDzK.CI.>$?>)s)s)XCCr9