HACKING.txt

# How to develop and run this code.

## Ubuntu

We need node and npm for this. So lets setup a virtualenv like atmosphere.

First make sure you have the basics installed (which you prolly do if you have done any developing at all.):

    $ sudo apt-get update
    $ sudo apt-get install build-essential libssl-dev

Next we'll install the venv equivalent:

    $ curl https://raw.githubusercontent.com/creationix/nvm/v0.7.0/install.sh | sh

See https://github.com/creationix/nvm for more about nvm

Then setup node and npm:

    $ nvm install 0.11.13
    $ nvm alias default 0.11.13
    $ nvm use default

In the top level directory:

    ## For global access to grunt commands
    $ npm install -g grunt grunt-cli
    ## Installs our depedencies for isat
    $ npm install

This will install the dependencies.

Run jasmine like so:

	$ grunt dev

And open the test runner like so:

	open http://localhost:9999/jasmine/SpecRunner.html


Then you can run the tests against saucelabs with your key and secret like so:

	$ export SAUCE_USERNAME=YOUR-SAUCE-USERNAME
	$ export SAUCE_ACCESS_KEY=YOUR-SAUCE-API-KEY
  ## Start local server, open sauce tunnel, and run remote browsers against it
  $ grunt test

That's it.

## Travis CI setup notes

This is not specifically hacking but to support hacking:)

Again these instructions are for Ubuntu:

    $ curl -sSL https://get.rvm.io | bash -s stable --ruby
    $ echo "alias rvmify="source /home/robrien/.rvm/scripts/rvm" >> ~/.profile
    $ source ~/.profile
    $ rvmify
    $ gem install travis

Once travis installs do this in the top level of the repo

    $ . ~/AeroFS/.saucelabs/koansys-oss
    $ travis encrypt SAUCE_USERNAME=$SAUCE_USERNAME --add env.global \
        -r koansys/isat
    $ travis encrypt SAUCE_ACCESS_KEY=$SAUCE_ACCESS_KEY --add env.global \
        -r koansys/isat

Then log into travis-ci.org and enable the repo under accounts.

The following didn't work.

    # $ sudo apt-get install python-software-properties
    # $ sudo apt-add-repository ppa:brightbox/ruby-ng
    # $ sudo apt-get update
    # $ sudo apt-get install ruby2.1 ruby-switch
    # $ sudo ruby-switch --set ruby2.1

#Bump to make travis run...