请问一下PYTHON有没有和JAVA一样的API介绍的文档啊

aikunoracle

和楼上有同感啊

wolfg

原帖由 jkit 于 2006-6-8 11:27 发表
dir和help确实是python中很方便的地方。
我的意思不是说找到这个对象后很难得到帮助信息，而是说python在怎么去找到这个对象上比较麻烦。

java的文档在这方面就容易了吗？如果把在java文档找的思维过程用到Python的文档上，应该也很容易。

对于新手，在不熟悉Python的情况下，花时间浏览一下Python Manual的目录是值得的。看一下Python Library Reference这部分的章节目录，了解一下Python Library 的用途。这样，在解决具体的问题时，就可以找到自己要用的对象。还有，一些入门的书也是很好的guide，比如Learning Python

我现在也算是初学Python，我也遇到过不知用什么模块的问题，Python Manual给了我很大的帮助。

lzhome

个人认为python的manual中api帮助，比javadoc要优越的多！结构分类清晰，生动简洁。

jkit

可能是我对于java先入为主了，所以稍微有点点不习惯python的文档，也不算很严重。
不习惯的地方主要是：
1：python的模块很多都是直接扔在lib的根目录下，没有很好的组织，而且多如牛毛，让人眼花缭乱。也就是说python虽然也有package，但是此package实际上相当于namespace，和java的package概念是不一样的。
2：文档上方法或者函数签名中的参数和返回值没有类型，只有通过它的说明才能略知一二。特别是返回值，经常需要跑到命令行执行一下，然后用type和dir看返回的是个啥东东。而javadoc里面是有类型的，而且是链接，可以点来点去，相关的类之间都是可以串起来的，所以非常方便。
当然python也有很多java不具备的优点，这里只是就事论事，希望不要引起语言之间孰优孰劣的争论。

lzhome

的确刚看python lib时有些不适应，不过习惯以后，还是感觉很容易看的。其实我想文档里没写格式很严谨的返回类型，可能是因为python本身对类型定义不需要声明有关，方法返回一个值，直接赋给变量，不会出类型错误的：）看lib，按主题浏览比较好，python的上手速度还是非常快的，感觉如果精通了一门语言来学python，官方说法用几天时间都是谦虚的，感觉用心的话，几个小时就可以简单编程了：）

baif

原帖由 jkit 于 2006-6-8 09:33 发表
纯html文件的javadoc我觉得就已经很好用了，因为它层次分明，很容易找到想要的文档，根本就不需要搜索。
而python的文档是chm的，因为chm支持搜索，所以也还凑合着可以用，如果不能搜索的话，特别是对于新手来说 ...

这位同学不知是否到过python.org 不妨到这里看看
http://www.python.org/doc/

jkit

原帖由 lzhome 于 2006-6-9 10:14 发表
的确刚看python lib时有些不适应，不过习惯以后，还是感觉很容易看的。其实我想文档里没写格式很严谨的返回类型，可能是因为python本身对类型定义不需要声明有关，方法返回一个值，直接赋给变量，不会出类型错误的 ...

几个小时就可以编程是没错。可是写程序的时候非得一边看文档，一边在命令行dir什么的，要不然真不知道程序怎么进行下去。而光看javadoc就可以在大脑里面构思出程序的样子来，不用写代码就能给出解决方案。而python不行，不知道返回值就不知道它是否适用，以及下面该怎么写都不知道，非得一边看文档，一边在命令行dir什么的。说这么多好像我对python意见很大似的，其实我已经习惯了，只是发表一下以前的感受而已。

wolfg

原帖由 jkit 于 2006-6-9 10:39 发表
几个小时就可以编程是没错。可是写程序的时候非得一边看文档，一边在命令行dir什么的，要不然真不知道程序怎么进行下去。而光看javadoc就可以在大脑里面构思出程序的样子来，不用写代码就能给出解决方案。而python不行，不知道返回值就不知道它是否适用，以及下面该怎么写都不知道，非得一边看文档，一边在命令行dir什么的。说这么多好像我对python意见很大似的，其实我已经习惯了，只是发表一下以前的感受而已。

“知道返回值”是什么意思？在命令行dir是找自己想要的模块吗？

Python的一个好处就是可以一边思考，一边在解释器里验证自己的想法

[ 本帖最后由 wolfg 于 2006-6-9 17:41 编辑 ]

jkit

原帖由 wolfg 于 2006-6-9 17:35 发表


“知道返回值”是什么意思？在命令行dir是找自己想要的模块吗？

Python的一个好处就是可以一边思考，一边在解释器里验证自己的想法

比如有个模块，mymod，提供了sort方法，方法的签名是 mymod.sort(myobj)
你光看这个知道怎么使用吗？你非的要在命令行执行一下，看看返回个啥才知道该怎么用！
如果有返回类型说明，例如 void mymod.sort(myobj), 那么立刻就知道是直接用mymod.sort(myobj)，
如果是 myobj mymod.sort(myobj)，你也立刻就能知道该用 myobjsorted = mymod.sort(myobj)
这只是个最简单的例子，因为方法的名字是sort，如果是 mymod.mymethod(myobj) 你知道是怎么回事？你知道接到返回值之后接下来该怎么用？

一边思考，一边在解释器里验证自己的想法是个优点，但是如果只能在验证了前面的想法之后才能继续思考的话就未必了。我憧憬的是既能即时验证自己的想法，也能根据文档就能思考到底。

[ 本帖最后由 jkit 于 2006-6-10 14:18 编辑 ]

newbuding

有问题找google