{"id":13501407,"url":"https://github.com/microsoft/quilla","last_synced_at":"2025-10-19T14:30:30.355Z","repository":{"id":48347009,"uuid":"381137063","full_name":"microsoft/quilla","owner":"microsoft","description":"Declarative UI Testing with JSON","archived":false,"fork":false,"pushed_at":"2024-01-13T05:53:34.000Z","size":6383,"stargazers_count":58,"open_issues_count":11,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-30T11:33:51.634Z","etag":null,"topics":["frontent","selenium","selenium-python","test","ui"],"latest_commit_sha":null,"homepage":"https://microsoft.github.io/quilla","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-28T19:12:31.000Z","updated_at":"2024-10-14T19:57:02.000Z","dependencies_parsed_at":"2024-01-16T10:36:18.350Z","dependency_job_id":"24c4791c-e55c-45c5-8108-56529b7b6437","html_url":"https://github.com/microsoft/quilla","commit_stats":{"total_commits":40,"total_committers":6,"mean_commits":6.666666666666667,"dds":"0.30000000000000004","last_synced_commit":"79eb50aeff3a01a20488b2de17db1e8465d67014"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fquilla","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fquilla/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fquilla/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fquilla/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/quilla/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237143499,"owners_count":19262216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["frontent","selenium","selenium-python","test","ui"],"created_at":"2024-07-31T22:01:36.324Z","updated_at":"2025-10-19T14:30:29.959Z","avatar_url":"https://github.com/microsoft.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Quilla\n\n[![CodeQL Code Analysis](https://img.shields.io/github/workflow/status/microsoft/quilla/CodeQL?label=CodeQL\u0026logo=Github)](https://github.com/microsoft/quilla/actions/workflows/codeql-analysis.yml)\n[![Test pipeline](https://img.shields.io/github/workflow/status/microsoft/quilla/Test%20pipeline?label=Tests\u0026logo=Github)](https://github.com/microsoft/quilla/actions/workflows/test-pipeline.yml)\n[![Release pipeline](https://img.shields.io/github/workflow/status/microsoft/quilla/Release%20pipeline?label=Release\u0026logo=Github)](https://github.com/microsoft/quilla/actions/workflows/release-pipeline.yml)\n[![Documentation publish](https://img.shields.io/github/deployments/microsoft/quilla/github-pages?label=Documentation\u0026logo=Github)](https://microsoft.github.io/quilla)\n\n[![License](https://img.shields.io/pypi/l/quilla?logo=github\u0026logoColor=white\u0026label=License)](https://github.com/microsoft/quilla/blob/main/LICENSE)\n[![Package Version](https://img.shields.io/pypi/v/quilla?logo=pypi\u0026logoColor=white\u0026label=PyPI)](https://pypi.org/project/quilla/)\n[![Supported Python Versions](https://img.shields.io/pypi/pyversions/quilla?logo=pypi\u0026logoColor=white\u0026label=Python)](https://github.com/microsoft/quilla)\n[![Pypi Downloads](https://img.shields.io/pypi/dm/quilla?logo=pypi\u0026logoColor=white\u0026label=Downloads)](https://pypi.org/project/quilla/)\n\n\u003c!-- THIS SECTION SHOULD BE COPY+PASTED INTO THE docs/intro.md FILE --\u003e\n## Declarative UI Testing with JSON\n\nQuilla is a framework that allows test-writers to perform UI testing using declarative syntax through JSON files. This enables test writers, owners, and maintainers to focus not on how to use code libraries, but on what steps a user would have to take to perform the actions being tested. In turn, this allows for more agile test writing and easier-to-understand test cases.\n\nQuilla was built to be run in CI/CD, in containers, and locally. It also comes with an optional integration with [pytest](https://pytest.org), so you can write your Quilla test cases as part of your regular testing environment for python-based projects. Check out the [quilla-pytest](docs/quilla_pytest.md) docs for more information on how to configure `pytest` to auto-discover Quilla files, adding markers, and more.\n\nCheck out the [features](docs/features.md) docs for an overview of all quilla can do!\n\n## Quickstart\n\n1. Run `pip install quilla`\n1. Ensure that you have the correct browser and drivers. Quilla will autodetect drivers that are in your PATH or in the directory it is called\n1. Write the following as `Validation.json`, substituting \"Edge\" for whatever browser you have installed and have the driver for:\n\n    ```json\n    {\n      \"targetBrowsers\": [\"Edge\"],\n      \"path\": \"https://www.bing.com\",\n      \"steps\": [\n        {\n          \"action\": \"Validate\",\n          \"type\": \"URL\",\n          \"state\": \"Contains\",\n          \"target\": \"bing\"\n        }\n      ]\n    }\n    ```\n\n1. Run `quilla -f Validation.json`\n\n## Installation\n\n\u003e Note: It is **highly recommended** that you use a virtual environment whenever you install new python packages.\nYou can install Quilla by cloning the repository and running `make install`.\n\nQuilla is available on [PyPI](https://pypi.org/project/quilla/), and can be installed by running `pip install quilla`.\n\nFor more information on installation options (such as installing from source) and packaging Quilla for remote install, check out the documentation for it [here](docs/install.md)\n\n## Writing Validation Files\n\nCheck out the documentation for it [here](docs/validation_files.md)\n\n## Context Expressions\n\nThis package is able to dynamically inject different values, exposed through context objects and expressions whenever the validation JSON would ordinarily require a regular string (instead of an enum). This can be used to grab values specified either at the command-line, or through environment variables.\n\nMore discussion of context expressions and how to use them can be found in the documentation file [here](docs/context_expressions.md)\n\n## Generating Documentation\n\nDocumentation can be generated through the `make` command `make docs`\n\nCheck out the documentation for it [here](docs/README.md)\n\n## Make commands\n\nA Makefile is provided with several convenience commands. You can find usage instructions with `make help`, or below:\n\n```text\nUsage:\n  make [target]\n\nTargets:\n  help                            Print this help message and exit\n  package                         Create release packages\n  package-deps                    Create wheel files for all runtime dependencies\n  docs                            Build all the docs in the docs/_build directory\n  clean-python                    Cleans all the python cache \u0026 egg files files\n  clean-docs                      Clean the docs build directory\n  clean-build                     Cleans all code build and distribution directories\n  clean                           Cleans all build, docs, and cache files\n  install                         Installs the package\n  install-docs                    Install the package and docs dependencies\n  install-tests                   Install the package and test dependencies\n  install-all                     Install the package, docs, and test dependencies\n```\n\n## Contributing\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark \u0026 Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fquilla","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fquilla","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fquilla/lists"}