httprunner学习15-运行用例命令行参数详解
前言
HttpRunner 在命令行中启动测试时，通过指定参数，可实现丰富的测试特性控制。
命令行参数CLI
使用 -h 查看相关命令行参数
hrun -h
| 参数名称 | 参数值 | 参数说明 |
|---|---|---|
| -h, —help | 不带参数 | 查看帮助信息 |
| -V, —version | 不带参数 | 查看版本号 |
| —no-html-report | 不带参数 | 不生成测试报告 |
| —html-report-name | HTML_REPORT_NAM | 重命名html报告名称 |
| —html-report-template | HTML_REPORT_TEMPLATE | 自定义html报告模板，参数带上html模板的信息路径 |
| —log-level | LOG_LEVEL | 日志等级，如：debug |
| —log-file | LOG_FILE | 指定日志文本保存路径 |
| —dot-env-path | DOT_ENV_PATH | 指定环境变量.env的详细路径 |
| —failfast | 不带参数 | 运到失败后停止测试 |
| —startproject | STARTPROJECT | 指定项目的根目录 |
| —validate | [VALIDATE [VALIDATE …]] | 校验json格式 |
| —prettify | [PRETTIFY [PRETTIFY …]] | 各式化json文件 |
—no-html-report
不生成html报告，使用—no-html-report
hrun test_demo.yml —no-html-report
这样运行的时候，就不会生成html报告
D:\soft\untitled>hrun test_demo.yml --no-html-report
test_demo case1
INFO GET http://127.0.0.1:8000/api/test/demo
INFO status_code: 200, response_time(ms): 4.96 ms, response_length: 255 bytes
INFO start to extract from response object.
INFO start to validate.
.
----------------------------------------------------------------------
Ran 1 test in 0.014s
OK
—html-report-name
—html-report-name 用于指定测试报告的名称
hrun test_demo.yml —html-report-name yoyo
这样运行之后，会再当前的report目录下，生成一个yoyo的文件夹
—html-report-template
自定义测试报告模板，后面参数是模板报告的绝对路径
hrun test_demo.yml —html-report-template /path/templates/extent_report_template.html
如果指定报告名称的话，需要修改源码，详情参考httprunner学习10-测试报告ExtentReport
—log-level
打印日志等级，使用—log-level参数，日志有五个等级：debug < info < warn < error < critical
各等级的含义：
debug: 级别最低，用户开发过程中的调试
info：
打印程序运行是的正常的信息，用于替代print输出
warn: 打印警告信息，不影响程序的运行
error: 程序运行出错，可以修复，常用在except异常捕获之后
critical: 非常严重，无法修复，程序继续运行的话后果非常严重
设置了日志等级后，调用比等级低的日志记录函数则不会输出。
httprunner默认使用info等级，不带 --log-level info 参数结果也是一样的
hrun test_demo.yml —log-level info
设置debug等级，打印最详细的内容
hrun test_demo.yml —log-level debug
另外三个等级warn/error/critical,只有有警告或者报错时候，才有日志输出，所以用的很少
D:\soft\untitled>hrun test_demo.yml --log-level warn
test_demo case1
.
----------------------------------------------------------------------
Ran 1 test in 0.006s
OK
D:\soft\untitled>hrun test_demo.yml --log-level error
test_demo case1
.
----------------------------------------------------------------------
Ran 1 test in 0.006s
OK
D:\soft\untitled>hrun test_demo.yml --log-level critical
test_demo case1
.
----------------------------------------------------------------------
Ran 1 test in 0.007s
OK
—log-file
—log-file 参数保存日志文件到指定的目录,保存日志文件到yoyo.txt
hrun test_demo.yml —log-file yoyo.txt
在当前运行的目录，会生成一个yoyo.txt文件
2019-09-28 22:43:11,492 - INFO - [32mGET http://127.0.0.1:8000/api/test/demo
2019-09-28 22:43:11,498 - INFO - [32mstatus_code: 200, response_time(ms): 6.0 ms, response_length: 255 bytes
2019-09-28 22:43:11,498 - INFO - [32mstart to extract from response object.
2019-09-28 22:43:11,498 - INFO - [32mstart to validate.
2019-09-28 22:43:11,503 - INFO - [32mStart to render Html report ...
2019-09-28 22:43:11,578 - INFO - [32mGenerated Html report: D:\soft\untitled\reports\1569681791.html
由于日志的输出有加颜色，所以保存的时候会有一些乱码，我稍微改了下httprunner/logger.py文件的日志内容，但还是有一点乱码
def setup_logger(log_level, log_file=None):
"""setup root logger with ColoredFormatter."""
level = getattr(logging, log_level.upper(), None)
if not level:
color_print("Invalid log level: %s" % log_level, "RED")
sys.exit(1)
# hide traceback when log level is INFO/WARNING/ERROR/CRITICAL
if level >= logging.INFO:
sys.tracebacklimit = 0
formatter = ColoredFormatter(
u"%(log_color)s%(bg_white)s%(levelname)-8s%(reset)s %(message)s",
datefmt=None,
reset=True,
log_colors=log_colors_config
)
if log_file:
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s') # 加了这句
handler = logging.FileHandler(log_file, encoding='utf-8')
else:
handler = logging.StreamHandler()
handler.setFormatter(formatter)
logging.root.addHandler(handler)
logging.root.setLevel(level)
其它
—dot-env-path 用于指定.env文件的目录
hrun test_demo.yml —dot-env-path d:\path\to.env
—failfast 遇到失败停止测试
hrun test_demo.yml —failfast
—validate 校验json格式,格式正确返回OK，若 JSON 文件格式存在异常，则打印详细的报错信息，精确到错误在文件中出现的行和列。
hrun —validate test_login2.json
—prettify 用于格式化json文件内容
hrun —prettify test_login2.json
D:\soft\untitled>hrun --validate test_login2.json
Start to validate JSON file: test_login2.json
OK
D:\soft\untitled>hrun --prettify test_login2.json
Start to prettify JSON file: test_login2.json
success: test_login2.pretty.json