gpt4 book ai didi

python - sphinx 警告 : autosummary: stub file not found for the methods of the class. 检查您的 autosummary_generate 设置

转载 作者:行者123 更新时间:2023-12-03 23:01:55 24 4
gpt4 key购买 nike

我有一个开源包,其中包含许多不同子模块上的类。所有类都有方法fittransform , 并继承 fit_transform来自sklearn。所有类都有 numpydoc 后面的文档字符串,带有子标题参数、属性、注释、另见和方法,我在其中列出 fit , transformfit_transform .我复制一个类的例子:

class DropFeatures(BaseEstimator, TransformerMixin):
"""
Some description.

Parameters
----------
features_to_drop : str or list, default=None
Variable(s) to be dropped from the dataframe

Methods
-------
fit
transform
fit_transform
"""

def __init__(self, features_to_drop: List[Union[str, int]]):

some init parameters

def fit(self, X: pd.DataFrame, y: pd.Series = None):
"""
This transformer does not learn any parameter.

Verifies that the input X is a pandas dataframe, and that the variables to
drop exist in the training dataframe.

Parameters
----------
X : pandas dataframe of shape = [n_samples, n_features]
The input dataframe
y : pandas Series, default = None
y is not needed for this transformer. You can pass y or None.

Returns
-------
self
"""
some functionality

return self

def transform(self, X: pd.DataFrame):
"""
Drop the variable or list of variables from the dataframe.

Parameters
----------
X : pandas dataframe
The input dataframe from which features will be dropped

Returns
-------
X_transformed : pandas dataframe,
shape = [n_samples, n_features - len(features_to_drop)]
The transformed dataframe with the remaining subset of variables.

"""

some more functionality

return X
在 Sphinx 的 conf.py 中,我包括:
extensions = [
"sphinx.ext.autodoc", # Core Sphinx library for auto html doc generation from docstrings
"sphinx.ext.autosummary", # Create neat summary tables for modules/classes/methods etc
"sphinx.ext.intersphinx", # Link to other project's documentation (see mapping below)
"sphinx_autodoc_typehints", # Automatically document param types (less noise in class signature)
"numpydoc",
"sphinx.ext.linkcode",
]


numpydoc_show_class_members = False


# generate autosummary even if no references
autosummary_generate = True
autosummary_imported_members = True
当我使用 sphinx-build -b html docs build 构建文档时,文档构建得非常好,但是每个类我收到 3 个警告,每个方法一个,上面写着:
warning: autosummary: stub file not found for the methods of the class. check your autosummary_generate settings
我已经用尽了我所有的搜索资源,我准备放弃了。有人会知道如何防止该警告或如何使狮身人面像不将其打印到控制台吗?
我附上了错误的副本,如果需要,我可以提供指向 repo 的 PR 链接
enter image description here

最佳答案

好的,3天后,我搞定了。秘诀是在标题“方法”之后的文档字符串中添加简短描述,而不是像我一样将它们留空。
所以:

class DropFeatures(BaseEstimator, TransformerMixin):

Some description.

Parameters
----------
features_to_drop : str or list, default=None
Variable(s) to be dropped from the dataframe

Methods
-------
fit:
some description
transform:
some description
fit_transform:
some description

关于python - sphinx 警告 : autosummary: stub file not found for the methods of the class. 检查您的 autosummary_generate 设置,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/65198998/

24 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com