Python快速从注释生成文档的方法
作为一个标准的程序猿，为程序编写说明文档是一步必不可少的工作，如何才能写的又好又快呢，下面我们就来详细探讨下吧。
今天将告诉大家一个简单平时只要注意的小细节，就可以轻松生成注释文档，也可以检查我们写的类方法引用名称是否重复有问题等。
一看别人专业的大牛们写的文档多牛多羡慕，不用担心我们可以让python为我们生成基本满足的说明文档，一来可以提高代码整体阅读性，二来可以将代码的整体结构看着也更清晰，这样在交接的时候可以省很多麻烦，其它同事在接手你工作的时候也不会一行行去问你这是什么那是什么的，因为注释已经很直观的表述了，在整合的时候可当说明文档给客户简单说明(主要是给你BOSS看的).
那么进入正题怎么实现看下面我简单的代码格式，注意注释的地方和函数名类名都是与__all__内相关联的
#!/usr/bin/env python # -*-coding:utf-8 -*- ''' 文档快速生成注释的方法介绍,首先我们要用到__all__属性 在Py中使用为导出__all__中的所有类、函数、变量成员等 在模块使用__all__属性可避免相互引用时命名冲突 ''' __all__ = ['Login', 'check', 'Shop', 'upDateIt', 'findIt', 'deleteIt', 'createIt'] class Login: ''' 测试注释一可以写上此类的作用说明等 例如此方法用来写登录 ''' def __init__(self): ''' 初始化你要的参数说明 那么登录可能要用到 用户名username 密码password ''' pass def check(self): ''' 协商你要实现的功能说明 功能也有很多例如验证 判断语句，验证码之类的 ''' pass class Shop: ''' 商品类所包含的属性及方法 update改/更新 find查找 delete删除 create添加 ''' def __init__(self): ''' 初始化商品的价格、日期、分类等 ''' pass def upDateIt(self): ''' 用来更新商品信息 ''' pass def findIt(self): ''' 查找商品信息 ''' pass def deleteIt(self): ''' 删除过期下架商品信息 ''' pass def createIt(self): ''' 创建新商品及上架信息 ''' pass if __name__=="__main__": import pythonzhushi print help(pythonzhushi)
这里要强调说明下py的名字要和你当前工作的py名字一样(我这里创建的py名字就是pythonzhushi,最后导入也是这名字)，因为下面的测试中import的导入的是自身所以,im port 名称 和Help(名称)以及你的文件名称要一致才可以。为了更加直观请看下面这图：
当然还可以从其它文件引用的方式导入这里用到python常用的导入方式from从哪个目录import导入什么文件pythonzhushi
当然我这里还是用图片来展示以下：
是不是一目了然，这样也可以导入我们需要做的注释文档，help帮助方法就是帮我们查看到此文件中所包含的类，函数,的一个简单帮助文档，类似于readme文档的一个说明。最后来看看掩饰效果吧：
是不是简单的打印出我们程序的说明文档，后面步骤直接可以建一个文本把这个粘贴过去，就完成一个readme的文档说明，经过测试有几点注意是，想要写#这种注释不要写到def放发内要写到它的上面位置和装饰器类似，相反三引号'''不要写到def外面,这样也是没显示效果的。大家赶紧去试试吧。感谢观看。。
相关文章
Python中有三种內建的数据结构：列表、元祖和字典，这篇文章对这三种数据结构进行了分别的介绍与实例演示，让大家更简洁明了的了解这三个之间的区别，下面一起来看看。2016-08-08
这篇文章主要介绍了Python实现基本数据结构中队列的操作方法,结合实例形式演示了Python针对数据结构中队列的初始化、插入、删除、判断队列满及队列空等相关操作技巧,需要的朋友可以参考下2017-12-12
本文会介绍如何将语句组织成函数，还会详细介绍参数和作用域的概念，以及递归的概念及其在程序中的用途。2013-11-11
这篇文章主要介绍了如何对csv文件数据分组,并用pyecharts展示，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-11-11
这篇文章主要介绍了WxPython中控件隐藏与显示的小技巧，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-11-11
Python作为一种强大的编程语言,广泛应用于数据科学、机器学习、Web开发以及图形化编程等领域,在图形化编程方面,Python提供了多种库和工具,帮助开发者快速构建用户界面和图形应用,本文将介绍几种流行的Python图形化工具,需要的朋友可以参考下2024-12-12
下面小编就为大家分享一篇python 显示数组全部元素的方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-04-04
这篇文章主要介绍了pynq-z2条形码识别功能,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-07-07
这篇文章主要介绍了Python线程之定位与销毁的实现,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2019-02-02
这篇文章主要介绍了使用Python OpenCV为CNN增加图像样本的实现，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2019-06-06
最新评论