scratch-www/test/integration/README.md

# Requirements

* Selenium
  * See this directory's package.json
* TAP
  * In the scratch-www repo's package.json
* Currently, we also require that you download [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/), but this will be replaced by Saucelabs imminently

# Running the tests

* By default, tests run against our Staging instance, but you can pass in a different location if you want to run the tests against e.g. your local build

## Using tap
* Run all tests in the smoke-testing directory from the command-line: `$ make smoke`
* To run a single file from the command-line: `$ node_modules/.bin/tap ./test/integration/smoke-testing/filename.js --timeout=3600`
  * The timeout var is for the length of the entire tap test-suite; if you are getting a timeout error, you may need to adjust this value (some of the Selenium tests take a while to run)

### Configuration

| Variable      		| Default               | Description                                 			    |
| ---------------------	| --------------------- | --------------------------------------------------------- |
| `SMOKE_USERNAME`    	| `None` 				| Username for Scratch user you're signing in with to test 	|
| `SMOKE_PASSWORD`  	| `None`                | Password for Scratch user you're signing in with to test  |

## Using sauce
* We're still working on setting this up; more info coming shortly
Issue/gh 1013 remove end to end testing package dependencies from repo (#1319) * remove selenium from package.json * Add package.json & README for the integration directory * add newline at end of file * add chromedriver dependency 2017-05-24 13:12:37 -04:00			`# Requirements`

			`* Selenium`
			`* See this directory's package.json`
			`* TAP`
			`* In the scratch-www repo's package.json`
			`* Currently, we also require that you download [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/), but this will be replaced by Saucelabs imminently`

			`# Running the tests`

			`* By default, tests run against our Staging instance, but you can pass in a different location if you want to run the tests against e.g. your local build`

			`## Using tap`
			* Run all tests in the smoke-testing directory from the command-line: `$ make smoke`
			* To run a single file from the command-line: `$ node_modules/.bin/tap ./test/integration/smoke-testing/filename.js --timeout=3600`
			`* The timeout var is for the length of the entire tap test-suite; if you are getting a timeout error, you may need to adjust this value (some of the Selenium tests take a while to run)`

Fix Gh-1385 - Issue/smoke test signing in (#1411) * add tests for signing in and my stuff * flesh out tests, reorganize a bit * add more tests * tests for my stuff & signing in * fix some of the errors causing build to fail * pass in credentials from commandline rather than uncommitted file * switch root back to staging * address pr review comments, rename username & password vars * update testing readme 2017-07-19 12:58:50 -04:00			`### Configuration`

			`\| Variable \| Default \| Description \|`
			`\| --------------------- \| --------------------- \| --------------------------------------------------------- \|`
			\| `SMOKE_USERNAME` \| `None` \| Username for Scratch user you're signing in with to test \|
			\| `SMOKE_PASSWORD` \| `None` \| Password for Scratch user you're signing in with to test \|

Issue/gh 1013 remove end to end testing package dependencies from repo (#1319) * remove selenium from package.json * Add package.json & README for the integration directory * add newline at end of file * add chromedriver dependency 2017-05-24 13:12:37 -04:00			`## Using sauce`
			`* We're still working on setting this up; more info coming shortly`