https://github.com/ngneat/falso

All the Fake Data for All Your Real Needs 🙂
https://github.com/ngneat/falso

data fake fakedata mock mockdata random

Last synced: about 2 months ago
JSON representation

All the Fake Data for All Your Real Needs 🙂

• Host: GitHub
• URL: https://github.com/ngneat/falso
• Owner: ngneat
• License: mit
• Created: 2022-01-08T18:21:34.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-02-21T08:01:58.000Z (7 months ago)
• Last Synced: 2024-05-01T11:39:41.905Z (5 months ago)
• Topics: data, fake, fakedata, mock, mockdata, random
• Language: TypeScript
• Homepage: https://ngneat.github.io/falso/
• Size: 13.1 MB
• Stars: 3,118
• Watchers: 14
• Forks: 111
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • Changelog: changelog.config.js
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• my-awesome-list - falso
• awesome-github-repos - ngneat/falso - All the Fake Data for All Your Real Needs 🙂 (TypeScript)
• awesome-opensource-israel - @ngneat/falso - All the Fake Data for All Your Real Needs 🙂    (Projects by main language / typescript)
• awesome-angular - falso - All the Fake Data for All Your Real Needs. (Table of contents / Third Party Components)

README

        


 



> All the Fake Data for All Your Real Needs 🙂

Create massive amounts of fake data in the browser and NodeJS. Tree Shakeable & Fully Typed.





[![@ngneat/falso](https://github.com/ngneat/falso/actions/workflows/ci.yml/badge.svg)](https://github.com/ngneat/falso/actions/workflows/ci.yml)

[![commitizen](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=flat-square)]()

[![PRs](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)]()

[![coc-badge](https://img.shields.io/badge/codeof-conduct-ff69b4.svg?style=flat-square)](CODE_OF_CONDUCT.md)

[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e5079.svg?style=flat-square)](https://github.com/semantic-release/semantic-release)

[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)



✅  203 Functions  

✅  Tree Shakable  

✅  Fully Typed  

✅  Factory Functions  

✅  Entity Functions  

✅  Single and Array Result

🤓 Learn about it on the [docs site](https://ngneat.github.io/falso/) 


## Sponsoring ngneat

[Sponsorships](https://github.com/sponsors/ngneat) aid in the continued development and maintenance of ngneat libraries. Consider asking your company to sponsor ngneat as its core to their business and application development.

### Gold Sponsors

Elevate your support by becoming a Gold Sponsor and have your logo prominently featured on our README in the top 5 repositories.

### Silver Sponsors

Boost your backing by becoming a Gold Sponsor and enjoy the spotlight with your logo prominently showcased in the top 3 repositories on our README.

### Bronze Sponsors



  



Become a bronze sponsor and get your logo on our README on GitHub.

## StackBlitz

[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz_small.svg)](https://stackblitz.com/edit/typescript-pj5epp?file=index.ts)

## Installation

```

npm i @ngneat/falso

yarn add @ngneat/falso

```

### Usage

```ts

import { randEmail, randFullName } from '@ngneat/falso';

const user = { email: randEmail(), name: randFullName() };

const emails = randEmail({ length: 10 });

```

You can specify the length of elements you want to generate. Below is an example of generating 10 emails with length equal or smaller than 20 characters.

```ts

const emails = randEmail({ length: 10, maxCharCount: 20 });

```

### Setting a Randomness Seed

You can set your own seed if you want consistent results:

```ts

import { rand, seed } from '@ngneat/falso';

seed('some-constant-seed');

// Always returns 2

rand([1, 2, 3, 4, 5]);

// Reset random seed

seed();

```

## Contribute

- Go over the steps in [this](https://github.com/firstcontributions/first-contributions) guide

- Add a new falso

![contribute](contribute.gif)

- Use `npm run c` and choose the right answers

Icons made by Freepik from www.flaticon.com