如何在 Python 3.9 / 3.10 中記錄 Classmethod 屬性？

Question

python 3.9的一個小附加組件是

在 3.9 版更改: 類方法現在可以包裝其他描述符，例如 property()。

這在多種情況下很有用，例如作為在 classmethods 上使用 property()的解決方案，或者為了通過配方創建本質上是延遲評估的類屬性

class A:
   @classmethod
   @property
   @cache
   def lazy_class_attribute(cls):
       """Method docstring."""
       return expensive_computation(cls)

這種運作良好，並罰款蟒之內，進口類，實例化它或它的子類，不會造成expensive_computation發生，但似乎雙方pydoc和sphinx不僅會造成執行expensive_computation ，當他們試圖獲得的文檔字符串，但不顯示這個@classmethod任何文檔字符串。

問題：是否有可能 - 從 python (*) 內部 - 懶惰地評估在構建文檔時不會執行的類屬性/屬性？

(*) 在Stop Sphinx from Executing a cached classmethod property 中提出的一種解決方法，感謝 /u/jsbueno，包括根據環境變量修改函數體：

def lazy_class_attribute(cls):
   """Method docstring."""
    if os.environ.get("GENERATING_DOCS", False):
        return
   return expensive_computation(cls)

我非常喜歡這種解決方法，因為特別是它允許人們在記錄時呈現不同的輸出。 （例如，我的類具有基於類名的路徑屬性。如果不同的用戶執行相同的腳本，路徑將不同，因為他們的主文件夾不同。）

但是有兩個問題：

1. 這種方法取決於在 python 之外做的事情，imo，在理想的世界中，不需要在 python 本身之外做
2. 為了在文檔中獲取文檔字符串，似乎我們最終不得不做一些不直觀的事情，比如

class MetaClass:
    @property
    @cache
    def _expensive_function(cls):
        """some expensive function"""

class BaseClass(metaclass=MetaClass):
    lazy_attribute: type = classmethod(MetaClass._expensive_funcion)
    """lazy_attribute docstring"""

PS：順便說一下， @classmethod@property和attribute之間有什么功能區別嗎？ 他們看起來非常相似。 我目前唯一能看出的區別是，如果該屬性需要訪問其他@classmethod ，我們需要像上面一樣移動元類中的所有內容。