{"id":18400513,"url":"https://github.com/docksal/qa-suite","last_synced_at":"2025-04-07T06:33:32.320Z","repository":{"id":53479074,"uuid":"69319585","full_name":"docksal/qa-suite","owner":"docksal","description":"QA suite for running automated tests on websites, powered by Docksal","archived":false,"fork":false,"pushed_at":"2021-03-29T16:09:35.000Z","size":37,"stargazers_count":10,"open_issues_count":1,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-05-22T15:27:10.725Z","etag":null,"topics":["backstopjs","behat","docksal","phantomjs"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/docksal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-09-27T04:35:06.000Z","updated_at":"2021-10-03T16:53:52.000Z","dependencies_parsed_at":"2022-08-19T19:40:50.585Z","dependency_job_id":null,"html_url":"https://github.com/docksal/qa-suite","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fqa-suite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fqa-suite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fqa-suite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docksal%2Fqa-suite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docksal","download_url":"https://codeload.github.com/docksal/qa-suite/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247607762,"owners_count":20965945,"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":["backstopjs","behat","docksal","phantomjs"],"created_at":"2024-11-06T02:34:05.846Z","updated_at":"2025-04-07T06:33:32.304Z","avatar_url":"https://github.com/docksal.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# QA Suite \n\nQA suite for running automated tests on websites, powered by Docksal.  \n\nFeatures:\n\n- [Behat 3.x](https://github.com/Behat/Behat)\n- [BackstopJS 2.x](https://github.com/garris/BackstopJS)\n- [PhantomJS](http://phantomjs.org/), [SlimerJS](https://slimerjs.org/) (with Firefox ESR), [CasperJS](http://casperjs.org/)\n\n\n## Setup instructions\n\n### Step #1: Docksal environment setup\n\n**This is a one time setup - skip this if you already have a working Docksal environment.**  \n\nFollow [Docksal environment setup instructions](https://docs.docksal.io/getting-started/setup/)\n\n   \n### Step #2: Project setup\n\n1. Clone this repo into your Projects directory\n\n    ```\n    git clone git@github.com:docksal/qa-suite.git qa-suite\n    cd qa-suite\n    ```\n\n2. Initialize the stack\n\n    ```\n    fin init\n    ```\n    \n    Make sure to follow on-screen directions.\n\n## Usage\n\n### Behat\n\nRun all features under `tests/behat/features`\n\n```\nfin behat\n```\n\nRun a particular feature\n\n```\nfin behat features/blackbox.feature\n```\n\n\n### BackstopJS\n\n1. Take reference screenshots\n    \n    ```\n    fin backstop reference --config=backstop-example.json\n    ```\n\n2. Take test screenshots and compare\n\n    ```\n    fin backstop test --config=backstop-example.json\n    ```\n\nBy default, BackstopJS is using PhantomJS to take screenshots.  \nYou can also use SlimerJS/Firefox by setting `\"engine\": \"slimerjs\"` \nin the [configuration file](tests/backstop/backstop-example.json).\n\n## Pre-configured sample commands \n\nPre-configured commands are in `.docksal/commands`.   \nThey can be used as shortcuts/alternative to typing long lists of arguments every time.\n\nRun sample BDD (behavior-driven development) tests with Behat\n\n```\nfin behat-example\n```\n\nOpen http://qa-suite.docksal/tests/behat/reports/html/\n\nRun sample VRT (visual regression testing) tests with BackstopJS\n\n```\nfin backstop-example\n```\n\nOpen http://qa-suite.docksal/tests/backstop/data/example/reports/html/\n\n\n## Debugging\n\nFor tests that utilize Chrome/Firefox via Selenium (`@javascript` tests), you can watch the browser in real time \ninside the container with [VNC Viewer](https://www.realvnc.com/en/connect/download/viewer/).  \n\nConnect to `192.168.64.100:5900`, password: `secret`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fqa-suite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocksal%2Fqa-suite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocksal%2Fqa-suite/lists"}