Project

grade_runner

0.0
Low commit activity in last 3 years
A long-lived project that still receives updates
grade_runnerfirstdraft/grade_runnerHomepageDocumentationSource CodeBug TrackerWiki
This gem runs your RSpec test suite and posts the JSON output to grades.firstdraft.com.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Popularity
Downloads
99,506
Stars
1
Forks
1
Watchers
0
 Releases
Current version
0.0.13
Total releases
51
First release
2019-05-01
Latest release
2025-03-18
 Issues
Open Issues
6
Closed Issues
26
Total Issues
32
Issue Closure Rate
81%
 Pull Requests
Open Pull Requests
5
Closed Pull Requests
22
Merged Pull Requests
33
Pull Request Acceptance Rate
55%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2020-09-19
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 2.1.4
juwelier
~> 2.1.0
pry
~> 0
pry-byebug
~> 3
pry-doc
~> 0
pry-remote
~> 0
pry-rescue
~> 1
pry-stack_explorer
~> 0
rdoc
~> 6.1
rspec
~> 3.5.0
simplecov
>= 0

Runtime

zip
>= 0
activesupport
>= 2.3.5
faraday-retry
~> 1.0.3
octokit
~> 5.0
oj
~> 3.13.12
rake
~> 13
 Project Readme

grade_runner

A Ruby client for firstdraft Grades

Installation

Add this line to your application's Gemfile:

gem "grade_runner"

And then execute:

$ bundle

Usage

Rails

After installed, run rails grade to run specs.

Optional Configuration

As of version 0.0.13, you can override the default points used on each test and the overwriting behavior of the spec folder by:

Moving the gem into the :development, :test group in your Gemfile:

# Gemfile

# ...
group :development, :test do
  gem "grade_runner", "~> 0.0.13"
  # ...
end
# ...

Adding this configurable initializer:

# config/initializers/grade_runner.rb

if Rails.env.development? || Rails.env.test?
  GradeRunner.config do |config|
    config.default_points = 1           # default 1
    config.override_local_specs = false # default true
  end
end

Adding this line to the Rakefile:

# Rakefile

require_relative "config/initializers/grade_runner"

And making this change to the spec_helper.rb:

# spec/spec_helper.rb

# ...

# GradeRunner updates on https://github.com/firstdraft/grade_runner/pull/88
# make the formatters available from within the grade_runner gem
require "grade_runner/formatters/json_output_formatter"
require "grade_runner/formatters/hint_formatter"
# require "#{File.expand_path("../support/json_output_formatter", __FILE__)}"
# require "#{File.expand_path("../support/hint_formatter", __FILE__)}"

# ...

Note that for that last step, the gem formatters can be overridden by requiring the formatters present in the local project like before.

Ruby

In order to load and run the Rake task, you need to load it.

This is usually done by making a runnable file1, typically called bin/rails, with contents that look like this:

#!/usr/bin/env ruby
require "rubygems"
require "bundler/setup"
require "rake"

dir = Gem::Specification.find_by_name("grade_runner").gem_dir

load "#{dir}/lib/tasks/grade.rake"
task_name = ARGV[0]

Rake::Task[task_name].invoke

Then you can run bin/rails grade like before. You can even add this file to the PATH so you can run rails grade like with Rails apps.

echo 'export PATH="$PATH:/path/to/project/bin/rails"' >> ~/.bashrc
source ~/.bashrc

Copyright

Copyright (c) 2018 Raghu Betina. See LICENSE.txt for further details.

Footnotes

  1. If you get file permissions errors when running bin/rails grade try updating the permissions with chmod 755 bin/rails first. ↩