chai-backbone-rails 0.2.1 → 0.3.0

data/README.md

@@ -99,14 +99,32 @@ other objects as you see fit:
 
 ### Traits
 
-you can also use 'traits':
+you can also use 'traits'.
+Traits are flags that are set when the user calls create with the
+factory name prefixed with terms separated by dashes.
 
-    Factory.define 'user', (attributes = {}, traits...) ->
-      if traits.indexOf('male') isnt -1
-        attributes.gender = 'male'
+Like: 'female-admin-user'
+
+This will call the 'user' factory, and provide the terms 'female' and
+'admin' as traits for this user
+
+this list is accessible in the factory callback using `this.traits`
+
+There are 2 helper methods to help check if traits are set:
+
+    this.trait('returns', 'one', 'of', 'these', 'values')
+
+and
+
+    this.hasTrait('admin') # returns a boolean value
+
+Extended example:
+
+    Factory.define 'user', (attributes = {}) ->
+      attributes.gender = @trait('male', 'female') || 'male'
 
       returningClass = User
-      if traits.indexOf('admin') isnt -1
+      if @hasTrait('admin')
         returningClass = AdminUser
 
       new returningClass attributes
@@ -114,6 +132,7 @@ you can also use 'traits':
     Factory.create 'user', name: 'Matthijs' # => new User name: 'Matthijs'
     Factory.create 'male-user', name: 'Matthijs' # => new User name: 'Matthijs', gender: 'male'
     Factory.create 'male-admin-user', name: 'Matthijs' # => new AdminUser name: 'Matthijs', gender: 'male'
+    Factory.create 'female-user', name: 'Beppie' # => new User name: 'Beppie', gender: 'female'
 
 ### Sequences
 
@@ -136,6 +155,15 @@ You can also yield results:
     Factory.create('abc') => 'a'
     Factory.create('abc') => 'b'
 
+### Sampling
+
+You can sample a value from a list
+
+    Factory.define 'sampler', ->
+      @sample 'a', 'b', 'c'
+
+Will randomly return a, b or c every time
+
 Running the tests
 =================
 

data/lib/chai-backbone-rails/version.rb

@@ -1,7 +1,7 @@
 module Chai
   module Backbone
     module Rails
-      VERSION = "0.2.1"
+      VERSION = "0.3.0"
     end
   end
 end

data/vendor/assets/javascripts/chai-backbone.js.coffee

@@ -79,6 +79,8 @@
     Backbone.history = new Backbone.History
 
     spy = sinon.spy router, methodName # spy on our expected method call
+    @assert router._bindRoutes?, 'provided router is not a Backbone.Router'
+
     router._bindRoutes() # inject router routes into our history
     if options.considering? # if multiple routers are provided load their routes aswell
       consideredRouter._bindRoutes() for consideredRouter in options.considering

data/vendor/assets/javascripts/factories.js.coffee

@@ -19,14 +19,30 @@ window.Factory =
     @factories[factoryName] =
       sequences: {}
       factory: builder
-      sequence: sequencer
 
-  create: (nameWithTraits, options) ->
+  create: (nameWithTraits, args...) ->
     traits = nameWithTraits.split '-'
     factoryName = traits.pop()
     unless @factories[factoryName]?
       throw "Factory #{factoryName} does not exist"
-    @factories[factoryName].factory options, traits...
+
+    f = @factories[factoryName]
+    obj =
+      sequences: f.sequences
+      factory: f.factory
+      sequence: sequencer
+      traits: traits
+      hasTrait: (name) -> ~@traits.indexOf(name)
+      trait: (names...) ->
+        for name in @traits
+          return name if ~names.indexOf(name)
+      sample: (values...) ->
+        values[Math.floor(Math.random() * values.length)]
+
+    r = obj.factory args...
+    f.sequences = obj.sequences
+    obj = null
+    r
 
   resetFactories: ->
     @factories = []

data/vendor/assets/javascripts/spec/factory_spec.js.coffee

@@ -3,8 +3,8 @@
 describe 'Factory', ->
 
   beforeEach ->
-    Factory.define 'user', (options = {}, traits...) ->
-      [options, traits]
+    Factory.define 'user', (args...) ->
+      args: args
 
   afterEach ->
     Factory.resetFactories()
@@ -13,8 +13,7 @@ describe 'Factory', ->
 
     it 'registers a factory', ->
       result = Factory.create 'user'
-      result[0].should.deep.equal {}
-      result[1].should.deep.equal []
+      result.args.should.deep.equal []
 
     it 'raises an error on existing factory', ->
       expect(-> Factory.define('user', ->)).to.throw 'Factory user is already defined'
@@ -28,25 +27,61 @@ describe 'Factory', ->
       result = Factory.create 'user'
         hello: 'world'
         other: 'value'
-      result[0].should.deep.equal { hello: 'world', other: 'value' }
+      result.args[0].should.deep.equal { hello: 'world', other: 'value' }
 
-    it 'delivers traits to the callback', ->
-      result = Factory.create 'male-admin-user'
-      result[1].should.deep.equal ['male', 'admin']
+    it 'accepts multiple arguments', ->
+      result = Factory.create 'user', 1, 2, 3
+      result.args.should.deep.equal [1, 2, 3]
 
 
   describe 'helpers', ->
 
+    describe 'traits', ->
+      beforeEach ->
+        Factory.define 'traits', ->
+          traits: @traits
+
+      it 'delivers traits to the callback', ->
+        result = Factory.create 'something-with-traits'
+        result.traits.should.deep.equal ['something', 'with']
+
+    describe '#hasTrait', ->
+
+      it 'checks if trait is set', ->
+        Factory.define 'hasTrait', ->
+          @hasTrait('hello')
+
+        Factory.create('hello-hasTrait').should.be.ok
+        Factory.create('bye-hasTrait').should.not.be.ok
+        Factory.create('bye-other-hello-somewhere-hasTrait').should.be.ok
+
+    describe '#trait', ->
+
+      beforeEach ->
+        Factory.define 'trait', ->
+          @trait('red', 'green', 'refactor')
+
+      it 'returns undefined if no values match', ->
+        expect(Factory.create('refgreen-trait')).to.be.undefined
+
+      it 'returns one of the provided trait values', ->
+        Factory.create('green-trait').should.equal 'green'
+        Factory.create('red-trait').should.equal 'red'
+
+      it 'returns the first encountered if multiple values match', ->
+        Factory.create('green-red-trait').should.equal 'green'
+        Factory.create('refactor-green-trait').should.equal 'refactor'
+
     describe 'sequence', ->
 
       beforeEach ->
-        Factory.define 'counter', (options = {}, traits...) ->
+        Factory.define 'counter', ->
           @sequence('property')
 
-        Factory.define 'otherCounter', (options = {}, traits...) ->
+        Factory.define 'otherCounter', ->
           @sequence('property')
 
-        Factory.define 'abc', (options = {}, traits...) ->
+        Factory.define 'abc', ->
           @sequence((c) -> ['a', 'b', 'c'][c])
 
       it 'provides sequencers scoped to factory and property', ->
@@ -58,3 +93,20 @@ describe 'Factory', ->
         Factory.create('abc').should.equal 'a'
         Factory.create('abc').should.equal 'b'
 
+    describe 'sample', ->
+
+      beforeEach ->
+        Factory.define 'sampling', ->
+          @sample('henk', 'piet', 'kees')
+
+      afterEach ->
+        @mathStub?.restore()
+
+      it 'returns one of the provided values', ->
+        @mathStub = sinon.stub Math, 'random', -> 0.01
+        Factory.create('sampling').should.eql 'henk'
+
+      it 'uses random to decide value', ->
+        @mathStub = sinon.stub Math, 'random', -> 0.99
+        Factory.create('sampling').should.eql 'kees'
+

metadata

@@ -1,23 +1,33 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: chai-backbone-rails
-version: !ruby/object:Gem::Version
-  version: 0.2.1
+version: !ruby/object:Gem::Version 
+  hash: 19
   prerelease: 
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
-authors:
+authors: 
 - Matthijs Groen
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-27 00:00:00.000000000 Z
+
+date: 2012-09-30 00:00:00 Z
 dependencies: []
+
 description: Chai.js matchers for Backbone.js framework
-email:
+email: 
 - matthijs.groen@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
 - Gemfile
 - LICENSE
@@ -38,26 +48,36 @@ files:
 - vendor/assets/javascripts/spec/factory_spec.js.coffee
 homepage: https://github.com/matthijsgroen/chai-backbone-rails
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: A set of assertion matchers to test Backbone code using Konacha in Rails
 test_files: []
+