Add warnings.deprecated

[LecrisUT]

This is used to add both static type-checking deprecations and run-time as well. For now it requires upgrading typing-extensions to a required conditional dependency, otherwise the dynamic deprecation would not apply (and would require some trickery to make it no-op on non TYPE_CHECKING)

Pull Request Checklist

• implement the feature
• write the documentation
• mention the version
• include a release note

Depends-on #3059, #3117 (managed without it), BGZ#2295924

[LecrisUT]

Great, this is a nice issue with pre-commit running a versioned tmt-lint instead of the current one from source (dependencies are not being updated)

[martinhoyer]

Do you know if we're able to utilize this for informing users about pending/existing deprecations?

Few places with deprecating stuff:

tmt/tmt/utils/__init__.py

Line 2802 in 0e68636

#: Mark the option as deprecated. Instance of :py:class:`Deprecated`

tmt/tmt/options.py

Line 33 in 0e68636

class Deprecated:

tmt/tmt/steps/__init__.py

Line 211 in 0e68636

def assert_feeling_safe(self, deprecated_in_version: str, subject: str) -> None:

I'm thinking, deprecated decorator, which would accept 'deprecated in' and 'text' args, which would be visible to end user. Like the --feeling-safe, but easily reusable.

[LecrisUT]

Do you know if we're able to utilize this for informing users about pending/existing deprecations?

Hmm, would need to mull it over. Easily, no, there is none that I could find when navigating through the usage. The implementation seems to rely on native support for deprecation on click and dataclasses side, so would have to rely on them to figure out how to make a support for type-hinting these.

I'm thinking, deprecated decorator, which would accept 'deprecated in' and 'text' args, which would be visible to end user. Like the --feeling-safe, but easily reusable.

That would require decorators to work on attributes?

[martinhoyer]

/packit build

[martinhoyer]

/packit test

[happz]

/packit build

[happz]

Unrelated failures, merging.