generative 0.1.0 → 0.2.0.pre1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cb07b72eae577b93f0b1a1ad07c359febd371b2a
-  data.tar.gz: 546a72740dba23846335a260cd990b869475e9a6
+  metadata.gz: 91579b9cbddd9ab1a63136fd9466b779dce20ce5
+  data.tar.gz: 35947c6dd629fe09df3c2d5d08ce2ad84bedfb3d
 SHA512:
-  metadata.gz: e05ce694896ac75dbd22283c29bcf7ff6900d5928ddebbf907184944f1098c2a34c02f75d14866c0c72385a56796163307765c4cd655911379948b400e2c1d91
-  data.tar.gz: 1af5f8fd24a3449a28c602d8be2cf33299aef47c647851f0ff3aa123252a66b3c401da015f561b7f5688cc5c9fc93734f3969337531d4320744bb9929c1cba4e
+  metadata.gz: 0b3e014eb4add9e5e87b633720418f1926646d4c8cd4447cc5042a0904465eb93deb19dd4b878b736920a09836cd64c97857cb2b25f71efe97e965bba78ded11
+  data.tar.gz: 9763f83d3d197452d419a4ad20de6a5c816fa1dc12b398c4ee07dd85e049cea097e9d4ea46b50f23de91d634ce09369cd37a60f595acd71b9bc0cab23272b80f

data/.travis.yml

@@ -9,3 +9,5 @@ rvm:
 matrix:
   allow_failures:
     - rvm: ruby-head
+script:
+  - rake ci

data/README.md

@@ -26,30 +26,27 @@ end
 --require generative
 ```
 
-### Modify your `Rakefile` to create separate `spec` and `generative` tasks:
+### (Optional) Require the Generative Rake task in your `Rakefile`:
 
 ```rb
-require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'generative/rake_task'
 
-task default: [:spec, :generative]
-
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.rspec_opts = '--format documentation --tag ~generative --order random'
-end
-
-RSpec::Core::RakeTask.new(:generative) do |t|
-  ENV['GENERATIVE_COUNT'] = '10_000'
-  t.rspec_opts = '--format Generative --tag generative'
-end
+task(:default).enhance [:spec, :generative]
 ```
 
 ### Remove any random/other ordering
 
 If using RSpec 2, you'll need to make sure you remove `config.order =
-'random'`, or any other ordering strategies, from your spec helper.
+'random'`, or any other ordering strategies, from your spec helper. You can
+also use `Generative.running?` to only disable random ordering during
+Generative runs:
+
+```rb
+config.order = :random unless Generative.running?
+```
 
-In RSpec 3, this is not nessecary, because each example group (the `generative`
+In RSpec 3, this is not necessary, because each example group (the `generative`
 block) can override ordering for that group.
 
 ## Usage
@@ -85,13 +82,38 @@ describe String do
 end
 ```
 
-Now, run your tests with `rake` or `rspec`.
+### Running
+
+Generative comes with a `generative` command, which simply runs rspec with the
+required arguments:
+
+```
+$ generative
++ GENERATIVE_COUNT=10_000
++ rspec --require generative --format Generative --tag generative
+Run options: include {:generative=>true}
+
+String
+  #length
+    generative
+      is never negative
+  #reverse
+    generative
+      maintains length
+      is not destructive
+
+Finished in 2.28 seconds
+30000 examples, 0 failures
+```
+
+If you've added the Generative task to your `Rakefile`, you can also simply run
+`rake ` to run all tests, including Generative ones.
 
 ### Number of Tests
 
 Generative uses the `GENERATIVE_COUNT` environment variable to control how many
-tests to run for each example. It defaults to 100, and in the example
-`Rakefile` above, we set it to 10,000.
+tests to run for each example. Both the `generative` command and the example
+`Rakefile` above set it to 10,000.
 
 ### Formatters
 

data/Rakefile

@@ -1,13 +1,27 @@
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
+require 'generative/rake_task'
 
-task default: [:spec, :generative]
+task default: [:spec, :generative, :acceptance]
+task ci: [:spec, :generative]
 
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.rspec_opts = '--format documentation --tag ~generative --order random'
-end
+RSpec::Core::RakeTask.new(:spec)
+Generative::RakeTask.new(:generative)
+
+desc "Verify all spec commands behave properly"
+task :acceptance do
+  [
+    ['rspec', '6'],
+    ['rake spec', '6'],
+    ['rake generative', '30000'],
+    ['bin/generative', '30000']
+  ].each do |command, example_count|
+    result = system %{#{command} | grep "#{example_count} examples, 0 failures"}
+
+    unless result
+      fail "`#{command}` had an incorrect example count"
+    end
+  end
 
-RSpec::Core::RakeTask.new(:generative) do |t|
-  ENV['GENERATIVE_COUNT'] ||= '10_000'
-  t.rspec_opts = '--format Generative --tag generative'
+  puts "Yay!"
 end

data/bin/generative

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path(File.join(File.dirname(__FILE__), "..", "lib"))
+
+require 'generative'
+
+ENV['GENERATIVE_COUNT'] ||= '10_000'
+
+command = %w[
+  rspec
+  --require generative
+  --format Generative::Formatter
+  --tag generative
+].join(' ')
+
+command = "GENERATIVE_COUNT=#{ENV['GENERATIVE_COUNT']} #{command}"
+
+puts command
+system command

data/generative.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |gem|
   gem.name          = 'generative'
-  gem.version       = '0.1.0'
+  gem.version       = '0.2.0.pre1'
   gem.authors       = ["Justin Campbell",          "Dan McClory"]
   gem.email         = ["justin@justincampbell.me", "danmcclory@gmail.com"]
   gem.description   = "Generative testing for RSpec"
@@ -13,6 +13,7 @@ Gem::Specification.new do |gem|
   gem.license       = 'MIT'
 
   gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map { |file| File.basename file }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
 

data/lib/generative.rb

@@ -1,5 +1,13 @@
 require 'rspec/core'
 
+module Generative
+  DEFAULT_COUNT = '10_000'
+
+  def self.running?
+    !!ENV['GENERATIVE_COUNT']
+  end
+end
+
 require 'generative/dsl'
 require 'generative/formatters'
 require 'generative/ordering'

data/lib/generative/formatters.rb

@@ -14,55 +14,57 @@ end
 
 require 'rspec/core/formatters/documentation_formatter'
 
-class Generative < RSpec::Core::Formatters::DocumentationFormatter
-  def initialize(output)
-    super(output)
-  end
+module Generative
+  class Formatter < RSpec::Core::Formatters::DocumentationFormatter
+    def initialize(output)
+      super(output)
+    end
 
-  def example_group_started(example_group)
-    @example_group = example_group
+    def example_group_started(example_group)
+      @example_group = example_group
 
-    output.puts if @group_level == 0
+      output.puts if @group_level == 0
 
-    if generative?(example_group)
-      output.puts "#{current_indentation}#{detail_color('generative')}"
+      if generative?(example_group)
+        output.puts "#{current_indentation}#{detail_color('generative')}"
 
-      @group_level += 1
-      example_group.examples.each do |example|
-        output.puts "#{current_indentation}#{detail_color(example.description)}"
+        @group_level += 1
+        example_group.examples.each do |example|
+          output.puts "#{current_indentation}#{detail_color(example.description)}"
+        end
+
+        @group_level -= 1
+      else
+        output.puts "#{current_indentation}#{example_group.description.strip}"
       end
 
-      @group_level -= 1
-    else
-      output.puts "#{current_indentation}#{example_group.description.strip}"
+      @group_level += 1
     end
 
-    @group_level += 1
-  end
+    def example_passed(example)
+      return if generative?(example)
 
-  def example_passed(example)
-    return if generative?(example)
+      super(example)
+    end
 
-    super(example)
-  end
+    def example_pending(example)
+      return if generative?(example)
 
-  def example_pending(example)
-    return if generative?(example)
+      super(example)
+    end
 
-    super(example)
-  end
+    def example_failed(example)
+      if generative?(example)
+        RSpec.wants_to_quit = true
+      end
 
-  def example_failed(example)
-    if generative?(example)
-      RSpec.wants_to_quit = true
+      super(example)
     end
 
-    super(example)
-  end
+    private
 
-  private
-
-  def generative?(example)
-    example.metadata[:generative]
+    def generative?(example)
+      example.metadata[:generative]
+    end
   end
 end

data/lib/generative/rake_task.rb

@@ -0,0 +1,28 @@
+require 'generative'
+require 'rspec/core/rake_task'
+
+module Generative
+  class RakeTask < RSpec::Core::RakeTask
+    def initialize(*args, &task_block)
+      setup_ivars(args)
+
+      desc "Run Generative specs" unless Rake.application.last_comment
+
+      options = %w[
+        --require generative
+        --format Generative::Formatter
+        --tag generative
+      ]
+
+      self.rspec_opts = options.join(' ')
+
+      task name, *args do |_, task_args|
+        RakeFileUtils.send(:verbose, verbose) do
+          ENV['GENERATIVE_COUNT'] ||= Generative::DEFAULT_COUNT
+          task_block.call(*[self, task_args].slice(0, task_block.arity)) if task_block
+          run_task verbose
+        end
+      end
+    end
+  end
+end

data/spec/generative_spec.rb

@@ -8,7 +8,7 @@ describe String do
       expect(string.length).to eq(3)
     end
 
-    xit "does other stuff"
+    xit "still prints pending spec names"
 
     generative do
       data(:string) { "a" * rand(255) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: generative
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0.pre1
 platform: ruby
 authors:
 - Justin Campbell
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-18 00:00:00.000000000 Z
+date: 2014-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -43,7 +43,8 @@ description: Generative testing for RSpec
 email:
 - justin@justincampbell.me
 - danmcclory@gmail.com
-executables: []
+executables:
+- generative
 extensions: []
 extra_rdoc_files: []
 files:
@@ -55,11 +56,13 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- bin/generative
 - generative.gemspec
 - lib/generative.rb
 - lib/generative/dsl.rb
 - lib/generative/formatters.rb
 - lib/generative/ordering.rb
+- lib/generative/rake_task.rb
 - lib/generative/version.rb
 - spec/generative_spec.rb
 - spec/spec_helper.rb
@@ -78,9 +81,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.2.0