feat: make schema deprecation warnings handle-able

[jkowalleck]

Description

Introduced cyclonedx.schema.deprecation.BaseSchemaDeprecationWarning and version-specific subclasses (e.g., for schema 1.1, 1.2).
Deprecated features in CycloneDX schemas now issue warnings using these custom warning classes instead of Python's built-in DeprecationWarning.
Downstream code can now filter or suppress schema-related deprecation warnings by category.

see our examples. usage like so

import warnings

import cyclonedx.schema.deprection.BaseSchemaDeprecationWarning

with warnings.catch_warnings():
    warnings.simplefilter("ignore", categpry=cyclonedx.schema.deprection.BaseSchemaDeprecationWarning)
    bom_from_xml = Bom.from_xml(...)

closes #944

AI Tool Disclosure

• My contribution does not include any AI-generated content
• My contribution includes AI-generated content, as disclosed below:
  • AI Tools: [e.g. GitHub CoPilot, ChatGPT, JetBrains Junie etc.]
  • LLMs and versions: [e.g. GPT-4.1, Claude Haiku 4.5, Gemini 2.5 Pro etc.]
  • Prompts: [Summarize the key prompts or instructions given to the AI tools]

Affirmation

• My code follows the CONTRIBUTING.md guidelines

[read-the-docs-community]

Documentation build overview

📚 CycloneDX Python Library | 🛠️ Build #31791935 | 📁 Comparing c551d50 against latest (6460b71)

🔍 Preview build

Show files changed (7 files in total): 📝 6 modified | ➕ 1 added | ➖ 0 deleted

File	Status
examples.html	📝 modified
genindex.html	📝 modified
py-modindex.html	📝 modified
autoapi/index.html	📝 modified
autoapi/cyclonedx/schema/index.html	📝 modified
autoapi/cyclonedx/schema/deprecation/index.html	➕ added
autoapi/cyclonedx/schema/schema/index.html	📝 modified

[codacy-production]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
✅ +0.03%	✅ 97.06% (target: 80.00%)

Coverage variation details

	Coverable lines	Covered lines	Coverage
Common ancestor commit (44f1273)	5908	5561	94.13%
Head commit (c551d50)	5937 (+29)	5590 (+29)	94.16% (+0.03%)

Coverage variation is the difference between the coverage for the head and common ancestor commits of the pull request branch: <coverage of head commit> - <coverage of common ancestor commit>

Diff coverage details

	Coverable lines	Covered lines	Diff coverage
Pull request (#945)	34	33	97.06%

Diff coverage is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: <covered lines added or modified>/<coverable lines added or modified> * 100%

See your quality gate settings    Change summary preferences

[jkowalleck]

@stefan6419846, could I ask you for a review?
If the implementation looks about right, I will draft a preview release you may try in your environment.

[stefan6419846]

Thanks. Looks good for me.

If the implementation looks about right, I will draft a preview release you may try in your environment.

From my side, there is no explicit need for a preview release - I am completely fine to include a regular release once available.

[jkowalleck]

I think the feature is complete.
Will let it sink over the weekend and might cut a release early next week.