Running Fae Locally

Dependencies

Before you fire this up locally, you’ll need some dependencies installed.

Dummy App

There is a dummy app included in the Engine source. To get it running, follow these steps.

After cloning the repo, cd into Fae and install gems into a gemset on Ruby 2.3.1:

cd path/to/fae
bundle install

Cd to the dummy app:

cd spec/dummy

Create the DB and migrate:

rake db:create
rake db:migrate && rake db:migrate RAILS_ENV=test

Seed the DB:

rake fae:seed_db

Fire up the server:

rails server

Testing

The dummy app should stay up-to-date with the latest Rails version we support. Running tests against it will run all specs against that version.

Use guard to have specs autorunning as you change files

guard

Appraisal

Appraisal is an amazing gem that allows us to run the specs against multiple versions of Rails. You can find all support versions in the Appraisals file.

To run all appraisals, first install all of the gems of the different appraisal versions with:

appraisal

To run tests in all appraisal versions:

appraisal rspec

Or you can run a specific version using the name defined in Appraisals:

appraisal rails_4_2 rspec