FAutoTest 项目使用教程

FAutoTest 项目使用教程

FAutoTest A UI automated testing framework for H5 and applets 项目地址: https://gitcode.com/gh_mirrors/fa/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/

通过以上配置文件，可以确保项目的正确安装和打包，同时避免不必要的文件被版本控制。

FAutoTest A UI automated testing framework for H5 and applets 项目地址: https://gitcode.com/gh_mirrors/fa/FAutoTest