设为首页 收藏本站
查看: 661|回复: 0

[经验分享] 你有,我有,Python也有

[复制链接]

尚未签到

发表于 2015-4-25 10:30:13 | 显示全部楼层 |阅读模式
Java.net环境下都有工具可以把代码中的注释提取出来,python在这方面也不示弱,pydoc就可以作到这一点。
Pydoc是从python2.1版本就加入到其标准库中的。当我们在命令行解释器中调用help()命令时,就使用他来在控制台上显示代码中的注释。我们也可以使用他来把module中的注释提取出来,按照一定的组织方式生成该module的说明文档,包括类,方法等。

Pydoc
的源代码可以在python的安装目录的lib文件夹内找到(我安装的是2.4)。
使用pydoc时,你可以使用-w参数来对指定的模块生成一个Html文档。
例如:pydoc.py –w string
这样就会在当前目录生成一个对应的HTML文件。

如果要给某个目录下的所有模块生成HTML文件。可以使用:
pydoc.py –w Z:\

你还可以使用-p参数来启动一个本地站点,这样你就可以在浏览器中查看modules的说明了,例如:
pydoc -p 1234 -w z:\
执行完此命令,在浏览器中输入地址:http://localhost:1234/,就可以查看modules的说明了。怎么样,生成的文档还不错把。
如果你对生成的效果不满意,可以自己打开pydoc.py文件来修改自己喜欢的样式。
另外还有一个doc生成工具:pythondoc

VS.net中的代码折叠是一项很不错的功能,特别是代码比较长的时候,可以使代码阅读起来容易些。在python中虽然默认的IDLE没有这个功能,但是pythonwin这个IDE有这功能,在编辑.py文件时,可以看到在代码编辑器左边有一栏,在“class”,“def”等关键字旁有小横杠样的标记,点击后会变成加号,同时折叠这部分的代码,不单是“class”,“def”等关键字,甚至连ifelsefor等都可以折叠。

这让我不由想到以前看delphi代码时的痛苦,代码一多,阅读起来只能用上下翻飞来形容。而这样的一个功能,pythonwin这样的由个人写的IDE都实现了,可是borland却一直没有给delphi加上,让人感慨python的活力的同时,为borland感到惋惜。

运维网声明 1、欢迎大家加入本站运维交流群:群②:261659950 群⑤:202807635 群⑦870801961 群⑧679858003
2、本站所有主题由该帖子作者发表,该帖子作者与运维网享有帖子相关版权
3、所有作品的著作权均归原作者享有,请您和我们一样尊重他人的著作权等合法权益。如果您对作品感到满意,请购买正版
4、禁止制作、复制、发布和传播具有反动、淫秽、色情、暴力、凶杀等内容的信息,一经发现立即删除。若您因此触犯法律,一切后果自负,我们对此不承担任何责任
5、所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其内容的准确性、可靠性、正当性、安全性、合法性等负责,亦不承担任何法律责任
6、所有作品仅供您个人学习、研究或欣赏,不得用于商业或者其他用途,否则,一切后果均由您自己承担,我们对此不承担任何法律责任
7、如涉及侵犯版权等问题,请您及时通知我们,我们将立即采取措施予以解决
8、联系人Email:admin@iyunv.com 网址:www.yunweiku.com

所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其承担任何法律责任,如涉及侵犯版权等问题,请您及时通知我们,我们将立即处理,联系人Email:kefu@iyunv.com,QQ:1061981298 本贴地址:https://www.yunweiku.com/thread-60494-1-1.html 上篇帖子: python threading获取线程函数返回值 下篇帖子: 二分查找的C++和python的实现
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

扫码加入运维网微信交流群X

扫码加入运维网微信交流群

扫描二维码加入运维网微信交流群,最新一手资源尽在官方微信交流群!快快加入我们吧...

扫描微信二维码查看详情

客服E-mail:kefu@iyunv.com 客服QQ:1061981298


QQ群⑦:运维网交流群⑦ QQ群⑧:运维网交流群⑧ k8s群:运维网kubernetes交流群


提醒:禁止发布任何违反国家法律、法规的言论与图片等内容;本站内容均来自个人观点与网络等信息,非本站认同之观点.


本站大部分资源是网友从网上搜集分享而来,其版权均归原作者及其网站所有,我们尊重他人的合法权益,如有内容侵犯您的合法权益,请及时与我们联系进行核实删除!



合作伙伴: 青云cloud

快速回复 返回顶部 返回列表