FAutoTest 项目使用教程
1. 项目目录结构及介绍
FAutoTest 项目的目录结构如下:
FAutoTest/
├── dist/
├── docs/
├── fastAutoTest/
├── sample/
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE.txt
├── MANIFEST.in
├── README.md
└── setup.py
目录介绍
- dist/: 存放项目的打包文件,如
.whl
文件。 - docs/: 存放项目的文档文件。
- fastAutoTest/: 项目的核心代码目录,包含了自动化测试框架的主要实现。
- sample/: 存放示例代码,展示了如何使用 FAutoTest 进行自动化测试。
- .gitignore: Git 忽略文件,指定了哪些文件或目录不需要被版本控制。
- CONTRIBUTING.md: 贡献指南,指导开发者如何为项目贡献代码。
- LICENSE.txt: 项目的开源许可证文件。
- MANIFEST.in: 用于指定在打包时需要包含的文件。
- README.md: 项目的介绍文件,包含了项目的基本信息和使用说明。
- setup.py: 项目的安装脚本,用于安装项目所需的依赖。
2. 项目启动文件介绍
FAutoTest 项目的启动文件主要位于 fastAutoTest/
目录下。以下是一些关键的启动文件:
- fastAutoTest/core/h5/h5Engine.py: 用于启动 H5 页面的自动化测试。
- fastAutoTest/core/qq/qqEngine.py: 用于启动 QQ 内 H5 页面的自动化测试。
- fastAutoTest/core/wx/wxEngine.py: 用于启动微信小程序的自动化测试。
启动示例
以微信 H5 页面为例,启动文件的使用方式如下:
# coding=utf-8
from fastAutoTest.core.h5.h5Engine import H5Driver
if __name__ == '__main__':
h5Driver = H5Driver()
h5Driver.initDriver()
h5Driver.clickElementByXpath('/html/body/div[1]/div/div[3]/p')
h5Driver.clickFirstElementByText('白内障')
h5Driver.returnLastPage()
h5Driver.returnLastPage()
print(h5Driver.getElementTextByXpath('/html/body/div[1]/div/div[3]/p'))
h5Driver.close()
3. 项目配置文件介绍
FAutoTest 项目的配置文件主要包括以下几个部分:
- setup.py: 用于配置项目的安装信息,包括依赖库、版本号等。
- MANIFEST.in: 用于指定在打包时需要包含的文件。
- .gitignore: 用于指定哪些文件或目录不需要被版本控制。
setup.py 配置示例
from setuptools import setup, find_packages
setup(
name='fastAutoTest',
version='0.1.0',
packages=find_packages(),
install_requires=[
'uiautomator==0.3.2',
'lxml==4.2.3',
'bidict==0.17.0',
'websocket-client==0.44.0'
],
include_package_data=True,
package_data={
'fastAutoTest': ['*.txt', '*.md']
},
entry_points={
'console_scripts': [
'fastAutoTest=fastAutoTest.core.h5.h5Engine:main'
]
}
)
MANIFEST.in 配置示例
include LICENSE.txt
include README.md
include CONTRIBUTING.md
include fastAutoTest/*.py
include fastAutoTest/core/*.py
include fastAutoTest/core/h5/*.py
include fastAutoTest/core/qq/*.py
include fastAutoTest/core/wx/*.py
.gitignore 配置示例
# Python
*.pyc
*.pyo
*.pyd
__pycache__/
# IDE
.idea/
.vscode/
# Build
dist/
build/
*.egg-info/
通过以上配置文件,可以确保项目的正确安装和打包,同时避免不必要的文件被版本控制。