js-factories

js-factories is a library to use dynamic fixtures using Factories in javascript/coffeescript. Ideal to combine using Mocha/chai frameworks and test rich classes for MV** Frameworks like Backbone.js

Usage

Include js-factories.js in your test suite.

Factory support is added to quickly be able to build models or other objects as you see fit:

1  Factory.define('user', function(attributes) {
2    if (attributes == null) {
3      attributes = {};
4    }
5    return new User(attributes);
6  });
7  
8  Factory.create('user', { name: 'Matthijs' })
9  Factory.createList(10, 'user', { name: 'Matthijs' })

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.

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:

1this.trait('returns', 'one', 'of', 'these', 'values')

and

1this.is('admin') // returns a boolean value

Extended example:

1  Factory.define('user', function(attributes) {
2    var returningClass;
3    if (attributes == null) {
4      attributes = {};
5    }
6    attributes.gender = this.trait('male', 'female') || 'male';
7    returningClass = User;
8    if (this.is('admin')) {
9      returningClass = AdminUser;
10    }
11    return new returningClass(attributes);
12  });
13  
14  Factory.create('user', { name: 'Matthijs' }) // => new User name: 'Matthijs'
15  Factory.create('male-user', { name: 'Matthijs' }) // => new User name: 'Matthijs', gender: 'male'
16  Factory.create('male-admin-user', { name: 'Matthijs' }) // => new AdminUser name: 'Matthijs', gender: 'male'
17  Factory.create('female-user', { name: 'Beppie' }) // => new User name: 'Beppie', gender: 'female'

Sequences

Sequences are also supported:

1  Factory.define('counter', function() {
2    return {
3      amount: this.sequence('amount'),
4      other: this.sequence('other')
5    };
6  });

This does not conflict with similar names in other factory definitions.

You can also yield results:

1  Factory.define('abc', function() {
2    return this.sequence(function(i) {
3      return ['a', 'b', 'c'][i];
4    });
5  });
6
7  // results in:
8  Factory.create('abc') // => 'a'
9  Factory.create('abc') // => 'b'

Sampling

You can sample a value from a list

1  Factory.define('sampler', function() {
2    return this.sample('a', 'b', 'c');
3  });

Will randomly return a, b or c every time

License

Copyright (c) 2012-2014 Matthijs Groen

MIT License (see the LICENSE file)