python快速生成注释文档的方法

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的导入的是自身因此,import 名称 和Help(名称)以及你的文件名称要一致才能够。为了更加直观请看下面这图：

固然还能够从其它文件引用的方式导入这里用到python经常使用的导入方式from从哪一个目录import导入什么文件pythonzhushi

固然我这里仍是用图片来展现如下：

是否是一目了然，这样也能够导入咱们须要作的注释文档，help帮助方法就是帮咱们查看到此文件中所包含的类，函数,的一个简单帮助文档，相似于readme文档的一个说明。最后来看看掩饰效果吧：

是否是简单的打印出咱们程序的说明文档，后面步骤直接能够建一个文本把这个粘贴过去，就完成一个readme的文档说明，通过测试有几点注意是，想要写#这种注释不要写到def放发内要写到它的上面位置和装饰器相似，相反三引号'''不要写到def外面,这样也是没显示效果的。你们赶忙去试试吧。感谢观看。。