4.0.0 • Published 9 years ago

sharkhorse v4.0.0

Weekly downloads
144
License
BSD-3-Clause
Repository
github
Last release
9 years ago

Sharkhorse

Build Status codecov.io

Javascript Test factories

Summary

Defining Factories

Factory definitions are plain javascript objects that hold generator objects.

// message_factory.js
import {generators} from 'sharkhorse';

export const Message = {
    id: generators.sequence(),
    subject: generators.lorem().words(2),
    from: {
        name: generators.name().full(),
        email: generators.email()
    }
};

Building objects from factories

To build an object from a factory definition use a create or 'createMany` function the function would iterate through object's nested properties and evaluate all generators to their values

import {create, createMany} from 'sharkhorse';
import {Message} from './message_factory';

create(Message) // => {id: 1, subject: 'Lorem ipsum', from: {name: 'Nickolas Conrad', email: 'random_0@example.com'}}
create(Message) // => {id: 2, subject: 'Lorem ipsum', from: {name: 'Seth Edwards', email: 'random_1@example.com'}}

createMany() will create an array of objects

createMany(Message, 3) // [{...}, {...}, {...}]

generators

sequence()

generates an incrementing or decrementing number every time it's evaluated

generators.sequence() // 1, 2, ..
generators.sequence().decrement() // 1, 0, -1, ...
generators.sequence().startFrom(100) // 100, 101, 102, ...

number()

generates a random number

generators.number() // 285
generators.number().min(500) // 24029
generators.number().max(2)
generators.number().min(0).max(2)

randomItem(list)

generators.randomItem([1, 2, 3]) // one of the numbers

name()

generates a random name

generators.name() // Seth Edwards
generators.name().full() // Seth Edwards
generators.name().first() // Seth
generators.name().last() // Edwards

email()

generates a random unique email every time it's evaluated

generators.email() // random_0@example.com, random_1@example.com

templateString()

Tagged template string generator. Any generator passed as a template string value will be evaluated when passing the generator into create function

let MyStr = generators.templateString`test${generators.sequence()}`;
create(MyStr); // test1
create(MyStr); // test2
create(MyStr); // test3

lorem()

generates random text

generators.lorem() // Lorem ipsum dolor sit amet, per in mazim...
generators.lorem().word()
generators.lorem().words(n)
generators.lorem().paraghaph()
generators.lorem().paraghaphs(n)

date()

generators.date() // Date() object
generators.date().jsTimestamp // 1457241758397
generators.date().unixTimestamp // 1457241758

create(FactoryDefinition)

generates a new factory object from the passed argument

generate.create(MessageFactory) // {id: 1, subject: 'lorem', ...}

createMany(FactoryDefinition, n)

same as create() but generates an array of factories

4.0.0

9 years ago

3.0.8

9 years ago

3.0.7

10 years ago

3.0.6

10 years ago

3.0.5

10 years ago

3.0.4

10 years ago

3.0.3

10 years ago

3.0.2

10 years ago

3.0.1

10 years ago

3.0.0

10 years ago

2.0.1

10 years ago

2.0.0

10 years ago

1.0.2

11 years ago

1.0.1

11 years ago

1.0.0

11 years ago

0.0.4

11 years ago

0.0.3

11 years ago

0.0.2

11 years ago

0.0.1

11 years ago

0.0.0

11 years ago