mock-uuid

Mock UUID

This package is ment for testing and development purposes where a repeatable UUID is needed only. My personal reason to do it is to fill a mock state in React, and to be honest because I was bored and went a bit overboard. :-P

Goes beyond saying but don't use this in production. Use a proper UUID library.

Repo at Github: https://github.com/nkholski/mock-uuid

Install

Run npm i -D mock-uuid

Public methods

Method	Signature	Description
v2,v3,v4,v5	no parameters	Mimics v2,v3,v4,v5 in UUID
mockUuid.getIncrementalGenerator	(seed:number = Math.E, uuidVersion = 4, variant = 1) => () => uuid:string	Function to generate uuid with built in incrementation
mockUuid.getGenerator	(seed:number = Math.E, uuidVersion = 4, variant = 1) => (i: number) => uuid:string	Function to generate uuid with index as a parameter
mockUuid.get	(i: number, seed = Math.E, uuidVersion = 4, variant = 1) => uuid:string	Get UUID with index i

Parameters

Parameter	Valid values	Description
seed	any number	Uuid generation is based on the seed.
uuidVersion	2,3,4 or 5	Which version of UUID to generate (version 1 is not supported)
variant	0,1,2,3	Which variant to use

Usage example

Recommended: Switching between UUID and Mock UUID

Import import { v4 as uuidv4 } from "mock-uuid" during development to be able to easilly switch Mock UUID to proper UUID in production by changing the import to import { v4 as uuidv4 } from 'uuid'. All your code should work with either. (works for v2, v3, v4 and v5)

Mocking a list of books:

import { mockUuid } from "mock-uuid";

const books = [];
const getUuid = mockUuid.getIncrementalGenerator();
for(let i=0;i<numberOfBooks;i++){
    books.push({
        id: uuid(),
        title: `book ${i+1}`,
    });
}

Mocking a list of books with uuid by index:

import { mockUuid } from "mock-uuid";
 
const books:Book[] = [];
for(let i=0;i<numberOfBooks;i++){
    books.push({
        id:  mockUuid.getUuid(i),
        title: `book ${i+1}`,
    });
}
books[0].id === mockUuid.getUuid(0); // <-- true

Development

The script is built in Typescript. The intructions below is only relevant if you want to poke in it. Start with $ npm i to install dependencies.

• Build: npm run build
• Test: npm run test