Campsite-Checker

Use the Nightwatch.js end-to-end testing framework to check if campsites or permits have become available.

##Setup Local Environment

Clone repo to your computer.
Within the directory Campsite-Checker, run npm install from the terminal.
Download latest Selenium server from http://selenium-release.storage.googleapis.com/index.html

Click on the latest version
Click on selenium-server-standalone-(version number).jar

Open the nightwatch.json file in the main directiory for editing.

Save.

Copy nightwatch.json.

##Run Automatic Checks Campsite Checker uses forever to run, well, forever, in the background of your computer.

Open your command line window to the root directory for Campsite-Checker/.
Run forever start server.js.

Inside server.js there is a simple loop which runs npm test every 10 minutes. It also appends the event to runlog.txt to confirm that the test ran.

To stop the tests, go back to the command line and root directory. Type forever stop server.js.

##Run Manual Checks Tests which are in-use will be flagged with the "run" tag. This allows other tests to remain archived for future use, without the need to run them unneccessarily or delete them.

To run tests, open a terminal window and navigate to theCampsite-Checker/ directory, then enter:

npm test

##Other Browsers

Chrome

The default browser is currently PhantomJS, but Chrome could be another option. Check to ensure that your tests are compatible with different browsers by running tests from the command line using the --env flag.

./nightwatch -a run --env chrome

This is already aliased in package.json because it's easier to see your development process when it pops open a browser, unlike the headless PhantomJS.

npm run test-chrome

Firefox

Firefox does not like dropdown selection menus. In tests/SteepRavine.js, you may notice commented-lines which indicate they are firefox only. These lines should generally be uncommented, with the lines below them being removed.

For some reason, you have to use keystrokes as a work-around. Here's a Stack Overflow topic explaining the issue and solution.

##Writing Tests See Nightwatch.js documentation: http://nightwatchjs.org/guide#usage

There are also examples in node_modules/nightwatch/examples/tests/google/.

##Manually Start the Selenium-Standalone Server The nightwatch.json file asks the selenium process to start automatically, but sometimes you may wish to start the server manually for debugging purposes.

Open a terminal window to the root director Campsite-Checker/.
Enter java -jar selenium-server-standalone-VERSION#.jar.

##Todos

Update README to include mandrill, etc.
Update README to include forever
Generalize code for other sites/locations/needs

adamjaffeback / campsite-checker Goto Github PK