jpalardy-forgetful 0.0.5 → 0.0.6

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2008 Jonathan Palardy
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/README.rdoc

@@ -0,0 +1,74 @@
+= Forgetful
+
+A minimal command-line app implementing the SuperMemo 2 algorithm.
+
+The SuperMemo algorithm is designed to refresh your memory at
+intervals based on how well you remembered something.
+
+Put question-answer pairs in a file. Everyday, feed the file to forgetful and
+it will quiz you on what you need to remember today. Based on your
+self-evaluation, forgetful will reschedule at an appropriate time in the
+future.
+
+
+== Install
+
+  gem install forgetful
+
+
+== Usage
+
+  forgetful filename.csv [more filenames]
+
+The CSV files are formatted very simply:
+
+  question,answer
+
+The interaction goes as follow:
+
+  forgetful: shows question
+  you:       press enter
+  forgetful: shows answer
+  forgetful: asks for self-evaluation
+  you:       type a number, press enter
+
+You will be asked all of today's questions. After you will be asked, again, the
+questions for which you scored less than 4.
+
+Self-evaluation values:
+
+  5 - perfect response
+  4 - correct response after a hesitation
+  3 - correct response recalled with serious difficulty
+  2 - incorrect response; where the correct one seemed easy to recall
+  1 - incorrect response; the correct one remembered
+  0 - complete blackout.
+
+WARNING: Statistics are written back to the input file. This is a feature. Put
+your CSV files under source control to keep a history.
+
+Enjoy!
+
+
+== License
+
+Copyright (c) 2008 Jonathan Palardy
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/bin/forgetful

@@ -25,9 +25,11 @@ end
 #-------------------------------------------------
 
 def ask_about(reminder, i, n)
-  ask("#{i}/#{n}. Q: #{reminder.question}")
-  puts "     A: #{reminder.answer}"
-  q = ask_grade("     ? ")
+  width = "#{n}/#{n}. ".size
+  padding = " " * width
+  ask "#{i}/#{n}. ".rjust(width) + "Q: #{reminder.question}"
+  puts                   padding + "A: #{reminder.answer}"
+  q = ask_grade          padding + "? "
   puts
   return q
 end
@@ -46,14 +48,14 @@ end
 
 def process_file(filename)
   #--------------------- quiz ----------------------
-  reminders = Reminder.load_csv(filename)
+  reminders = Reminder.read_csv(filename)
 
   dues, not_dues = reminders.partition {|reminder| reminder.execute_on <= Date.today}
 
   puts "### QUIZ: #{filename}"
   gradeds = quiz(dues.sort_by { rand })
 
-  Reminder.save_csv(filename, (gradeds + not_dues).sort)
+  Reminder.write_csv(filename, (gradeds + not_dues).sort)
 
   #-------------------- review ---------------------
   faileds = gradeds.select {|reminder| reminder.review? }

data/forgetful.gemspec

@@ -1,23 +1,23 @@
 Gem::Specification.new do |s|
   s.name = %q{forgetful}
-  s.version = "0.0.5"
+  s.version = "0.0.6"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jonathan Palardy"]
-  s.date = %q{2008-11-12}
+  s.date = %q{2008-11-13}
   s.default_executable = %q{forgetful}
   s.description = %q{A minimal command-line implementation of the SuperMemo 2 algorithm.}
   s.email = %q{jonathan.palardy@gmail.com}
   s.executables = ["forgetful"]
-  s.extra_rdoc_files = ["bin/forgetful", "lib/csv_ext/reminder.rb", "lib/forgetful.rb", "lib/reminder.rb", "README"]
-  s.files = ["bin/forgetful", "examples/katakana_romanji.csv", "examples/romanji_katakana.csv", "forgetful.gemspec", "lib/csv_ext/reminder.rb", "lib/forgetful.rb", "lib/reminder.rb", "Manifest", "README", "test/test_forgetful.rb"]
+  s.extra_rdoc_files = ["bin/forgetful", "lib/csv_ext/reminder.rb", "lib/forgetful.rb", "lib/reminder.rb", "README.rdoc"]
+  s.files = ["bin/forgetful", "examples/katakana_romanji.csv", "examples/romanji_katakana.csv", "lib/csv_ext/reminder.rb", "lib/forgetful.rb", "lib/reminder.rb", "Manifest", "MIT-LICENSE", "README.rdoc", "test/test_reminder.rb", "test/test_reminder_csv.rb", "forgetful.gemspec"]
   s.homepage = %q{http://github.com/jpalardy/forgetful}
-  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Forgetful", "--main", "README"]
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Forgetful", "--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{forgetful}
   s.rubygems_version = %q{1.2.0}
   s.summary = %q{A minimal command-line implementation of the SuperMemo 2 algorithm.}
-  s.test_files = ["test/test_forgetful.rb"]
+  s.test_files = ["test/test_reminder.rb", "test/test_reminder_csv.rb"]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION

data/lib/csv_ext/reminder.rb

@@ -4,19 +4,43 @@ require 'fastercsv'
 
 class Reminder
 
-  def self.load_csv(filename)
-    identity = lambda {|x| x}
+  def self.read_csv(filename)
+    File.open(filename) do |file|
+      self.parse_csv(file)
+    end
+  end
 
-    #                                        question  answer    next   ef      i         interval  q
-    FasterCSV.read(filename, :converters => [identity, identity, :date, :float, :integer, :integer, :integer]).collect do |list|
+  def self.parse_csv(io)
+    converters = [lambda {|question|   question},
+                  lambda {|answer|     answer},
+                  lambda {|execute_on| Date.parse(execute_on)},
+                  lambda {|ef|         ef.to_f},
+                  lambda {|i|          i.to_i},
+                  lambda {|interval|   interval.to_i},
+                  lambda {|q|          q.nil? ? q : q.to_i}]
+
+    FasterCSV.parse(io, :skip_blanks => true).collect do |list|
+      list = list.zip(converters).collect {|col, converter| converter[col]}
       self.new(*list)
     end
   end
 
-  def self.save_csv(filename, reminders)
-    FasterCSV.open(filename, "w") do |csv|
+  ############################################################
+
+  def self.write_csv(filename, reminders)
+    File.open(filename, "w") do |file|
+      file.write(generate_csv(reminders))
+    end
+  end
+
+  def self.generate_csv(reminders)
+    FasterCSV.generate do |csv|
       reminders.each do |reminder|
-        csv << reminder.to_a
+        if reminder.to_a.last.nil? # future reminder, never graded
+          csv << reminder.to_a.first(3)
+        else
+          csv << reminder.to_a
+        end
       end
     end
   end

data/test/test_reminder.rb

@@ -0,0 +1,128 @@
+
+require 'test/unit'
+require "#{File.dirname(__FILE__)}/../lib/forgetful"
+
+
+class TestReminder < Test::Unit::TestCase
+
+  def assert_raise_message(error, re)
+    exception = assert_raise(error) do
+      yield
+    end
+    assert_match re, exception.message
+  end
+
+  #-------------------------------------------------
+
+  def assert_equal_inspect(expected, actual)
+    assert_equal expected.inspect, actual.inspect
+  end
+
+  def setup
+    @carbon_question = Reminder.new 'carbon', '6'
+  end
+
+  #-------------------------------------------------
+
+  def test_empty
+    assert_raise_message ArgumentError, /wrong number of arguments \(0 for 2\)/ do
+      Reminder.new
+    end
+  end
+
+  def test_just_question
+    assert_raise_message ArgumentError, /wrong number of arguments \(1 for 2\)/ do
+      Reminder.new 'carbon'
+    end
+  end
+
+  #-------------------------------------------------
+
+  def test_minimum
+    assert_equal 'carbon',   @carbon_question.question
+    assert_equal '6',        @carbon_question.answer
+    assert_equal Date.today, @carbon_question.execute_on
+    assert_equal 2.5,        @carbon_question.ef
+    assert_equal 0,          @carbon_question.i
+    assert_equal 0,          @carbon_question.interval
+    assert_equal nil,        @carbon_question.q
+  end
+
+  def test_minium_array
+    assert_equal ['carbon', '6', Date.today, 2.5, 0, 0, nil], [@carbon_question.question, @carbon_question.answer, @carbon_question.execute_on, @carbon_question.ef, @carbon_question.i, @carbon_question.interval, @carbon_question.q]
+  end
+
+  #-------------------------------------------------
+
+  def test_next
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.7, 0, 1, 0], @carbon_question.next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.96, 0, 1, 1], @carbon_question.next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.18, 0, 1, 2], @carbon_question.next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.36, 1, 1, 3], @carbon_question.next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1,  2.5, 1, 1, 4], @carbon_question.next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1,  2.6, 1, 1, 5], @carbon_question.next(5).to_a
+  end
+
+  def test_next_after_0
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.3, 0, 1, 0], @carbon_question.next(0).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.3, 0, 1, 1], @carbon_question.next(0).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.38, 0, 1, 2], @carbon_question.next(0).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.56, 1, 1, 3], @carbon_question.next(0).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.7, 1, 1, 4], @carbon_question.next(0).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.8, 1, 1, 5], @carbon_question.next(0).next(5).to_a
+  end
+
+  def test_next_after_1
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.3, 0, 1, 0], @carbon_question.next(1).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.42, 0, 1, 1], @carbon_question.next(1).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.64, 0, 1, 2], @carbon_question.next(1).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.82, 1, 1, 3], @carbon_question.next(1).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.96, 1, 1, 4], @carbon_question.next(1).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.06, 1, 1, 5], @carbon_question.next(1).next(5).to_a
+  end
+
+  def test_next_after_2
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.38, 0, 1, 0], @carbon_question.next(2).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.64, 0, 1, 1], @carbon_question.next(2).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.86, 0, 1, 2], @carbon_question.next(2).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.04, 1, 1, 3], @carbon_question.next(2).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.18, 1, 1, 4], @carbon_question.next(2).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.28, 1, 1, 5], @carbon_question.next(2).next(5).to_a
+  end
+
+  def test_next_after_3
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.56, 0, 1, 0], @carbon_question.next(3).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.82, 0, 1, 1], @carbon_question.next(3).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.04, 0, 1, 2], @carbon_question.next(3).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6, 2.22, 2, 6, 3], @carbon_question.next(3).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6, 2.36, 2, 6, 4], @carbon_question.next(3).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6, 2.46, 2, 6, 5], @carbon_question.next(3).next(5).to_a
+  end
+
+  def test_next_after_4
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.7, 0, 1, 0], @carbon_question.next(4).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 1.96, 0, 1, 1], @carbon_question.next(4).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.18, 0, 1, 2], @carbon_question.next(4).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6, 2.36, 2, 6, 3], @carbon_question.next(4).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6,  2.5, 2, 6, 4], @carbon_question.next(4).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6,  2.6, 2, 6, 5], @carbon_question.next(4).next(5).to_a
+  end
+
+  def test_next_after_5
+    assert_equal_inspect ['carbon', '6', Date.today+1,  1.8, 0, 1, 0], @carbon_question.next(5).next(0).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.06, 0, 1, 1], @carbon_question.next(5).next(1).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+1, 2.28, 0, 1, 2], @carbon_question.next(5).next(2).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6, 2.46, 2, 6, 3], @carbon_question.next(5).next(3).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6,  2.6, 2, 6, 4], @carbon_question.next(5).next(4).to_a
+    assert_equal_inspect ['carbon', '6', Date.today+6,  2.7, 2, 6, 5], @carbon_question.next(5).next(5).to_a
+  end
+
+  #-------------------------------------------------
+
+  # will ask tomorrow?
+  def test_fail_after_long_interval
+    oxygen_question = Reminder.new('oxygen', '8', Date.today, 3.2, 7, 393)
+    assert_equal_inspect ['oxygen', '8', Date.today+1,  2.4, 0, 1, 0], oxygen_question.next(0).to_a
+  end
+
+end

data/test/test_reminder_csv.rb

@@ -0,0 +1,103 @@
+
+require 'test/unit'
+require "#{File.dirname(__FILE__)}/../lib/forgetful"
+
+
+class TestReminderCSV < Test::Unit::TestCase
+
+  def assert_equal_inspect(expected, actual)
+    assert_equal expected.inspect, actual.inspect
+  end
+
+  #-------------------------------------------------
+
+  def test_parse_csv_bare
+    csv = <<END
+carbon,6
+nitrogen,7
+oxygen,8
+END
+
+    reminders = Reminder.parse_csv(csv)
+
+    assert_equal 3, reminders.length
+
+    assert_equal_inspect ['carbon',  '6',Date.today, 2.5, 0, 0, nil], reminders[0].to_a
+    assert_equal_inspect ['nitrogen','7',Date.today, 2.5, 0, 0, nil], reminders[1].to_a
+    assert_equal_inspect ['oxygen',  '8',Date.today, 2.5, 0, 0, nil], reminders[2].to_a
+  end
+
+  def test_parse_csv_with_dates
+    csv = <<END
+carbon,6,2008-11-11
+nitrogen,7,2008-11-11
+oxygen,8,2008-11-11
+END
+
+    reminders = Reminder.parse_csv(csv)
+
+    assert_equal 3, reminders.length
+
+    assert_equal_inspect ['carbon',  '6',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[0].to_a
+    assert_equal_inspect ['nitrogen','7',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[1].to_a
+    assert_equal_inspect ['oxygen',  '8',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[2].to_a
+  end
+
+  def test_parse_csv_full
+    csv = <<END
+carbon,6,2008-11-11,2.5,0,0,
+nitrogen,7,2008-11-11,2.5,0,0,
+oxygen,8,2008-11-11,2.5,0,0,
+END
+
+    reminders = Reminder.parse_csv(csv)
+
+    assert_equal 3, reminders.length
+
+    assert_equal_inspect ['carbon',  '6',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[0].to_a
+    assert_equal_inspect ['nitrogen','7',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[1].to_a
+    assert_equal_inspect ['oxygen',  '8',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[2].to_a
+  end
+
+  def test_parse_csv_full_with_spaces
+    csv = <<END
+
+carbon,6,2008-11-11,2.5,0,0,
+
+
+nitrogen,7,2008-11-11,2.5,0,0,
+oxygen,8,2008-11-11,2.5,0,0,
+
+END
+
+    reminders = Reminder.parse_csv(csv)
+
+    assert_equal 3, reminders.length
+
+    assert_equal_inspect ['carbon',  '6',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[0].to_a
+    assert_equal_inspect ['nitrogen','7',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[1].to_a
+    assert_equal_inspect ['oxygen',  '8',Date.parse('2008-11-11'), 2.5, 0, 0, nil], reminders[2].to_a
+  end
+
+  ############################################################
+
+  def test_generate_csv
+    reminders = []
+    reminders << Reminder.new('carbon','6')
+    reminders << Reminder.new('nitrogen','7').next(5).next(5).next(5)
+    reminders << Reminder.new('oxygen','8').next(1).next(1).next(1)
+    reminders << Reminder.new('fluorine','9').next(1).next(5).next(1).next(5)
+    reminders << Reminder.new('neon','10',Date.today+5)
+
+    expected =<<END
+carbon,6,#{Date.today}
+nitrogen,7,#{(Date.today+16)},2.8,3,16,5
+oxygen,8,#{(Date.today+1)},1.3,0,1,1
+fluorine,9,#{(Date.today+1)},1.62,1,1,5
+neon,10,#{(Date.today+5)}
+END
+
+    assert_equal expected, Reminder.generate_csv(reminders)
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: jpalardy-forgetful
 version: !ruby/object:Gem::Version 
-  version: 0.0.5
+  version: 0.0.6
 platform: ruby
 authors: 
 - Jonathan Palardy
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-11-12 00:00:00 -08:00
+date: 2008-11-13 00:00:00 -08:00
 default_executable: forgetful
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -35,18 +35,20 @@ extra_rdoc_files:
 - lib/csv_ext/reminder.rb
 - lib/forgetful.rb
 - lib/reminder.rb
-- README
+- README.rdoc
 files: 
 - bin/forgetful
 - examples/katakana_romanji.csv
 - examples/romanji_katakana.csv
-- forgetful.gemspec
 - lib/csv_ext/reminder.rb
 - lib/forgetful.rb
 - lib/reminder.rb
 - Manifest
-- README
-- test/test_forgetful.rb
+- MIT-LICENSE
+- README.rdoc
+- test/test_reminder.rb
+- test/test_reminder_csv.rb
+- forgetful.gemspec
 has_rdoc: false
 homepage: http://github.com/jpalardy/forgetful
 post_install_message: 
@@ -56,7 +58,7 @@ rdoc_options:
 - --title
 - Forgetful
 - --main
-- README
+- README.rdoc
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -79,4 +81,5 @@ signing_key:
 specification_version: 2
 summary: A minimal command-line implementation of the SuperMemo 2 algorithm.
 test_files: 
-- test/test_forgetful.rb
+- test/test_reminder.rb
+- test/test_reminder_csv.rb

data/README

@@ -1,51 +0,0 @@
-
-A minimal command-line app implementing the SuperMemo 2 algorithm.
-
-The SuperMemo algorithm is designed to refresh your memory at
-intervals based on how well you remembered something.
-
-Put question-answer pairs in a file. Everyday, feed the file to forgetful and
-it will quiz you on what you need to remember today. Based on your
-self-evaluation, forgetful will reschedule at an appropriate time in the
-future.
-
-Usage:
-
-  forgetful filename.csv [more filenames]
-
-Format:
-
-A CSV file to contain your questions and answers, in the following format:
-
-  question,answer
-
-Flow:
-
-  1. shows question (press enter)
-  2. shows answer
-  3. asks for self-evaluation (type number, and enter)
-  4. repeats for all questions
-  5. repeats for questions that scored less than 4
-
-Self-evaluation:
-
-  5 - perfect response
-  4 - correct response after a hesitation
-  3 - correct response recalled with serious difficulty
-  2 - incorrect response; where the correct one seemed easy to recall
-  1 - incorrect response; the correct one remembered
-  0 - complete blackout.
-
-WARNING:
-
-Statistics are written back to the input file. This is a feature. Put your CSV
-files under source control to keep a history.
-
-Enjoy!
-
-############################################################
-
-The article that sparked my interest: http://www.wired.com/medtech/health/magazine/16-05/ff_wozniak
-
-The algorithm itself: http://www.supermemo.com/english/ol/sm2.htm
-