From 4a97c1d0fd791f2df9f680cf8b648742df2e6761 Mon Sep 17 00:00:00 2001 From: dandds Date: Mon, 1 Oct 2018 13:16:17 -0400 Subject: [PATCH] add readme info about selenium testing --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index bd646be0..264c44aa 100644 --- a/README.md +++ b/README.md @@ -131,6 +131,27 @@ To re-run tests each time a file is changed: pipenv run ptw +### Selenium Tests + +Selenium tests rely on BrowserStack. In order to run the Selenium tests +locally, you need BrowserStack credentials. The user email and key can +be found on the account settings page. To run the selenium tests: + +``` +BROWSERSTACK_TOKEN= BROWSERSTACK_EMAIL= ./script/selenium_test +``` + +The selenium tests are in `tests/acceptance`. This directory is ignored by +pytest for normal test runs. + +The `selenium_test` script manages the setup of a separate database and +launching the BrowserStackLocal client. If you already have the client running +locally, you can run the selenium tests with: + +``` +BROWSERSTACK_TOKEN= BROWSERSTACK_EMAIL= pipenv run pytest tests/acceptance +``` + ## Notes Jinja templates are like mustache templates -- add the