respec 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+/*.gem

data/CHANGELOG

@@ -0,0 +1,3 @@
+== 0.0.1 2012-05-17
+
+ * Hi.

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) George Ogata
+
+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.markdown

@@ -0,0 +1,63 @@
+## Respec
+
+Provides a command, `respec`, which wraps `rspec`, and records your
+failing examples for easy rerunning.
+
+## How?
+
+Run your specs:
+
+    respec
+
+3 fail. Rerun just the 3 failures like this:
+
+    respec f
+
+Need to debug failure #1? Pop a `debugger` in your code, and rerun it
+like this:
+
+    respec 1
+
+This will just rerun failure 1. Once it's passing, rerun the 3 failing
+examples again:
+
+    respec f
+
+1 is now fixed, but 2 and 3 are still failing - `respec f` will now
+only run failures 2 and 3 again.
+
+## How it works
+
+All that's happening is the list of failed examples is being recorded
+in a file (`.respec_failures`). The `f` argument means "run these
+recorded failures only." A numeric argument like `1` means "just run
+that failure."
+
+The list of failed examples is always updated _except_ when selecting
+which failures to rerun with a number (more than one number can also
+be given, incidentally).
+
+## Other tricks
+
+You can pass `respec` file or directory names, just like
+`rspec`. However, you can also just specify example names on the
+command line:
+
+    respec 'My example name'
+
+If the argument doesn't name an existing file, it's assumed to be an
+example name.
+
+There are a few other shortcuts. Do `respec --help` to see them all.
+
+## Contributing
+
+ * [Bug reports](https://github.com/oggy/respec/issues)
+ * [Source](https://github.com/oggy/respec)
+ * Patches: Fork on Github, send pull request.
+   * Include tests where practical.
+   * Leave the version alone, or bump it in a separate commit.
+
+## Copyright
+
+Copyright (c) George Ogata. See LICENSE for details.

data/Rakefile

@@ -0,0 +1 @@
+require 'ritual'

data/bin/respec

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'respec'
+
+app = Respec::App.new(*ARGV)
+if app.help_only?
+  STDERR.puts app.help
+else
+  STDERR.puts "++ #{app.command.join(' ')}"
+  exec *app.command
+end

data/lib/respec.rb

@@ -0,0 +1,5 @@
+module Respec
+  autoload :VERSION, 'respec/version'
+  autoload :App, 'respec/app'
+  autoload :Formatter, 'respec/formatter'
+end

data/lib/respec/app.rb

@@ -0,0 +1,117 @@
+module Respec
+  class App
+    def initialize(*args)
+      if (i = args.index('--'))
+        @args = args.slice!(0...i)
+        @raw_args = args[1..-1]
+      else
+        @args = args
+        @raw_args = []
+      end
+      @formatter = 'progress'
+      @output_failures = true
+      process_args
+    end
+
+    def command
+      @command ||= ['rspec'] + formatter_args + generated_args + raw_args
+    end
+
+    def formatter_args
+      if @output_failures
+        formatter_path = File.expand_path('formatter.rb', File.dirname(__FILE__))
+        ['--require', formatter_path, '--format', 'Respec::Formatter', '--out', failures_path, '--format', @formatter]
+      else
+        []
+      end
+    end
+
+    attr_reader :generated_args, :raw_args
+
+    class << self
+      attr_accessor :failures_path
+    end
+    self.failures_path = ENV['RESPEC_FAILURES'] || File.expand_path("~/.respec_failures")
+
+    def help_only?
+      @help_only
+    end
+
+    def help
+      <<-EOS.gsub(/^ *\|/, '')
+        |USAGE: respec RESPEC-ARGS ... [ -- RSPEC-ARGS ... ]
+        |
+        |Run rspec recording failed examples for easy rerunning later.
+        |
+        |RESPEC-ARGS may consist of:
+        |
+        |  f            Rerun all failed examples
+        |  <integer>    Rerun only the n-th failure
+        |  s            Output specdoc format, instead of progress
+        |  c            Output context diffs
+        |  <file name>  Run specs in these files
+        |  <other>      Run only examples matching this pattern
+        |  --help       This!  (Also 'help'.)
+        |
+        |RSPEC-ARGS may follow a '--' argument, and are passed
+        |directly to rspec.
+        |
+        |More info: http://github.com/oggy/respec
+      EOS
+    end
+
+    private
+
+    def process_args
+      args = []
+      files = []
+      @args.each do |arg|
+        if File.exist?(arg)
+          files << arg
+        elsif arg =~ /\A(--)?help\z/
+          @help_only = true
+        elsif arg == 'f'
+          if File.exist?(failures_path)
+            if failures.empty?
+              abort "No specs failed!"
+            else
+              failures.each do |line|
+                args << line.strip
+              end
+            end
+          else
+            warn "no fail file - ignoring 'f' argument"
+          end
+        elsif arg == 's'
+          @formatter = 'specdoc'
+        elsif arg == 'c'
+          args << '--diff' << 'context'
+        elsif arg =~ /\A\d+\z/
+          i = Integer(arg)
+          if (failure = failures[i - 1])
+            args << failure
+            @output_failures = false
+          else
+            warn "invalid failure: #{i} for (1..#{failures.size})"
+          end
+        else
+          args << '--example' << arg.gsub(/[$]/, '\\\\\\0')
+        end
+      end
+      @generated_args = args + files
+    end
+
+    def failures_path
+      self.class.failures_path
+    end
+
+    def failures
+      @failures ||=
+        if File.exist?(failures_path)
+          File.read(failures_path).split(/\n/)
+        else
+          []
+        end
+    end
+  end
+end

data/lib/respec/formatter.rb

@@ -0,0 +1,11 @@
+require 'rspec/core/formatters/base_formatter'
+
+module Respec
+  class Formatter < RSpec::Core::Formatters::BaseFormatter
+    def start_dump
+      @failed_examples.each do |example|
+        output.puts example.metadata[:location]
+      end
+    end
+  end
+end

data/lib/respec/version.rb

@@ -0,0 +1,11 @@
+module Respec
+  VERSION = [0, 0, 1]
+
+  class << VERSION
+    include Comparable
+
+    def to_s
+      join('.')
+    end
+  end
+end

data/respec.gemspec

@@ -0,0 +1,17 @@
+$:.unshift File.expand_path('lib', File.dirname(__FILE__))
+require 'respec/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'respec'
+  gem.version       = Respec::VERSION
+  gem.authors       = ['George Ogata']
+  gem.email         = ['george.ogata@gmail.com']
+  gem.summary       = "Rerun failing RSpec examples easily."
+  gem.homepage      = 'http://github.com/oggy/respec'
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  gem.add_development_dependency 'ritual', '~> 0.4.0'
+end

data/spec/integration_spec.rb

@@ -0,0 +1,49 @@
+require_relative 'spec_helper'
+require 'rbconfig'
+
+describe Respec do
+  CONFIG = (Object.const_defined?(:RbConfig) ? RbConfig : Config)::CONFIG
+  def respec(args)
+    ruby = File.join(CONFIG['bindir'], CONFIG['ruby_install_name'])
+    respec = "#{ROOT}/bin/respec"
+    output = `RESPEC_FAILURES=#{TMP}/failures.txt #{ruby} -I #{ROOT}/lib #{respec} #{args} 2>&1`
+    [$?, output]
+  end
+
+  def make_spec(params)
+    num_failures = params[:num_failures] or
+      raise ArgumentError, "expected :num_failures parameter"
+
+    source = "describe 'test' do\n"
+    (0...2).map do |i|
+      if i < num_failures
+        source << "  it('#{i}') { 1.should == 2 }\n"
+      else
+        source << "  it('#{i}') {}\n"
+      end
+    end
+    source << "end"
+    open(spec_path, 'w') { |f| f.puts source }
+  end
+
+  def spec_path
+    "#{TMP}/test_spec.rb"
+  end
+
+  it "should let you rerun failing specs until they all pass" do
+    make_spec(num_failures: 2)
+    status, output = respec(spec_path)
+    status.should_not be_success
+    output.should include('2 examples, 2 failures')
+
+    make_spec(num_failures: 1)
+    status, output = respec("#{spec_path} f")
+    status.should_not be_success
+    output.should include('2 examples, 1 failure')
+
+    make_spec(num_failures: 0)
+    status, output = respec("#{spec_path} f")
+    status.should be_success
+    output.should include('1 example, 0 failures')
+  end
+end

data/spec/respec/app_spec.rb

@@ -0,0 +1,91 @@
+require_relative '../spec_helper'
+
+require 'fileutils'
+
+describe Respec::App do
+  FORMATTER_PATH = File.expand_path("#{ROOT}/lib/respec/formatter.rb", File.dirname(__FILE__))
+  FAIL_PATH = "#{TMP}/failures.txt"
+
+  Respec::App.failures_path = FAIL_PATH
+
+  def make_failures_file(*examples)
+    open Respec::App.failures_path, 'w' do |file|
+      examples.each do |example|
+        file.puts example
+      end
+    end
+  end
+
+  describe "#generated_args" do
+    it "should run with --context if 'c' is given" do
+      app = Respec::App.new('c')
+      app.generated_args.should == ['--diff', 'context']
+    end
+
+    it "should run all failures if 'f' is given" do
+      make_failures_file 'a.rb:1', 'b.rb:2'
+      app = Respec::App.new('f')
+      app.generated_args.should == ['a.rb:1', 'b.rb:2']
+    end
+
+    it "should run the n-th failure if a numeric argument 'n' is given" do
+      make_failures_file 'a.rb:1', 'b.rb:2'
+      app = Respec::App.new('2')
+      app.generated_args.should == ['b.rb:2']
+    end
+
+    it "should interpret existing file names as file name arguments" do
+      FileUtils.touch "#{TMP}/existing.rb"
+      app = Respec::App.new("#{TMP}/existing.rb")
+      app.generated_args.should == ["#{TMP}/existing.rb"]
+    end
+
+    it "should treat other arguments as example names" do
+      FileUtils.touch "#{TMP}/FILE"
+      app = Respec::App.new("#{TMP}/FILE")
+      app.generated_args.should == ["#{TMP}/FILE"]
+    end
+  end
+
+  describe "#formatter_args" do
+    it "should include the respec and progress formatters by default" do
+      app = Respec::App.new
+      app.formatter_args.should == ['--require', FORMATTER_PATH, '--format', 'Respec::Formatter', '--out', FAIL_PATH, '--format', 'progress']
+    end
+
+    it "should include '--format specdoc' if an 's' argument is given" do
+      app = Respec::App.new('s')
+      app.formatter_args.should == ['--require', FORMATTER_PATH, '--format', 'Respec::Formatter', '--out', FAIL_PATH, '--format', 'specdoc']
+    end
+
+    it "should update the stored failures if no args are given" do
+      app = Respec::App.new
+      app.formatter_args.should == ['--require', FORMATTER_PATH, '--format', 'Respec::Formatter', '--out', FAIL_PATH, '--format', 'progress']
+    end
+
+    it "should update the stored failures if 'f' is used" do
+      app = Respec::App.new('f')
+      app.formatter_args.should == ['--require', FORMATTER_PATH, '--format', 'Respec::Formatter', '--out', FAIL_PATH, '--format', 'progress']
+    end
+
+    it "should not update the stored failures if a numeric argument is given" do
+      app = Respec::App.new('1')
+      app.formatter_args.should == []
+    end
+  end
+
+  describe "#raw_args" do
+    it "should pass arguments after '--' directly to rspec" do
+      app = Respec::App.new('--', '--blah')
+      app.raw_args.should == ['--blah']
+    end
+  end
+
+  describe "#command" do
+    it "should combine all the args" do
+      make_failures_file 'a.rb:1'
+      app = Respec::App.new('f', '--', '-t', 'TAG')
+      app.command.should == ['rspec', '--require', FORMATTER_PATH, '--format', 'Respec::Formatter', '--out', FAIL_PATH, '--format', 'progress', 'a.rb:1', '-t', 'TAG']
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+$:.unshift File.expand_path('../lib', File.dirname(__FILE__))
+require 'respec'
+require 'tmpdir'
+
+ROOT = File.expand_path('..', File.dirname(__FILE__))
+TMP = Dir.tmpdir

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: respec
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- George Ogata
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ritual
+  requirement: &70131397136780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :development
+  prerelease: false
+  version_requirements: *70131397136780
+description: 
+email:
+- george.ogata@gmail.com
+executables:
+- respec
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.markdown
+- Rakefile
+- bin/respec
+- lib/respec.rb
+- lib/respec/app.rb
+- lib/respec/formatter.rb
+- lib/respec/version.rb
+- respec.gemspec
+- spec/integration_spec.rb
+- spec/respec/app_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/oggy/respec
+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.10
+signing_key: 
+specification_version: 3
+summary: Rerun failing RSpec examples easily.
+test_files:
+- spec/integration_spec.rb
+- spec/respec/app_spec.rb
+- spec/spec_helper.rb
+has_rdoc: