目录

前言：

1.1 源码：

1.2 实现功能

1.3 yml管理case功能

框架详细介绍：

一、使用git远程连接&上传&下载项目

1.1 用户权限问题：本地生成密钥，gitlab后台端绑定公钥

1.1.1 本地生成密钥

1.2 项目里没有仓库，直接在gitlab上新建一个仓库

1.3 github上项目里，没有仓库，将本地存在的一个项目，推上去

1.4 存在仓库 Existing Git repository

二、常用命令

requirements.txt相关命令

三、python 命名规范

编码

包名 package

模块命名，模块(module)其实就是py文件

类名命名

函数命名

变量命名

常量命名

yml文件命名

case命名规范

四、yml文件格式

五、yml中编写case

5.1 注意事项

5.2 yml中case讲解

5.2.1 传参编写

5.2.2 headers编写

5.2.3 断言编写

六、py文件中case编写

七、case中依赖数据的处理

7.1 编写的接口，依赖另一个接口的数据，处理。在yml文件中，写被依赖的接口数据

7.2 将依赖的数据进行参数化，从全局变量的字典中取值。

八、数据问题

8.1 conftest实现数据，参数共享

8.2 全局变量

九、jsonpath 学习

前言：

1.1 源码：

https://github.com/18713341733/ApiFrame

1.2 实现功能

基于pytest+allure实现的接口自动化框架。主要就是实现了yml管理case的功能。

以及参数中变量的处理、参数的传递、接口a依赖接口b返回值的处理

用户编写case时，需要写两个地方。

1、/data/ 下，yml文件，编写case所需数据

2、/test_case/下，编写case

1.3 yml管理case功能

1、单接口请求

2、两个依赖接口请求

3、依赖变量的请求

框架详细介绍：

作者：喵酱老师

描述：本项目使用说明

一、使用git远程连接&上传&下载项目

1.1 用户权限问题：本地生成密钥，gitlab后台端绑定公钥

1.1.1 本地生成密钥

--------设置用户名，邮箱（Git global setup）

git config --global user.name "喵酱"
git config --global user.email "miaojaing@163.com"

------生成本地密钥 1.查看是否已经有了ssh密钥：cd ~/.ssh 如果没有密钥则不会有此文件夹，有则备份删除 2.生成密钥： ssh-keygen -t rsa -C 'miaojaing@163.com' 按3个回车，密码为空。

------------github后台端绑定公钥 公钥信息：

cat ~/.ssh/id_rsa.pub

将公钥信息，复制到github 后台 点击右上角自己的头像----Settings----SSh Keys-----添加公钥信息

1.2 项目里没有仓库，直接在gitlab上新建一个仓库

git clone http://xxx/ApiFrame.git
cd ApiFrame
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master

1.3 github上项目里，没有仓库，将本地存在的一个项目，推上去

cd existing_folder
git init
git remote add origin http://xxxxxx/ApiFrame.git
git add .
git commit -m "Initial commit"
git push -u origin master

1.4 存在仓库 Existing Git repository

cd existing_repo
git remote add origin http://xxxx/ApiFrame.git
git push -u origin --all
git push -u origin --tags

二、常用命令

requirements.txt相关命令

1、安装

python3 -m pip install pipreqs

2、在当前目录生成

pipreqs . --encoding=utf8 --force

3、在当前环境，导入依赖包

python3 -m pip install -r requirements.txt

三、python 命名规范

编码

如无特殊情况, 文件头部必须加入#--coding:utf-8--标识

包名 package

包名尽量短小，并且全部使用小写字母，不推荐使用下划线。例如：box、top、game、fun等。

模块命名，模块(module)其实就是py文件

模块名尽量短小，并且全部小写字母，可以使用下划线连接多个单词。例如：value、game_value等。(value是我经常用的一个单词)

类名命名

类名使用驼峰(CamelCase)命名风格，首字母大写，私有类可用一个下划线开头，如

class Farm():

class AnimalFarm(Farm):

class _PrivateFarm(Farm):

函数命名

函数名一律小写，如有多个单词，用下划线隔开，如

def run_with_env()

私有函数在函数前加一个下划线，如：

def _private_func():

变量命名

变量名尽量小写, 如有多个单词，用下划线隔开，如

school_name = "一中"

常量命名

常量使用以下划线分隔的大写命名

MAX_OVERFLOW = 100

yml文件命名

全部小写，多个单词 以 - 分割。如：

application-dev.yml，application-prod.yml

case命名规范

case名称，要与接口名称保持一致。且用下划线隔开

如接口名称为 /system/menu

则case命名应该为 def test_system_menu()

四、yml文件格式

对象，map(属性和值) （键值对）

user:
  userName: "xiaoming"
  boss: true
  birth: 2022/07/13
  age: 20

行内写法:

user:{userName: "小明",boss: true,birth: 2022/07/13,age: 20}

五、yml中编写case

5.1 注意事项

1、yml文件，是通过缩进表示层级关系的，所在xxx.yml文件中，编写case时，一定要注意缩进。

2、每个yaml文件是一个模块

3、每个模块下，编写case时。一定要保证 case 名称与接口名称一致。

5.2 yml中case讲解

/api/abc/abc/abc/page:
  - name: "获取接口统一鉴权token"
    request:
      method: post
      url: /api/abcf/abc/abc/page
      headers:
        Content-Type: application/json
      datas:
        username: miaojiang
        password: 123456
    assertion:
      -
        - expectation: "'data':"
        - compare: "in"
        - ctual_value:
      -
        - expectation: "1"
        - compare: "="
        - ctual_value: "$.data.id"

1、yml中接口名称（/api/abc/abc/abc/page），必须与 接口文档中的接口名称保持一致

2、name 为当前case的名称

3、reqeust 填写请求需要的信息。

4、assertion: 断言

最少要有1个断言。上述代码中有2个断言。

expectation 为用户的期望值

compare 比较方式

ctual_value 为实际值。为空时，实际值取的整个response返回值。 想取具体某个字段时，需要使用jsonpath语法。 python中jsonpath的用法_python jsonpath_keer丶的博客-CSDN博客

jsonpath语法 在当前项目example中也有示例。

5.2.1 传参编写

1、传参为空

datas 后面为空就可以了

        Content-Type: application/json
      datas:
    assertion:

2、传参为josn，写法一

datas 后面直接跟一个字典。这个字典只能写一行。

      headers:
        Content-Type: application/json
      datas: {"username":"miaojiang","password":"123456","code":"1111"}
    assertion:

2、传参为josn，写法二

参数为key value的形式。

      datas:
        username: miaojiang
        password: 123456
    assertion:

5.2.2 headers编写

后台中，很多接口，都需要一个登录信息的鉴权。

是通过header里的 Authorization 进行鉴权的。 当case需要有这个信息时，在yml里的headers中可以写Authorization，也可以不写这个字段。 框架中，鉴权信息不是通过 headr控制的，是通过 编写case时，传参get_authorization控制的，如

def test_get_info(self,test_data:dict,get_authorization):

5.2.3 断言编写

代码如下：

    assertion:
      -
        - expectation: "操作成功"
        - compare: "in"
        - ctual_value:
      -
        - expectation: "admin"
        - compare: "="
        - ctual_value: "$.data.user.name"

1、支持多个断言

2、断言逻辑是，拿着期望值 expectation 与 实际值 ctual_value 做比较

3、ctual_value: 为空时，表示实际值是整个接口返回值response

4、当实际值，想具体取接口返回值中的某一个字段时，使用jsonpath的写法。

如整个返回值为

{
    'code': 200, 
    'msg': '操作成功', 
    'data': {
        'user': {
            'name': 'miaojiang', 
            'createTime': '2022-04-25 13:53:01', 
            'update': None, 

想要对比的实际值为data下，user 下的 name 字段。 写法为：

- ctual_value: "$.data.user.name"

5、 比较方式 compare in 表示 期望值 在 实际值里面。

> 期望值 大于 实际值

< 期望值，小于 实际值

六、py文件中case编写

类名，与方法名，必须以test_开头。

case 需要登录鉴权信息时，需要传入 get_authorization，如

def test_get_info(self,test_data:dict,get_authorization):

七、case中依赖数据的处理

7.1 编写的接口，依赖另一个接口的数据，处理。在yml文件中，写被依赖的接口数据

举个例子。

/goods/getgoods:
  - name: "演示：获取商品信息"
    request:
      method: post
      url: /api/abc/goods/getGoods
      headers:
        Content-Type: application/json
      datas: {"id": $id}
    assertion:
      -
        - expectation: "成功"
        - compare: "in"
        - ctual_value:
    dependence:
      request:
        method: post
        uri: /api/abc/goods/queryGoodsList
        headers:
          Content-Type: application/json
        datas: {"Platform":"","pageNum":1,"pageSize":10}
      expectation:
        id: $.data.list[:1].id

查询商品详情：/goods/getGoods:

url: /api/abc/goods/getGoods

需要传一个good id, 但是这个id 不能写死。 我先去获取 商品列表，queryGoodsList ,取第一个商品的 id,将这个id 传给查看 商品详情的接口。 在 getGoods 接口中，传参 id,写不写无所谓。怎么写都行。 重点在于dependence.expectation的取值。

id: $.data.list[:1].id

key：value

key 为 getGoods 接口中，传参datas 中的key， value ,取值，为依赖接口queryGoodsList 返回值中的，需要的字段取值 用的jsonpath语法

注意： 1、yml中，有依赖的场景再添加dependence， 没有依赖，就不需要添加 dependence 数据

2、dependence 中的uri，如果host 与主接口的host一致，就可以直接写uri，不用写host, http://xxx.xx.xx

如果依赖的接口host，与主接口的host不一致，则需要在dependence 中的uri 中，写全url的路径。

7.2 将依赖的数据进行参数化，从全局变量的字典中取值。

比如，修改商品 的 接口，这个商品的id，不能是写死的，是一个参数化的东西。

第一步：

我在yml文件中，写商品的id 时， 使用 ${id} 的形式。

方式一：datas所有数据写一行

datas: {"id": "${id}","status":"0"}

方式二：datas数据写多行

      datas:
          Platform: "abc"
          id: "${id}"
          imgUrl: "http://t"

或者

      datas:
          Platform: "abc"
          id: ${id}
          imgUrl: "http://t"

第二步：

在执行case之前，把变量id写到全局变量的字典中。 可以写在contest.py 文件中，也可以写到case py文件的setup中，如：

class Test_GoodsController():
    """
    类名必须以Test_开头
    功能： 商品管理页面
    """
    def setup_class(self):
        """类的初始化"""
        # 设置全局变量，商品的id
        set_value("id",113)

八、数据问题

8.1 conftest实现数据，参数共享

conftest.py来实现数据，参数，方法、函数的共享。

方法： pytest使用(3)-conftest_pytest中的conftest_止语---的博客-CSDN博客

• function：每一个函数或方法都会调用
• class：每一个类调用一次，一个类中可以有多个方法
• module：每一个.py文件调用一次，该文件内又有多个function和class
• session：是多个文件调用一次，可以跨.py文件调用，每个.py文件就是module

1. scope参数为session：所有测试.py文件执行前执行一次
2. scope参数为module：每一个测试.py文件执行前都会执行一次conftest文件中的fixture
3. scope参数为class：每一个测试文件中的测试类执行前都会执行一次conftest文件中的
4. scope参数为function：所有文件的测试用例执行前都会执行一次conftest文件中的fixture

8.2 全局变量

定义了一个全局变量类，GlobalDict

用来存放整个项目中用到的变量。 注意变量key的命名。

使用方法

from common.global_dict import get_value,set_value

def test1():
    set_value("a","1112")
    pass

def test2():
    x=get_value("a")
    print(x)


if __name__ == '__main__':
    test1()
    test2()

九、jsonpath 学习

练习地址：

JSONPath Online Evaluator

相关博客： JsonPath完全介绍及详细使用教程_软件测试情报局的博客-CSDN博客

字典中，嵌套list，取list中第一个元素的id值 $.data.list[:1].id

十、json(字符串)、字典相互转换

10.1 将字符串转成字典

使用ast

import ast
user = '{"name" : "john", "gender" : "male", "age": 28}'
user_dict = ast.literal_eval(user)

如果使用 json （json.loads）进行转换存在不能使用单引号的问题。

json 语法规定 数组或对象之中的字符串必须使用双引号，不能使用单引号，会报错。

十一、更新 依赖接口的处理teardown

2023年5月9日，第一次更新。更新功能，处理依赖接口。

一个完整的接口，依赖setup 与teardown 。

setup 就是上面讲的dependence: 数据块。

本次新增teardown的处理。

版本有在迭代，但是我没时间更新，等有时间了我更一波代码