Python语言API

时间:2020-03-06 14:45:20  来源:igfitidea点击:

我从Java发出的Python开始。

我想知道是否存在类似于JavaDoc API的东西,可以在其中找到该类,其方法以及如何使用它的示例。

我发现从Python(命令行)使用help(Thing)非常有用

我也发现了这一点:

http://docs.python.org/2/

https://docs.python.org/2/py-modindex.html

但是,当我们已经拥有要查找的类名称时,这似乎会有所帮助。在JavaDoc API中,我具有所有类,因此,如果我需要一些东西,可以向下滚动到一个"听起来像"我需要的类。或者有时候我只是浏览所有的类以查看它们的作用,当我需要一个功能时,我的大脑就会想起我。我们在javadoc中看到了类似的东西,还记得!!

但我似乎尚未在Python中找到类似的东西,这就是为什么我发布此问题的原因。

顺便说一句,我知道我最终会读到以下内容:

https://docs.python.org/2/library/

但是,我认为不是今天。

解决方案

pydoc?

我不确定我们是否正在寻找更复杂的东西,但这确实有用。

这是Python中所有模块的列表,不确定这是否是我们真正需要的。

如果我们使用的是Windows ActiveState,则Python随附了文档,包括可搜索帮助文件中的库参考。

标准的python库已被很好地记录。尝试跳入python并导入一个名为" os"的模块并运行:

import os   
help(os)

这将读取模块中每个项目上的文档字符串并显示它。这正是pydoc也会做的。

编辑:epydoc可能正是我们在寻找什么:

我已经从Python.org下载了Python 2.5,它不包含pydoc。

Directorio de C:\Python25

9/23/2008  10:45 PM    <DIR>          .
9/23/2008  10:45 PM    <DIR>          ..
9/23/2008  10:45 PM    <DIR>          DLLs
9/23/2008  10:45 PM    <DIR>          Doc
9/23/2008  10:45 PM    <DIR>          include
9/25/2008  06:34 PM    <DIR>          Lib
9/23/2008  10:45 PM    <DIR>          libs
2/21/2008  01:05 PM            14,013 LICENSE.txt
2/21/2008  01:05 PM           119,048 NEWS.txt
2/21/2008  01:11 PM            24,064 python.exe
2/21/2008  01:12 PM            24,576 pythonw.exe
2/21/2008  01:05 PM            56,354 README.txt
9/23/2008  10:45 PM    <DIR>          tcl
9/23/2008  10:45 PM    <DIR>          Tools
2/21/2008  01:11 PM             4,608 w9xpopen.exe
          6 archivos        242,663 bytes

但是它有(我猜是替代品)pydocgui ...

C:\Python25>dir Tools\Scripts\pydocgui.pyw

10/28/2005  07:06 PM               222 pydocgui.pyw
           1 archivos            222 bytes

这将启动一个网络服务器,并显示我在寻找什么。平台随附的所有模块以及所有类。

Doc目录包含与以下内容相同的内容:

http://docs.python.org/

非常感谢我们指导我使用pydoc。

BTW I know that I would eventually
  will read this:
  
  http://docs.python.org/lib/lib.html
  
  But, well, I think it is not today.

我建议我们犯了一个错误。 lib doc具有"类,其方法以及使用方法的示例"。这就是我们要寻找的。

我一直都在使用Java和Python。深入研究库文档,我们将找到所需的所有内容。

它不会直接回答问题(因此我可能会被降级),但是我们可能对Jython感兴趣。

Jython is an implementation of the high-level, dynamic, object-oriented language Python written in 100% Pure Java, and seamlessly integrated with the Java platform. It thus allows you to run Python on any Java platform.

由于我们来自Java,因此Jython可能会利用Python,同时仍然允许我们使用Java知识。

我们可以将环境变量PYTHONDOCS设置为指向python文档的安装位置。

在我的系统上,它在/usr/share/doc/python2.5中

因此,我们可以在shell配置文件或者其他位置定义此变量,具体取决于系统:

export PYTHONDOCS=/usr/share/doc/python2.5

现在,如果我们打开一个交互式python控制台,则可以调用帮助系统。举个例子:

>>> help(Exception)
>>> Help on class Exception in module exceptions:

>>> class Exception(BaseException)
>>>  |  Common base class for all non-exit exceptions.
>>>  |  
>>>  |  Method resolution order:
>>>  |      Exception

文档在这里:

https://docs.python.org/library/pydoc.html

也试试

pydoc -p 11111

然后在Web浏览器中输入http:// localhost:11111

编辑:当然,我们可以使用端口号代替11111的任何其他值