Does nanobind have annotations to mark methods as deprecated?

[stephen29xie]

Does nanobind have annotations to mark methods as deprecated?

[wjakob]

No such capability exists at the moment.

[jurihock]

One possible workaround could be to manually raise a DeprecationWarning in Python bindings.

Maybe something like this:

PyErr_WarnEx(PyExc_DeprecationWarning, "your deprecation message", 1);

[wjakob]

That's what I do as well. I have not found a good way to include a nb::deprecated("message") annotation in bindings without this causing some kind of overhead in the default (non-deprecated) case.

[jurihock]

I think, a kind of deprecation annotation would be indeed an intuitive solution.

But on the other hand, imagine that a particular function argument is to be deprecated.
For example, the warning should only appear if the user explicitly sets this argument.

Things start to get complicated in such a case.
Therefore, it's reasonable to type PyErr_WarnEx just manually when it's really required.