python - 将一个类标记为已弃用，以便在 PyCharm 中标记继承类

Question

可以像这样在 Python/PyCharm 中标记弃用的类:

class Foo:
    def __init__(self):
        warnings.warn('Use Bar instead.', DeprecationWarning)

任何试图实例化 Foo 的代码现在都会被 PyCharm 适本地标记为 Foo() 。

但是，仅仅继承类不会:

class Baz(Foo):
    pass

有什么方法可以让 Baz 的声明以任何方式标记弃用警告？

Answer 1

您可以使用元类来完成此操作。在 Python 2.7 中:

import warnings

def deprecated_metaclass(message):
    class DeprecatedMetaclass(type):
        def __init__(cls, name, bases, dct):
            if not hasattr(cls, '__metaclass__'):
                cls.__metaclass__ = DeprecatedMetaclass
            if any(getattr(base, '__metaclass__', None) == DeprecatedMetaclass
                    for base in bases):
                warnings.warn(message, DeprecationWarning, stacklevel=2)
            super(DeprecatedMetaclass, cls).__init__(name, bases, dct)

class Foo(object):
    __metaclass__ = deprecated_metaclass('Use Bar instead.')

class Bar(Foo):
    pass

请注意，在 PyCharm 之外，您可能看不到任何内容，因为弃用警告在默认情况下处于关闭状态。

在 Python 3 中，将 Foo 更改为:

class Foo(metaclass=deprecated_metaclass('Use Bar instead.')):
    pass