# clickx3-toolkit

**Repository Path**: taylortaurus/clickx3-toolkit

## Basic Information

- **Project Name**: clickx3-toolkit
- **Description**: 测试点点点就完事了
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-06-22
- **Last Updated**: 2021-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ClickX3 Toolkit

- ClickX3直译过来是点击三次，点点点的意思，通俗的说就是测试日常的工作“点点点”。

- ClickX3结合传统的PO模式，在Page对象之上再增加一层App对象，可使脚本结构更清晰但又不会增加脚本复杂度，在此基础上提供封装好的功能增强的api和提供大量的异常校验和重试机制。

- ClickX3主要通过继承Selenium、Uiautomator2和Facebook-WDA的主要模块实现，并将以上依赖库抽象为Driver/Device、App、Page和Element类，由于是通过继承实现，再实现自定义方法后也不会破坏原有方法，不会影响原依赖库的使用习惯。

- ClickX3初衷是提供开箱即用的模块，在测试脚本中减少甚至不需要编写异常处理代码和大量sleep的语句，在测试脚本中只需要编写业务流程的测试代码即可完成完整且稳定的UI自动化测试。

- ClickX3可一定程度上提高脚本易维护性、易读性、稳定性和结果可信度。

- 我们常说测试点点点就完事，那么就让点点点自动化吧！

## 安装依赖

```shell
python3 -m pip install poetry -i https://mirrors.aliyun.com/pypi/simple/
cd clickx3-toolkit/
python3 -m poetry install
```

## 虚拟环境添加myproject.pth

在目录`.cache/virtualenvs/xxx/Lib/site-packages/`下新增`myproject.pth`文件，内容如下：

```text
absolute/path/to/project
```

## 导出requirements.txt

```shell
python3 -m poetry export -f requirements.txt -o requirements.txt --without-hashes
```

## 站在巨人的肩膀上，主要使用了以下开源项目

- Selenium: `https://github.com/SeleniumHQ/selenium`
- Uiautomator2: `https://github.com/openatx/uiautomator2`
- Facebook-WDA`https://github.com/openatx/facebook-wda`
- WebDriverAgent: `https://github.com/appium/WebDriverAgent`
- WebEditor: `https://github.com/alibaba/web-editor`
- Tidevice: `https://github.com/alibaba/taobao-iphone-device`