# 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 [-g] ``` `` 是DDT文档所在目录 -g 启用该选项会在执行完后,再执行allure.bat生产html report 3. 产生的allure-report将会出现在 ``/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)