1.7.0 • Published 1 year ago
@decimalvalues/faker v1.7.0
Decimalvalues Faker
Table of contents
Introduction
Decimalvalues Faker is a tiny javascript library for creating fake random data. It comes with its own command line to help in the creating of the fake data.
Installation
npm install --save-dev @decimalvalues/faker
Usage
Add the following line to the package script property
"scripts": {
"faker": "decimalvalues-faker faker.config.js"
}
Create a javascript file at the root of the application with any name eg "faker.config.js"
npm run faker
Configuration
An object module with the following properties:
Properties | Description |
---|---|
outDir | The output directory for the random faker data. |
filename | The name to be given to the random data. |
structure | This property contains an abstract construction of the faker data structure. |
API Reference
Functions | Description |
---|---|
getUsername | Generate random username |
getEmail | Generate random email |
getId | Generate a unique id |
getText | Generate random text |
getName | Generate random full name |
getContact | Generate random contact |
getImage | Generate random image link |
getFromList | Generate a random content based on the given argument |
getBoolean | Generate a random boolean |
getNumber | Generate a random number from a range of input |
getCountry | Generate a random country |
getGender | Generate a random gender |
getColor | Generate a random color |
getTitle | Generate a random title eg Mr |
faker | A generic function that wraps the data structure |
repeat | A function that helps to repeat a certain data structure |
Example
faker.config.js
const {
faker,
getUsername,
getId,
repeat,
getName,
getEmail,
} = require("@decimalvales/faker");
/** @type {import("./types").FakerConfig} */
module.exports = {
outDir: "/",
filename: "data.json",
structure: faker({
username: getUsername(),
id: getId(),
friends: repeat(
{
fullName: getName,
email: getEmail,
id: getId,
},
{ count: 2, key: "id" }
),
}),
};
Contributing
Contributions are always welcome!
See contributing.md
for ways to get started.
Please adhere to this project's code of conduct
.
Feedback
If you have any feedback, please reach out to us at decimalvalues@gmail.com