ni
Add "deprecated" functions, enums, enum values, attributes to nimi-python's code generator
Description of issue
We need the ability to mark functions as "deprecated" in metadata so that the codegenerator does the appropriate thing:
- DeprecationWarning
- remove from ReadTheDocs or mark it as deprecated
This is needed for #1403
We should have the ability to deprecate enums, enum values and attributes, as well.
In https://github.com/ni/nidaqmx-python and https://github.com/ni/measurement-plugin-python we have been using the https://pypi.org/project/deprecation/ package, which provides a decorator that generates a warning and adds a deprecated notice to the docstring.
However, Python 3.13 adds a standard decorator for this, @warnings.deprecated, so I will not be using the deprecation package in new code. I will use the backport in https://github.com/python/typing_extensions/
Also, the docstring manipulation done by the deprecation package only works with doc tools that load your code at runtime, like autodoc, not doc tools that parse your code without loading it, like sphinx-autoapi.
