Skip to content

aaronbuchanan/loopback-fixtures

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code
This branch is 4 commits ahead, 8 commits behind sghribi:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

loopback-fixtures

Expressive fixtures generator for Loopback

build status dependency status

Installation

Basic usage

npm install --save loopback-fixtures

Then, in your server/component-config.json, add :

{
  "loopback-fixtures": {
    "fixturePath": "/fixtures/data/",
    "append": false,
    "autoLoad": false
  }
}

Write your YML fixture file /fixture/data/data.yml (adapt according your model) :

Group:
  group{1..10}:
    name: "Groupe {@} depuis les fixtures"

User:
  user{1..10}:
    name: "User {@} : {{name.lastName}}"
    groupId: @group{@}
    email: "{{internet.email}}"
    birthDate: "2016-01-01"
    favoriteNumber: "(function() { return Math.round(Math.random()*1000);})()"

How to load fixtures ?

  • If autoLoad is set to true, fixtures will be loaded when you start your application

  • With the server:

    app.loadFixtures() (return a promise)

    e.g:

    app.loadFixtures()
    .then(function() {
      console.log('Done!');
    })
    .catch(function(err) {
      console.log('Errors:', err);
    });
  • With a node command:

    ./node_modules/loopback-fixtures/lib/load-fixtures.js
    

Configuration options

  • fixturePath (default value '/fixtures/data')

    The directory to load data fixtures from

  • append (default value false)

    If set to true, data fixtures will be append instead of deleting all data from the database first. WARNING false will erase your database

  • autoLoad (default value false)

Features

  • Load data according your model

  • Multiple generators :

    User:
      user{1..45}:
        name: "User number {@}"

    {@} represents the current identifier for the generator

  • References :

    Group:
      group{1..3}:
        name: "Groupe number {@}"
    
    User:
      user{1..9}:
        name: "User number {@}"
        group: @group1  # Reference to group1
    
      user{10..19}:
        name: "User number {@}"
        group: @group.* # Reference to any matching group

    @group1 represents the reference for the group1 and can be used in other fixtures @group.* represents the reference for a random matching group

  • Fakers :

    User:
      user{1..10}:
        name: "User n°{@} : {{name.lastName}} {{name.firstName}}"
        email: "{{internet.email}}"

    You can use Faker.js API to provide fake data

  • Custom function :

    User:
      user{1..10}:
        favoriteNumber: "(function() { return Math.round(Math.random()*1000);})()"

    You can use custom functions too

Credits

Samy Ghribi

License

ISC

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 51.9%
  • CoffeeScript 48.1%