@deprecated(...)
class SomeDeprecatedThing(object):
...
Although since the goal of the deprecation should be for this code to result in a warning being emitted:
from module import SomeDeprecatedThing
possibly the solution needs to be something more like `deprecatedModuleAttribute`.
I guess the important point is that there are two goals to keep in mind for this one API. It needs to cause a `DeprecationWarning` to be emitted when the deprecated API is used and it needs to inform pydoctor that it should annotate some generated documentation with deprecation information.
Here's one idea:
from twisted. python. deprecate import deprecated
@deprecated (...) hing(object) :
class SomeDeprecatedT
...
Although since the goal of the deprecation should be for this code to result in a warning being emitted:
from module import SomeDeprecatedThing
possibly the solution needs to be something more like `deprecatedModu leAttribute` .
I guess the important point is that there are two goals to keep in mind for this one API. It needs to cause a `DeprecationWar ning` to be emitted when the deprecated API is used and it needs to inform pydoctor that it should annotate some generated documentation with deprecation information.