Quilla

使用JSON进行声明式UI测试

Quilla是一个框架，允许测试编写者通过JSON文件使用声明性语法进行UI测试。这使测试编写者、所有者和维护者能够专注于用户必须执行的操作步骤，而不是如何使用代码库。反过来，这允许进行更敏捷的测试编写和更容易理解的测试用例。

Quilla旨在在CI/CD、容器和本地运行。它还提供与pytest的可选集成，因此您可以将Quilla测试用例作为您常规测试环境的一部分来编写python项目。有关如何配置pytest以自动发现Quilla文件、添加标记等信息，请参阅quilla-pytest文档。

查看功能文档，了解Quilla能做什么的概述！

快速入门

1. 运行 pip install quilla

2. 确保您拥有正确的浏览器和驱动程序。Quilla 会自动检测您的 PATH 目录或 Quilla 被调用所在的目录中的驱动程序。

3. 将以下内容写入 Validation.json 文件中，将“Edge”替换为您已安装并具有驱动程序的浏览器。

   {
     "targetBrowsers": ["Edge"],
     "path": "https://www.bing.com",
     "steps": [
       {
         "action": "Validate",
         "type": "URL",
         "state": "Contains",
         "target": "bing"
       }
     ]
   }
   

4. 运行 quilla -f Validation.json

安装

注意：在安装新的 Python 包时，强烈建议您使用虚拟环境。您可以通过克隆存储库并运行 make install 来安装 Quilla。

Quilla 可在 PyPI 上找到，并且可以通过运行 pip install quilla 来安装。

有关安装选项（例如从源安装）和为远程安装打包 Quilla 的更多信息，请参阅其文档

编写验证文件

请参阅其文档

上下文表达式

此包能够动态注入不同值，通过上下文对象和表达式在验证 JSON 常规字符串（而不是枚举）需要时暴露。这可以用来获取在命令行或通过环境变量指定的值。

有关上下文表达式及其使用方法的更多讨论，请参阅文档

生成文档

可以通过 make 命令 make docs 来生成文档。

请参阅其文档

Make 命令

提供了一些便利命令的 Makefile。您可以使用 make help 来查找用法说明，或者在下文中查看。

Usage:
  make [target]

Targets:
  help                            Print this help message and exit
  package                         Create release packages
  package-deps                    Create wheel files for all runtime dependencies
  docs                            Build all the docs in the docs/_build directory
  clean-python                    Cleans all the python cache & egg files files
  clean-docs                      Clean the docs build directory
  clean-build                     Cleans all code build and distribution directories
  clean                           Cleans all build, docs, and cache files
  install                         Installs the package
  install-docs                    Install the package and docs dependencies
  install-tests                   Install the package and test dependencies
  install-all                     Install the package, docs, and test dependencies

贡献

此项目欢迎贡献和建议。大多数贡献都需要您同意贡献者许可协议（CLA），声明您有权利并且确实授予我们使用您贡献的权利。有关详细信息，请访问此处。

在您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA，并适当修饰 PR（例如，状态检查，评论）。只需遵循机器人提供的说明即可。您只需要在整个使用我们 CLA 的所有存储库中这样做一次。

此项目已采用Microsoft 开源行为准则。有关更多信息，请参阅行为准则常见问题解答或联系opencode@microsoft.com以获取任何额外的疑问或评论。

商标

此项目可能包含项目、产品或服务的商标或徽标。Microsoft 商标或徽标的授权使用必须遵守并遵循Microsoft 的商标和品牌指南。在修改此项目的版本中使用 Microsoft 商标或徽标不得引起混淆或暗示 Microsoft 赞助。任何使用第三方商标或徽标的行为均受这些第三方政策的约束。