Python基础（十四）文档与测试

1. 使用pydoc生成文档

1. 在控制台中查看文档

python -m pydoc 模块名

如，python -m pydoc requests

Help on package requests:

NAME
    requests

DESCRIPTION
    Requests HTTP Library
    ~~~~~~~~~~~~~~~~~~~~~

    Requests is an HTTP library, written in Python, for human beings. Basic GET
    usage:

       >>> import requests
       >>> r = requests.get('https://www.python.org')
       >>> r.status_code
       200
       >>> 'Python is a programming language' in r.content
       True

    ... or POST:

       >>> payload = dict(key1='value1', key2='value2')
       >>> r = requests.post('http://httpbin.org/post', data=payload)
       >>> print(r.text)
       {
         ...
-- More  --

2. 生成HTML文档

python -m pydoc -w 模块名

3. 启动本地服务器来查看文档信息

python3 -m pydoc -p 端口号

4. 查找模块

python -m pydoc -k 被搜索模块的部分内容

2. 软件测试概述

1. 软件测试的概念和目的

IEEE给出如下定义
测试是使用人工和自动手段来运行或检测某个系统的过程，其目的在于检验系统是否满足规定的需求，或者弄清预期结果与实际结果之间的差别。

---

Glen Myers（梅尔斯）提出的定义

• 软件测试是为了发现软件隐藏的缺陷
• 一次成功的软件测试是发现了尚未被发现的缺陷
• 软件测试并不能保证软件没有缺陷

---

导致软件的缺陷：

• 编程错误
• 软件的复杂度
• 不断变更的需求
• 时间的压力
• 开发平台本身的缺陷

软件测试的基本原则：

• 应该尽早并不断地进行软件测试
• 测试用例应该由测试输入数据和对用的预期输出结果两部分组成
• 开发人员避免测试自己的项目
• 在设计测试用例时，至少应该包括合理的输入不合理的输入两种
• 应该充分注意测试中的群集现象，经验表明，测试后程序中残存的错误数目与该程序中已发现的错误数目呈正比
• 严格执行测试计划，避免测试的随意性
• 应当对每一个测试结果都做全面检查
• 妥善保存测试计划，测试用例，出错统计和最后分析报告，为维护提供方便。

2. 软件测试的分类

1. 从软件工程的总体把握来说

• 静态测试
  • 代码审阅
  • 代码分析
  • 文档检查
• 动态测试
  • 结构测试（白盒）：各种覆盖测试
  • 功能测试（黑盒）： 集成测试，系统测试和用户测试等。

2. 从软件测试工程的大小来分

• 单元测试：测试中的最小单位
• 集成测试
• 系统测试
• 用户测试
• 平行测试

3. 开发活动和测试活动

开发活动和测试活动

3. 单元测试

1. 单元测试是一种小粒度的测试，用以测试某个功能或代码块。
2. 单元测试的好处：

• 提高开发速度
• 提高软件代码质量
• 提高系统的可信赖度

3. 单元测试的逻辑覆盖包括：

• 语句覆盖： 每条语句都至少执行一次
• 判定（边）覆盖： 每条语句都执行，每个判定的所有可能结果都至少执行一次
• 条件覆盖： 每条语句都执行，判定表达式的每种可能都取得各种结果
• 判定-条件覆盖： 同时满足判定覆盖和条件覆盖
• 路径覆盖： 程序的每条可能路径都至少执行一次