conference_tracker 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7286832479c6601a446e51d0ccb8b2cab5bce276
+  data.tar.gz: f76f784f392022aabd19e2a7ac0f4a52dcbc9479
+SHA512:
+  metadata.gz: 0602d0efcc7c77d339becd15bb1fba3563240ec61e516cf7625612db03169d306499a65270fa4aade8e4b668f3e03ab5391725f1945bc348e46d087b66d67ba3
+  data.tar.gz: 5b1ac9dd0f19f1bbd4808b98dd8ed2479c565db77514538d9bf2cb7e1836bb39358055a6632b3f045196cf8cf00c2b41bd5e503a85badd0814260e8d0caf1888

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in conference_tracker.gemspec
+gemspec

data/README.md

@@ -0,0 +1,112 @@
+## Table of Contents
+* [Scope](#scope)
+* [Design](#design)
+  * [SRP](#srp)
+* [Installation](#installation)
+* [Usage](#usage)
+  * [Library](#library)
+  * [CLI](#cli)
+
+## Scope
+This gem is the Ruby implementation of the `Conference Track Management` code-kata.
+
+## Design
+
+### SRP
+The code design follows the single responsibility principle by using a dedicated class for any specific task.  
+
+## Installation
+Install the gem from your shell:
+```shell
+gem install conference_tracker
+```
+
+## Usage
+
+### Library
+Just require the library into your program and pass an array of notes to the converter:
+```ruby
+require "conference_tracker"
+
+talks = ["Writing Fast Tests Against Enterprise Rails 60min", "Overdoing it in Python 45min", "Lua for the Masses 30min", "Ruby Errors from Mismatched Gem Versions 45min", "Common Ruby Errors 45min"]
+
+puts ConferenceTracker.call(talks)
+# Track 1:
+# 09:00AM Writing Fast Tests Against Enterprise Rails 60min
+# 10:00AM Overdoing it in Python 45min
+# 10:45AM Ruby Errors from Mismatched Gem Versions 45min
+# 11:30AM Lua for the Masses 30min
+# 12:00PM Lunch
+# 01:00PM Common Ruby Errors 45min
+# 04:00PM Networking Event
+```
+
+### CLI
+The gem provides a CLI interface. 
+Once installed you will be able to use the `conference_tracker` command from the terminal.  
+
+#### Help
+You can print CLI help by:
+```shell
+conference_tracker -h
+Usage: conference_tracker ~/talks.txt
+    -h --help               Print this help
+    <path-to-file>          Load conference talks
+```
+
+#### Input
+The program accepts as input a file containing the talks titles with their duration:
+```txt
+# ~/talks.txt
+Writing Fast Tests Against Enterprise Rails 60min
+Overdoing it in Python 45min
+Lua for the Masses 30min
+Ruby Errors from Mismatched Gem Versions 45min
+Common Ruby Errors 45min
+Rails for Python Developers lightning
+Communicating Over Distance 60min
+Accounting-Driven Development 45min
+Woah 30min
+Sit Down and Write 30min
+Pair Programming vs Noise 45min
+Rails Magic 60min
+Ruby on Rails: Why We Should Move On 60min
+Clojure Ate Scala (on my project) 45min
+Programming in the Boondocks of Seattle 30min
+Ruby vs. Clojure for Back-End Development 30min
+Ruby on Rails Legacy App Maintenance 60min
+A World Without HackerNews 30min
+User Interface CSS in Rails Apps 30min
+```
+
+Just pass the file path to the program:
+```shell
+conference_tracker ~/talks.txt
+> Track 1:
+> 09:00AM Rails Magic 60min
+> 10:00AM Ruby on Rails: Why We Should Move On 60min
+> 11:00AM Writing Fast Tests Against Enterprise Rails 60min
+> 12:00PM Lunch
+> 01:00PM Ruby on Rails Legacy App Maintenance 60min
+> 02:00PM Communicating Over Distance 60min
+> 03:00PM Ruby Errors from Mismatched Gem Versions 45min
+> 03:45PM Pair Programming vs Noise 45min
+> 04:30PM User Interface CSS in Rails Apps 30min
+> 05:00PM Networking Event
+
+> Track 2:
+> 09:00AM Accounting-Driven Development 45min
+> 09:45AM Clojure Ate Scala (on my project) 45min
+> 10:30AM Common Ruby Errors 45min
+> 11:15AM Overdoing it in Python 45min
+> 12:00PM Lunch
+> 01:00PM Lua for the Masses 30min
+> 01:30PM Woah 30min
+> 02:00PM Sit Down and Write 30min
+> 02:30PM Programming in the Boondocks of Seattle 30min
+> 03:00PM Ruby vs. Clojure for Back-End Development 30min
+> 03:30PM A World Without HackerNews 30min
+> 04:00PM Rails for Python Developers lightning
+> 04:05PM Networking Event
+
+```

data/Rakefile

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

data/bin/conference_tracker

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path("../../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require "conference_tracker"
+
+input = ARGV.fetch(0, "")
+ConferenceTracker::CLI.new(input).call

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "conference_tracker"
+
+# 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/conference_tracker.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "conference_tracker/version"
+
+Gem::Specification.new do |s|
+  s.name = "conference_tracker"
+  s.version = ConferenceTracker::VERSION
+  s.authors = ["costajob"]
+  s.email = ["costajob@gmail.com"]
+  s.summary = "Implementation of the Conference Track Management kata"
+  s.homepage = "https://bitbucket.org/costajob/conference_tracker"
+  s.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  s.bindir = "bin"
+  s.executables << "conference_tracker" 
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "bundler", "~> 1.15"
+  s.add_development_dependency "rake", "~> 10.0"
+  s.add_development_dependency "minitest", "~> 5.0"
+  s.add_development_dependency "benchmark-ips", "~> 2"
+end

data/lib/conference_tracker/cli.rb

@@ -0,0 +1,43 @@
+require "conference_tracker/scheduler"
+
+module ConferenceTracker
+  class CLI
+    HELP_FLAGS = %w[-h --help]
+    COL_WIDTH = 23
+
+    def initialize(input, 
+                   pipe = STDOUT, 
+                   scheduler = Scheduler)
+      @input = input
+      @pipe = pipe
+      @scheduler = scheduler
+    end
+
+    def call
+      @pipe.puts output
+    end
+
+    private def output
+      return help if help?
+      return unless file?
+      talks = File.readlines(@input).map(&:strip)
+      @scheduler.new(talks).call
+    end
+
+    private def file?
+      File.file?(File.expand_path(@input))
+    end
+
+    private def help?
+      HELP_FLAGS.include?(@input)
+    end
+
+    private def help
+      [].tap do |h|
+        h << %q{Usage: conference_tracker ~/talks.txt}
+        h << "    %-#{COL_WIDTH}s Print this help" % "-h --help"
+        h << "    %-#{COL_WIDTH}s Load conference talks" % "<path-to-file>"
+      end
+    end
+  end
+end

data/lib/conference_tracker/duration.rb

@@ -0,0 +1,20 @@
+module ConferenceTracker
+  class Duration
+    SECS_IN_MIN = 60
+    UNITS = {
+      "lightning" => 5
+    }
+
+    def initialize(value)
+      @value = UNITS.fetch(value, value).to_i
+    end
+
+    def to_i
+      @value * SECS_IN_MIN
+    end
+
+    def to_s
+      UNITS.invert.fetch(@value, "#{@value}min")
+    end
+  end
+end

data/lib/conference_tracker/event.rb

@@ -0,0 +1,45 @@
+module ConferenceTracker
+  class Event
+    NETWORKING = "Networking Event"
+
+    class Constraint
+      attr_reader :early_start
+
+      def initialize(early_start)
+        @early_start = Time.parse(early_start)
+      end
+
+      def valid?(time)
+        time >= @early_start
+      end
+    end
+
+    def self.lunch
+      new("Lunch", "12PM")
+    end
+
+    def self.networking
+      new("Networking Event", "4PM", Constraint.new("4PM"))
+    end
+
+    def initialize(name, start, constraint = nil)
+      @name = name
+      @start = ConferenceTracker.parse(start)
+      @constraint = constraint
+    end
+
+    def to_s
+      "#{early_start.strftime(FORMAT)} #{@name}"
+    end
+
+    def update(start)
+      @start = ConferenceTracker.parse(start)
+      self
+    end
+
+    private def early_start
+      return @start if @constraint.nil? || @constraint.valid?(@start)
+      @constraint.early_start
+    end
+  end
+end

data/lib/conference_tracker/scheduler.rb

@@ -0,0 +1,29 @@
+require "conference_tracker/talk"
+require "conference_tracker/track"
+
+module ConferenceTracker
+  class Scheduler
+    TRACK = "Track"
+
+    def initialize(talks, talk = Talk, track = Track)
+      @talks = talk.bulk(talks.to_a).sort { |a,b| b.to_i <=> a.to_i }
+      @track = track
+    end
+
+    def call
+      collect.to_a.reject(&:empty?).each_with_index.map do |track, i|
+        track.name = "#{TRACK} #{i+1}:"
+        track.schedule << ""
+      end
+    end
+
+    private def collect
+      return if @talks.empty?
+      @talks.reduce([]) do |tracks, talk|
+        tracks.each { |track| track.add(talk) }
+        tracks << @track.new.add(talk) unless talk.scheduled?
+        tracks
+      end
+    end
+  end
+end

data/lib/conference_tracker/session.rb

@@ -0,0 +1,47 @@
+require "forwardable"
+
+module ConferenceTracker
+  class Session
+    extend Forwardable
+
+    def self.morning
+      new("9am", "12pm")
+    end
+
+    def self.afternoon
+      new("1pm", "5pm")
+    end
+
+    def_delegators :@talks, :size, :empty?
+
+    attr_reader :next_start
+
+    def initialize(start, finish)
+      @start = ConferenceTracker.parse(start)
+      @finish = ConferenceTracker.parse(finish)
+      @lapse = @finish - @start
+      @talks = []
+    end
+
+    def schedule
+      @talks.map(&:to_s)
+    end
+
+    def add(talk)
+      return if talk.scheduled? || overflow?(talk)
+      @talks << talk.schedule(next_start)
+    end
+
+    def next_start
+      @start + length
+    end
+
+    private def overflow?(talk)
+      length + talk.to_i > @lapse
+    end
+
+    private def length
+      @talks.reduce(0) { |length, talk| length += talk.to_i }
+    end
+  end
+end

data/lib/conference_tracker/talk.rb

@@ -0,0 +1,43 @@
+require "conference_tracker/duration"
+
+module ConferenceTracker
+  class Talk
+    RULE = /(.*) (\d+min|#{Duration::UNITS.keys.join("|")})/
+
+    def self.factory(talk)
+      matching = talk.match(RULE)
+      return unless matching
+      new(*matching.captures)
+    end
+
+    def self.bulk(talks)
+      talks.map { |talk| factory(talk) }.compact
+    end
+
+    def initialize(name, duration)
+      @name = name
+      @duration = Duration.new(duration)
+    end
+
+    def to_s
+      [].tap do |s|
+        s << @start.strftime(FORMAT) if @start
+        s << @name
+        s << @duration
+      end.compact.join(" ")
+    end
+
+    def to_i
+      @duration.to_i
+    end
+
+    def schedule(time)
+      @start = ConferenceTracker.parse(time)
+      self
+    end
+
+    def scheduled?
+      !!@start
+    end
+  end
+end

data/lib/conference_tracker/track.rb

@@ -0,0 +1,34 @@
+require "conference_tracker/event"
+require "conference_tracker/session"
+
+module ConferenceTracker
+  class Track
+    attr_accessor :name
+    attr_reader :morning, :afternoon
+
+    def initialize(morning = Session.morning, afternoon = Session.afternoon, event = Event)
+      @morning = morning
+      @afternoon = afternoon
+      @event = event
+    end
+
+    def add(talk)
+      @morning.add(talk) || @afternoon.add(talk)
+      self
+    end
+
+    def empty?
+      @morning.empty?
+    end
+
+    def schedule
+      [].tap do |s|
+        s << @name
+        s.concat(@morning.schedule)
+        s << @event.lunch.to_s
+        s.concat(@afternoon.schedule)
+        s << @event.networking.update(@afternoon.next_start).to_s
+      end.compact
+    end
+  end
+end

data/lib/conference_tracker/version.rb

@@ -0,0 +1,3 @@
+module ConferenceTracker
+  VERSION = "1.1.0"
+end

data/lib/conference_tracker.rb

@@ -0,0 +1,18 @@
+require "time"
+require "conference_tracker/cli"
+require "conference_tracker/version"
+
+module ConferenceTracker
+  extend self
+
+  FORMAT = "%I:%M%p"
+
+  def call(talks)
+    Scheduler.new(talks).call
+  end
+
+  def parse(time)
+    return time if time.instance_of?(Time)
+    Time.parse(time)
+  end
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: conference_tracker
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- costajob
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !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: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: 
+email:
+- costajob@gmail.com
+executables:
+- conference_tracker
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- bin/conference_tracker
+- bin/console
+- bin/setup
+- conference_tracker.gemspec
+- lib/conference_tracker.rb
+- lib/conference_tracker/cli.rb
+- lib/conference_tracker/duration.rb
+- lib/conference_tracker/event.rb
+- lib/conference_tracker/scheduler.rb
+- lib/conference_tracker/session.rb
+- lib/conference_tracker/talk.rb
+- lib/conference_tracker/track.rb
+- lib/conference_tracker/version.rb
+homepage: https://bitbucket.org/costajob/conference_tracker
+licenses: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Implementation of the Conference Track Management kata
+test_files: []