deepin-autotest-framework-master.zip

<p align="center"> <a href="https://linuxdeepin.github.io/deepin-autotest-framework/"> <img src="./docs/logo.png" width="520" alt="YouQu"> </a> </p> <p align="center"> <em>有趣，一个使用简单且功能强大的自动化测试基础框架。</em> </p> [](https://github.com/linuxdeepin/deepin-autotest-framework/issues) [](https://github.com/linuxdeepin/deepin-autotest-framework/pulls) [](https://github.com/linuxdeepin/deepin-autotest-framework/discussions) [](https://pypi.org/project/youqu/)      [](https://pepy.tech/project/youqu) [](https://pepy.tech/project/youqu) [](https://pepy.tech/project/youqu) [](https://github.com/linuxdeepin/deepin-autotest-framework) [](https://linuxdeepin.github.io/deepin-autotest-framework) [](http://youqu.uniontech.com/) [](https://pypi.org/project/youqu/) --- **文档**: <a href="https://linuxdeepin.github.io/deepin-autotest-framework" target="_blank">https://linuxdeepin.github.io/deepin-autotest-framework</a> **源码**: <a href="https://github.com/linuxdeepin/deepin-autotest-framework" target="_blank">https://github.com/linuxdeepin/deepin-autotest-framework</a> --- 有趣（YouQu）是深度科技开源的一个用于 `Deepin/UOS` 操作系统（Linux）的自动化测试框架，采用结构分层的设计理念，支持多元化元素定位和断言、用例标签化管理和执行、强大的日志和报告输出等特色功能，同时完美兼容 X11、Wayland 显示协议，环境部署简单，操作易上手。 ### 爱上 “有趣” 的 18 个理由 1. 核心库提供了统一的接口，编写方法时只需要导入一个包就可以使用到核心库提供的所有功能； 2. 公共库封装了很多常用模块的相关方法，比如：任务栏的操作、桌面的操作、右键菜单的操作等等； 3. 除了常用的属性定位、图像识别以外，我们还提供基于 `UI` 的元素定位方案，其使用简单且高效，效果一定能惊讶到你； 4. 对属性定位的方法进行了二次封装，将编写属性定位的方法变得简单而优雅； 5. 对图像识别定位技术进行功能升级，除了支持单个坐标返回，还支持同一界面下多个相同元素返回多个坐标的功能； 6. 提供用例标签化管理、批量跳过和批量条件跳过的功能，你想不到一个 `csv` 文件原来能干这么多事情； 7. 提供了功能强大的执行器入口，让你可以方便的在本地执行任何用例集的用例，其丰富的自定义配置项，满足你对执行器所有的幻想； 8. 提供远程执行的功能，可以控制多台机器并行跑，或者分布式跑，这种付费功能现在免费给你用； 9. 提供自动输出日志的功能，你再也不用为每个方法单独写输出日志的代码，一切我们给你搞定了，日志输出不仅内容丰富，颜值也绝对在线，我们还自己设计了一款终端输出主题叫《五彩斑斓的黑》； 10. 提供一键部署自动化测试环境的功能，让你再也不用为环境部署而烦恼； 11. 提供自动生成多种报告的功能，你想输出什么报告形式都行，而且我们在报告中还加入了失败录屏和失败截图的功能； 12. 对断言进行了二次封装，提供更友好化的错误提示，让定位问题精准高效； 13. 不仅支持单条用例超时控制，而且还支持动态控制用例批量执行的总时间，确保 `CI` 环境下能顺畅运行； 14. 支持本地文件测试套执行、`PMS` 测试套执行、标签化执行方案，满足你各种场景下的执行需求； 15. 支持基于深度学习的 `OCR` 功能，可定位可断言，中文识别的天花板； 16. 完美兼容 `Wayland` 和 `X11`，真正做到一套代码，随处执行； 17. 支持多种方式的数据回填功能，其中异步回填的方案，完美解决了数据回填的耗时问题； 18. 支持重启交互场景用例的执行，使用方法优雅简洁； ------------------------ 统信公司内网还可以访问【[内网文档](http://youqu.uniontech.com/)】，文档内容一样，访问速度更快哦~~ ## 安装使用 从 PyPI 安装: <div class="termy"> ```console $ sudo pip3 install youqu ---> 100% ``` </div> 创建项目: <div class="termy"> ```console $ youqu-startproject my_project ---> 100% The project: [my_project],has been created by youqu-x.x.x ``` </div> 如果 `youqu-startproject` 后面不加参数，默认的项目名称为：`youqu` ； 安装依赖: <div class="termy"> ```console // 如果你的测试机密码不是 `1` ，那你需要在全局配置文件 `globalconfig.ini` 里面将 `PASSWORD` 配置项修改为当前测试机的密码。 $ cd my_project $ bash env.sh ---> 100% ``` </div> ------------------------------- **【APP工程】** 如果您已经有一个可用的 `APP` 工程，将应用库放到基础框架下 `apps` 目录下，像这样： ```shell hl_lines="3" my_project ├── apps │ ├── autotest_deepin_music # 应用库 ... ``` 如果您还没有 `APP` 工程，建议使用框架提供的脚手架功能创建一个全新的 `APP` 工程。 ## 创建工程 创建一个 APP 工程： <div class="termy"> ```console $ youqu manage.py startapp autotest_deepin_some ---> 100% ``` </div> 这样在 `apps` 目录下会创建一个子项目工程 `autotest_deepin_some`，同时新建好工程模板目录和模板文件： ```shell apps └── autotest_deepin_some    ├── case    │   ├── assert_res    │   │   └── readme    │   ├── base_case.py    │   └── __init__.py    ├── config.ini    ├── config.py    ├── conftest.py    ├── control    ├── deepin_some_assert.py    ├── deepin_some.csv    ├── __init__.py    └── widget    ├── base_widget.py    ├── case_res    │   └── readme    ├── deepin_some_widget.py    ├── __init__.py    ├── other.ini    ├── other_widget.py    ├── pic_res    │   └── readme    └── ui.ini ``` `autotest_deepin_some` 是你的工程名称，比如：`autotest_deepin_music` ； 在此基础上，你可以快速的开始你的 AT 项目，更重要的是确保创建工程的规范性。 运行 ---