@faykah/core
Data mock library.
📎 Summary
🤔 Requirements
⬇️ Installation
Browser
Script
<!DOCTYPE html>
<html>
<script src="https://unpkg.com/@faykah/core"></script>
<script>
"use strict";
const {createGenerator, createObjectGenerator} = Faykah;
</script>
</html>ECMAScript Module
<!DOCTYPE html>
<html>
<script type="module">
"use strict";
import {createGenerator, createObjectGenerator} from "https://unpkg.com/@faykah/core/lib/index.esm.min.js";
</script>
</html>Node
$ npm install --save @faykah/coreCommonJS
const {createGenerator, createObjectGenerator} = require("@faykah/core");ECMAScript Module
import {createGenerator, createObjectGenerator} from "@faykah/core";
🤔 Usage
Generator
Classic
// Creates a handy function to pick a random first name
const generateFirstName = createGenerator(["Nelson", "Martin", "Muhammad", "Mahatma", "Dalai"]);
// First name randomly picked
const firstName = generateFirstName();With libraries
import {firstNames} from "@faykah/first-names-en";
// Creates a handy function to pick a random first name
const generateFirstName = createGenerator(firstNames);
// First name randomly picked
const firstName = generateFirstName();With middleware function
import {firstNames} from "@faykah/first-names-en";
// Creates a handy function to pick a random first name
const generateFirstName = createGenerator(firstNames);
// Return an uppercase version of the text
const uppercased = text => text.toUpperCase();
// First name randomly picked and uppercased
const name = generateName(uppercased);Object generator
Classic
// Creates a handy function to pick a random user
const generateUser = createObjectGenerator({
// Pick a random email
email: ["first@domain.com", "second@domain.com", "third@domain.com"],
// Pick a random first name
firstName: ["first", "second", "third"],
// Pick a random last name
lastName: ["fourth", "fifth", "sixth"]
});
// User randomly picked
const user = generateUser();With libraries
import {emails} from "@faykah/emails-en";
import {firstNames} from "@faykah/first-names-en";
import {lastNames} from "@faykah/last-names-en";
// Create a handy function to pick a random user
const generateUser = createObjectGenerator({
// Pick a random email
email: emails,
// Pick a random first name
firstName: firstNames,
// Pick a random last name
lastName: lastNames
});
// User randomly picked
const user = generateUser();With middleware functions
import {emails} from "@faykah/emails-en";
import {firstNames} from "@faykah/first-names-en";
import {lastNames} from "@faykah/last-names-en";
// Create a handy function to pick a random user
const generateUser = createObjectGenerator({
// Pick a random email
email: emails,
// Pick a random first name
firstName: firstNames,
// Pick a random last name
lastName: lastNames
});
// Handy function to uppercase a text
const uppercased = text => text.toUpperCase();
// Handy function to lowercase a text
const lowercased = text => text.toLowerCase();
// User randomly picked with transformations
const user = generateUser({
firstName: lowercased,
lastName: uppercased
});With nested configuration
import {emails} from "@faykah/emails-en";
import {firstNames} from "@faykah/first-names-en";
import {lastNames} from "@faykah/last-names-en";
// Create a handy function to pick a random user
const generateUser = createObjectGenerator({
// Pick a random first name
firstName: firstNames,
// Pick a random last name
lastName: lastNames,
// Meta user informations
meta: {
// Pick a random email
email: emails
}
});
// Creates a handy function to uppercase a text
const uppercased = text => text.toUpperCase();
// User randomly picked
const user = generateUser({meta: {email: uppercased}});With multiple generators
import {emails} from "@faykah/emails-en";
import {firstNames} from "@faykah/first-names-en";
import {lastNames} from "@faykah/last-names-en";
// Create a handy function to pick a random user
const generateUserName = createObjectGenerator({
// Pick a random first name
firstName: firstNames,
// Pick a random last name
lastName: lastNames
});
// Creates a handy function for generating user informations
const generateUserInformations = createObjectGenerator({
// Pick a random email
email: emails
});
// User randomly picked
const user = {
...generateUserName(),
...generateUserInformations()
};
🔖 Changelog
See CHANGELOG.md
🙏 Contributing
See CONTRIBUTING.md
📜 License
See LICENSE