factoryi-js
v1.2.1
Published
Building JavaScript objects inspired by [rosie](https://github.com/bkeepers/rosie) and [factory_girl](https://github.com/thoughtbot/factory_girl).
Downloads
14
Maintainers
Readme
Factory
Building JavaScript objects inspired by rosie and factory_girl.
Factory can integrate with JavaScript framework persistence layer through Adapters.
Setup for Ember.js
Call Factory.setupForEmber(App)
before factory definitions. See live example at jsbin
NOTE: You need to call Factory.reset()
to reset sequences for each test run.
Usage
Factory.define('vote', function() {
this.sequence('id');
this.attr('value', 0);
this.trait('up', function() {
return this.attr('value', 1);
});
return this.trait('down', function() {
return this.attr('value', -1);
});
});
Factory.define('post', function() {
this.sequence('id');
this.sequence('title', function(i) {
return "Post " + i;
});
this.attr('content', null);
this.hasMany('votes', 'vote');
return this.after(function() {
if (!this.content) {
return this.content = "" + this.title + " content";
}
});
});
Factory.define('category', function() {
this.sequence('id');
this.sequence('name', function(i) {
return "Category " + i;
});
this.ignore('postsCount', 0);
return this.after(function(attributes) {
return this.posts = Factory.buildList('post', attributes.postsCount);
});
});
NOTE: looks better with CoffeeScript ;-)
Build with no attributes
Factory.build('post')
result:
{
"id":1,
"title":"Post 1",
"content":"Post 1 content"
}
Build with attributes
Factory.build('post', {content: 'my content'})
result:
{
"id":1,
"title":"Post 1",
"content":"my content"
}
Build with ignored attribute and after() callback
Factory.build('category',{name: 'First category', postsCount: 2})
result:
{
"name":"First category",
"id":1,
"posts":[
{"id":1,"title":"Post 1","content":"Post 1 content"},
{"id":2,"title":"Post 2","content":"Post 2 content"}
]
}
Build post with votes count
Factory.build('post', {votes: 2})
result:
{
"content" : "Post 1 content",
"id" : 1,
"title" : "Post 1",
"votes" : [
{"id":1,"value":1},
{"id":2,"value":1}
]
}
Build post with votes traits or attributes
Factory.build('post', {votes: ['up', 'down', 'up']})
or
Factory.build('post', {votes: [{value: 1}, {value: -1}, {value: 1}]})
result:
{
"content" : "Post 1 content",
"id" : 1,
"title" : "Post 1",
"votes" : [
{"id":1,"value":1},
{"id":2,"value":-1},
{"id":3,"value":1}
]
}
Adapters
By default factory is building JavaScript objects using default Factory.Adapter
class Factory.Adapter
constructor: (factory) -> @factory = factory
build: (name, attrs) -> attrs
create: (name, attrs) -> attrs
push: (name, object) -> @[name].push object
Factory integrates with Ember.js through Factory.EmberDataAdapter
(used by Factory.setupForEmber(App)
)
class Factory.EmberDataAdapter extends Factory.Adapter
build: (name, attrs) -> Ember.run => App.__container__.lookup('store:main').createRecord name, attrs
create: (name, attrs) -> @build name, attrs
push: (name, object) -> Ember.run => @get(name).addObject object
You can set adapter globally
Factory.adapter = Factory.YourAdapter
or per factory definition
Factory.define 'yourModel', ->
@adapter Factory.YourAdapter
Contributing
git clone [email protected]:tb/factory.git
cd factory
npm install
grunt build