Socket
Socket
Sign inDemoInstall

mockingbird

Package Overview
Dependencies
15
Maintainers
1
Versions
10
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    mockingbird

Super Simple, Yet Powerful, TypeScript Library for Creating Mocks. Mockingbird allows you to create class mocks like a breeze with a simple yet powerful @Mock decorator


Version published
Weekly downloads
542
increased by0.93%
Maintainers
1
Install size
11.1 MB
Created
Weekly downloads
 

Readme

Source

ISC license npm version Codecov Coverage lerna ci

Mockingbird Logo

Mockingbird

Simple Yet Powerful TypeScript Mocking Library

Manage and create your test mocks easily, and focus on your tests logic instead

Installation

npm i -D mockingbird
yarn add -D mockingbird

What is "Mocking Library"?

A lot of times you find yourself “preparing” some dummy data for your tests that has to make sense for a specific test case(s) and is manipulated often. Some developers are preparing JSON files, others create a long verbose object in the test file itself, but the outcome always contains some fake data inside (or even a snapshot from an external API).

This is what Mockingbird aims to solve! It suggests two ways of creating mocks for your entities/models classes, thus, creating one uniform way to manage mocks (whether you are working alone or with your team), your dev experience will improve, and you won’t have to deal with this messy setup at all!

Features

  • Prepare as many unique mocks/fixtures as you need for your tests
  • Generate dummy (but reasonable) data for database seeding
  • Manage your mocks from one place, forget about the messy work
  • Full TypeScript compatibility
  • Convenient and simple API

Usage

Here is the simplest usage of Mockingbird:

// Could be interface as well
class BirdEntity {
  name: string;
  birthday: Date;
  goodPoints: number;
}
import { Mock, MockFactory } from 'mockingbird';

// BirdEntity could be an interface or a class
class BirdEntityMock implements BirdEntity {
  @Mock(faker => faker.name.firstName())
  name!: string;

  @Mock()
  birthday!: Date; // Will generate a recent date

  @Mock()
  goodPoints!: number; // Will generate a random number
}

const oneBird = MockFactory(BirdEntityMock).one();
const lotsOfBirds = MockFactory(BirdEntityMock).many(3);

Documentation

Jump to the full documentation and explore the full API

There's also an example, you can find it under the sample folder

Playground

Jump to the REPL Playground where you can see Mockingbird in action!

Motivation

Creating mocks for your tests (sometimes called "fixtures") can be a tedious and cumbersome process usually done manually.

We came up with a simple yet super convenient solution: all you have to do to get mocks out of the box is to decorate your classes (whether it's an entity, or a model representing the database layer) and generate simple or complex mocks.

Mockingbird offers two different ways for preparing mocks; The first one (as we call it), is the TypeScript way which requires decorating existing (or duplicate) classes. The second way is to use Mockingbird's functionality directly

What is faker.js?

faker.js it's a library which is used to "generate massive amounts of fake data in the browser and Node".

Mockingbird uses faker.js under the hood, making it possible to enjoy its rich database, and thereby allows to create mocks that are meaningful like email, first name, address and many more.

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

faker.js

Keywords

FAQs

Last updated on 08 Dec 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc