language_cards 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6f7f8621d542935a3fd0ef4a0f3443adb400b770
+  data.tar.gz: c3e5c5271866b9b2ccc29715db06459847a27a86
+SHA512:
+  metadata.gz: efa78c38cbf83cccef29b98897b2b2434f2c777d09b7b95850c2cc78bd663b85bbec2b3c7d27926c50b560014ad206bb3e4c1d4394d2ea3c30e50596ec296f68
+  data.tar.gz: 263f886122db25b28b0919d01d0bdb5fc451a584219788a46015a21c10bad4c09131c405dd623d6d16c5eea523d4db8cdf359295ee071879db7cf4814ef38211

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+**/*.swp
+mkmf.log
+*.gem

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.0
+before_install: gem install bundler -v 1.13.7

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in language_cards.gemspec
+gemspec
+
+gem 'simplecov', :require => false, :group => :test

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Daniel P. Clark
+
+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.md

@@ -0,0 +1,49 @@
+# LanguageCards
+
+This is a flash card game for guessing translations or keyboard learning.  Currently implemented is
+English Romaji to Japanese Hirigana/Katakana and typing exercises for each.  Game experience will be improved upon!
+
+Also if your interested in adding other flash cards for language learning, pull requests are welcome.  Please
+keep some sort of organized collection for sets of cards (for instance the Japanese-Language Proficiency Test
+has different levels to complete, N1 through N5, which would each count as a collection).
+
+Internationalization support is built in!  Translators are welcome to make this game available in other languages.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'language_cards'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install language_cards
+
+## Usage
+
+After installing the gem you can run the executable `language_cards`.  If you clone the repo then use
+`bin/language_cards`.
+
+## Development
+
+*Tests required moving forward with this project unless it's translation files.*
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/danielpclark/language_cards.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "language_cards"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/language_cards

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path(File.join('..', '..', 'lib'), __FILE__)
+
+require 'language_cards'
+
+LanguageCards.start
+

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/cards/japanese-katakana-hiragana.yml

@@ -0,0 +1,460 @@
+---
+Japanese:
+  Katakana:
+    mapping:
+      - Romaji: Katakana
+        index: 
+          - :k
+          - :v
+      - Katakana: Katakana
+        index: 
+          - :v
+          - :v
+    a: ア
+    i: イ
+    u: ウ
+    e: エ
+    o: オ
+    "-": ー
+    xa: ァ
+    xi: ィ
+    xu: ゥ
+    xe: ェ
+    xo: ォ
+    ka: カ
+    ki: キ
+    ku: ク
+    ke: ケ
+    ko: コ
+    ca: カ
+    cu: ク
+    co: コ
+    ga: ガ
+    gi: ギ
+    gu: グ
+    ge: ゲ
+    go: ゴ
+    sa: サ
+    si: シ
+    su: ス
+    se: セ
+    so: ソ
+    za: ザ
+    zi: ジ
+    zu: ズ
+    ze: ゼ
+    zo: ゾ
+    ja: ジャ
+    ji: ジ
+    ju: ジュ
+    je: ジェ
+    jo: ジョ
+    ta: タ
+    ti: チ
+    tu: ツ
+    te: テ
+    to: ト
+    da: ダ
+    di: ヂ
+    du: ヅ
+    de: デ
+    do: ド
+    na: ナ
+    ni: ニ
+    nu: ヌ
+    ne: ネ
+    'no': ノ
+    ha: ハ
+    hi: ヒ
+    hu: フ
+    he: ヘ
+    ho: ホ
+    ba: バ
+    bi: ビ
+    bu: ブ
+    be: ベ
+    bo: ボ
+    pa: パ
+    pi: ピ
+    pu: プ
+    pe: ペ
+    po: ポ
+    va: ヴァ
+    vi: ヴィ
+    vu: ヴ
+    ve: ヴェ
+    vo: ヴォ
+    fa: ファ
+    fi: フィ
+    fu: フ
+    fe: フェ
+    fo: フォ
+    ma: マ
+    mi: ミ
+    mu: ム
+    me: メ
+    mo: モ
+    ya: ヤ
+    yi: イ
+    yu: ユ
+    ye: イェ
+    yo: ヨ
+    ra: ラ
+    ri: リ
+    ru: ル
+    re: レ
+    ro: ロ
+    la: ラ
+    li: リ
+    lu: ル
+    le: レ
+    lo: ロ
+    wa: ワ
+    wi: ウィ
+    wu: ウ
+    we: ウェ
+    wo: ヲ
+    nn: ン
+    n: ン
+    tsu: ツ
+    xka: ヵ
+    xke: ヶ
+    xwa: ヮ
+    xtsu: ッ
+    xya: ャ
+    xyu: ュ
+    xyo: ョ
+    kya: キャ
+    kyi: キィ
+    kyu: キュ
+    kye: キェ
+    kyo: キョ
+    gya: ギャ
+    gyi: ギィ
+    gyu: ギュ
+    gye: ギェ
+    gyo: ギョ
+    sya: シャ
+    syi: シィ
+    syu: シュ
+    sye: シェ
+    syo: ショ
+    sha: シャ
+    shi: シ
+    shu: シュ
+    she: シェ
+    sho: ショ
+    zya: ジャ
+    zyi: ジィ
+    zyu: ジュ
+    zye: ジェ
+    zyo: ジョ
+    jya: ジャ
+    jyi: ジィ
+    jyu: ジュ
+    jye: ジェ
+    jyo: ジョ
+    tya: チャ
+    tyi: チィ
+    tyu: チュ
+    tye: チェ
+    tyo: チョ
+    twa: トァ
+    twi: トィ
+    twu: トゥ
+    twe: トェ
+    two: トォ
+    dwa: ドァ
+    dwi: ドィ
+    dwu: ドゥ
+    dwe: ドェ
+    dwo: ドォ
+    cya: チャ
+    cyi: チィ
+    cyu: チュ
+    cye: チェ
+    cyo: チョ
+    cha: チャ
+    chi: チ
+    chu: チュ
+    che: チェ
+    cho: チョ
+    tha: テャ
+    thi: ティ
+    thu: テュ
+    the: テェ
+    tho: テョ
+    dya: ヂャ
+    dyi: ヂィ
+    dyu: ヂュ
+    dye: ヂェ
+    dyo: ヂョ
+    dha: デャ
+    dhi: ディ
+    dhu: デュ
+    dhe: デェ
+    dho: デョ
+    nya: ニャ
+    nyi: ニィ
+    nyu: ニュ
+    nye: ニェ
+    nyo: ニョ
+    hya: ヒャ
+    hyi: ヒィ
+    hyu: ヒュ
+    hye: ヒェ
+    hyo: ヒョ
+    bya: ビャ
+    byi: ビィ
+    byu: ビュ
+    bye: ビェ
+    byo: ビョ
+    pya: ピャ
+    pyi: ピィ
+    pyu: ピュ
+    pye: ピェ
+    pyo: ピョ
+    mya: ミャ
+    myi: ミィ
+    myu: ミュ
+    mye: ミェ
+    myo: ミョ
+    rya: リャ
+    ryi: リィ
+    ryu: リュ
+    rye: リェ
+    ryo: リョ
+    lya: リャ
+    lyi: リィ
+    lyu: リュ
+    lye: リェ
+    lyo: リョ
+  Hiragana:
+    mapping:
+      - Romaji: Hiragana
+        index: 
+          - :k
+          - :v
+      - Hiragana: Hiragana
+        index: 
+          - :v
+          - :v
+    a: あ
+    i: い
+    u: う
+    e: え
+    o: お
+    #    "-": 
+    #    xa: 
+    #    xi: 
+    #    xu: 
+    #    xe: 
+    #    xo: 
+    ka: か
+    ki: き
+    ku: く
+    ke: け
+    ko: こ
+    #    ca: 
+    #    cu: 
+    #    co: 
+    ga: が
+    gi: ぎ
+    gu: ぐ
+    ge: げ
+    go: ご
+    sa: さ
+    #    si: 
+    su: す
+    se: せ
+    so: そ
+    za: ざ
+    #    zi: 
+    zu: ず
+    ze: ぜ
+    zo: ぞ
+    ja: じゃ
+    ji: じ
+    ju: じゅ
+    #    je:  
+    jo: じょ
+    ta: た
+    #    ti: 
+    #    tu: 
+    te: て
+    to: と
+    da: だ
+    di: ぢ
+    du: づ
+    de: で
+    do: ど
+    na: な
+    ni: に
+    nu: ぬ
+    ne: ね
+    'no': の
+    ha: は
+    hi: ひ
+    #    hu: 
+    he: へ
+    ho: ほ
+    ba: ば
+    bi: び
+    bu: ぶ
+    be: べ
+    bo: ぼ
+    pa: ぱ
+    pi: ぴ
+    pu: ぷ
+    pe: ぺ
+    po: ぽ
+    #    va:  
+    #    vi:  
+    #    vu: 
+    #    ve:  
+    #    vo:  
+    #    fa:  
+    #    fi:  
+    fu: ふ
+    #    fe:  
+    #    fo:  
+    ma: ま
+    mi: み
+    mu: む
+    me: め
+    mo: も
+    ya: や
+    #    yi: 
+    yu: ゆ
+    #    ye:  
+    yo: よ
+    ra: ら
+    ri: り
+    ru: る
+    re: れ
+    ro: ろ
+    #    la: 
+    #    li: 
+    #    lu: 
+    #    le: 
+    #    lo: 
+    wa: わ
+    #    wi:  
+    #    wu: 
+    #    we:  
+    wo: を
+    #    nn: 
+    n: ん
+    tsu: つ
+    #    xka: 
+    #    xke: 
+    #    xwa: 
+    #    xtsu: 
+    #    xya: 
+    #    xyu: 
+    #    xyo: 
+    kya: きゃ
+    #    kyi: 
+    kyu: きゅ
+    #    kye: 
+    kyo: きょ
+    gya: ぎゃ
+    #    gyi: 
+    gyu: ぎゅ
+    #    gye: 
+    gyo: ぎょ
+    #    sya: 
+    #    syi: 
+    #    syu: 
+    #    sye: 
+    #    syo: 
+    sha: しゃ
+    shi: し
+    shu: しゅ
+    #    she: 
+    sho: しょ
+    #    zya: 
+    #    zyi: 
+    #    zyu: 
+    #    zye: 
+    #    zyo: 
+    #    jya: 
+    #    jyi: 
+    #    jyu: 
+    #    jye: 
+    #    jyo: 
+    #    tya: 
+    #    tyi: 
+    #    tyu: 
+    #    tye: 
+    #    tyo: 
+    #    twa: 
+    #    twi: 
+    #    twu: 
+    #    twe: 
+    #    two: 
+    #    dwa: 
+    #    dwi: 
+    #    dwu: 
+    #    dwe: 
+    #    dwo: 
+    #    cya: 
+    #    cyi: 
+    #    cyu: 
+    #    cye: 
+    #    cyo: 
+    cha: ちゃ
+    chi: ち
+    chu: ちゅ
+    #    che: 
+    cho: ちょ
+    #    tha: 
+    #    thi: 
+    #    thu: 
+    #    the: 
+    #    tho: 
+    #    dya: 
+    #    dyi: 
+    #    dyu: 
+    #    dye: 
+    #    dyo: 
+    #    dha: 
+    #    dhi: 
+    #    dhu: 
+    #    dhe: 
+    #    dho: 
+    nya: にゃ
+    #    nyi: 
+    nyu: にゅ
+    #    nye: 
+    nyo: にょ
+    hya: ひゃ
+    #    hyi: 
+    hyu: ひゅ
+    #    hye: 
+    hyo: ひょ
+    bya: びゃ
+    #    byi: 
+    byu: びゅ
+    #    bye: 
+    byo: びょ
+    pya: ぴゃ
+    #    pyi: 
+    pyu: ぴゅ
+    #    pye: 
+    pyo: ぴょ
+    mya: みゃ
+    #    myi: 
+    myu: みゅ
+    #    mye: 
+    myo: みょ
+    rya: りゃ
+    #    ryi: 
+    ryu: りゅ
+    #    rye: 
+    ryo: りょ
+    #    lya: 
+    #    lyi: 
+    #    lyu: 
+    #    lye: 
+    #    lyo: 

data/language_cards.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'language_cards/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "language_cards"
+  spec.version       = LanguageCards::VERSION
+  spec.authors       = ["Daniel P. Clark"]
+  spec.email         = ["6ftdan@gmail.com"]
+
+  spec.summary       = %q{Flashcard game for language learning.}
+  spec.description   = %q{Flashcard game for language learning. Make your own cards or translations as well.}
+  spec.homepage      = "http://github.com/danielpclark/language_cards"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.executables   = ['language_cards']
+  spec.require_paths = ["lib","cards"]
+
+  spec.add_dependency "highline", "~> 1.7"
+  spec.add_dependency "i18n", "~> 0.7"
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "minitest", "~> 5.10"
+end

data/lib/language_cards/card_collection.rb

@@ -0,0 +1,97 @@
+require_relative 'comparator'
+require_relative 'mapping'
+
+module LanguageCards
+  class CardCollection
+    attr_reader :name
+    ##
+    # RULE: Always compare by value regardless of key value ordering in mapping.
+    #    (This allows for duplicate spellings of the same character translation)
+    def initialize hsh, name=nil
+      @hsh = hsh
+      @name = I18n.t "LanguageName.#{name}" if name
+      send :_build
+      @mappings = @hsh["mapping"]
+      if @mappings
+        @cards = @hsh.select {|k,v| !v.is_a? Mappings}
+      end
+    end
+
+    ##
+    # Recursively build class course names
+    def classes s=nil
+      s = @name.nil? ? nil : [s, @name].compact.join(JOIN)
+      @hsh.select do |k,v|
+        [CardCollection, Mappings].include? v.class
+      end.flat_map do |k,v|
+        v.send :classes, s
+      end
+    end
+
+    def [](value)
+      raise EmptyCollection unless collection?
+      @cards[value]
+    end
+
+    def rand
+      raise EmptyCollection unless collection?
+      v = @cards.keys.sample
+      @comparator.given(v, @cards[v])
+    end
+
+    def correct? input, comp_bitz
+      raise EmptyCollection unless collection?
+      @comparator.match? input, comp_bitz
+    end
+
+    def mapped_as
+      raise EmptyCollection unless collection?
+      @comparator.mapped_as
+    end
+
+    def children
+      @hsh.select {|k,v| v.is_a? CardCollection}.values.map do |cc|
+        {cc.name => cc}
+      end.inject(:merge)
+    end
+
+    def select_collection string
+      first, tail = string.split(JOIN, 2)
+      if collection?
+        @comparator = @mappings.select_mapping(first)
+        return self
+      else
+        children[first].select_collection tail
+      end
+    end
+
+    def collection?
+      !!@cards
+    end
+
+    def cards
+      @cards || raise(I18n.t 'Errors.UpperCollection')
+    end
+
+    private
+    ##
+    # Replace respective raw ruby object with our objects
+    def _build
+      if @hsh.has_key? "mapping"
+        @hsh["mapping"] = Mappings.new(@hsh["mapping"], self) 
+      else
+        @hsh.tap do |h|
+          h.select {|k,v| v.is_a? Hash }.each do |k,v|
+            h[k] = self.class.new(v, k) 
+          end
+        end
+      end
+    end
+
+    class EmptyCollection < StandardError
+      def initialize
+        super(I18n.t 'Errors.EmptyCollection')
+      end
+    end
+  end
+end

data/lib/language_cards/comp_bitz.rb

@@ -0,0 +1,12 @@
+module LanguageCards
+  class CompBitz
+    attr_reader :display, :collection, :value, :mapping, :expected
+    def initialize options
+      @display = options.fetch(:display)
+      @collection = options.fetch(:collection)
+      @expected = options.fetch(:expected)
+      @value = options.fetch(:value)
+      @mapping = options.fetch(:mapping)
+    end
+  end
+end

data/lib/language_cards/comparator.rb

@@ -0,0 +1,61 @@
+require_relative 'comp_bitz'
+
+module LanguageCards
+  class Comparator
+    def initialize mapping_key, mapping, collection
+      ##
+      # @title should be a hash like {"Romaji"=>"Katakana"}
+      # @mapping should be an array like [:k, :v]
+      @mapped_as, @mapping = mapping[mapping_key].reduce
+      @collection = collection
+    end
+
+    def mapped_as
+      case @mapping.first
+      when :k
+        @mapped_as.keys
+      else
+        @mapped_as.values
+      end
+    end
+
+    def given key, value
+      CompBitz.new(
+        display: choose_display(key, value),
+        collection: @collection,
+        expected: choose_expected(key, value),
+        value: value,
+        mapping: @mapping.first
+      )
+    end
+
+    def match? input, comp_bitz
+      case comp_bitz.mapping 
+      when :k
+        comp_bitz.value == comp_bitz.collection[input]
+      when :v
+        comp_bitz.value == input
+      end
+    end
+
+    private
+    def choose_display key, value
+      case @mapping.last
+      when :k
+        key
+      when :v
+        value
+      end
+    end
+
+    def choose_expected key, value
+      case @mapping.first
+      when :k
+        key
+      when :v
+        value
+      end
+    end
+  end
+end
+

data/lib/language_cards/language_cards.rb

@@ -0,0 +1,18 @@
+require_relative 'card_collection'
+require_relative 'user_interface'
+
+module LanguageCards
+  class LanguageCards
+    def initialize
+      @CARDS = {}
+      Dir[File.join 'cards', '*.yml'].each do |c|
+        @CARDS.merge!(YAML.load(File.open(c).read))
+      end
+      @CARDS = CardCollection.new @CARDS
+    end
+
+    def start
+      UserInterface.new.start(@CARDS)
+    end
+  end
+end

data/lib/language_cards/mapping.rb

@@ -0,0 +1,55 @@
+module LanguageCards
+  class Mappings
+    def initialize mapping, collection=nil
+      @collection = collection
+      @mappings = {}
+      mapping.each do |h|
+        index = h.delete("index")
+        begin
+          a,b = h.reduce
+        rescue LocalJumpError
+          raise InvalidMapping
+        end
+        a = I18n.t "LanguageName.#{a}"
+        b = I18n.t "LanguageName.#{b}"
+
+        @mappings["#{a} => #{b}"] = {
+          h => index
+        }
+      end
+    end
+
+    def select_mapping string
+      Comparator.new string, self, @collection
+    end
+
+    def classes s=nil
+      keys.map do |names|
+        [s, names].compact.join(JOIN)
+      end
+    end
+
+    def [] key
+      @mappings[key]
+    end
+
+    def order key # what was my intention in design here?
+      self[key].values.flatten
+    end
+
+    def keys
+      @mappings.keys
+    end
+
+    def inspect
+      @mappings.keys
+    end
+
+    class InvalidMapping < StandardError
+      def initialize
+        super(I18n.t 'Errors.InvalidMapping')
+      end
+    end
+
+  end
+end

data/lib/language_cards/user_interface.rb

@@ -0,0 +1,109 @@
+
+
+module LanguageCards
+  class UserInterface
+    def main_menu(courses:)
+      title = I18n.t 'Menu.Title'
+<<-MAINMENU
+#{'~' * SUBMENUWIDTH}
+#{title}#{('v' + VERSION).rjust(SUBMENUWIDTH - title.length)}
+#{'~' * SUBMENUWIDTH}
+
+Select an option:
+
+#{ courses.each.with_index.map {|item,index| "#{index + 1}: #{item}\n" }.join.chop }
+#{I18n.t 'Menu.Exit'}
+
+#{'~' * SUBMENUWIDTH}
+MAINMENU
+    end
+
+    def score_menu(correct:, incorrect:)
+      score = "#{I18n.t 'Game.ScoreMenu.Score'}: #{correct.to_i} #{I18n.t 'Game.ScoreMenu.OutOf'} #{correct.to_i + incorrect.to_i}"
+<<-SCOREMENU
+#{'~' * SUBMENUWIDTH}
+#{score + I18n.t('Menu.Exit').rjust(SUBMENUWIDTH - score.length)}
+#{@last}
+#{'~' * SUBMENUWIDTH}
+SCOREMENU
+    end
+
+    def start(cards)
+      clear
+
+      CLI.say SPLASH_SCREEN
+      sleep 2
+
+      begin
+        loop do
+          clear
+          
+          CLI.say main_menu(courses: cards.classes)
+          value = CLI.ask("").to_i - 1
+          courses = cards.classes
+          if (0..courses.length-1).include? value
+            collection = cards.select_collection(courses[value])
+            begin
+              loop do
+                clear
+                CLI.say score_menu(correct: @correct, incorrect: @incorrect)
+                comp_bitz = collection.rand
+                input = CLI.ask("#{I18n.t('Game.TypeThis')} #{collection.mapped_as.first}: #{comp_bitz.display}")
+                if collection.correct? input, comp_bitz
+                  @correct = @correct.to_i + 1
+                  @last = [
+                    I18n.t('Game.Correct'),
+                    "#{input} = #{comp_bitz.display}"
+                  ].join(" ")
+                else
+                  @incorrect = @incorrect.to_i + 1
+                  @last = [
+                    I18n.t('Game.Incorrect'),
+                    "#{input} != #{comp_bitz.display}",
+                    I18n.t('Game.Its'),
+                    "#{comp_bitz.expected}"
+                  ].join(" ")
+                end
+              end
+            rescue SystemExit, Interrupt
+            end
+          end
+        end
+
+      rescue SystemExit, Interrupt
+      end
+    end
+
+    private
+    def clear
+      printf CLEAR
+    end
+  end
+end
+
+
+SPLASH_SCREEN = %q(
+  _            _       __    _    ____    _     _      _        ____    _______
+ | |          / \     |  \  | |  / __ \  | |   | |    / \      / __ \  |  _____|
+ | |         / _ \    |   \ | | / /  \_\ | |   | |   / _ \    / /  \_\ | |
+ | |        / /_\ \   | |\ \| || |   ___ | |   | |  / /_\ \  | |   ___ | ^‒‒‒v
+ | |       / _____ \  | | \ \ || |  |_  || |   | | / _____ \ | |  |_  || .‒‒‒^
+ | |____  / /     \ \ | |  \  | \ \__/  | \ \_/ / / /     \ \ \ \__/  || |_____
+ |______|/_/       \_\|_|   \_|  \____/_|  \___/ /_/       \_\ \____/_||_______|
+ 
+ 
+                   ____        _       _____     _____     _____   
+                  / __ \      / \     |  __ \   |  __ \   / ___/
+                 / /  \_\    / _ \    | |  \ \  | |  \ \ / /__ 
+                | |         / /_\ \   | |__/ /  | |  | | \___ \
+                | |    _   / _____ \  |  __ <   | |  | |     \ \
+                 \ \__/ / / /     \ \ | |  \ \  | |__/ /  ___/ / 
+                  \____/ /_/       \_\|_|   \_\ |_____/  /____/
+ 
+ 
+ 
+ 
+                               by Daniel P. Clark
+ 
+                                     @6ftdan
+)

data/lib/language_cards/version.rb

@@ -0,0 +1,3 @@
+module LanguageCards
+  VERSION = "0.0.1"
+end

data/lib/language_cards.rb

@@ -0,0 +1,39 @@
+require 'language_cards/version'
+require 'language_cards/language_cards'
+require 'yaml'
+require 'i18n'
+require 'highline'
+
+##
+# TODO:
+#  * Implement score-keeper
+#  * Race against the clock
+#  * Weighted random for better learning
+#  * Value to Value is simply keyboard practice and should be clocked
+#  * Finish building Hiragana cards (figure out duplicates for ja, ju, jo)
+
+module LanguageCards
+  CLEAR = begin
+            require 'mkmf'
+            clear = case RbConfig::CONFIG['target_os']
+            when /mingw32|mswin/
+              MakeMakefile.find_executable('cls')
+            else
+              MakeMakefile.find_executable('clear')
+            end
+            clear ? `#{clear}` : "\e[3J\e[H\e[2J"
+          ensure
+            File.delete('mkmf.log')
+          end
+
+  CLI = HighLine.new
+  JOIN = " : "
+
+  SUBMENUWIDTH = 60
+
+  ::I18n.load_path = Dir[File.join 'locales', '*.yml']
+
+  def self.start
+    LanguageCards.new.start
+  end
+end

data/locales/en.yml

@@ -0,0 +1,27 @@
+en:
+  Menu:
+    Title: Language Cards by @6ftdan
+    Choose: Choose your flash cards.
+    Exit: Press CTRL-C to quit.
+  Game:
+    TypeThis: Type the following in
+    Correct: Correct!
+    Incorrect: Wrong!
+    Its: it's
+    ScoreMenu:
+      Score: Your score is
+      OutOf: out of
+  Errors:
+    UpperCollection: Upper level collection container.\nYou need to use a deeper collection for cards.
+    InvalidMapping: >
+      Invalid mapping in YAML definition.
+      Their needs to be exactly two entries.
+        * one with an "index" key
+        * and one with one language name as the key and the other as a value
+      Fix your language mapping.
+    EmptyCollection: Invalid option on empty card collection! 
+  LanguageName:
+    Japanese: Japanese
+    Romaji: Romaji
+    Katakana: Katakana
+    Hiragana: Hiragana

metadata

@@ -0,0 +1,137 @@
+--- !ruby/object:Gem::Specification
+name: language_cards
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Daniel P. Clark
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.10'
+description: Flashcard game for language learning. Make your own cards or translations
+  as well.
+email:
+- 6ftdan@gmail.com
+executables:
+- language_cards
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/language_cards
+- bin/setup
+- cards/japanese-katakana-hiragana.yml
+- language_cards.gemspec
+- lib/language_cards.rb
+- lib/language_cards/card_collection.rb
+- lib/language_cards/comp_bitz.rb
+- lib/language_cards/comparator.rb
+- lib/language_cards/language_cards.rb
+- lib/language_cards/mapping.rb
+- lib/language_cards/user_interface.rb
+- lib/language_cards/version.rb
+- locales/en.yml
+homepage: http://github.com/danielpclark/language_cards
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- cards
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Flashcard game for language learning.
+test_files: []