Python，Google 风格的文档字符串：将参数或返回类型定义为另一种类型的子类？

Question

应该如何使用 Google 样式的文档字符串记录参数或返回类型旨在成为特定类型的子类？

这是我在使用类型提示时建议子类的方式。

from typing import TYPE_CHECKING, Type
...

if TYPE_CHECKING:
    from package.core import AbstractClass

def foo(bar: Type["AbstractClass"]) -> str:
    ...

假设以上是合理的，那么我该如何在文档字符串中类似地记录呢？

def foo(bar: Type["AbstractClass"]) -> str:
    """Map the class to str for no other reason then that SO question makes more sense.

    Args:
        bar (???): A concrete subclass of an abstract class.

    Returns:
        str: ...
    """
    ...

Answer 1

我建议不要重复文档字符串中的类型信息。你提到你使用了pdoc，它已经显示了类型注释，所以你在这里创建了一个不必要的不​​一致源。

如果你真的想重复类型信息，你可以重复你用于注释的内容，即Type[AbstractClass]。