HttpRunner3.x 源码解析-runner.py

Posted 2023-04-09 东方不败之鸭梨的测试笔记

首先看下生成的pytest文件

from httprunner import HttpRunner, Config, Step, RunRequest, RunTestCase


class TestCaseLogin(HttpRunner):

    config = (
        Config("登录成功").variables(**"password": "tester", "expect_foo2": "config_bar2").base_url("https://api.pity.fun")
        .verify(False)
        .export(*["token"])
    )

    teststeps = [
        Step(
            RunRequest("登录成功")
            .with_variables(**"foo1": "bar1")
            .setup_hook("$get_request($request)")
            .post("/auth/login")
            .with_headers(**"Content-Type": "application/json")
            .with_json("username": "$ENV(username)", "password": "$ENV(password)")
            .teardown_hook("$get_reponse($response)")
            .extract()
            .with_jmespath("body.msg", "token")
            .validate()
            .assert_equal("status_code", 200)
            .assert_equal("body.code", 0)
            .assert_equal("body.msg", "哈哈哈")
        ),
    ]


if __name__ == "__main__":
    TestCaseLogin().test_start()

首先类继承了HttpRunner类

主要包括config和teststeps两部分

函数的入库是test_start()方法

test_start

  def test_start(self, param: Dict = None) -> "HttpRunner":
        """main entrance, discovered by pytest"""
        self.__init_tests__()
        self.__project_meta = self.__project_meta or load_project_meta(
            self.__config.path
        )
        self.__case_id = self.__case_id or str(uuid.uuid4())
        self.__log_path = self.__log_path or os.path.join(
            self.__project_meta.RootDir, "logs", f"self.__case_id.run.log"
        )
        log_handler = logger.add(self.__log_path, level="DEBUG")

        # parse config name
        config_variables = self.__config.variables
        if param:
            config_variables.update(param)
        config_variables.update(self.__session_variables)
        self.__config.name = parse_data(
            self.__config.name, config_variables, self.__project_meta.functions
        )

        if USE_ALLURE:
            # update allure report meta
            allure.dynamic.title(self.__config.name)
            allure.dynamic.description(f"TestCase ID: self.__case_id")

        logger.info(
            f"Start to run testcase: self.__config.name, TestCase ID: self.__case_id"
        )

        try:
            return self.run_testcase(
                TestCase(config=self.__config, teststeps=self.__teststeps)
            )
        finally:
            logger.remove(log_handler)
            logger.info(f"generate testcase log: self.__log_path")

首先调用了__init_tests__()方法

 teststeps是pytest文件中的Step列表，示例只有1个步骤。

 

config.perform方法返回了一个Tconfig对象，这个对象定义了testcase的config中的关键字和内容

 

teststeps是py文件中的Step列表，

调用的step.perform()方法，返回__step_context，而__step_context来自step_context调用perfoem方法。

在Step类的初始化函数可以看到，step_context可以是如下几种

当step_contxt时RunTestCase时，调用它的perfom方法如下，可以看到返回的是一个TStep对象。

 

 接着看test_start()

self.__project_meta = self.__project_meta or load_project_meta(
    self.__config.path
)

 返回项目的资源文件

self.__case_id为caseid或者是一个uuid

self.__log_path为日志目录

config_variables = self.__config.variables为config部分的变量

self.__config.name = parse_data(
    self.__config.name, config_variables, self.__project_meta.functions
)获取config中的name

if USE_ALLURE:
    # update allure report meta
    allure.dynamic.title(self.__config.name)
    allure.dynamic.description(f"TestCase ID: self.__case_id")

logger.info(
    f"Start to run testcase: self.__config.name, TestCase ID: self.__case_id"
)

如果用了allure报告，则定义title和描述

 

return self.run_testcase(
    TestCase(config=self.__config, teststeps=self.__teststeps)
)

将config和teststeps列表传给TestCase并调用HttpRunner类的run_testcase方法执行用例

run_testcase

这个方法最后返回的也是HttpRunner实例

主要的是下面这一句，执行了用例的步骤。

extract_mapping = self.__run_step(step)

 __run_step方法

如果步骤中存在request，则调用__run_step_request来执行步骤，并返回返回testdata

如果存在testcase，则调用__run_step_testcase(step)来执行，最后返回test_data

    def __run_step(self, step: TStep):
        """run teststep, teststep maybe a request or referenced testcase"""
        logger.info(f"run step begin: step.name >>>>>>")

        if step.request:
            step_data = self.__run_step_request(step)
        elif step.testcase:
            step_data = self.__run_step_testcase(step)
        else:
            raise ParamsError(
                f"teststep is neither a request nor a referenced testcase: step.dict()"
            )

        self.__step_datas.append(step_data)
        logger.info(f"run step end: step.name <<<<<<\\n")
        return step_data.export_vars

__run_step_request

这个方法解析request并调用request方法来执行

resp = self.__session.request(method, url, **parsed_request_dict)

 

parsed_request_dict解析请求字典

parsed_request_dict

'method': 'POST', 'url': '/auth/login', 'params': , 'headers': 'Content-Type': 'application/json', 'req_json': 'username': 'tester', 'password': 'tester', 'data': None, 'cookies': , 'timeout': 120, 'allow_redirects': True, 'verify': False

if step.setup_hooks:
    self.__call_hooks(step.setup_hooks, step.variables, "setup request")

如果存在setup_hooks就调用hook

 

 

# teardown hooks
if step.teardown_hooks:
    self.__call_hooks(step.teardown_hooks, step.variables, "teardown request")

如果存在teardown就调用hook

 最后返回step_data

 

 

httprunner 3.X学习

httprunner 3.X相比httprunner 2.X系统中会新增 4 个命令：

• httprunner： 核心命令
• hrun：httprunner 的缩写，功能与 httprunner 完全相同
• hmake：httprunner make的别名，用于将YAML/JSON测试用例转换为pytest文件
• har2case：辅助工具，可将标准通用的 HAR 格式（HTTP Archive）转换为YAML/JSON格式的测试用例

新建项目区别：

进入项目路径，终端执行以下指令，创建项目

hrun --startproject httprunner_demo  # 2.x版本
httprunner startproject httprunner_demo  # 3.x版本

 

 

• debugtalk.py 放置在项目根目录下（借鉴了pytest的conftest文件的设计）
• .env 放置在项目根目录下，可以用于存放一些环境变量
• reports 文件夹：存储 HTML 测试报告
• testcases 用于存放测试用例
• har 可以存放录制导出的.har文件

【运行项目】

终端执行以下指令

hrun httprunner_demo

【录制生成测试用例】

对接口信息进行抓包,生成.har文件，比如命名为baidu_home.har

mac : 抓包工具charles导出接口数据

windows: Fiddler导出接口抓包数据

转化为测试用例

在项目的har文件中，终端输入以下指令

har2case baidu_home.har  # 默认生成json格式
har2case baidu_home.har -2y  # 生成yaml格式

运行测试用例

hrun baidu_home.json

运行后，生成.py文件

 

 

来源：https://www.cnblogs.com/pingguo-softwaretesting/p/13204045.html