cost 258 ms
如何在本地目录中激活 Python env 并使用预提交运行 pdoc? - How to activate Python env in the local directory and run pdoc with pre-commit?

我最近创建了一个 GitHub Actions 工作流来检查/重新格式化我的 repo 代码并使用pdoc创建文档 HTML 页面。 最后一步是有问题的,因为 pdoc 运行 .py 文件来创建文档。 对于其中一个文件 (file.py),需要设置 ServiceNow ODBC 驱动程序,并且不 ...

为什么预提交中的 pdoc 在本地通过,但在 GitHub 操作中因“文件已被此挂钩修改”而失败? - Why does pdoc in pre-commit pass locally, but fail with "files were modified by this hook" in GitHub action?

Pdoc 在我的 pre-commit 钩子中最后被调用,它将文档构建到/docs ,它包含在我的存储库中。 /docs中的文件被排除在预提交挂钩之外,因此格式化挂钩不会触及它们。 我观察到以下模式: 我使用pre-commit run --all在本地运行预提交。 钩子过去了。 我 ...

在 Python 中运行 pdoc 时如何解决 ModuleNotFoundError? - How do I resolve ModuleNotFoundError when running pdoc in Python?

我会先说我仍然熟悉 Python。 我的代码执行得很好,没有错误。 我已经安装了我需要的所有软件包。 但是当我尝试使用pdoc --html <filename>为我的代码创建文档时,我收到了这个错误...... 这是我尝试在其上运行 pdoc 的文件开头的导入语句。 我认为这是路径问 ...

pip 无法识别 PIL - pip isn't recognizing PIL

这是一个非常平的问题。 我正在使用 pdoc 为我的库创建一些文档,该库使用 PIL 进行图像处理。 一切正常,除了使用 PIL 的模块,它抛出了以下内容Traceback (most recent call last): File "/Library/Frameworks/Python.fr ...

如何为 python 项目生成文档,包括使用 pdoc 的私有/受保护类 - How to generate documentation for python project including private/protected classes with pdoc

我正在尝试按照本文使用pdoc模块为我的 python 项目生成文档。 我注意到生成的文档中缺少以__ (私有/受保护的)开头的所有类、方法等。 这是sample.py 这就是我使用 pdoc 生成文档的方式 根据此屏幕截图,我在生成的文档中只看到 public class : 有人可以帮我想办法 ...

如何自动生成包含嵌套函数的文档字符串? - How to automatically generate docstrings including nested functions?

如何为c_nested function 自动生成文档? 背景:我为其他开发人员编写代码文档,我想自动生成所有 class 方法的摘要,包括带有简短描述(文档字符串)的嵌套函数。 当我在 class A上运行help(A)时,我得到:Help on class A in module __main ...

ReadTheDocs:将预构建的 HTML 页面发布到 ReadTheDocs - ReadTheDocs: Publishing Pre-Built HTML Pages to ReadTheDocs

我试图从 python 文档字符串创建文档,并找到了 pdoc。 如果您不知道,它会从 python 文档字符串创建 html 文档。 由于它生成.html文件而不是.rst ,我如何将这些文件发布到 ReadTheDocs 或使用 pdoc 生成.rst文件? 快速旁注:我不想使用 sphinx ...

Pdoc - 以编程方式更改模板目录 - Pdoc - Change template directory programatically

我有一个脚本,它使用 pdoc 为我的项目中的所有类生成文档。 我想通过更改 pdoc 模板来进一步自定义我的文档。 我想在我的项目中执行此操作,以便我可以跟踪 git 中的更改,因此我需要更改 --template-dir。 这作为 cmd 行参数很容易,但是在 python 脚本中使用 pdoc ...

Pdoc 向每个枚举变量添加类信息 - Pdoc adds class info to every enum variable

我不知道到底发生了什么,我对Pdoc没有那么了解,但我正在使用它来创建我的源代码的文档。 它通常工作得很好,但我最近在记录从enum.Enum继承的类时偶然发现了一个问题。 类文档工作得很好,但我添加到枚举中的每个类变量都包含它下面的整个文档。 有什么办法可以去掉这些吗? ...

Pydoc找不到已安装的模块 - Pydoc not finding installed modules

我正在尝试使用 pydoc 生成 HTML 文档。 该项目分为几个子文件夹,所有子文件夹都包含__init__.py文件。 我的主文件夹中__init__.py的内容如下: 我可以毫无问题地运行该应用程序。 子文件夹中的文件可以看到主文件夹中的文件,并且所有导入的模块都运行良好。 但是,pydoc ...


 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM