# SeleniumTestRunner

**Repository Path**: RickyLi79/selenium-test-runner

## Basic Information

- **Project Name**: SeleniumTestRunner
- **Description**: Python + Selenium + AllureReport 
用JsonDoc来实现数据驱动。
侧重点在 制作出定高度制化的AllureReport
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2021-01-12
- **Last Updated**: 2025-05-10

## Categories & Tags

**Categories**: testing

**Tags**: None

## README

# SeleniumTestRunner

## 介绍
Python + Selenium + AllureReport 
用JsonDoc来实现数据驱动。
侧重点在 制作出定高度制化的AllureReport

## 制作目的

开源DDT的自动化测试引擎很多很丰富。自己做一个是重复造轮子的行为。

但自己做一个，可以令自己对很多深层原理理解得更透彻。

本引擎不是为了对外使用，更不是为了商用，所以很多未实现的功能。仅供学习。

该项目的目的已经基本达成。**本项目不再更新** 

## 引擎特点

本引擎采用专有的DDT json文档，一下成DDT文档
DDT文档是规范的[JSON Scheme](http://json-schema.org/)，语法规范遵从 [SeleniumTestRunnerSchema_0_0_1.json](https://gitee.com/RickyLi79/selenium-test-runner/blob/master/SeleniumTestRunnerSchema_0_0_1.json)

## 运行环境

1. windows 、python 3.9
2. python依赖类库，详见：https://gitee.com/RickyLi79/selenium-test-runner/blob/master/requirements.txt
3.  安装好Selenium WebDriver 最少一款浏览器驱动，并把驱动exe文件放置在python根目录
4.  安装好Allure Report工具，并确保path上加上路径使可以在任意目录调用allure.bat。 本引擎例子用的是 allure-2.13.8

## 使用说明

1. 任意位置建立一个目录，在该目录里建立并编写符合[DDT文档规范](https://gitee.com/RickyLi79/selenium-test-runner/blob/master/SeleniumTestRunnerSchema_0_0_1.json)的JSON文档
2. 在本引擎的项目根目录下，执行win cmd命令：
```cmd
python main.py <PlanDir> [-g]
```
`<Plandir>` 是DDT文档所在目录
-g 启用该选项会在执行完后，再执行allure.bat生产html report


3.  产生的allure-report将会出现在 `<Plandir>`/allure-report


#### 使用例子

- 建立目录`D:\myPlans\test\` 
- 编写一个或多个符合[DDT文档规范](https://gitee.com/RickyLi79/selenium-test-runner/blob/master/SeleniumTestRunnerSchema_0_0_1.json)的JSON文档到该文件夹内
- [可选]下载示例文档到该文件夹内：[git_guest.json](https://gitee.com/RickyLi79/selenium-test-runner/raw/master/plans/gitee/gitee_guest.json)
- 进入本引擎项目根目录，例如：'D:\py-projects\SeleniumTestRunner'
- 在windows的cmd模式下输入指令
    ```cmd
    cd /d D:\py-projects\SeleniumTestRunner
    python main.py D:\myPlans\test\ -g
    ```
- 等待自动化测试结束
- 本次例子产生的allure report将会在   `D:\myPlans\test\`allure-report\


#### 示例

- [示例对应DDT文档](https://gitee.com/RickyLi79/selenium-test-runner/tree/master/plans/gitee)
- [线上allure-report HTML](https://rickyli79.gitee.io/testing-reports/SeleniumTestRunner/gitee/sample01/#)
- AllureReport截图
![AllureReport截图](https://gitee.com/RickyLi79/selenium-test-runner/raw/master/plans/gitee/result01.png)
- DDT文档简短说明图示
![DDT文档简短说明图示](https://gitee.com/RickyLi79/selenium-test-runner/raw/master/plans/gitee/DDT-Explain-01.png)