ftc_event 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bc1e3cbb8a698c4fdc0f7d8bf55a14669b9c2f6dbae46db3ba38478bae0d5352
+  data.tar.gz: c54d67ec82119e7f32cd8dd1878d03dd71f05ef869c6c72af7107dce325f3aef
+SHA512:
+  metadata.gz: 670b6da28f10e983adb64421811e266edbb976096ba0c2b6e04352b133e29832c69a524fd418e59ea3f9ee6feadb167c3ab9e87ef4d2031a6c88df01f239df21
+  data.tar.gz: 843e8f6813a102cb5096cf2a1bc726ed7d00674341c098d285b49e60c3c947adb4e7d265a9943e0b234185612955ae588895adaca0ce1f0e2f8da1a6421b28cb

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.idea/.gitignore

@@ -0,0 +1,2 @@
+# Default ignored files
+/workspace.xml

data/.idea/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build ftc_event-0.1.0.gem into the pkg directory" fullCmd="build" taksId="build" /><RakeTask description="Remove any temporary products" fullCmd="clean" taksId="clean" /><RakeTask description="Remove any generated files" fullCmd="clobber" taksId="clobber" /><RakeTask description="Build and install ftc_event-0.1.0.gem into system gems" fullCmd="install" taksId="install" /><RakeGroup description="" fullCmd="" taksId="install"><RakeTask description="Build and install ftc_event-0.1.0.gem into system gems without network access" fullCmd="install:local" taksId="local" /></RakeGroup><RakeTask description="Create tag v0.1.0 and build and push ftc_event-0.1.0.gem to rubygems.org" fullCmd="release[remote]" taksId="release[remote]" /><RakeTask description="Run RSpec code examples" fullCmd="spec" taksId="spec" /><RakeTask description="" fullCmd="default" taksId="default" /><RakeTask description="" fullCmd="release" taksId="release" /><RakeGroup description="" fullCmd="" taksId="release"><RakeTask description="" fullCmd="release:guard_clean" taksId="guard_clean" /><RakeTask description="" fullCmd="release:rubygem_push" taksId="rubygem_push" /><RakeTask description="" fullCmd="release:source_control_push" taksId="source_control_push" /></RakeGroup></RakeGroup></Settings>

data/.idea/ftc_event.iml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="rbenv: 2.6.3" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.0.1, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="diff-lcs (v1.3, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="jaro_winkler (v1.5.4, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.19.1, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v2.7.0.2, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.0.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v10.5.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec (v3.9.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-core (v3.9.1, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-expectations (v3.9.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-mocks (v3.9.1, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rspec-support (v3.9.2, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v0.79.0, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.10.1, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="sqlite3 (v1.4.2, rbenv: 2.6.3) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v1.6.1, rbenv: 2.6.3) [gem]" level="application" />
+  </component>
+</module>

data/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Rubocop" enabled="false" level="WARNING" enabled_by_default="false" />
+  </profile>
+</component>

data/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,5 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="PROJECT_PROFILE" />
+  </settings>
+</component>

data/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptSettings">
+    <option name="languageLevel" value="ES6" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="ruby-2.4.2-p198" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/ftc_event.iml" filepath="$PROJECT_DIR$/.idea/ftc_event.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,17 @@
+Style/Documentation:
+  Enabled: false
+
+Style/TrailingCommaInHashLiteral:
+  Enabled: false
+
+Style/TrailingCommaInArrayLiteral:
+  Enabled: false
+
+Style/FormatString:
+  Enabled: false
+
+Style/FormatStringToken:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.6.3
+before_install: gem install bundler -v 2.0.1

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ftc_event.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,53 @@
+PATH
+  remote: .
+  specs:
+    ftc_event (0.1.0)
+      sqlite3 (~> 1.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.0)
+    diff-lcs (1.3)
+    jaro_winkler (1.5.4)
+    parallel (1.19.1)
+    parser (2.7.0.2)
+      ast (~> 2.4.0)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    rubocop (0.79.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.7)
+    ruby-progressbar (1.10.1)
+    sqlite3 (1.4.2)
+    unicode-display_width (1.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  ftc_event!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  rubocop (~> 0.79)
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Jeremy Cole
+
+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,54 @@
+# FtcEvent
+
+This is a Ruby gem for accessing the SQLite3 databases produced by the FIRST Tech Challenge scorekeeper software.
+
+This gem was primarily developed in order to access the match start times to automatically extract per-match videos excerpts from an event video. See [jeremycole/ftc_video](https://github.com/jeremycole/ftc_video) for more about that. 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ftc_event'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ftc_event
+
+## Usage
+
+Get some basic information using IRB:
+
+```
+>> e = FtcEvent::Event.new("event.db")
+
+>> e.name
+=> "Northern Nevada FTC League Tournament"
+
+>> e.qualifications.matches.count
+=> 24
+
+>> e.qualifications.match(1).result
+=> "Red 63 points [no penalties] (win), Blue 37 points [no penalties] (loss)"
+```
+
+You'll probably want to explore with IRB.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` 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 [jeremycole/ftc_event](https://github.com/jeremycole/ftc_event).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'ftc_event'
+
+# 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(__FILE__)

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/ftc_event.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ftc_event/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ftc_event'
+  spec.version       = FtcEvent::VERSION
+  spec.authors       = ['Jeremy Cole']
+  spec.email         = ['jeremy@jcole.us']
+
+  spec.summary       = 'A library for accessing a FIRST Tech Challenge scorekeeper event database.'
+  spec.description   = spec.summary
+  spec.homepage      = 'http://github.com/jeremycole/ftc_event'
+  spec.license       = 'MIT'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.79'
+
+  spec.add_dependency 'sqlite3', '~> 1.4'
+end

data/lib/ftc_event/alliance.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Alliance
+    attr_reader :event
+    attr_reader :rank
+
+    def initialize(event, rank)
+      @event = event
+      @rank = rank
+    end
+
+    def info
+      event.db.query('SELECT * FROM alliances WHERE rank = ?', [rank])&.first
+    end
+
+    def teams
+      [1, 2, 3].map { |n| info["team#{n}"] }.reject(&:zero?)
+    end
+
+    def each_team
+      return enum_for(:each_team) unless block_given?
+
+      teams.each do |team_number|
+        yield event.team(team_number)
+      end
+
+      nil
+    end
+
+    def short_team_list
+      each_team.map(&:number).join(' & ')
+    end
+
+    def long_team_list
+      each_team.map(&:description).join(' and ')
+    end
+
+    def short_description
+      "##{rank} #{short_team_list}"
+    end
+
+    def long_description
+      "##{rank} #{long_team_list}"
+    end
+  end
+end

data/lib/ftc_event/elimination.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Elimination < Match
+    attr_reader :event
+    attr_reader :match
+
+    def initialize(event, match)
+      @event = event
+      @match = match
+    end
+
+    def table_prefix
+      'elims'
+    end
+
+    def short_name
+      case match
+      when 1, 3, 5
+        'SF1-%i' % [(match + 1) / 2]
+      when 2, 4, 6
+        'SF2-%i' % [(match + 0) / 2]
+      when 7
+        'F-1'
+      when 9
+        'F-2'
+      end
+    end
+
+    def short_identifier
+      short_name.gsub(/-/, '')
+    end
+
+    def long_name
+      case match
+      when 1, 3, 5
+        'Semifinal 1 Match %i' % [(match + 1) / 2]
+      when 2, 4, 6
+        'Semifinal 2 Match %i' % [(match + 0) / 2]
+      when 7
+        'Finals Match 1'
+      when 9
+        'Finals Match 2'
+      end
+    end
+
+    def positions
+      FtcEvent::ALLIANCES
+    end
+
+    def alliances
+      positions.each_with_object({}) do |position, h|
+        h[position] = Alliance.new(event, info[position])
+      end
+    end
+
+    def each_team(alliance)
+      return enum_for(:each_team, alliance) unless block_given?
+
+      alliances[alliance].each_team do |team|
+        yield team
+      end
+
+      nil
+    end
+
+    def short_alliance_description(color)
+      alliances[color].short_description
+    end
+
+    def long_alliance_description(color)
+      alliances[color].long_description
+    end
+  end
+end

data/lib/ftc_event/eliminations.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Eliminations
+    attr_reader :event
+
+    def initialize(event)
+      @event = event
+    end
+
+    def name
+      'Eliminations'
+    end
+
+    def match(match_number)
+      Elimination.new(event, match_number)
+    end
+
+    def matches
+      event.db.query('SELECT match FROM elims').map { |row| row['match'] }
+    end
+
+    def each_match
+      return enum_for(:each_match) unless block_given?
+
+      matches.each do |match_number|
+        yield match(match_number)
+      end
+
+      nil
+    end
+  end
+end

data/lib/ftc_event/event.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Event
+    attr_reader :db
+
+    def initialize(filename)
+      @db = SQLite3::Database.new(filename, results_as_hash: true)
+    end
+
+    def config
+      db.execute('SELECT key, value FROM config').each_with_object({}) do |row, h|
+        h[row['key']] = row['value']
+      end
+    end
+
+    def leagues
+      db.execute('SELECT code FROM leagueInfo').map { |row| row['code'] }
+    end
+
+    def code
+      config['code']
+    end
+
+    def name
+      config['name']
+    end
+
+    def short_name
+      code.upcase
+    end
+
+    def start
+      Time.at(config['start'].to_f / 1000.0)
+    end
+
+    def end
+      Time.at(config['end'].to_f / 1000.0)
+    end
+
+    def league(code = leagues.first)
+      League.new(self, code)
+    end
+
+    def team(number)
+      Team.new(self, number)
+    end
+
+    def qualifications
+      Qualifications.new(self)
+    end
+
+    def alliance(rank)
+      Alliance.new(self, rank)
+    end
+
+    def eliminations
+      Eliminations.new(self)
+    end
+
+    def phases
+      [qualifications, eliminations]
+    end
+
+    def each_phase
+      return enum_for(:each_phase) unless block_given?
+
+      phases.each do |phase|
+        yield phase unless phase.matches.empty?
+      end
+
+      nil
+    end
+  end
+end

data/lib/ftc_event/league.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class League
+    attr_reader :event
+    attr_reader :code
+
+    def initialize(event, code)
+      @event = event
+      @code = code
+    end
+
+    def info
+      event.db.query('SELECT * FROM leagueInfo WHERE code = ?', [code])&.first
+    end
+
+    def name
+      info['name']
+    end
+
+    def teams
+      result = event.db.query('SELECT team FROM leagueMembers WHERE code = ?', [code])
+      result&.map { |row| row['team'] }
+    end
+
+    def each_team
+      return enum_for(:each_team) unless block_given?
+
+      teams.each do |number|
+        yield event.team(number)
+      end
+
+      nil
+    end
+  end
+end

data/lib/ftc_event/match.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Match
+    attr_reader :event
+    attr_reader :match
+
+    def initialize(event, match)
+      @event = event
+      @match = match
+    end
+
+    def table_prefix
+      raise 'Abstract method not implemented'
+    end
+
+    def one_row_from_table(table, match)
+      result = event.db.query("SELECT * FROM #{table_prefix}#{table} WHERE match = ?", [match])
+      result&.first
+    end
+
+    def info
+      one_row_from_table('', match)
+    end
+
+    def data
+      one_row_from_table('Data', match)
+    end
+
+    def results
+      one_row_from_table('Results', match)
+    end
+
+    def game_specific
+      one_row_from_table('GameSpecific', match)
+    end
+
+    def short_name
+      raise 'Abstract method not implemented'
+    end
+
+    def short_identifier
+      raise 'Abstract method not implemented'
+    end
+
+    def long_name
+      raise 'Abstract method not implemented'
+    end
+
+    def positions
+      raise 'Abstract method not implemented'
+    end
+
+    def teams
+      raise 'Abstract method not implemented'
+    end
+
+    def each_team(_alliance)
+      raise 'Abstract method not implemented'
+    end
+
+    def short_alliance_description(_color)
+      raise 'Abstract method not implemented'
+    end
+
+    def long_alliance_description(_color)
+      raise 'Abstract method not implemented'
+    end
+
+    def short_alliances_description
+      '%s vs. %s' % [
+        short_alliance_description('red'),
+        short_alliance_description('blue'),
+      ]
+    end
+
+    def long_alliances_description
+      '%s vs. %s' % [
+        long_alliance_description('red'),
+        long_alliance_description('blue'),
+      ]
+    end
+
+    def short_description
+      "#{short_name}: #{short_alliances_description}"
+    end
+
+    def long_description
+      "#{long_name}: #{long_alliances_description}"
+    end
+
+    def other_alliance(alliance)
+      return unless FtcEvent::ALLIANCES.include?(alliance)
+
+      FtcEvent::ALLIANCES.reject { |x| x == alliance }.first
+    end
+
+    def penalties_by(alliance)
+      results["#{alliance}PenaltyCommitted"]
+    end
+
+    def points_for(alliance)
+      results["#{alliance}Score"]
+    end
+
+    def score_for(alliance)
+      points_for(alliance) + penalties_by(other_alliance(alliance))
+    end
+
+    def winner
+      red  = score_for('red')
+      blue = score_for('blue')
+
+      if red > blue
+        'red'
+      elsif blue > red
+        'blue'
+      else
+        'tie'
+      end
+    end
+
+    def win_for(alliance)
+      case winner
+      when 'tie'
+        'tie'
+      when alliance
+        'win'
+      when other_alliance(alliance)
+        'loss'
+      end
+    end
+
+    def result_for(alliance)
+      return unless ALLIANCES.include?(alliance)
+
+      from_penalties = penalties_by(other_alliance(alliance))
+      '%i points [%s penalties] (%s)' % [
+        score_for(alliance),
+        from_penalties.zero? ? 'no' : "#{from_penalties} from",
+        win_for(alliance),
+      ]
+    end
+
+    def result
+      "Red #{result_for('red')}, Blue #{result_for('blue')}"
+    end
+
+    def started
+      Time.at(data['start'].to_f / 1000.0)
+    end
+
+    def scheduled
+      Time.at(data['scheduleStart'].to_f / 1000.0)
+    end
+
+    def posted
+      Time.at(data['postedTime'].to_f / 1000.0)
+    end
+  end
+end

data/lib/ftc_event/qualification.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Qualification < Match
+    attr_reader :event
+    attr_reader :match
+
+    def initialize(event, match)
+      @event = event
+      @match = match
+    end
+
+    def table_prefix
+      'quals'
+    end
+
+    def short_name
+      'Q-%i' % [match]
+    end
+
+    def short_identifier
+      'Q%02i' % [match]
+    end
+
+    def long_name
+      'Qualification Match %i' % [match]
+    end
+
+    def positions
+      FtcEvent::ALLIANCES.product([1, 2]).map(&:join)
+    end
+
+    def teams
+      positions.each_with_object({}) do |position, h|
+        h[position] = Team.new(event, info[position])
+      end
+    end
+
+    def each_team(alliance)
+      return enum_for(:each_team, alliance) unless block_given?
+
+      teams.each do |position, team|
+        yield team if position.start_with?(alliance)
+      end
+
+      nil
+    end
+
+    def short_alliance_description(color)
+      '%i & %i' % [
+        teams["#{color}1"]&.number || 0,
+        teams["#{color}2"]&.number || 0,
+      ]
+    end
+
+    def long_alliance_description(color)
+      '%s and %s' % [
+        teams["#{color}1"].description,
+        teams["#{color}2"].description,
+      ]
+    end
+  end
+end

data/lib/ftc_event/qualifications.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Qualifications
+    attr_reader :event
+
+    def initialize(event)
+      @event = event
+    end
+
+    def name
+      'Qualifications'
+    end
+
+    def match(match_number)
+      Qualification.new(event, match_number)
+    end
+
+    def matches
+      event.db.query('SELECT match FROM quals').map { |row| row['match'] }
+    end
+
+    def each_match
+      return enum_for(:each_match) unless block_given?
+
+      matches.each do |match_number|
+        yield match(match_number)
+      end
+
+      nil
+    end
+  end
+end

data/lib/ftc_event/team.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  class Team
+    attr_reader :event
+    attr_reader :number
+
+    def initialize(event, number)
+      @event = event
+      @number = number
+    end
+
+    def info
+      event.db.query('SELECT * FROM teamInfo WHERE number = ?', [number])&.first
+    end
+
+    def name
+      info && info['name']
+    end
+
+    def school
+      info && info['school']
+    end
+
+    def city
+      info && info['city']
+    end
+
+    def state
+      info && info['state']
+    end
+
+    def country
+      info && info['country']
+    end
+
+    def location
+      return unless info
+
+      [
+        city,
+        state,
+        country != 'USA' ? country : nil
+      ].reject(&:nil?).join(', ')
+    end
+
+    def description
+      "#{number} #{name}"
+    end
+
+    def full_description
+      "#{description} from #{location}"
+    end
+  end
+end

data/lib/ftc_event/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  VERSION = '0.1.0'
+end

data/lib/ftc_event.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module FtcEvent
+  ALLIANCES = %w[red blue].freeze
+end
+
+require 'sqlite3'
+
+require 'ftc_event/event'
+require 'ftc_event/league'
+require 'ftc_event/team'
+require 'ftc_event/match'
+require 'ftc_event/qualifications'
+require 'ftc_event/qualification'
+require 'ftc_event/alliance'
+require 'ftc_event/eliminations'
+require 'ftc_event/elimination'

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: ftc_event
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jeremy Cole
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-02-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.79'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.79'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+description: A library for accessing a FIRST Tech Challenge scorekeeper event database.
+email:
+- jeremy@jcole.us
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".idea/.gitignore"
+- ".idea/.rakeTasks"
+- ".idea/ftc_event.iml"
+- ".idea/inspectionProfiles/Project_Default.xml"
+- ".idea/inspectionProfiles/profiles_settings.xml"
+- ".idea/misc.xml"
+- ".idea/modules.xml"
+- ".idea/vcs.xml"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- ftc_event.gemspec
+- lib/ftc_event.rb
+- lib/ftc_event/alliance.rb
+- lib/ftc_event/elimination.rb
+- lib/ftc_event/eliminations.rb
+- lib/ftc_event/event.rb
+- lib/ftc_event/league.rb
+- lib/ftc_event/match.rb
+- lib/ftc_event/qualification.rb
+- lib/ftc_event/qualifications.rb
+- lib/ftc_event/team.rb
+- lib/ftc_event/version.rb
+homepage: http://github.com/jeremycole/ftc_event
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+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: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: A library for accessing a FIRST Tech Challenge scorekeeper event database.
+test_files: []