Contributing to Pageflow
See the GitHub wiki for details on how to contribute to Pageflow.
Running the Test Suite
Pageflow expects credentials of a MySQL user in the environment
PAGEFLOW_DB_PASSWORD. By default
"root" and the empty password are used. If your MySQL is on a
different host, you can specify a MySQL host in the environment
$PAGEFLOW_DB_HOST and a port in
Use the binstubs to invoke the Ruby test suite
PhantomJS has to be installed on the system.
The dummy Rails app used for tests is created automatically through the
install generator during test runs. To have it regenerated,
simply delete the contents of the
spec/dummy directory. This is
required everytime new migrations are added or if tests are failing
after pulling changes into the local working tree.
Pageflow can run its test suite against Rails 4.0 and 4.1
applications. The dummy app is created by a Rails template using the
pageflow:install generator. There are two ways to specify the Rails
version to develop and test against: Either set
$PAGEFLOW_RAILS_VERSION environment variable or create a
.rails_version file in the project root containing the Rails version
number. The environment variable takes precendence.
Remember to delete the ignored
Gemfile.lock and running
install after changing the Rails version through either of these