sPjjdZddlmZddlmZmZmZddlmZddl m Z gdZ Gdd e eZ Gd d e ZGd d e ZGdde ZGdde ZGdde ZGdde ZGdde Zy)av CycloneDX Schema Deprecation Warnings ===================================== This module provides warning classes for deprecated features in CycloneDX schemas. Each warning class corresponds to a specific schema version, enabling downstream code to catch, filter, or otherwise handle schema-specific deprecation warnings. Intended Usage -------------- Downstream consumers can manage warnings using Python's ``warnings`` module. Common scenarios include: - Filtering by schema version - Suppressing warnings in tests or batch processing - Logging or reporting deprecation warnings without raising exceptions Example ------- .. code-block:: python import warnings from cyclonedx.schema.deprecation import ( BaseSchemaDeprecationWarning, SchemaDeprecationWarning1Dot7, ) # Suppress all CycloneDX schema deprecation warnings warnings.filterwarnings("ignore", category=BaseSchemaDeprecationWarning) # Suppress only warnings specific to schema version 1.7 warnings.filterwarnings("ignore", category=SchemaDeprecationWarning1Dot7) Notes ----- - All deprecation warnings inherit from :class:`BaseSchemaDeprecationWarning`. - The ``SCHEMA_VERSION`` class variable indicates the CycloneDX schema version where the feature became deprecated. - These warning classes are designed for downstream **filtering and logging**, not for raising exceptions. )ABC)ClassVarLiteralOptional)warn) SchemaVersion)BaseSchemaDeprecationWarningSchemaDeprecationWarning1Dot1SchemaDeprecationWarning1Dot2SchemaDeprecationWarning1Dot3SchemaDeprecationWarning1Dot4SchemaDeprecationWarning1Dot5SchemaDeprecationWarning1Dot6SchemaDeprecationWarning1Dot7c ReZdZUdZeeed<ed dddede ede d dfd Z y) r z9Base class for warnings about deprecated schema features.SCHEMA_VERSIONNr) stacklevel deprecatedinsteadrreturnc~d|d|jjd}|r |d|dz }t|||dzy) z/Internal API. Not part of the public interface.`z ` is deprecated from CycloneDX vz onwards.z Please use `z ` instead.r)categoryrN)r to_versionr)clsrrrmsgs a/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/cyclonedx/schema/deprecation.py_warnz"BaseSchemaDeprecationWarning._warnXsP*=c>P>P>[>[>]=^^gh  ]7):6 6C S3:>:)N) __name__ __module__ __qualname____doc__rr __annotations__ classmethodstrrintrr rr r SsLC]++;XY;s;Xc];RU;^b;;r r cTeZdZUdZej Zeeej e d<y)rzDClass for warnings about deprecated schema features in CycloneDX 1.7rN) r!r"r#r$r V1_7rrrr%r)r rrra%Nr?s&+\..  ;#5s ;O$@O O$@O O$@O O$@O O$@O O$@O O$@Or