Skip to content

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

For typeorm-seed suporting typeorm >= 0.3.x use this package - https://www.npmjs.com/package/@vita-mojo/typeorm-seed

TypeORM Seed Utils

TypeORM Seed Utils is an opinionated library to write and run database seeds.

Installing

Run npm install typeorm-seed

Running the CLI (use ./node_modules/.bin/typeorm-seed if not installed globally)

typeorm-seed <command> <...files>

CLI features:

  • Execute one or multiple seed files up
typeorm-seed up roles users

This will execute sequentially the files dist/data/seeds/roles.js and dist/data/seeds/users.js. Base directory (dist/data/seeds) is not configurable at the moment.

  • Revert one or multiple seed files down
typeorm-seed down users roles

This command will revert seed files users.js and roles.js.

  • Clear entire database clear
typeorm-seed clear

Clear all data from all models registered in configured connection (ormconfig.json).

  • Show help --help
typeorm-seed --help

Adding seed files

Seed files should be added at src/data/seeds/<seedFile>.ts. Base path will be configurable in the future.

Examples of seed files will be added later.

Additional functionality

Seed factory manager

Allows generating data and seeding it to database from the provided factories and models.

Code example:

import * as faker from 'faker';
import { SeedFactoryManager } from 'typeorm-seed';
import { SampleModel, OtherModel } from 'data/models';

const createSampleModel = () => ({
  uuid: faker.random.uuid(),
  name: faker.name.firstName(),
});

const createOtherModel = () => ({
  uuid: faker.random.uuid(),
  name: faker.name.firstName(),
});

export const modelsFactories: SeedFactoryManager = new SeedFactoryManager()
  .register(SampleModel, createSampleModel)
  .register(OtherModel, createOtherModel);

Using model factories:

modelsFactories.makeOne(SampleModel); // create a Sample object from random data (using faker factory)
modelsFactories.makeOne(SampleModel, data); // create a Sample object from provided (partial) data
modelsFactories.makeMany(SampleModel, data, 10); // create 10 Sample objects

await modelsFactories.seedOne(SampleModel); // create and save to database one Sample object
await modelsFactories.seedOne(SampleModel, data, 10); // create and save to database 10 Sample objects
await modelsFactories.seedAll(SampleModel, data); // create and save Sample objects from an array of partial entities

Providing custom connection to an instance of SeedFactoryManager:

modelsFactories.setConnection(customConnection);

Clearing the database:

import { clearEntities, clearDatabase } from 'typeorm-seed';

clearEntities([SampleModel, OtherModel]); // deletes data from specified entities

clearDatabase(customConnection); // deletes data from all entities registered connection (ormconfig.json)

To do

  • Configurable connection

About

TypeORM Seed

Resources

Stars

14 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages