Fakefill

Magically creates a random fake data such as names, addresses, and phone numbers based in your SimpleSchema. Good for testing fixtures.

Installation

Install using Meteor's package management system:

> meteor add gbit:fakefill

Testing (if you clone the package)

$ meteor test-packages ./

How to use

Mongo.Collection instances

You can call Fakefill from your Collection namespace

Collection.fakefill().insert

Do you want to easily seed your collection with 10 fake docs? Just do it:

	var docs = Authors.fakefill().insert(number, overrides, options);
	=> [ { profile: { firstName: '...', lastName: '...', email: '...' }, ..., ..., ... } ]

This method inserts the number you specified of random documents to your collection. If you want to omit some field, just pass an array in options.omit:

	var docs = Authors.fakefill().insert(number, overrides, {
		omit: ['email']
	});
	=> [ { profile: { firstName: '...', lastName: '...' }, ..., ..., ... } ]

Colection.fakefill.gen

This method doesn't insert nothing to your collection, just returns a array with random documents.

	var Authors = new Mongo.Collection('authors');
	Authors.attachSchema(new SimpleSchema({
		profile: {
			type: new SimpleSchema({
				firstName: {
					type: String
				},

				lastName: {
					type: String
				},

				email: {
					type: String
				}
			})
		}
	}));

	var docs = Authors.fakefill().gen(10); //
	=> [ { profile: { firstName: '...', lastName: '...', email: '...' }, ..., ..., ... } ]

Fakefill goal: easily seed data

Do you want to seed your collection in a single line with zero effort?

// Create for me 10 random users, please.
Users.fakefill().gen(10);

Fakefill.fromSchema(simpleSchemaInstance, overrides, options)

You can get a random totally filled doc just passing a schema to Fakefill.fromSchema. Fakefill will load all the fields and generate the proper data for each of them. So just relax and:

var doc = Fakefill.fromSchema(new SimpleSchema({
	userName: {
		type: String,
		label: 'Site username'
	},

	email: {
		type: SimpleSchema.RegEx.Email,
		label: 'Your email'
	}
}));

=> { username: 'Maria_Juana666', email: '[email protected]' }

But if you're unhappy with the generated data of a field, you can pass an override:

var doc = Fakefill.fromSchema(new SimpleSchema({
	userName: {
		type: String,
		label: 'Site username'
	},

	email: {
		type: SimpleSchema.RegEx.Email,
		label: 'Your email'
	}
}), {
	userName: function(){
		return 'oh my god';
	}
});

=> { username: 'oh my god', email: '[email protected]' }

That's it.

Fakefill.genDoc(MongoCollectionInstance, overrides)

This method is just a shortcut for Fakefill(Collection.simpleSchema())

	var doc = Fakefill.genDoc(Users);

	=> { username: 'Maria_Juana666', email: '[email protected]', ... }

Fakefill.setLocale(locate)

	Fakefill.setLocale('pt_BR');

Set the language locate you want. See the supported locales:

• de
• de_AT
• de_CH
• en
• en_AU
• en_BORK
• en_CA
• en_GB
• en_IE
• en_IND
• en_US
• en_au_ocker
• es
• fa
• fr
• fr_CA
• ge
• it
• ja
• ko
• nb_NO
• nep
• nl
• pl
• pt_BR
• ru
• sk
• sv
• tr
• uk
• vi
• zh_CN
• zh_TW

Faker

This package includes gbit:faker, so you can use it too calling faker.

Issues

• Fakefill don't fill up correctly schema fields with type [Type]
• Autodetect for field with String type is too slow (hope improve this soon) :(

Pull request

Accepting pull requests that increase Fakefill perfomance.