在网站上做教学直播平台多少钱,网站建设都讲哪些内容,做淘宝优惠劵网站服务器配置,投资网站pydoc是python自带的一个文档生成工具#xff0c;使用pydoc可以很方便的查看类和方法结构
本文主要介绍#xff1a;1.查看文档的方法、2.html文档说明、3.注释方法、
一、查看文档的方法
**方法1#xff1a;**启动本地服务#xff0c;在web上查看文档
命令【python3 -m…pydoc是python自带的一个文档生成工具使用pydoc可以很方便的查看类和方法结构
本文主要介绍1.查看文档的方法、2.html文档说明、3.注释方法、
一、查看文档的方法
**方法1**启动本地服务在web上查看文档
命令【python3 -m pydoc -p 1234】
通过http://localhost:1234来访问查看文档 说明
1、-p指定启动的服务的端口号可以随意指定不冲突的端口号
2、只有在自建的工程根目录下使用该命令才能看到当前工程下所有的内容否则只能看到python环境变量下的模块内容
3、如果本地只有一个python可以直接使用【pydoc -p 端口号】启动但因为我本地有python2和python3所以指定了用python3
**方法2**直接查看某个py文件的内容
例子新建了一个py文件叫做testpydoc.py进入testpydoc.py所在目录
python3 -m pydoc testpydoc **方法三**生成html说明文档
例子新建了一个py文件叫做testpydoc.py进入testpydoc.py所在目录
python3 -m pydoc -w testpydoc
会默认将当前目录下的testpydoc生成一个叫做testpydoc.html的文档如果是目录直接【python3 -m pydoc -w 目录名】生成文档
说明如果是将整个目录生成这种格式不建议用这种方式因为如果他展示目录下的子文件的说明时会去子目录下找对应.html文件如果文件不存在就会404 方法四-k查找模块
py通过-k查找模块会在当前工程目录以及python环境变量目录下查找包含关键词的模块信息
【python3 -m pydoc -k 关键词】
例如如下命令
python3 -m pydoc -k testpydoc
结果如下
testpydoc - author 每天1990
二、html文档说明
通过查看文档的方法我们可以看到在html的文档主要分成四部分py文件的顶部注释、Classes、Functions、Data
示例代码见结尾部分
第一部分模块的文档说明展示模块顶部的多行注释
注释内如果包含了模块文件内的class名或方法名()则显示蓝色且可以点击跳转到对应说明位置 第二部分classes展示class以及class下的function
1.只能展示class下的注释不会展示class下方法的注释
2.class上面有#注释时展示#号的注释
3.class下有”””多行注释”””时优先展示多行注释就不展示顶部的#号的注释了
第三部分function模块下的def方法不是class中的方法
1.function上面有#注释时展示#号的注释
2.function下有”””多行注释”””时优先展示多行注释就不展示顶部的#号的注释了 第四部分data模块下直接定义的变量不是function或class的变量 示例代码
“” author 每天1990 desc 本模块是一个测试文件用来说明pydoc的读取内容 date 2017/4/13 说明 classes:testclass()具有function1()和function2()两个方法
functiontest1()test2()test3()
Dataab “”
#注释放在方法名前使用#号注释 def test1(a): print(“注释放在方法名前”)
#注释放在方法名前使用#号注释 def test2(): “” 注释放在方法内的第一行既有#号又有多行注释时优先展示多行注释 “” print(既有#号又有多行注释时优先展示多行注释 )
def test3(): #在方法第一行内使用#注释 print(“在方法内使用#号注释不生效”)
class testclass(): “” 注释生效顺序与方法一致优先展示类下的多行注释如果没有才展示类上面的#号注释 类下的方法的注释不会展示出来 “” def function1(self):#类下方法的注释不会展示 print(“类下的第一个方法”) def function2(self,a): print(“类下的第二个参数包含a参数”)
a1#变量的注释不会展示出来 b2
三、注释方法
通过上面的文档说明我们可以合理的注释有助于了解工程结构
python的注释方法有两种
1.单行注释使用#号进行注释
#单行注释
2.多行注释使用三个双引号或单引号来注释多行内容
‘’’ 单引号进行多行注释
‘’’
“”
双引号进行多行注释
“”
pydoc注释展示策略
在functions和classes前面加#注释或者在function和class第一行内加三个单引号或三个双引号进行注释
如果有三个引号的注释方法会优先使用三个点的注释其次才展示#号的注释
注意如果在方法或class定义后第一行使用#注释是拉取不到注释的
例子1class前有#号注释class内有多行注释pydoc会优先展示三个点内的注释 例子2方法内使用#号注释pydoc不会显示注释内容class同理 例子3方法或class没有多行注释只在方法外有#号注释时会展示定义前的#号内的内容 例子4模块顶部的内容优先展示多行注释中的内容
