^j,dZddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z mZddlmZddlmZmZddlmZmZmZmZmZerddlmZdd lmZmZmZdd lm Z m!Z!dd l"m#Z#Gd d e$ejZ%Gdde$ejZ&de$de$fdZ'de$ddfdZ(GddeZ)e dGddZ*e*jVZ,ee,de*de-de-ddfdZ.e.e*_+d e/e$efde$fd!Z0d"ede1e/e$effd#Z2d$ede*fd%Z3d$ed&e$ddfd'Z4d(e$de$fd)Z5d*e1e*d&e$de1e$fd+Z6 dPd,eee$fd&ee$d-e7d.e7de1e$f d/Z8 dQd,eee$fd-e7d.e7de1e*fd0Z9d,eee$fd&ee$de/ee$edffd1Z:de$dedfd2Z;d3e*de$fd4Zd3e*de$fd<Z?d3e*de/e$e$e$e7e$ffd=Z@d>d?dee$d@e$de$fdAZAd3e*d&edde&fdBZBdde%jdfddCd,eee$fd&ee$d-e7dDee%e$fd.e7dEee1dde$fdFZD dRd,eee$fd-e7de1e*fdGZEddHlFmGZGeGe3dIdJKd$ede*fdLZHeGe9dIdJK dRd,eee$fd-e7de1e*fdMZIe!e*dIdJKGdNdOZJy)SuAudit tools for deprecation lifecycle management. This module provides three complementary utilities for verifying the health of deprecated callables across a codebase. All three are designed to be called from pytest or a CI script against an imported package. **Wrapper configuration** (:func:`~deprecate.audit.validate_deprecation_wrapper`, :func:`~deprecate.audit.find_deprecation_wrappers`): Detect wrappers that have zero impact — invalid ``args_mapping`` keys, identity mappings, empty mappings, or a ``target`` pointing back to the same wrapper. **Expiry enforcement** (:func:`~deprecate.audit.validate_deprecation_expiry`): Detect wrappers whose ``remove_in`` version has been reached or passed, preventing zombie code from shipping past its scheduled removal deadline. **Chain detection** (:func:`~deprecate.audit.validate_deprecation_chains`): Detect wrappers whose ``target`` is itself a deprecated callable, forming a chain that users traverse unnecessarily. Two chain kinds are reported via :class:`~deprecate.audit.ChainType`: ``TARGET`` (forwarding chain) and ``STACKED`` (composed argument mappings). **Report generation** (:func:`~deprecate.audit.generate_deprecation_table`): Generate a docs-friendly markdown summary from wrapper metadata. Results are returned as :class:`~deprecate.audit.DeprecationWrapperInfo` dataclasses, which carry both identification info and structured validation results for programmatic processing. !!! note :func:`~deprecate.audit.validate_deprecation_expiry` requires the ``packaging`` library for PEP 440 version comparison. Install with: ``pip install pyDeprecate[audit]`` Copyright (C) 2020-2026 Jiri Borovec <6035284+Borda@users.noreply.github.com> N)suppress) dataclassfield is_dataclassreplace)Enum)cached_propertywraps) TYPE_CHECKINGAnyCallableOptionalUnion)Version)DeprecationConfig TargetMode_has_deprecation_meta)_DeprecatedProxydeprecated_class)!get_func_arguments_types_defaultsceZdZdZdZdZy) TableStylezVMarkdown table layout produced by :func:`~deprecate.audit.generate_deprecation_table`.compactmatrixN)__name__ __module__ __qualname____doc__COMPACTMATRIXZ/var/www/ramen.bs-engineer-server.com/venv/lib/python3.12/site-packages/deprecate/audit.pyrr>s`G Fr"rc0eZdZdZdZdZdZdZdZdZ dZ d Z y ) DeprecationStatusuLLifecycle status labels used in the deprecation report's *Current Status* column. Each member's value is the full display string (emoji + text) rendered in the table. Using a ``str`` enum means members compare equal to their string values and can be returned wherever a plain string is expected. Members are ordered from least to most urgent for easy visual scanning: Examples: >>> DeprecationStatus.ACTIVE_WARNING.value '📢 Deprecation Active' >>> DeprecationStatus.PAST_REMOVAL_DATE > DeprecationStatus.ACTIVE_WARNING False u🕒 Scheduled Deprecationuℹ️ No Removal Targetu⚪ Status Unknownu⚪ Invalid Removal Targetu📢 Deprecation Activeu⏰ Removal Imminentu🔔 Remove Before Releaseu💥 Past Removal DateN) rrrrSCHEDULED_DEPRECATIONNO_REMOVAL_TARGETSTATUS_UNKNOWNINVALID_REMOVAL_TARGETACTIVE_WARNINGREMOVAL_IMMINENTREMOVE_BEFORE_RELEASEPAST_REMOVAL_DATEr!r"r#r%r%Es7 92)N9.N-80r"r%versionreturnc|jd}tjdtj}|j d|S)uNormalize non-standard version strings before PEP 440 parsing. Newer ``packaging`` (>=22) is strict PEP 440 and rejects real-world strings that omit trailing digits on pre/post/dev release labels (e.g. ``"1.8.0.dev"``, ``"1.8.0dev"``, ``"1.8.0.post"``). This helper performs the minimum normalization needed to make such strings parseable, then defers everything else (label aliasing like ``alpha`` -> ``a``, case folding, separator handling) to ``packaging.Version``. The transformation is conservative: 1. Strip a single leading ``v`` or ``V`` prefix (``packaging`` accepts this, but stripping defensively keeps the normalized output stable for downstream callers). 2. Append ``0`` to bare pre/post/dev labels that lack a trailing digit. Labels recognized: ``dev``, ``rc``, ``a``, ``b``, ``c``, ``alpha``, ``beta``, ``preview``, ``post``. No other transformations are applied — case, separators, and label aliases pass through unchanged so ``packaging.Version`` can apply its own canonicalization. Args: version: Raw version string, possibly missing trailing digits on labels. Returns: Normalized version string ready to be passed to ``packaging.version.Version``. Examples: >>> _normalize_version_string("1.8.0.dev") '1.8.0.dev0' >>> _normalize_version_string("1.8.0dev") '1.8.0dev0' >>> _normalize_version_string("1.8.0.post") '1.8.0.post0' >>> _normalize_version_string("v1.2.3") '1.2.3' >>> _normalize_version_string("1.8.0.RC1") '1.8.0.RC1' >>> _normalize_version_string("1.2.3") '1.2.3' vVzJ(?P\.?)(?P