CycloneDX / CycloneDX/cyclonedx-python-lib

feat: improve deprecation warnings - PEP-387

Open
#760 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Python
Stars
116
Forks
67
PR merge metrics
No merged PRs in 30d

Description

see also: https://peps.python.org/pep-0387/

goal: improve backwards compatibility, while improving Developer experience.

## solution

- [x] move deprecated property warnings to setters
- via #838
- [x] annotate deprecated symbols
- via #839
- [ ] use `DeprecationWarning` instead of warnings. -- DEBATABLE -- see below
- requires py8.13

## important

we dont have any intention to remove deprecated properties, unless we have a backwards-compatibility layer that guarantees that all supported versions of CycloneDX spec are serializable and deserializable.

## implementation

- use for annotation of symbols: https://typing-extensions.readthedocs.io/en/latest/#typing_extensions.deprecated

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.