0.02
No commit activity in last 3 years
No release in over 3 years
System Tester aims to symplify QA for Rails applications by providing a development tool for creating and managing system tests
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 0.9.0
~> 5.1.0
 Project Readme

Build Status Code Climate Test Coverage

System Tester

A development tool for creating and managing system tests in Ruby on Rails >= 5.1 applications

Usage

This gem is used only in development and is a mountable rails engine that creates JSON endpoints for a chrome extension.

Installation

Add this line to your application's Gemfile:

gem 'system_tester', group: :development

Add the system_tester db to config/database.yml

# you may want to consider a shared MySQL/Postgres database
# if you have a team that needs shared access
system_tester:
  <<: *default
  database: db/system_tester.sqlite3

And then install and run the migrations:

$ bundle install
$ rails system_tester:migrate

Mount the engine in config/routes.rb:

Rails.application.routes.draw do
  # ... other routes
  
  # Mount in development environment only
  if Rails.env.development?
    mount SystemTester::Engine => "/system_tester"
  end
end

Start your dev server and you are good to go.

Chrome extension

System Tester Demo

The chrome extension provides a Devtools tab and acts as a client to this gem.

ADD TO CHROME

Design

System Tester is designed to work with a chrome extension, but could potentially be used for other applications as well. Run rails routes to see what endpoints are provided. The following design was set in place for the easy of reusing testing steps:

  • Features - the top level: one test script for a feature
  • Scenarios - 1:M assocation from Feature to Scenario. A Scenario is one test method.
  • Steps - Basically a line of code that can be an action or an assertion. STI is used to provide different step types.
  • ScenarioSteps - M:M assocation for Steps and Scenarios which also as a position attribute to allow for reordering.
  • Stairs - an ordered group of steps that can be reused.
  • StairSteps - M:M association to support stairs, Stair inherits from Step so the fk points back to the same table.

License

The gem is available as open source under the terms of the MIT License.