flappinator 0.0.1

data/README.md

@@ -0,0 +1,23 @@
+# flappinator
+
+A command-line utility to help debug flapping processes, including tests.
+
+## Installation
+
+```bash
+gem install flappinator
+```
+
+## Usage
+
+The flappinator repeats any given command a number of times (25 by default). When it fails, the command's output is displayed.
+
+```bash
+flappinator [ --repetitions=TIMES ] COMMAND
+```
+
+For example:
+
+```bash
+flappinator rspec spec/models/flapping_spec.rb
+```

data/bin/flappinator

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'flappinator'
+Flappinator.start(ARGV)

data/lib/flappinator.rb

@@ -0,0 +1,11 @@
+require_relative 'flappinator/options'
+require_relative 'flappinator/runner'
+
+module Flappinator
+  def self.start(args)
+    options = Flappinator::Options.new(args)
+    options.parse!
+
+    Flappinator::Runner.start(options)
+  end
+end

data/lib/flappinator/options.rb

@@ -0,0 +1,40 @@
+require 'optparse'
+
+module Flappinator
+  class Options
+    attr_reader :command,
+                :repetitions
+
+    def initialize(args)
+      @args = args
+      @command = []
+      @repetitions = 25
+    end
+
+    def parse!
+      # Duplicate the arguments, as parsing is destructive.
+      args = @args.dup
+      parser.parse!(args)
+      # Assign the remaining unparsed arguments (the COMMAND).
+      @command = args
+      raise ArgumentError if @command.empty?
+    end
+
+  private
+
+    def parser
+      OptionParser.new do |parser|
+        parser.banner = 'Usage: flappinator [ options ] COMMAND'
+
+        parser.on('-r', '--repetitions=TIMES', Integer, 'Number of repetitions') do |times|
+          @repetitions = times
+        end
+
+        parser.on_tail('-h', '--help', 'Show this message') do
+          puts parser
+          exit
+        end
+      end
+    end
+  end
+end

data/lib/flappinator/runner.rb

@@ -0,0 +1,76 @@
+require 'childprocess'
+require 'ruby-progressbar'
+require 'forwardable'
+require 'tempfile'
+
+module Flappinator
+  class Runner
+    def self.start(options)
+      @options = options
+
+      progress_bar
+
+      runs = @options.repetitions.times.map do |index|
+        new(@options.command).tap do |runner|
+          runner.run
+          log(runner.output) if runner.failed?
+          increment
+        end
+      end
+
+      summarize(runs)
+    end
+
+    def self.progress_bar
+      @progress_bar ||= ProgressBar.create(
+        :title       => @options.command.join(' '),
+        :total       => @options.repetitions,
+        :format      => '%t %E %w'
+      )
+    end
+
+    def self.log(output)
+      output += "\n"
+      progress_bar.log(output)
+    end
+
+    def self.increment
+      # Work around a small display bug where intermittently the percentage
+      # shown is one frame behind:
+      sleep 0.1
+      progress_bar.increment
+    end
+
+    def self.summarize(runs)
+      puts "\nSuccess: #{runs.count(&:success?)}"
+      puts "Failed: #{runs.count(&:failed?)}"
+    end
+
+    def initialize(command)
+      @command = command
+      @process = ChildProcess.build(*@command)
+      @io = Tempfile.new('flappinator')
+    end
+
+    def run
+      @process.io.stdout = @io
+      @process.io.stderr = @io
+      @process.start
+      @process.wait
+    end
+
+    def output
+      @io.close
+      @io.open
+      @io.read
+    end
+
+    def success?
+      !@process.crashed?
+    end
+
+    def failed?
+      @process.crashed?
+    end
+  end
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: flappinator
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Todd Mazierski
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-progressbar
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: childprocess
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A command-line utility to help debug flapping processes, including tests.
+email:
+- todd@generalassemb.ly
+executables:
+- flappinator
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/flappinator/runner.rb
+- lib/flappinator/options.rb
+- lib/flappinator.rb
+- bin/flappinator
+homepage: https://github.com/toddmazierski/flappinator
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A command-line utility to help debug flapping processes, including tests.
+test_files: []