mongoose-fakery
mongoose-fakery
provides an easy fixture replacement method and random data generators.
Inspiration
Parts of mongoose-fakery
where inspired by:
Thanks.
Contributing
- Clone the repo.
- Create a branch.
- Write awesome code.
- Add tests for your changes. Test dependencies are defined in
package.json
. - Open a Pull Request.
- Receive a 'Thank you!' and possibly a digital beer from me.
License
MIT.
TODO
- Associations with other models. This is my first priority.
- Browser compatibility.
- Add more data generators.
Documentation
Installing
npm install mongoose-fakery
Creating a fakery (factory)
In your models.js
:
var mongoose = Schema = mongooseSchema; var UserSchema = name: String surname: String; mongoose;
In your tests or fixture files:
var fakery = ; fakery;
Getting a fakery
If the only argument you pass into fake()
is the name of the factory then
the method becomes a getter.
var userFakery = fakery;
Lazy attributes
'Lazy' attributes are attributes that are resolved during a 'second' pass over the attributes of the fakery. Common usage are attributes that depend on other attributes for their value.
To create a 'lazy' attribute use fakery.lazy()
:
fakery;
Each lazy attribute receives all the resolved attributes of the first pass as the only parameter.
Using data generators
Data generators are functions that return data. That data can be random or follow
specific patterns. mongoose-fakery
comes with a number of pre-defined data generators
which will probably suit most of your needs i.e:
- random strings (hex, alpha, alphanum)
- random numbers
- random booleans (true/false)
- lorem generator
- name, surname and gender
- picking random items from lists
Pre-defined data generators are exposed under the g
attribute of the fakery
object. Take a look in data_providers.js
to see all the available generators
and their APIs.
Some examples:
// using the user model defined abovefakery;
Generators can also be used in arrays and nested attributes:
fakery;
Data generators can also be used when you just want to generate a bunch of random data for whatever purpose. They are not specific to test factories:
var fakery = ; // generate 10 random full namesvar names = i;for i = 0; i < 10; i++ names;
Creating custom data generators
mongoose-fakery
gives you the option to create custom generators that attach
themselves to the g
attribute to the fakery
object:
// declare like thisfakery; // use like thisvar customGenerator = fakeryg;; // returns 'custom'
As you might have guessed, generators wrap 'data provider' methods in a function. You can thus do things like:
fakery; var timesTwo = fakeryg;; // returns 4
Making a fake model
To make a fake model, use the make()
method. make()
can also receive overrides.
var model = fakery;var modelWithOverrides = fakery;
Note that the model is not saved to the database.
Making & saving a fake model
To make and save a fake model, use the makeAndSave()
method.
fakery; fakery;