trackler 2.1.0.7 → 2.1.0.8

data/tracks/ruby/README.md

@@ -14,9 +14,19 @@ the language, so you're all set.
 
 The files for an exercise live in `exercises/<exercise_name>` (where
 `<exercise_name>` is the slug for the exercise, e.g. `clock` or
-`atbash-cipher`). An exercise has a test suite
-(`exercises/<exercise_name>/<exercise_name>_test.rb`) and an example solution
-(`exercises/<exercise_name>/example.rb`).
+`atbash-cipher`). All exercises have:
+
+* a test suite, `<exercise_name>_test.rb`
+* an example solution, `example.rb`
+
+Tests with a test generator will also have:
+
+* a `.version`
+* the test generator, `<exercise_name>_cases.rb`, in `.meta/generator`
+
+A few tests have other custom files which are discussed below.
+
+### Canonical Data
 
 **Most exercises can be generated from shared inputs/outputs, called canonical
 data (see [Generated Test Suites](#generated-test-suites) below).** To find out
@@ -25,9 +35,9 @@ the [x-common repo](https://github.com/exercism/x-common/tree/master/exercises).
 
 ## Running the Tests
 
-Run the tests using `rake`, rather than `ruby path/to/the_test.rb`. `rake`
-knows to look for `example.rb` and to disable skips. Just tell `rake` the
-name of your problem and you are set:
+Run the tests using `rake`, rather than `ruby path/to/the_test.rb`. `rake` knows
+to look for the example solution and to disable skips. Just tell `rake` the name
+of your problem and you are set:
 
 ```sh
 rake test:clock
@@ -121,12 +131,14 @@ the minitest `test_<whatever>` methods. An exercise's generator lives in
 `exercises/<exercise_name>/.meta/generator/<exercise_name>_cases.rb`.
 
 The test case generator is a derived class of `ExerciseCase` (in
-`lib/generator/exercise_cases.rb`). `ExerciseCase` does most of the work of
+`lib/generator/exercise_case.rb`). `ExerciseCase` does most of the work of
 extracting the canonical data. The derived class wraps the JSON for a single
 test case. The default version looks something like this:
 
 ```
-class <ExerciseName>Case < ExerciseCase
+require 'generator/exercise_case'
+
+class <ExerciseName>Case < Generator::ExerciseCase
 
   def workload
     # Example workload:
@@ -209,7 +221,7 @@ We have created a minimal set of guidelines for the testing files, which
 you can take advantage of by installing the `rubocop` gem.  It will use
 the configuration file located in the root folder, `.rubocop.yml`.  When
 you edit your code, you can simply run `rubocop -D`.  It will ignore
-your `example.rb`, but will gently suggest style for your test code.
+your example solution, but will gently suggest style for your test code.
 
 The `-D` option that is suggested is provided to give you the ability to
 easily ignore the Cops that you think should be ignored.  This is easily
@@ -218,7 +230,7 @@ appropriately.
 
 For more complete information, see [Rubocop](http://batsov.com/rubocop/).
 
-While `lib/generator/exercise_cases.rb` provides helper functions as discussed
+While `lib/generator/exercise_case.rb` provides helper functions as discussed
 above, it remains the responsibility of an exercise's generator to interpret its
 canonical-data.json data in a stylistically correct manner, e.g. converting
 string indices to integer indices.

data/tracks/ruby/exercises/accumulate/accumulate_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'accumulate'
 

data/tracks/ruby/exercises/acronym/.meta/generator/acronym_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class AcronymCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/acronym/acronym_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'acronym'
 
-# Common test data version: dcfe476
+# Common test data version: 1.0.0 dcfe476
 class AcronymTest < Minitest::Test
   def test_basic
     # skip

data/tracks/ruby/exercises/all-your-base/.meta/generator/all_your_base_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class AllYourBaseCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/all-your-base/all_your_base_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'all_your_base'
 
-# Common test data version: 39de23b
+# Common test data version: 1.0.0 39de23b
 class AllYourBaseTest < Minitest::Test
   def test_single_bit_one_to_decimal
     # skip

data/tracks/ruby/exercises/allergies/allergies_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'allergies'
 

data/tracks/ruby/exercises/alphametics/.meta/generator/alphametics_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class AlphameticsCase < Generator::ExerciseCase
   def workload

data/tracks/ruby/exercises/alphametics/.meta/generator/test_template.erb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'alphametics'
 
-# Common test data version: <%= abbreviated_commit_hash %>
+# Common test data version: <%= canonical_data_version %> <%= abbreviated_commit_hash %>
 class AlphameticsTest < Minitest::Test
 <% test_cases.each do |test_case| %>
 

data/tracks/ruby/exercises/alphametics/alphametics_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'alphametics'
 
-# Common test data version: b9bada8
+# Common test data version: 1.0.0 b9bada8
 class AlphameticsTest < Minitest::Test
 
   def test_puzzle_with_three_letters

data/tracks/ruby/exercises/anagram/.meta/generator/anagram_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class AnagramCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/anagram/anagram_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'anagram'
 
-# Common test data version: 196fc1a
+# Common test data version: 1.0.1 196fc1a
 class AnagramTest < Minitest::Test
   def test_no_matches
     # skip

data/tracks/ruby/exercises/atbash-cipher/atbash_cipher_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'atbash_cipher'
 

data/tracks/ruby/exercises/beer-song/.meta/generator/beer_song_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class BeerSongCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/beer-song/beer_song_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'beer_song'
 
-# Common test data version: 9f3d48a
+# Common test data version: 1.0.0 9f3d48a
 class BeerSongTest < Minitest::Test
   def test_first_generic_verse
     # skip

data/tracks/ruby/exercises/binary-search-tree/binary_search_tree_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'binary_search_tree'
 

data/tracks/ruby/exercises/binary-search/binary_search_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'binary_search'
 

data/tracks/ruby/exercises/binary/.meta/generator/binary_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class BinaryCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/binary/binary_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'binary'
 
-# Common test data version: 969717d
+# Common test data version: 1.0.0 969717d
 class BinaryTest < Minitest::Test
   def test_binary_0_is_decimal_0
     # skip

data/tracks/ruby/exercises/bob/bob_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'bob'
 

data/tracks/ruby/exercises/bowling/.meta/generator/bowling_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class BowlingCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/bowling/.meta/generator/test_template.erb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'bowling'
 
-# Common test data version: <%= abbreviated_commit_hash %>
+# Common test data version: <%= canonical_data_version %> <%= abbreviated_commit_hash %>
 class BowlingTest < Minitest::Test
   def setup
     @game = Game.new

data/tracks/ruby/exercises/bowling/bowling_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'bowling'
 
-# Common test data version: 3cf5eb9
+# Common test data version: 1.0.0 3cf5eb9
 class BowlingTest < Minitest::Test
   def setup
     @game = Game.new

data/tracks/ruby/exercises/bracket-push/.meta/generator/bracket_push_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class BracketPushCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/bracket-push/bracket_push_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'bracket_push'
 
-# Common test data version: 855c591
+# Common test data version: 1.1.0 855c591
 class BracketPushTest < Minitest::Test
   def test_paired_square_brackets
     # skip

data/tracks/ruby/exercises/circular-buffer/circular_buffer_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'circular_buffer'
 

data/tracks/ruby/exercises/clock/.meta/generator/clock_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class ClockCase < Generator::ExerciseCase
   def name

data/tracks/ruby/exercises/clock/clock_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'clock'
 
-# Common test data version: 8c7fc0c
+# Common test data version: 1.0.1 54c3b74
 class ClockTest < Minitest::Test
   def test_on_the_hour
     # skip

data/tracks/ruby/exercises/connect/.meta/generator/connect_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class ConnectCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/connect/.meta/generator/test_template.erb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'connect'
 
-# Common test data version: <%= abbreviated_commit_hash %>
+# Common test data version: <%= canonical_data_version %> <%= abbreviated_commit_hash %>
 class ConnectTest < Minitest::Test
 <% test_cases.each do |test_case| %>
   <%= test_case.ignore_method_length%>def <%= test_case.name %>

data/tracks/ruby/exercises/connect/connect_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'connect'
 
-# Common test data version: 327db7f
+# Common test data version: 1.0.0 327db7f
 class ConnectTest < Minitest::Test
   def test_an_empty_board_has_no_winner
     # skip

data/tracks/ruby/exercises/crypto-square/crypto_square_test.rb

@@ -1,5 +1,4 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'crypto_square'
 

data/tracks/ruby/exercises/custom-set/.meta/generator/custom_set_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class CustomSetCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/custom-set/custom_set_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'custom_set'
 
-# Common test data version: 4527635
+# Common test data version: 1.0.1 4527635
 class CustomSetTest < Minitest::Test
   def test_sets_with_no_elements_are_empty
     # skip

data/tracks/ruby/exercises/diamond/diamond_test.rb

@@ -1,5 +1,4 @@
 # !/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'diamond'
 

data/tracks/ruby/exercises/difference-of-squares/.meta/generator/difference_of_squares_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class DifferenceOfSquaresCase < Generator::ExerciseCase
 

data/tracks/ruby/exercises/difference-of-squares/difference_of_squares_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'difference_of_squares'
 
-# Common test data version: 1eb9535
+# Common test data version: 1.0.0 1eb9535
 class DifferenceOfSquaresTest < Minitest::Test
   def test_square_of_sum_5
     # skip

data/tracks/ruby/exercises/dominoes/.meta/generator/dominoes_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class DominoesCase < Generator::ExerciseCase
   def name

data/tracks/ruby/exercises/dominoes/.meta/generator/test_template.erb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'dominoes'
 
-# Common test data version: <%= abbreviated_commit_hash %>
+# Common test data version: <%= canonical_data_version %> <%= abbreviated_commit_hash %>
 class DominoesTest < Minitest::Test
 <% test_cases.each do |test_case| %>
   def <%= test_case.name %>

data/tracks/ruby/exercises/dominoes/dominoes_test.rb

@@ -1,9 +1,8 @@
 #!/usr/bin/env ruby
-gem 'minitest', '>= 5.0.0'
 require 'minitest/autorun'
 require_relative 'dominoes'
 
-# Common test data version: 89a5281
+# Common test data version: 1.0.0 89a5281
 class DominoesTest < Minitest::Test
   def test_empty_input_empty_output
     # skip

data/tracks/ruby/exercises/etl/.meta/generator/etl_cases.rb

@@ -1,4 +1,4 @@
-require 'generator/exercise_cases'
+require 'generator/exercise_case'
 
 class EtlCase < Generator::ExerciseCase
   def workload