我有更好的 Python 文档吗？更加结构化？

Question

我想这个问题已经被问过，但我没有找到。

我过去曾使用过 Java 和 PHP，我相信它们的语言文档结构更好。至少他们的API。

如果你看看 Java 的 API，你会发现它非常棒。结构非常好且可预测。它还可以让您找到您不知道的新东西。我正在考虑这个https://docs.oracle.com/javase/7/docs/api/。

PHP 的结构不是很好，但它运行得很好。我正在谈论这个： https: //www.php.net/manual/en/。

现在，如果您看到 Python 的等效内容（至少是我找到的https://docs.python.org/3/index.html），感觉就像一个非常长的教程。从我的角度来看，寻找东西很困难，而且不存在真正的等级组织。当您阅读有关函数的内容时，当我真正寻找摘要时，也会有很多描述内容的文本。以https://docs.python.org/3/library/string.html为例，请参阅有关“格式化字符串语法”的部分，感觉它应该放在专门致力于该主题的其他地方。

所以我的问题是：是否有某个地方 Python API 的结构与 JAVA 中的结构类似？

Answer 1

Python 在标准库中有一个与 Javadoc 几乎相当的版本，称为pydoc.

您可以使用以下命令将其启动为 Web 服务器

$ python -m pydoc -b

（或者-p 80，如果随机端口给您带来麻烦，请转到http://localhost）

这应该会打开一个 Web 浏览器，让您探索标准库以及您碰巧安装的任何其他软件包。

请注意，您还可以使用该实用程序从 Python 的交互式 shell/REPL 获取所有这些信息help()。

>>> help()

假设您想找到对字符串执行操作的函数，例如 strip()。使用任一方法如何找到该函数？

$ python -m pydoc str

或者

>>> help(str)

将显示该str类型的帮助，包括其所有方法。

如果您不知道字符串的类型为str，您可以创建一个字符串并询问其类型：

>>> type("foo")
<class 'str'>
>>> help(type("foo"))

要查看对象属性的更紧凑的目录，您可以使用

>>> dir(str)
['__add__', '__class__', '__contains__', '__delattr__', '__dir__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__', '__getnewargs__', '__gt__', '__hash__', '__init__', '__init_subclass__', '__iter__', '__le__', '__len__', '__lt__', '__mod__', '__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__rmod__', '__rmul__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', 'capitalize', 'casefold', 'center', 'count', 'encode', 'endswith', 'expandtabs', 'find', 'format', 'format_map', 'index', 'isalnum', 'isalpha', 'isascii', 'isdecimal', 'isdigit', 'isidentifier', 'islower', 'isnumeric', 'isprintable', 'isspace', 'istitle', 'isupper', 'join', 'ljust', 'lower', 'lstrip', 'maketrans', 'partition', 'replace', 'rfind', 'rindex', 'rjust', 'rpartition', 'rsplit', 'rstrip', 'split', 'splitlines', 'startswith', 'strip', 'swapcase', 'title', 'translate', 'upper', 'zfill']

但由于您已经知道名称是strip()，因此您可以就该对象寻求帮助。

>>> help(str.strip)

这将显示方法签名和文档字符串（如果有）。

使用 Pydoc 的 Web 服务器，您可以单击builtins起始页上“内置模块”中的链接，然后单击该str链接以查看完全相同的信息，因为help()pydoc 也提供服务。

还有一个“搜索”和“获取”栏。在“获取”栏中输入str.strip即可直接到达该位置，就像使用 一样help(str.strip)。

这是很棒的信息。谢谢。网上有什么地方可以发布这个吗？那么您不必在本地启动服务器吗？

从来没听说过。给出的https://docs.python.org似乎没有太多意义。本地服务器的优点是，它根据您启动它的解释器准确记录系统上安装的内容，即使您安装了多个 Python 版本（或者正在使用安装了不同软件包的 virtualenvs）。即使标准库也可能因操作系统或发行版以及（从源代码编译时）编译时可用的 C 库而异。