# testng-ext

**Repository Path**: ijfxu/testng-ext

## Basic Information

- **Project Name**: testng-ext
- **Description**: 对testNG框架的拓展
- **Primary Language**: Java
- **License**: GPL-2.0
- **Default Branch**: v1
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-17
- **Last Updated**: 2022-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: TestNG

## README

# testng-ext

## 介绍

**针对testNG原生框架进行接口自动化测试进行拓展**

- 拓展Reporter.log方法，通过环境变量log2reporter控制，可以将日志信息打印到报告中
- 新增dataProviderClass-->"DataProv"和dataprovider方法-->"dataProv"、"beanDataProv"

  - DataProv.class 可以迭代.txt和.xlsx文件内容
  - dataProv 方法 可以给测试方法提供字符串参数
  - beanDataProv 方法可以给测试方法提供指定类型的参数
- 新增测试方法和测试数据文件自动映射功能

  - 映射规则为

  ```
  casescript.[xx..xx.]测试类.测试方法-->resources\casedata\[xx\..\xx\]测试类名文件夹\测试方法名文件
  ```
- 新增测试数据注册方法:TestDataCollection.register(String methodName, String... filePaths)，支持一对一注册和一对多注册（即一个测试方法对应多个测试文件）
- 新增脚手架脚本(windows环境)，通过脚本执行生成maven工程的测试框架、测试类和测试方法的demo(可以直接打开执行测试)

## 安装教程

下载[scaffolding.testng-ext.win.7z](https://gitee.com/ijfxu/testng-ext/blob/v1/doc/scaffolding.testng-ext.win.7z)
解压后目录结构如下

```
│  pom.xml
│  README.txt
│  scaffold.bat
│
├─casedata
│  └─HelloTest
│          excelBeanDataIterTest.xlsx
│          excelDataIterTest.xlsx
│          hello_test.txt
│          txtBeanDataIterTest.txt
│          txtDataIterTest.txt
│
└─casescript
        HelloTest.java
        Stu.java

```

直接运行scaffold.bat,根据提示输入相关参数即可生成maven测试工程

## 测试工程相关目录介绍

```
│  pom.xml
│
└─src
    └─test
        ├─java
        │  └─com
        │      └─test
        │          └─casescript
        │                  HelloTest.java
        │                  Stu.java
        │
        └─resources
            └─casedata
                └─HelloTest
                        excelBeanDataIterTest.xlsx
                        excelDataIterTest.xlsx
                        hello_test.txt
                        txtBeanDataIterTest.txt
                        txtDataIterTest.txt
```

- casescript: 目录下存放测试类（HelloTest.java），也可以是测试类包，注意数据映射路径即可
- casedata:  目录下存放的是测试数据文件包

## 开发计划

- [X] 新增测试启动类
- [ ] 新增打包配置文件，通过jar包执行测试
- [ ] 报错信息规范

  - [ ] 用例入参和报错信息进行匹配组装成{api:"",case:"",type:"Nomal",msg:"",...}
- [ ] 增加dubbo工具类
- [X] 增加文件渲染监听器

## 相关连接

- [javadoc](https://apidoc.gitee.com/ijfxu/testng-ext)
- [脚手架脚本](https://gitee.com/ijfxu/testng-ext/blob/v1/doc/scaffolding.testng-ext.win.7z)