各位开源爱好者,感谢您一直以来对 YouQu 自动化测试框架的信赖与支持。随着技术的不断进步和市场需求的变化,YouQu 现已升级至更加先进、功能更强大的 YouQu3 版本。为了确保您能够继续享受到高效、稳定的自动化测试服务,我们诚挚地邀请您进行版本升级。
请注意,YouQu 版本已圆满完成其历史使命,在 2025 年 6 月 1 日
之后我们将不再对其进行维护。为了保障您的测试环境和项目的持续发展,我们强烈建议您升级至 YouQu3(迁移工具)。在迁移过程中,有任何问题您可以在 YouQu 官方兴趣小组咨询,我们将尽力帮助您顺利完成过渡。
YouQu(有趣),一个使用简单且功能强大的自动化测试框架。
深度社区:linuxdeepin | deepin-community
欧拉社区:openEuler
龙晰社区:openAnolis
官方文档:https://youqu.uniontech.com
欢迎加入 YouQu官方兴趣小组
YouQu(有趣)是统信公司(Deepin/UOS)开源的一个 Linux 操作系统的自动化测试框架,支持多元化元素定位和断言、用例标签化管理和执行、强大的日志和报告输出等特色功能,同时完美兼容 X11、Wayland 显示协议,环境部署简单,操作易上手。🔥
- 💻 Linux 桌面应用 UI 自动化测试
- 🌏 Web UI 自动化测试
- 🚌 Linux DBus 接口自动化测试
- 🚀 命令行自动化测试
- 🕷️ HTTP 接口自动化测试
从 PyPI 安装:
$ sudo pip3 install youqu
不加 sudo ?
不加 sudo 也可以:
pip3 install youqu
但可能出现 youqu-startproject
命令无法使用;
这是因为不加 sudo
时,youqu-startproject
命令会生成在 $HOME/.local/bin
下,
而此路径可能不在环境变量(PATH
)中,因此您需要添加环境变量:
export PATH=$PATH:$HOME/.local/bin
您可以在任意目录下,使用 youqu-startproject
命令创建一个项目:
$ youqu-startproject my_project
注意:所有命令不要以 root
用户执行!
如果 youqu-startproject
后面不加参数,默认的项目名称为:youqu
;
安装部署 YouQu 执行所需环境:
$ cd my_project
$ bash env.sh
# 使用的默认密码是 1;
# 您可以使用 -p 选项传入密码:bash env.sh -p ${my_password};
# 也可以修改配置文件 setting/globalconfig.ini 里面的 PASSWORD 配置项;
使用 startapp
命令自动创建 APP 工程:
$ youqu manage.py startapp autotest_deepin_some
自动创建的 APP 工程遵循完整的 PO 设计模式,让你可以专注于用例和方法的编写维护。
在 apps
目录下会自动创建一个 APP 工程:autotest_deepin_some
,同时新建好工程模板目录和模板文件:
my_project
├── apps
│ ├── autotest_deepin_some # <-- APP工程
... ├── ...
在你的远程 Git 仓库中,只需要保存 APP 工程这部分代码即可。
autotest_deepin_some
是你的 APP 工程名称,在此基础上,你可以快速的开始你的 AT 项目,更重要的是确保创建工程的规范性。
apps
目录下可以存在任意多个 APP 工程。
在项目根目录下有一个 manage.py
,它是一个执行器入口,提供了本地执行、远程执行等的功能。
$ youqu manage.py run
在一些 CI 环境下使用命令行参数会更加方便:
$ youqu manage.py run -a apps/autotest_deepin_some -k "xxx" -t "yyy"
更多用法可以使用 -h
或 --help
查看。
通过配置文件配置参数
在配置文件 setting/globalconfig.ini 里面支持配置对执行的一些参数进行配置。
远程执行就是用本地作为服务端控制远程机器执行,远程机器执行的用例相同。
使用 remote
命令:
$ youqu manage.py remote
YouQu 在 GPL-2.0 下发布。