mob_rotation 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4eac9d67bd7b967609ce166c6785f810ff8e7310
+  data.tar.gz: 8921a18fe1c2501f1440ad93c75deba49583e9b0
+SHA512:
+  metadata.gz: 5440387200cf66a07f8b019e24a2ab08efc448837c8e6859314bd8e0839acc2f54b917f21dd511460db2a2440330edaf3790f7f36efe7c07f69955f83a13c0f0
+  data.tar.gz: 27b0e608088f922085c72017a0f7543520f49b7dd92753735c3d8582e1d979245ae8e03b131d60f8609d150b85e9a8a31e98a6dba265be07285c30d98592794e

data/.gitignore

@@ -0,0 +1,25 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+*~
+*_test.*
+rotation.txt
+test*.txt
+results.txt
+rotate.txt
+\#*\#
+.\#*
+tmp
+vendor
+*.swp
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/.rubocop.yml

@@ -0,0 +1,33 @@
+# Default settings here:
+# https://github.com/bbatsov/rubocop/blob/master/config/default.yml
+# Find enabled settings here:
+# https://github.com/bbatsov/rubocop/blob/master/config/enabled.yml
+# We also prefer `or` and `and` for control flow:
+# http://devblog.avdi.org/2014/08/26/how-to-use-rubys-english-andor-operators-without-going-nuts/
+AllCops:
+  Exclude:
+    - bin/**
+    - config/**/*
+    - script/**
+# Follow the Jim Weirich school of thought on usage of do/end vs. {...}:
+# http://devblog.avdi.org/2011/07/26/the-procedurefunction-block-convention-in-ruby/
+Blocks:
+  Enabled: false
+CollectionMethods:
+  PreferredMethods:
+    map: "collect"
+    find: "detect"
+    find_all: "select"
+    reduce: "inject"
+Documentation:
+  Enabled: false
+EachWithObject:
+  Enabled: false
+Lambda:
+  Enabled: false
+RegexpLiteral:
+  MaxSlashes: 0
+StringLiterals:
+  EnforcedStyle: double_quotes
+TrailingBlankLines:
+  EnforcedStyle: final_newline

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - "2.1.2"
+script: bundle exec rspec spec

data/Changelog.md

@@ -0,0 +1,4 @@
+- Show the Driver and Navigator
+- Add mobsters
+- Remove mobsters
+- Create CLI program

data/Contributors.md

@@ -0,0 +1,29 @@
+* [Abhishek Bose](http://abhishekbose.com)
+* [Alex Harms](http://twitter.com/onealexharms)
+* [Alistair Cockburn](http://alistair.cockburn.us)
+* [Amitai Schlair](http://www.schmonz.com)
+* [Andrew Broman](http://github/afbroman)
+* [Ben Thompson](http://github.com/kotay)
+* [Dan Wagner](http://github.com/danwagnerco)
+* [Harri Jauri](http://twitter.com/harrijauri)
+* [Jacqueline S. Homan](http://github.com/jacqueline-homan)
+* [Jared Smith](http://sublimecoding.com)
+* [J. B. Rainsberger](http://jbrains.ca)
+* [Jen Diamond](http://jendiamond.com)
+* [Jonathan Whittington](http://github.com/ixil)
+* Kocur4d
+* [Lucas Mendelowski](http://github.com/lowski)
+* [Luisa Lima](http://github.com/luisalima)
+* [Luke DeWitt](http://github.com/ledewitt)
+* [Luqi Pan](https://github.com/LuqiPan)
+* [Mark](https://github.com/Digital-Learner)
+* [Mike Bonifer](http://gamechangers.com)
+* [Pat Maddox](http://patmaddox.com)
+* [Paul Yeoh](http://github.com/paul-ylz)
+* [Philip Coates](http://github.com/pcoates99)
+* [Ralph Hafliger](http://github.com/heroturtle)
+* [Rob Wilkinson](http://github.com/robawilkinson)
+* [Russell Baker](http://twitter.com/_russellb)
+* [Sean Miller](http://github.com/smiller)
+* [Willem Larsen](http://github.com/willemlarsen)
+* [Woody Zuill](http://zuill.us/WoodyZuill/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mob_rotation.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Pat Maddox
+
+MIT License
+
+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,27 @@
+Mob Rotation
+============
+
+### Features
+* Command line interface to simulate the [mob programming][mob_wiki_link] environment
+* Timer funtionality to indicate rotation
+* Ability to tell who is the driver, navigator and mobsters
+
+### Instructions For Use
+TODO
+
+### Gems and Dependencies
+* Ruby 2.1.2
+* RSpec
+
+### Upcoming Features
+* Timer
+* Randomization of Driver/Navigator
+* Browser-based GUI
+
+### Additional Resources
+* <http://mobprogramming.org/>
+
+### Credits
+TODO
+
+[mob_wiki_link]: http://en.wikipedia.org/wiki/Mob_programming

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/mob_rotation

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+require "mob_rotation"
+
+file_name = ENV["DB_FILE"] || "rotate.txt"
+command = ARGV[0] || "show"
+mobster_names = ARGV[1..-1]
+git_dir = ENV["MOB_GIT_DIR"] || File.join(Dir.pwd, ".git")
+
+mob_rotator = MobRotation::Rotation.new(
+                MobRotation::Database.new(file_name),
+                git_dir
+              )
+mob_rotator.command_router(command, mobster_names)

data/lib/mob_rotation.rb

@@ -0,0 +1,7 @@
+require "mob_rotation/version"
+require "mob_rotation/database"
+require "mob_rotation/rotation"
+
+# Manage a mob list during a mobbing session
+module MobRotation
+end

data/lib/mob_rotation/command_routing.rb

@@ -0,0 +1,29 @@
+module MobRotation
+  module CommandRouting
+    COMMAND_MAPPINGS = {}
+
+    module ClassMethods
+      def define_command(name, &block)
+        CommandRouting::COMMAND_MAPPINGS[name] = block
+      end
+    end
+
+    def command_router(command, mobster_names)
+      command_implementation = CommandRouting::COMMAND_MAPPINGS.fetch(command) {
+        lambda { |command|
+          inform_lovely_user(command)
+        }
+      }
+      case command_implementation.arity
+      when -2
+        instance_exec(command, *mobster_names, &command_implementation)
+      when -1
+        instance_exec(*mobster_names, &command_implementation)
+      when 1
+        instance_exec(command, &command_implementation)
+      else
+        instance_exec(&command_implementation)
+      end
+    end
+  end
+end

data/lib/mob_rotation/database.rb

@@ -0,0 +1,32 @@
+require "fileutils"
+
+module MobRotation
+  class Database
+    def sanitized_entries_in
+      each_database_entry(@filename) do |entry|
+        yield(entry.to_s.strip)
+      end
+    end
+
+    def initialize(filename)
+      @filename = filename
+      FileUtils.touch(filename) unless File.exist?(filename)
+    end
+
+    def write(mobsters)
+      File.open(@filename, "w") do |file|
+        mobsters.each do |mobster|
+          file << format_mobster(mobster.name, mobster.email) << "\n"
+        end
+      end
+    end
+
+    def format_mobster(name, email)
+      name + (" <#{email}>" if email && !email.empty?).to_s
+    end
+
+    def each_database_entry(filename)
+      File.readlines(filename).collect { |entry| yield(entry) }
+    end
+  end
+end

data/lib/mob_rotation/mobster.rb

@@ -0,0 +1,12 @@
+module MobRotation
+  class Mobster
+    attr_reader :name, :email
+
+    def initialize(name, email = nil)
+      @name = name
+      @email = email
+    end
+
+    alias_method :to_s, :name
+  end
+end

data/lib/mob_rotation/rotation.rb

@@ -0,0 +1,210 @@
+require "time"
+require "mob_rotation/command_routing"
+require "mob_rotation/mobster"
+
+module MobRotation
+  class Rotation
+    include CommandRouting
+    extend CommandRouting::ClassMethods
+
+    define_command("show") do
+      show_mobsters
+    end
+
+    define_command("run_with_timer") do
+      countdown_to_rotate(ARGV[1].to_i)
+    end
+
+    define_command("rotate") do
+      rotate
+      show_mobsters
+    end
+
+    define_command("random") do
+      random(ARGV[1])
+      show_mobsters
+    end
+
+    define_command("add") do |*mobster_names|
+      add_mobster(*mobster_names)
+      show_mobsters
+    end
+
+    define_command("remove") do |*mobster_names|
+      remove_mobsters(*mobster_names)
+      show_mobsters
+    end
+
+    define_command("help") do
+      show_help
+    end
+
+    def self.annoying_and_probably_not_accidental_beep(n = number_of_beeps)
+      n.times { print("\a") || sleep(minimum_sleep_between_beeps) }
+    end
+
+    def self.minimum_sleep_between_beeps
+      0.2
+    end
+
+    def self.number_of_beeps
+      5
+    end
+
+    def initialize(database, git_dir)
+      @git_dir = git_dir
+      @database = database
+      @real_mobsters = @database.sanitized_entries_in do | entry |
+        build_mobster(entry)
+      end
+    end
+
+    def build_mobster(entry)
+      name = extract_name_from(entry)
+      email = extract_email_from(entry)
+      Mobster.new(name, email)
+    end
+
+    def extract_email_from(entry)
+      if entry =~ /\<(.*)\>/
+        Regexp.last_match[1]
+      end
+    end
+
+    def write(text)
+      puts(text)
+    end
+
+    def show_mobsters
+      @real_mobsters.each_with_index do |person, index|
+        case index
+        when 0
+          write("git username: #{person.name}")
+          write("git user email: #{person.email}")
+          format_mobster("Driver", person)
+        when 1
+          format_mobster("Navigator", person)
+        else
+          format_mobster("Mobster", person)
+        end
+      end
+    end
+
+    def format_mobster(role, person)
+      if person.email.to_s.empty?
+        write("#{role} #{person.name}")
+      else
+        write("#{role} #{person.name.strip} <#{person.email.strip}>")
+      end
+    end
+
+    def add_mobster(*mobsters_to_add)
+      mobsters_to_add.collect(&:to_s).collect(&:strip).each do |mobster_to_add|
+        fail if mobster_to_add.empty?
+
+        if @real_mobsters.collect(&:name).include?(mobster_to_add)
+          write("user name '#{mobster_to_add}' already exists")
+          next
+        end
+
+        @real_mobsters << Mobster.new(mobster_to_add)
+      end
+
+      sync
+    end
+
+    def remove_mobster(given_mobster)
+      @real_mobsters.each_with_index do |mobster, i|
+        if found_mobster(mobster, given_mobster)
+          @real_mobsters.delete_at(i)
+        end
+      end
+      sync
+    end
+
+    def remove_mobsters(*mobsters)
+      mobsters.each do |mobster|
+        remove_mobster(mobster)
+      end
+    end
+
+    def show_help
+      puts ["Available commands are:",
+            "show",
+            "help",
+            "rotate",
+            "random",
+            "add <name1> [name2]",
+            "remove <name1> [name2]",
+            "run_with_timer [seconds]"
+           ]
+    end
+
+
+    def countdown_to_rotate(seconds = 300)
+      sleep(seconds)
+      puts("Time to rotate")
+      self.class.annoying_and_probably_not_accidental_beep
+    end
+
+    def inform_lovely_user(command)
+      puts("Unknown command #{command}")
+      show_help
+    end
+
+    def rotate_mobsters(&rotation_algorithm)
+      rotation_algorithm.call
+      git_config_update
+      sync
+    end
+
+    def rotate
+      puts("")
+      rotate_mobsters do
+        @real_mobsters << @real_mobsters.shift
+      end
+    end
+
+    def random(seed = nil)
+      puts("Randomized Output")
+      rotate_mobsters do
+        srand(seed.to_i) if seed
+        @real_mobsters.shuffle!
+      end
+    end
+
+    def extract_next_mobster_email
+      email = @real_mobsters.first.email.to_s.strip
+      email.empty? ? "mob@rubysteps.com" : email
+    end
+
+    def time_to_rotate
+      puts("Time to rotate!")
+    end
+
+    private
+
+    def git_config_update
+      # FIX yo that rescue nil is bogus
+      system(git_config_for("name", @real_mobsters.first.name)) rescue nil
+      system(git_config_for("email", extract_next_mobster_email)) rescue nil
+    end
+
+    def git_config_for(property, value)
+      "git --git-dir=#{@git_dir} config user.#{property} '#{value}'"
+    end
+
+    def sync
+      @database.write(@real_mobsters)
+    end
+
+    def found_mobster(line, mobster)
+      line.to_s.strip == mobster.to_s
+    end
+
+    def extract_name_from(entry)
+      entry_to_array = entry.split("")
+      entry_to_array.take_while { |c| c != "<" }.join("")
+    end
+  end
+end

data/lib/mob_rotation/version.rb

@@ -0,0 +1,3 @@
+module MobRotation
+  VERSION = "0.1.0"
+end

data/mob_rotation.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "mob_rotation/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "mob_rotation"
+  spec.version       = MobRotation::VERSION
+  spec.authors       = ["Pat Maddox"]
+  spec.email         = ["pat@rubysteps.com"]
+  spec.summary       = "Manage a mob list during a mobbing session"
+  spec.description   = "Provides an executable to manage a mob list"
+  spec.homepage      = "https://github.com/RubySteps/mob_rotation"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.1"
+end

data/spec/foo_fighter_spec.rb

@@ -0,0 +1,31 @@
+require "spec_helper"
+
+describe FooFighter do
+  it "raises an error when a class defines `#foo`" do
+    expect {
+      class TestClass
+        extend FooFighter
+
+        def foo
+          "shouldn't work"
+        end
+      end
+    }.to raise_error(/no foo for you/)
+  end
+
+  it "removes a method named `#foo`" do
+    begin
+      class TestClass2
+        extend FooFighter
+
+        def foo
+          "shouldn't work"
+        end
+      end
+    rescue => e
+      # no-op
+    ensure
+      expect(TestClass2.instance_methods - Object.methods).to_not include(:foo)
+    end
+  end
+end

data/spec/mob_rotation_executable_spec.rb

@@ -0,0 +1,324 @@
+require "fileutils"
+require "timeout"
+require "mob_rotation"
+
+describe "mob_rotation command line tool" do
+  let(:temp_rotation_db) { "/tmp/rotation_test.txt" }
+
+  before do
+    `rm -rf ./tmp/test_project`
+    `mkdir -p ./tmp/test_project`
+    `git init ./tmp/test_project`
+  end
+
+  def remove_temp_rotation_db
+    FileUtils.rm(temp_rotation_db) if File.exist?(temp_rotation_db)
+  end
+
+  def add_name_and_email_to_temp_db(name, email = nil)
+    s = email ? " <#{email}>" : ""
+    `echo "#{name} #{s}" >> #{temp_rotation_db}`
+  end
+
+  before do
+    remove_temp_rotation_db
+
+    add_name_and_email_to_temp_db("Bob")
+    add_name_and_email_to_temp_db("Phoebe")
+  end
+
+  def run_rotate(command = nil)
+    run_rotate_with_specified_redirect(command, "> /tmp/results.txt")
+  end
+
+  def run_rotate_with_specified_redirect(command = nil, redirect = nil)
+    # TODO: we have no idea why this is necessary, and don't like it
+    @our_output = nil
+
+    `MOB_GIT_DIR='./tmp/test_project/.git' DB_FILE='#{temp_rotation_db}' #{RbConfig.ruby} #{File.join(Dir.pwd, "bin/mob_rotation")}  #{command} #{redirect}`
+  end
+
+  def our_output
+    @our_output ||= File.readlines("/tmp/results.txt").collect(&:strip)
+      .reject(&:empty?)
+  end
+
+  context "command: ruby mob_rotation" do
+    it "defaults to 'rotate.txt' when no database file is specified" do
+      if backup = File.exist?("./rotate.txt")
+        FileUtils.mv("./rotate.txt", "./rotate.txt.backup")
+      end
+      FileUtils.cp(temp_rotation_db, "./rotate.txt")
+      `#{RbConfig.ruby} #{File.join(Dir.pwd, "bin/mob_rotation")} > /tmp/results.txt`
+      begin
+        expect(our_output).to include("Driver Bob", "Navigator Phoebe")
+      ensure
+        FileUtils.mv("./rotate.txt.backup", "./rotate.txt") if backup
+      end
+    end
+
+    it "prints out the rotation order" do
+      run_rotate
+      expect(our_output).to include("Driver Bob", "Navigator Phoebe")
+    end
+  end
+
+  context "command: ruby mob_rotation help" do
+    it "prints out help" do
+      run_rotate("help")
+      expected = ["Available commands are:",
+                  "show",
+                  "help",
+                  "rotate",
+                  "random",
+                  "add <name1> [name2]",
+                  "remove <name1> [name2]",
+                  "run_with_timer [seconds]"
+                 ]
+
+      expect(our_output).to eq(expected)
+    end
+  end
+
+  context "command: ruby mob_rotation arbitrary" do
+    it "prints out help on an unknown command" do
+      run_rotate("arbitrary")
+      expected = ["Unknown command arbitrary",
+                  "Available commands are:"
+                 ]
+
+      expect(our_output).to include(*expected)
+    end
+  end
+
+  context "command: ruby mob_rotation random" do
+    it "Identifies list as randomized" do
+      run_rotate("random 1")
+
+      expect(our_output).to include("Randomized Output")
+      expect(our_output).to include("Driver Bob", "Navigator Phoebe")
+    end
+
+    it "produces a different order with a different seed" do
+      run_rotate("random 0")
+
+      expect(our_output).to include("Driver Phoebe", "Navigator Bob")
+    end
+
+    it "saves the rotation order" do
+      run_rotate("random 0")
+      run_rotate
+
+      expect(our_output).to include("Driver Phoebe", "Navigator Bob")
+    end
+
+    it "updates the git username" do
+      remove_temp_rotation_db
+      add_name_and_email_to_temp_db("Bob Example", "bob@example.com")
+      add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+
+      run_rotate("random 0")
+
+      git_username = `git --git-dir=./tmp/test_project/.git config user.name`
+        .strip
+      expect(git_username).to eq("Phoebe Example")
+    end
+  end
+
+  context "command: ruby mob_rotation rotate" do
+    it "changes the order of rotation" do
+      run_rotate("rotate")
+      expect(our_output).to include("Driver Phoebe", "Navigator Bob")
+    end
+
+    describe "git stuff" do
+      it "includes the email addresses in rotation output" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+        add_name_and_email_to_temp_db("Bob Example", "bob@example.com")
+        add_name_and_email_to_temp_db("Joe Example", "joe@example.com")
+        run_rotate("rotate")
+
+        expect(our_output).to include(
+          "Driver Bob Example <bob@example.com>",
+          "Navigator Joe Example <joe@example.com>",
+          "Mobster Phoebe Example <phoebe@example.com>"
+        )
+      end
+
+      it "outputs the new git username when running rotate" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example")
+
+        run_rotate("rotate")
+
+        expect(our_output).to include(
+          "git username: Phoebe Example",
+          "Driver Phoebe Example"
+        )
+      end
+
+      it "outputs the new git email when running rotate" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+
+        run_rotate "rotate"
+
+        expect(our_output).to include("git user email: phoebe@example.com")
+
+        add_name_and_email_to_temp_db(
+          "David Example",
+          "david-example@example.com"
+        )
+
+        run_rotate("rotate")
+
+        expect(our_output).to include(
+          "git user email: david-example@example.com"
+        )
+      end
+
+      it "outputs the new git email when rotating a list of multiple users" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+        add_name_and_email_to_temp_db("David Example", "david@example.com")
+
+        run_rotate("rotate")
+
+        expect(our_output).to include("git user email: david@example.com")
+      end
+
+      it "updates the git user.name config when running rotate" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+
+        run_rotate("rotate")
+
+        git_username = `git --git-dir=./tmp/test_project/.git config user.name`
+          .strip
+        expect(git_username).to eq("Phoebe Example")
+      end
+
+      it "updates the git user.email config when running rotate" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+
+        run_rotate("rotate")
+
+        git_email = `git --git-dir=./tmp/test_project/.git config user.email`
+          .strip
+        expect(git_email).to eq("phoebe@example.com")
+      end
+
+      it "updates the email in the mobsters database when rotating" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+        add_name_and_email_to_temp_db("Bob Example" "bob@example.com")
+        add_name_and_email_to_temp_db("Joe Example", "joe@example.com")
+
+        run_rotate("rotate")
+        run_rotate("rotate")
+
+        git_email = `git --git-dir=./tmp/test_project/.git config user.email`
+          .strip
+        expect(git_email).to eq("joe@example.com")
+      end
+
+      it "falls back to a default email address when the driver has none" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+        add_name_and_email_to_temp_db("Bob Example")
+
+        run_rotate("rotate")
+
+        git_email = `git --git-dir=./tmp/test_project/.git config user.email`
+          .strip
+        expect(git_email).to eq("mob@rubysteps.com")
+      end
+
+      it "updates the email in the mobsters database when rotating, even when someone's missing an email address" do
+        remove_temp_rotation_db
+        add_name_and_email_to_temp_db("Phoebe Example", "phoebe@example.com")
+        add_name_and_email_to_temp_db("Bob Example")
+        add_name_and_email_to_temp_db("Joe Example", "joe@example.com")
+
+        run_rotate("rotate")
+        run_rotate("rotate")
+
+        git_email = `git --git-dir=./tmp/test_project/.git config user.email`
+          .strip
+        expect(git_email).to eq("joe@example.com")
+      end
+    end
+  end
+
+  context "command: ruby mob_rotation add one_name [two three]" do
+    it "adds one mobster to the mob list" do
+      run_rotate("add Joe")
+      expect(our_output).to include(
+        "Driver Bob",
+        "Navigator Phoebe",
+        "Mobster Joe"
+      )
+    end
+
+    it "adds multiple mobsters at once" do
+      run_rotate("add Phil Steve")
+      expect(our_output).to include("Mobster Phil", "Mobster Steve")
+    end
+
+    it "new name cannot match existing name" do
+      run_rotate("add Ralph")
+      run_rotate("add Ralph")
+
+      expect(our_output).to include("user name 'Ralph' already exists")
+      expect(our_output.select { |l| l.include?("Ralph") }.size).to eq(2)
+    end
+  end
+
+  context "command: ruby mob_rotation remove one_name [two three]" do
+    it "removes one mobster from the mob list" do
+      run_rotate("remove Bob")
+      expect(our_output).to include("Driver Phoebe")
+    end
+
+    it "removes multiple mobsters at once" do
+      # TODO: Doesn't test what it claims to test.
+      run_rotate("add Phil")
+      run_rotate("remove Bob Phoebe")
+      expect(our_output).to include("Driver Phil")
+    end
+  end
+
+  context "command: ruby mob_rotation run_with_timer N" do
+    it "it runs for a specific amount of time" do
+      ts = Time.now
+      run_rotate("run_with_timer 3")
+      tf = Time.now
+      threshold = 3.0 + MobRotation::Rotation.minimum_sleep_between_beeps * MobRotation::Rotation.number_of_beeps
+      expect(tf - ts).to be_within(1).of(threshold)
+      expect(our_output).to include("Time to rotate")
+    end
+
+    it "waits until time runs out before stating 'Time to Rotate'" do
+      expect {
+        Timeout.timeout(1) { run_rotate("run_with_timer 5") }
+      }.to raise_error(Timeout::Error)
+      expect(our_output).to eq([])
+    end
+
+    it "notifies with a beep" do
+      stdout_output = run_rotate_with_specified_redirect("run_with_timer")
+      expect(stdout_output).to include("\a")
+    end
+
+    it "runs for a specified amount of time and then notifies with a beep" do
+      ts = Time.now
+      stdout_output = run_rotate_with_specified_redirect("run_with_timer 2")
+      tf = Time.now
+      expect(tf - ts).to be_within(1).of(2.0 + MobRotation::Rotation.minimum_sleep_between_beeps * MobRotation::Rotation.number_of_beeps)
+      expect(stdout_output).to include("Time to rotate")
+      expect(stdout_output).to include("\a")
+    end
+  end
+end

data/spec/rotation_spec.rb

@@ -0,0 +1,129 @@
+require "spec_helper"
+
+describe MobRotation::Rotation do
+  extend FooFighter
+
+  let(:mob_rotator) {
+    MobRotation::Rotation.new(
+      MobRotation::Database.new(file_name),
+      "./tmp/test_project/.git"
+    )
+  }
+
+  before { FileUtils.rm_f(file_name) }
+
+  describe "#show_mobsters" do
+    let(:file_name) { "test.txt" }
+    let(:output) { Output.new }
+
+    before do
+      File.open(file_name, "w") do |file|
+        file << "Bob\n" << "Phoebe\n" << "Joe\n"
+      end
+
+      $stdout = output
+
+      mob_rotator.show_mobsters
+    end
+
+    it "print out all the mobsters in the text file" do
+      expect(output.mobsters.join).to include("Mobster Joe")
+    end
+
+    it "prints out driver" do
+      expect(output.mobsters.join).to include("Driver Bob")
+    end
+
+    it "prints out navigator" do
+      expect(output.mobsters.join).to include("Navigator Phoebe")
+    end
+  end
+
+  describe "#add_mobster" do
+    let(:file_name) { "test.txt" }
+
+    it "adds a mobster to the file" do
+      mob_rotator.add_mobster("Jackie")
+      mob_rotator.add_mobster("Phil")
+
+      expect(File.read(file_name)).to eq("Jackie\nPhil\n")
+    end
+
+    it "accepts more than one mobster" do
+      mob_rotator.add_mobster("Jackie", "Phil")
+      expect(File.read(file_name)).to include("\nPhil")
+    end
+
+    it "skips adding duplicate mobster name" do
+      mob_rotator.add_mobster("Rosie", "Rosie")
+      expect(File.read(file_name)).to eq("Rosie\n")
+    end
+
+    it "strips leading and trailing whitespace" do
+      mob_rotator.add_mobster(" \n   Rosie  \n  ")
+      expect(File.read(file_name)).to eq("Rosie\n")
+    end
+
+    it "does not allow blank usernames" do
+      expect { mob_rotator.add_mobster(" ") }
+        .to raise_error
+    end
+  end
+
+  describe "#remove_mobster" do
+    let(:file_name) { "test_remove.txt" }
+
+    before do
+      File.open(file_name, "w") do |file|
+        file << "Bob\n" << "Phoebe\n" << "Joe"
+      end
+    end
+
+    it "removes a mobster from the file" do
+      mob_rotator.remove_mobster("Bob")
+      expect(File.read(file_name)).not_to include("Bob")
+    end
+  end
+
+  describe "#rotate" do
+    let(:file_name) { "test_remove.txt" }
+
+    before do
+      File.open(file_name, "w") do |file|
+        file << "Bob\n" << "Phoebe\n" << "Joe\n"
+      end
+    end
+
+    it "rotates mobsters" do
+      mob_rotator.rotate
+      # new file to equal "Phoebe Joe Bob"
+      expect(File.read(file_name)).to eq("Phoebe\nJoe\nBob\n")
+    end
+  end
+
+  describe "#extract_email_from(entry)" do
+    let(:file_name) { "irrelevant_file" }
+
+    after(:each) do
+      FileUtils.rm_f(file_name)
+    end
+
+    it "returns the email address" do
+      email = MobRotation::Rotation.new(
+        MobRotation::Database.new(file_name),
+        "irrelevant git dir"
+      ).extract_email_from("a <b@example.com>")
+
+      expect(email).to eq("b@example.com")
+    end
+
+    it "it handles arbitary email addresses" do
+      email = MobRotation::Rotation.new(
+        MobRotation::Database.new(file_name),
+        "irrelevant git dir"
+      ).extract_email_from("bob <bob@example.com>")
+
+      expect(email).to eq("bob@example.com")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+require "fileutils"
+require "mob_rotation"
+
+class Output
+  attr_accessor :mobsters
+
+  def write(argument)
+    @mobsters ||= []
+    @mobsters << argument
+  end
+end
+
+module FooFighter
+  def method_added(m)
+    return unless m.to_s == "foo"
+    remove_method(m)
+    fail("no foo for you")
+  end
+end

data/todo.md

@@ -0,0 +1,113 @@
+- get a real test environment separated from production
+- add email git config on rotate DONE
+- in our tests change directory when running command line stuff
+- get the tests passing DONE
+- clean up this working directory
+- rename unit and acceptance tests to be more intuitive (maybe)
+- refactor MobRotation#initialize to read file once
+- refactor MobRotation#initialize to use either 2 class methods or 2 instance methods (extract_<something>_from)
+- add hook to emacs configuration to automatically show line numbers in (all?) files - DONE
+- match pattern on remove (like remove Jacq*)
+- shuffle the mobsters
+- move test output to ./tmp instead of /tmp
+- move todo/features to git issues/ clean up todo
+- Timer
+
+help w/o specifying database
+make main class match file name **** Done
+lots of commented out code in mob_rotation executable *** Done
+refactor case statement***
+include role information in database file
+#add_mobster takes multiple mobsters
+explicit path in acceptance tests only works on the mob station
+auto-generate help based on known commands *
+broken tests break production rotate.txt file - DONE
+
+delete Timer *** DONE
+each_with_index ? in remove_mobster ... * DONE
+known default database file, overridable * WIP
+refactor add_mobster to use sync!* DONE
+Tmux integration: powerline 
+refactor to mob commands vs timer class (and stuff like that :) **
+too much going on in mob_rotation executable? *
+add run_with_timer to help.
+
+
+
+Break functions out of mob_rotation.rb (God class)
+clean up directory structure...**
+do all the tests pass???****
+understand what it actually does...?
+play firecrackers whenever we rotate ***
+prevent non-driver from interacting w/ terminal
+get more information / permissions about participants (class-based?)
+include the project history in README
+create a README********
+abandon this and move on to something
+start a new project
+build a browser-based gui
+randomize driver / navigator (with limits) **
+record a history of rotation
+designated driver
+
+
+
+TODO
+- Unrecognized commands show help DONE
+- Timer! *
+
+Fails: ruby mob_rotation asdf cows
+
+____
+
+Add/remove multiple mobsters in one call**
+Timer ****
+Detect mobsters
+Tmux integration: powerline *
+
+
+# Time.now() == 7min ->timeisup!
+
+# naming acceptance ... again!~~~
+# No Readme file ~~~
+# End goal of the app ~~~
+# add a timer feature ~~~
+# is this going to stay a CLI, gem, rails app feature? Forward direction? ~~
+
+# introduce helper spec~
+# separate implementation from script~
+# organizing cli vs unit specs ~
+# Common structure for running tests
+# our 'clean state' isnt that clean. Lots of duplicate files from before
+
+
+
+# DONE adding remove mobster feature ----
+# naming the acteptance---
+# add timer feature---
+# refactor to dependency injection --
+# seperating implementation from the script --
+# connect the app with ruby lobby api * -
+# add new api via CLI-
+# introducing helper_spec(moving)-
+
+# do we keep features that are done or move to changelog?
+# focus on refactoring vs adding features?
+# adding directory structure
+
+# DONE show mobster should display who navigates and who is driver ****
+# DONE method to add
+# remove mobsters ***
+# remove dependency to / with file ***
+# DONE give the describe block a name **
+# operating on standard out... would it be worth it to refactor? **
+# DONE change it statement... don't know what the subject is *
+
+# --------
+
+# store more mata data in db file(rotation time...)
+# write specs for next method rotate?
+# how important is it really?
+# could change spec to add more meaning
+# removing time_to_rotate
+

data/woot_camp_todo.md

@@ -0,0 +1,28 @@
+* establish behavior in the tests ***** DONE
+* pending tests drive the team nuts **** DONE
+
+* what happens when two people have the same name? ****  DONE
+
+* blank user for no apparent reason *** DONE
+* name with trailing whitespace? DONE
+
+
+* disappearing emails...
+* some emails nil, some blank?
+
+* what should rotate do if next user has no email?
+* encapsulate the mobster class DONE
+
+
+
+BUGS
+
+
+IDEA
+
+* gemify so that we can run a stable version while developing
+* erase production db?
+* check email format
+* validate email for GitHub user
+
+* exchange twitter / email contact info (team)

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: mob_rotation
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Pat Maddox
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !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.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: Provides an executable to manage a mob list
+email:
+- pat@rubysteps.com
+executables:
+- mob_rotation
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Changelog.md
+- Contributors.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/mob_rotation
+- lib/mob_rotation.rb
+- lib/mob_rotation/command_routing.rb
+- lib/mob_rotation/database.rb
+- lib/mob_rotation/mobster.rb
+- lib/mob_rotation/rotation.rb
+- lib/mob_rotation/version.rb
+- mob_rotation.gemspec
+- spec/foo_fighter_spec.rb
+- spec/mob_rotation_executable_spec.rb
+- spec/rotation_spec.rb
+- spec/spec_helper.rb
+- todo.md
+- woot_camp_todo.md
+homepage: https://github.com/RubySteps/mob_rotation
+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: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Manage a mob list during a mobbing session
+test_files:
+- spec/foo_fighter_spec.rb
+- spec/mob_rotation_executable_spec.rb
+- spec/rotation_spec.rb
+- spec/spec_helper.rb