generative 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 02a4f62bfe5c5c3d05c10bc1196bb33abe6ee992
-  data.tar.gz: e692488353ac4202143d4ac3ec18597a72c5f10b
+  metadata.gz: 30facfd44bae285d5299ad418352db2d662b9fae
+  data.tar.gz: 10dd90eaf237f02a57c1087ce6287400a78427d6
 SHA512:
-  metadata.gz: 9840d498e882fec2575c43153a6c618988b2b8931923d7645c59d46ee0b82fa37e3b1797d6e5353fb5e272d9c6e5d173d478afc15981fba0d6c832e4ca0ef8a6
-  data.tar.gz: 4876dafd32294af5d8d74324263e84a6e840467667d7ead681dff0c68b179ace66fd585ebf5060b5a923f4eb7d704a952d59e2f41aee441f3f610def7fec49d5
+  metadata.gz: da448e92ce5aa862d8fe45cea577dd2682d3e9bf01cc5b169e0520a2bb8e90bdcd5a859a11fee4a14ea45de06ad68c481e1950057ccd8eaedd0395923f81c21e
+  data.tar.gz: 174c2dfd2ec20af6bfac7df2499afec77dbe3849ad3dd414f0837a18d9e7542220dcdbd112c20d40c2212d30a43415290c96c5cc215a39651f4680c3fc3a2b36

data/.travis.yml

@@ -8,4 +8,4 @@ matrix:
   allow_failures:
     - rvm: ruby-head
 script:
-  - rake ci
+  - bundle exec rake ci

data/README.md

@@ -110,3 +110,88 @@ Given the examples above, running `rspec` will use the default "progress"
 formatter. Requiring generative will modify this formatter to output blue dots
 instead of green for generative tests. Generative also includes it's own
 formatter, which will only display generative test names once, also in blue.
+
+### Generators
+
+Generative allows you to register your own custom generators for generative
+tests. Registering a generator requires two thing, a name and an object that
+responds to `#call`.
+
+Whether you just want to use lambdas.
+
+```rb
+Generative.register_generator(:full_name) { "#{Generative.generate(:string)} #{Generative.generate(:string}" }
+
+Generative.register_generator(:user) { FactoryGirl.build(:user, id: Generative.generate(:integer)) }
+```
+
+A class or module that responds to `#call`.
+
+```rb
+class LameGenerator
+  def self.call
+    random_string
+  end
+end
+
+Generative.register_generator(:lame, LameGenerator)
+```
+
+Or you want to use a fancy library.
+
+```rb
+FakeTypeMappingLibrary
+  generator_for Bar do
+    initializer Float, Fixnum
+
+    accessor :baz, Float
+    accessor :quz, NotherClass
+  end
+end
+
+Generative.register_generator(:bar, Bar }
+```
+
+You can then use your generators using the `generate` helper.
+
+```rb
+describe String do
+  let(:string) { "abc" }
+
+  describe "#reverse" do
+    generative do
+      data(:string) { generate(:my_fancy_string) }
+
+      it "maintains length" do
+        expect(string.reverse.length).to eq(string.length)
+      end
+    end
+  end
+end
+```
+
+#### I heard you like generators so I put some generators in your generators...
+
+If you want to use other generators in you registered generator do note
+you have to use Generative's module level method `.generate` like so...
+
+```rb
+Generative.register_generator :user do
+  User.new( first_name: Generative.generate(:string, max: 100) )
+end
+```
+
+
+
+### Pre-made Generators
+
+**Note**: At this time Generative provides no pre-made generators. We
+encourage you to go out and seek good ways of generating
+data and maybe even package them up as your own gems. If you
+do, let us know and we'll link to it here.
+
+
+#### Degenerate
+
+This library has a few generators for some basic primitives... A great start if
+you're looking to move quickly.

data/Rakefile

@@ -13,10 +13,10 @@ task :acceptance do
   ENV.delete('GENERATIVE_COUNT')
 
   [
-    ['rspec', '13'],
-    ['rake spec', '13'],
-    ['rake generative', '30000'],
-    ['bin/generative', '30000']
+    ['rspec', '22'], # can we do this some other way
+    ['rake spec', '22'], # sucks to bump as we add tests...
+    ['rake generative', '40000'],
+    ['bin/generative', '40000']
   ].each do |command, expected_example_count|
     puts "Checking output of `#{command}`"
     output = %x{#{command}}

data/bin/generative

@@ -13,7 +13,7 @@ command = %w[
   --tag generative
 ].join(' ')
 
-command = "GENERATIVE_COUNT=#{ENV['GENERATIVE_COUNT']} #{command}"
+command = "export GENERATIVE_COUNT=#{ENV['GENERATIVE_COUNT']}; #{command}; unset GENERATIVE_COUNT"
 
 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.2.0'
+  gem.version       = '0.2.2'
   gem.authors       = ["Justin Campbell",          "Dan McClory"]
   gem.email         = ["justin@justincampbell.me", "danmcclory@gmail.com"]
   gem.description   = "Generative testing for RSpec"

data/lib/generative.rb

@@ -1,8 +1,28 @@
 require 'rspec/core'
 
 module Generative
+
   DEFAULT_COUNT = '10_000'
 
+  class << self
+    extend Forwardable
+    def_delegators :manager, :register_generator, :find_and_call
+  end
+
+  def self.generate(generator_name, *args)
+    find_and_call(generator_name, *args)
+  end
+
+  def self.manager
+    @manager ||= GeneratorManager.new(preregistered_generators)
+  end
+
+  def self.preregistered_generators
+    {
+        # nothing to see here yet
+    }
+  end
+
   def self.running?
     !!ENV['GENERATIVE_COUNT']
   end
@@ -11,3 +31,4 @@ end
 require 'generative/dsl'
 require 'generative/formatters'
 require 'generative/ordering'
+require 'generative/generator_manager'

data/lib/generative/dsl.rb

@@ -4,5 +4,10 @@ class RSpec::Core::ExampleGroup
 
   class << self
     alias_method :data, :let
+    alias_method :for_every, :let
+  end
+
+  def generate(generator_name, *args)
+    Generative.generate(generator_name, *args)
   end
 end

data/lib/generative/formatters.rb

@@ -72,7 +72,7 @@ module Generative
       example = notification.example
 
       if generative?(example)
-        RSpec.wants_to_quit = true
+        RSpec.world.wants_to_quit = true
       end
 
       super

data/lib/generative/generator_manager.rb

@@ -0,0 +1,32 @@
+module Generative
+  class InvalidGenerator < StandardError; end
+  class UnregisteredGenerator < StandardError; end
+
+  class GeneratorManager
+
+    attr_reader :generators
+
+    def initialize(preregistered_generators={})
+      @generators = Hash.new(preregistered_generators)
+    end
+
+    def register_generator(name, factory=nil, &generator)
+      registerable = block_given? ? generator : factory
+      msg = "#{registerable} must respond to :call"
+      raise InvalidGenerator, msg unless generator_valid?(registerable)
+      @generators.merge!(name => registerable)
+    end
+
+    def find_and_call(name, *args)
+      begin
+        generators[name].call(*args)
+      rescue NoMethodError
+        raise UnregisteredGenerator, "#{name} generator not registered"
+      end
+    end
+
+    def generator_valid?(generator)
+      generator.respond_to?(:call)
+    end
+  end
+end

data/spec/generative/generator_manager_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe Generative::GeneratorManager do
+
+  subject { Generative::GeneratorManager.new }
+
+  describe "#register_generator_generator" do
+    it "throws an exception if a block or a factory object isn't given" do
+      expect { subject.register_generator(:test) }.to raise_error(Generative::InvalidGenerator)
+    end
+
+    it "registers a new generator when given a generator block" do
+      name, generator = :test, lambda { "hi" }
+      expect(subject.generators).not_to include(name)
+      expect(subject.register_generator(name) { "hi" }).to include(name)
+      expect(subject.generators[name].call).to eq("hi")
+    end
+
+    it "registers a new generator when given a factory object" do
+      name, factory = :test, OpenStruct.new(call: true)
+      expect(subject.generators).not_to include(name)
+      expect(subject.register_generator(name, factory)).to include(name)
+      expect(subject.generators[name].call).to be_truthy
+    end
+  end
+
+  describe "#find_and_call" do
+    it "calls a specific generator passing in it's arguments" do
+      name, generator = :test, lambda { |arg| arg }
+      subject.register_generator(name, &generator)
+      expect(subject.find_and_call(name, "hi")).to eq("hi")
+    end
+
+    it "raises an error fo ran unregistered generator" do
+      expect { subject.find_and_call(:nope) }
+        .to raise_error(Generative::UnregisteredGenerator)
+    end
+
+    describe "#generator_valid?" do
+      it "returns false if an object doesn't respond to :call or :build" do
+        expect(subject.generator_valid?(nil)).to be_falsey
+      end
+
+      it "returns true if an object doesn't respond to :call" do
+        generator = OpenStruct.new(call: true)
+        expect(subject.generator_valid?(generator)).to be_truthy
+      end
+    end
+  end
+end

data/spec/generative_spec.rb

@@ -1,5 +1,7 @@
 require 'generative'
 
+Generative.register_generator(:string) { "a" * rand(255) }
+
 describe String do
   let(:string) { "abc" }
 
@@ -17,6 +19,16 @@ describe String do
         expect(string.length).to be >= 0
       end
     end
+
+    xit "uses registered generators"
+
+    generative do
+      data(:string) { generate(:string) }
+
+      it "is never negative" do
+        expect(string.length).to be >= 0
+      end
+    end
   end
 
   describe "#reverse" do

metadata

@@ -1,44 +1,44 @@
 --- !ruby/object:Gem::Specification
 name: generative
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Justin Campbell
 - Dan McClory
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-08-12 00:00:00.000000000 Z
+date: 2014-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
+  prerelease: false
+  type: :runtime
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: !ruby/object:Gem::Requirement
+  version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+  prerelease: false
+  type: :development
 description: Generative testing for RSpec
 email:
 - justin@justincampbell.me
@@ -61,9 +61,11 @@ files:
 - lib/generative.rb
 - lib/generative/dsl.rb
 - lib/generative/formatters.rb
+- lib/generative/generator_manager.rb
 - lib/generative/ordering.rb
 - lib/generative/rake_task.rb
 - lib/generative/version.rb
+- spec/generative/generator_manager_spec.rb
 - spec/generative/ordering_spec.rb
 - spec/generative/rake_task_spec.rb
 - spec/generative_spec.rb
@@ -72,7 +74,7 @@ homepage: https://github.com/justincampbell/generative
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,14 +89,14 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.0.14
-signing_key: 
+rubyforge_project:
+rubygems_version: 2.1.9
+signing_key:
 specification_version: 4
 summary: Generative testing for RSpec
 test_files:
+- spec/generative/generator_manager_spec.rb
 - spec/generative/ordering_spec.rb
 - spec/generative/rake_task_spec.rb
 - spec/generative_spec.rb
 - spec/spec_helper.rb
-has_rdoc: