{"id":20000116,"url":"https://github.com/blackb1rd-development/tools-kit","last_synced_at":"2025-09-01T17:33:48.063Z","repository":{"id":34883781,"uuid":"181522719","full_name":"BlackB1RD-Development/tools-kit","owner":"BlackB1RD-Development","description":"An easy to use, powerful and multi-functionality tools-kit library for NodeJS written entirely in JavaScript.","archived":false,"fork":false,"pushed_at":"2023-02-02T03:16:53.000Z","size":1599,"stargazers_count":12,"open_issues_count":6,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-29T22:46:52.366Z","etag":null,"topics":["color","color-theme","custom","customization","hastebin","hastebin-client","logger","logger-interface","nodejs","nodejs-library","nodejs-modules","npm","npm-module","npm-package","utilities","utility","utility-library"],"latest_commit_sha":null,"homepage":"https://tools-kit.js.org/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlackB1RD-Development.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-04-15T16:10:38.000Z","updated_at":"2024-04-19T21:41:38.000Z","dependencies_parsed_at":"2023-02-17T13:46:05.870Z","dependency_job_id":null,"html_url":"https://github.com/BlackB1RD-Development/tools-kit","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackB1RD-Development%2Ftools-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackB1RD-Development%2Ftools-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackB1RD-Development%2Ftools-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackB1RD-Development%2Ftools-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackB1RD-Development","download_url":"https://codeload.github.com/BlackB1RD-Development/tools-kit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224393804,"owners_count":17303725,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["color","color-theme","custom","customization","hastebin","hastebin-client","logger","logger-interface","nodejs","nodejs-library","nodejs-modules","npm","npm-module","npm-package","utilities","utility","utility-library"],"created_at":"2024-11-13T05:13:50.070Z","updated_at":"2024-11-13T05:13:50.790Z","avatar_url":"https://github.com/BlackB1RD-Development.png","language":"JavaScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=\"500\" src=\"src/logo.png\" alt=\"Tools-Kit Logo\"\u003e\n  \u003cbr\u003e\n  An easy to use, powerful and multi-functionality tools-kit library for NodeJS written entirely in JavaScript.\n  \u003cbr\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://www.npmjs.com/package/tools-kit\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/tools-kit.svg?style=flat-square\" alt=\"npm\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/BlackB1RD-Development/tools-kit\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/release/BlackB1RD-Development/tools-kit.svg?style=flat-square\" alt=\"release\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/tools-kit\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/dt/tools-kit.svg?style=flat-square\" alt=\"downloads\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/tools-kit\"\u003e\n    \u003cimg src=\"https://img.shields.io/node/v/tools-kit.svg?style=flat-square\" alt=\"node\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/BlackB1RD-Development/tools-kit/blob/master/LICENSE.md\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/l/tools-kit.svg?style=flat-square\" alt=\"license\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://coveralls.io/github/BlackB1RD-Development/tools-kit?branch=master\"\u003e\n    \u003cimg src=\"https://coveralls.io/repos/github/BlackB1RD-Development/tools-kit/badge.svg?branch=master\" alt=\"Coverage Status\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://travis-ci.org/BlackB1RD-Development/tools-kit\"\u003e\n    \u003cimg src=\"https://travis-ci.org/BlackB1RD-Development/tools-kit.svg?branch=master\" alt=\"Build\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://app.fossa.com/projects/git%2Bgithub.com%2FBlackB1RD-Development%2Ftools-kit?ref=badge_shield\" alt=\"FOSSA Status\"\u003e\n    \u003cimg src=\"https://app.fossa.com/api/projects/git%2Bgithub.com%2FBlackB1RD-Development%2Ftools-kit.svg?type=shield\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/BlackB1RD-Development/tools-kit\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/code_style-XO-5ed9c7.svg\" alt=\"Code Style\" /\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\n  \u003ca href=\"https://nodei.co/npm/tools-kit/\"\u003e\n    \u003cimg src=\"https://nodei.co/npm/tools-kit.png\"\u003e\n  \u003c/a\u003e\n  \u003cbr /\u003e\n  \u003csub\u003e© \u003ca href=\"https://www.npmjs.com/package/tools-kit\"\u003eTools-Kit\u003c/a\u003e By \u003ca href=\"https://github.com/BlackB1RD-Development\"\u003eBlackB1RD-Development\u003c/a\u003e (Author: \u003ca href=\"https://github.com/RealBlackB1RD\"\u003e@RealBlackB1RD\u003c/a\u003e). All rights reserved ©\u003c/sub\u003e\n\u003c/p\u003e\n\n# Features\n\n- A [**Hastebin**][hastebin] Client that can post and fetch code easily from [**Hastebin**][hastebin].\n- A Logger Manager that can log a styled and colored text into the console.\n- A Styles Manager that can transfer your simple text into a styled and modern one.\n- A collection of easy to use and useful functions.\n- Extremely configurable and debuggable.\n- Well documented.\n\n# Install\n\n## NPM Through GitHub\n\n```console\nnpm install BlackB1RD-Development/tools-kit --save\n```\n\n## NPM\n\n```console\nnpm install tools-kit --save\n```\n\n## Yarn\n\n```console\nyarn add tools-kit\n```\n\n# Documentations\n\nRead the [**Documentations**][documentations] for more information about each method.\n\n# Table of Content\n\n#### Click to jump between class examples\n\n|              Class  Name              |                                 Class Description                                  |\n|            ---------------            |   ------------------------------------------------------------------------------   |\n|[**Hastebin Client**](#hastebin-client)|              Post and fetch code easily from [**Hastebin**][hastebin]              |\n| [**Logger Manager**](#logger-manager) |                   Log a styled and colored text into the console                   |\n| [**Styles Manager**](#styles-manager) |    Transfer your simple text into a styled and modern one (Console support only)   |\n|      [**Utilities**](#utilities)      |                  A collection of easy to use and useful functions                  |\n\n## Hastebin Client\n\nWith the [**Hastebin**][hastebin] Client you can post and fetch code easily from [**Hastebin**][hastebin].\n\n```javascript\nconst { logger, hastebin } = require('tools-kit');\n\nhastebin.post('var test = \\'test\\';\\n\\nconsole.log(test);', '.js')\n  .then(async postRes =\u003e {\n    logger.success({ tag: 'POST RES' }, postRes);\n    // Console \u003e [20/02/2020 - 00:00:00 | POST RES]: HastebinObject{}\n\n    await hastebin.get(postRes.link)\n      .then(getRes =\u003e {\n        logger.success({ tag: 'GET RES' }, getRes);\n        // Console \u003e [20/02/2020 - 00:00:00 | GET RES]: HastebinObject{}\n      })\n      .catch(getErr =\u003e {\n        logger.error({ tag: 'GET ERROR' }, getErr);\n        // Console \u003e [20/02/2020 - 00:00:00 | GET ERROR]: Error: Get Error\n      });\n  })\n  .catch(postErr =\u003e {\n    logger.error({ tag: 'POST ERROR' }, postErr);\n    // Console \u003e [20/02/2020 - 00:00:00 | POST ERROR]: Error: Post Error\n  });\n```\n\n## Logger Manager\n\nWith the Logger Manager you can log a styled and colored text into the console with pre made logging settings in each method.\n\n```javascript\nconst { logger } = require('tools-kit');\n\nlogger.log('content');\n// Console \u003e [20/02/2020 - 00:00:00 | LOG]: content\n\nlogger.important('Important log');\n// Console \u003e [20/02/2020 - 00:00:00 | IMPORTANT]: Important log\n\nlogger.success('Success log');\n// Console \u003e [20/02/2020 - 00:00:00 | SUCCESS]: Success log\n\nlogger.fatal('Fatal log');\n// Console \u003e [20/02/2020 - 00:00:00 | FATAL]: Fatal log\n\nlogger.trace('Trace log');\n// Console \u003e [20/02/2020 - 00:00:00 | TRACE]: Trace log\n\nlogger.error('Error log');\n// Console \u003e [20/02/2020 - 00:00:00 | ERROR]: Error log\n\nlogger.debug('Debug log');\n// Console \u003e [20/02/2020 - 00:00:00 | DEBUG]: Debugging log\n\nlogger.info('Information log');\n// Console \u003e [20/02/2020 - 00:00:00 | INFO]: Information log\n\nlogger.warn('Warning log');\n// Console \u003e [20/02/2020 - 00:00:00 | WARN]: Warning log\n\nlogger.figlet('FIGLET', 'LOG');\n/*\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:   _____ ___ ____ _     _____ _____   _     ___   ____\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  |  ___|_ _/ ___| |   | ____|_   _| | |   / _ \\ / ___|\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | |_   | | |  _| |   |  _|   | |   | |  | | | | |  _\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  |  _|  | | |_| | |___| |___  | |   | |__| |_| | |_| |\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  |_|   |___\\____|_____|_____| |_|   |_____\\___/ \\____|\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:\n*/\n```\n\nUsing custom options:\n\n```javascript\nconst { logger } = require('tools-kit');\n\n// Support custom logging options and rewriting of existing methods settings\nconst scsSettings = {\n    time: 'H:mm',\n    tag: 'PUBLISH SUCCESS',\n    format: (options) =\u003e {\n      return `[${options.tag}]: Published ${options.content} successfully at ${options.time}`;\n    }\n  }, errSettings = {\n    time: 'H:mm',\n    tag: 'PUBLISH ERROR',\n    format: (options) =\u003e {\n      return `[${options.tag}]: Couldn't publish ${options.content} at ${options.time}`;\n    }\n  }, settings = {\n    tag: 'PUBLISH API',\n    format: (options) =\u003e {\n      return `[${options.tag}]: Publish API ${options.content} | Last Check: ${options.time}`;\n    }\n  }, figSettings = {\n    figlet: {\n      font: 'Ghost',\n      verticalLayout: 'default',\n      horizontalLayout: 'default'\n    },\n    log: {\n      name: 'figlet',\n      options: {\n        background: 'black',\n        color: 'red',\n        style: 'bold',\n        type: 'log',\n        time: 'MM/DD/YY',\n        tag: true,\n        format: (options) =\u003e {\n          return !options.time \u0026\u0026 !options.tag ? options.content : !options.time ? `[${options.tag}]: ${options.content}` : !options.tag ? `[${options.time}]: ${options.content}` : `[${options.time} | ${options.tag}]: ${options.content}`;\n        }\n      }\n    }\n  }, image = {\n    name: 'logo.png',\n    size: '5MB'\n  }, api = {\n    message: 'Internal Server Error',\n    code: '500'\n  };\n\nlogger.success(scsSettings, 'image named \"%s\" with a total size of %s', image.name, image.size);\n// Console \u003e [PUBLISH SUCCESS]: Published image named \"logo.png\" with a total size of 5MB successfully at 20:00\n\nlogger.error(errSettings, 'image named \"%s\" with a total size of %s', image.name, image.size);\n// Console \u003e [PUBLISH ERROR]: Couldn't publish image named \"logo.png\" with a total size of 5MB at 20:00\n\nlogger.info(settings, 'respond with %s status code and \"%s\" message', api.code, api.message);\n// Console \u003e [PUBLISH API]: Publish API respond with 500 status code and \"Internal Server Error\" message | Last Check: 20/2/2020 - 20:00:00\n\nlogger.log({ time: false }, 'log', 'no time');\n// Console \u003e [LOG]: log no time\n\nlogger.figlet(figSettings, 'Boo');\n/*\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]: .-. .-')\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]: \\  ( OO )\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  ;-----.\\  .-'),-----.  .-'),-----.\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | .-.  | ( OO'  .-.  '( OO'  .-.  '\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | '-' /_)/   |  | |  |/   |  | |  |\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | .-. `. \\_) |  |\\|  |\\_) |  |\\|  |\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | |  \\  |  \\ |  | |  |  \\ |  | |  |\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  | '--'  /   `'  '-'  '   `'  '-'  '\n  Console \u003e [20/02/2020 - 00:00:00 | FIGLET]:  `------'      `-----'      `-----'\n*/\n\nlogger.log({ time: 'MM-DD-YY' }, 'log', 'custom time format');\n// Console \u003e [02-20-2020 | LOG]: log custom time format\n\nlogger.log({ tag: false }, 'log', 'no tag');\n// Console \u003e [20/02/2020 - 00:00:00]: log no tag\n\nlogger.log({ tag: 'CUSTOM TAG' }, 'log', 'custom tag');\n// Console \u003e [20/02/2020 - 00:00:00 | CUSTOM TAG]: log custom tag\n\nlogger.log({ time: false, tag: false }, 'log', 'no tag', 'no time');\n// Console \u003e log no tag no time\n\nlogger // Support chain logging\n  .log({ tag: 'FIRST LOG' }, 'First content')\n  .log({ tag: 'SECOND LOG' }, 'Second content')\n  .log({ tag: 'THIRD LOG' }, 'Third content');\n/*\n  Console \u003e [20/02/2020 - 00:00:00 | FIRST LOG]: First content\n  Console \u003e [20/02/2020 - 00:00:00 | SECOND LOG]: Second content\n  Console \u003e [20/02/2020 - 00:00:00 | THIRD LOG]: Third content\n*/\n```\n\nSee more backgrounds, colors, styles \u0026 consoles types by clicking [**here**](#logger-options)\n\n## Styles Manager\n\nWith the Styles Manager you can transfer your simple text into a styled and modern one.\n\n```javascript\nconst { logger, style } = require('tools-kit');\n\nlogger.log({ tag: 'STYLE' },\n  styles.bgGreen('testing %s', 'background'),\n  styles.red('testing %s', 'color'),\n  styles.underline('testing %s', 'style'),\n  styles.bgGreen.red.underline('testing %s', 'a style chain')\n);\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE]: testing background testing color testing style testing a style chain\n\nlogger.log({ tag: 'STYLE OBJECT' }, styles.stylify({ background: 'bgGreen' }, 'styled background'), 'normal background');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE OBJECT]: styled background normal background\n\nlogger.log({ tag: 'STYLE OBJECT' }, styles.stylify({ color: 'red' }, 'styled color'), 'normal color');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE OBJECT]: styled color normal color\n\nlogger.log({ tag: 'STYLE OBJECT' }, styles.stylify({ style: 'underline' }, 'styled style'), 'normal style');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE OBJECT]: styled style normal style\n\nlogger.log({ tag: 'STYLE OBJECT' }, styles.stylify({ background: 'bgGreen', color: 'red', style: 'underline' }, 'styled text'), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE OBJECT]: styled text normal text\n\nlogger.log({ tag: 'STYLE METHOD' }, styles.background('bgGreen', 'styled background'), 'normal style');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE METHOD]: styled background normal style\n\nlogger.log({ tag: 'STYLE METHOD' }, styles.color('red', 'styled color'), 'normal style');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE METHOD]: styled color normal style\n\nlogger.log({ tag: 'STYLE METHOD' }, styles.style('underline', 'styled style'), 'normal style');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE METHOD]: styled style normal style\n\nlogger.log({ tag: 'STYLE METHOD' }, styles.bgGreen.red.underline('styled text'), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | STYLE METHOD]: styled text normal text\n\nconst colors = [\n  styles.rgb([255, 0, 0]),\n  styles.hex('#ffff00'),\n  styles.hsv([180, 100, 100]),\n  styles.hsl([120, 100, 50]),\n  styles.hwb([240, 0, 0]),\n  styles.lab([35, 80, -104]),\n  styles.xyz([59, 28, 97]),\n  styles.lch([88, 90, 149]),\n  styles.cmyk([100, 50, 0, 0]),\n  styles.ansi16(12),\n  styles.ansi256(250),\n  styles.keyword('DeepSkyBlue')\n];\n\nlogger.log({ tag: 'CUSTOM MAP' }, styles.map('custom map styled-text', colors), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | CUSTOM MAP]: custom map styled-text normal text\n```\n\nUsing pre-made cool colors maps:\n\n```javascript\nconst { logger, color } = require('tools-kit');\n\nlogger.log({ tag: 'RAINBOW' }, styles.rainbow('rainbow styled-text'), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | RAINBOW]: rainbow styled-text normal text\n\nlogger.log({ tag: 'RANDOM' }, styles.random('random styled-text'), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | RANDOM]: random styled-text normal text\n\nlogger.log({ tag: 'ZEBRA' }, styles.zebra('zebra styled-text'), 'normal text');\n// Console \u003e [20/02/2020 - 00:00:00 | ZEBRA]: zebra styled-text normal text\n```\n\n## Utilities\n\nWith Tools-Kit Utilities you can use the functions that everyone uses in one simple line.\n\n```javascript\nconst { logger, util } = require('tools-kit');\n\nlogger.log({ tag: 'HAS?' }, util.has({}, 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has([], 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has({ name: 'test' }, 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: true\n\nlogger.log({ tag: 'HAS?' }, util.has({ name: 'test' }, 'test'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has({ name: 'test' }, 'name', 'test'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: true\n\nlogger.log({ tag: 'HAS?' }, util.has({ name: 'test' }, 'name', 'not test'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has(['name', 'test'], 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: true\n\nlogger.log({ tag: 'HAS?' }, util.has(['test', 'not test'], 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has([{ 'name': 'not test' }, { 'name': 'test' }], 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: true\n\nlogger.log({ tag: 'HAS?' }, util.has([{ 'name': 'not test' }, { 'name': 'test' }], 'test', 'name'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: false\n\nlogger.log({ tag: 'HAS?' }, util.has([{ 'name': 'not test' }, { 'name': 'test' }], 'name', 'test'));\n// Console \u003e [20/02/2020 - 00:00:00 | HAS?]: true\n\nlogger.log({ tag: 'ARRAY?' }, util.isArray(new Array()));\n// Console \u003e [20/02/2020 - 00:00:00 | ARRAY?]: true\n\nlogger.log({ tag: 'ARRAY?' }, util.isArray(new Object()));\n// Console \u003e [20/02/2020 - 00:00:00 | ARRAY?]: false\n\nlogger.log({ tag: 'ARRAY?' }, util.isArray([]));\n// Console \u003e [20/02/2020 - 00:00:00 | ARRAY?]: true\n\nlogger.log({ tag: 'ARRAY?' }, util.isArray({}));\n// Console \u003e [20/02/2020 - 00:00:00 | ARRAY?]: false\n\nlogger.log({ tag: 'OBJECT?' }, util.isObject(new Object()));\n// Console \u003e [20/02/2020 - 00:00:00 | OBJECT?]: true\n\nlogger.log({ tag: 'OBJECT?' }, util.isObject(new Array()));\n// Console \u003e [20/02/2020 - 00:00:00 | OBJECT?]: false\n\nlogger.log({ tag: 'OBJECT?' }, util.isObject({}));\n// Console \u003e [20/02/2020 - 00:00:00 | OBJECT?]: true\n\nlogger.log({ tag: 'OBJECT?' }, util.isObject([]));\n// Console \u003e [20/02/2020 - 00:00:00 | OBJECT?]: false\n\nlogger.log({ tag: 'RANDOM ITEM' }, util.randomItem(['cat', 'dog', 'fish']));\n// Console \u003e [20/02/2020 - 00:00:00 | RANDOM ITEM]: fish\n\nlogger.log({ tag: 'RANDOM NUMBER' }, util.randomNumber(5, 10));\n// Console \u003e [20/02/2020 - 00:00:00 | RANDOM NUMBER]: 8\n\nlogger.log({ tag: 'RANDOM NUMBER' }, util.randomNumber(5, 10, false)); // Default is true\n// Console \u003e [20/02/2020 - 00:00:00 | RANDOM NUMBER]: 9.478004123859458\n```\n\n## Logger Options\n\n### options.background\n\n- `bgBlack`\n- `bgGray`\n- `bgGrey`\n- `bgRed`\n- `bgGreen`\n- `bgYellow`\n- `bgBlue`\n- `bgMagenta`\n- `bgCyan`\n- `bgWhite`\n\n#### Light Backgrounds\n\n- `bgLBlack`\n- `bgLRed`\n- `bgLGreen`\n- `bgLYellow`\n- `bgLBlue`\n- `bgLMagenta`\n- `bgLCyan`\n- `bgLWhite`\n\n#### Bright Backgrounds\n\n- `bgBGray`\n- `bgBGrey`\n- `bgBRed`\n- `bgBGreen`\n- `bgBYellow`\n- `bgBBlue`\n- `bgBMagenta`\n- `bgBCyan`\n- `bgBWhite`\n\n### options.colors\n\n- `black`\n- `gray`\n- `grey`\n- `red`\n- `green`\n- `yellow`\n- `blue`\n- `magenta`\n- `cyan`\n- `white`\n\n#### Light Colors\n\n- `lblack`\n- `lred`\n- `lgreen`\n- `lyellow`\n- `lblue`\n- `lmagenta`\n- `lcyan`\n- `lwhite`\n\n#### Bright Colors\n\n- `bgray`\n- `bgrey`\n- `bred`\n- `bgreen`\n- `byellow`\n- `bblue`\n- `bmagenta`\n- `bcyan`\n- `bwhite`\n\n### options.style\n\n- `reset` - Resets the current color to the default console color.\n- `bold` - Make the text bold.\n- `dim` - Emitting only a small amount of the text light.\n- `italic` - Make the text *italic* styled - **Not widely supported**\n- `underline` - Make the text _underline_ styled - **Not widely supported**\n- `inverse`- Inverse the background and the foreground colors.\n- `hidden` - Prints the text, but makes it invisible.\n- `strikethrough` - Puts a horizontal line through the center of the text - **Not widely supported**\n\n### options.type\n\n- `log` - Prints to `stdout` with newline. Multiple arguments can be passed, with the first used as the primary message and all additional used as substitution values similar to `printf(3)` (the arguments are all passed to `util.format()`).\n- `error` - Prints to `stderr` with newline. Multiple arguments can be passed, with the first used as the primary message and all additional used as substitution values similar to `printf(3)` (the arguments are all passed to `util.format()`).\n- `trace` - Prints to `stderr` the string 'Trace: ', followed by the `util.format()` formatted message and stack trace to the current position in the code.\n- `debug`- The `console.debug()` function is an alias for `console.log()`.\n- `info` - The `console.info()` function is an alias for `console.log()`.\n- `warn` - The `console.warn()` function is an alias for `console.error()`.\n\n### options.time\n\n#### The `options.time` can be either of this two\n\n- `Boolean` (true/false) - If to include the current time and date with the stock format when logging (Stock used [**moment**][moment] format: DD/M/YYYY - H:mm:ss)\n- `String` - A custom [**moment**][moment] time format to use when logging\n\n### options.tag\n\n#### The `options.tag` can be either of this two\n\n- `Boolean` (true/false) - If to include the a tag when logging\n- `String` - A custom string value to use as a tag when logging (Case sensitive)\n\n# Author\n\n- [**BlackB1RD**][blackb1rd]\n\n# Maintainers\n\n- [**BlackB1RD-Development**][blackb1rd-development]\n\nSee also the list of [**contributors**](contributors) who participated in this project.\n\n# Changelog\n\nSee the [**Changes Log**][changelog] for more information about each update.\n\n# License\n\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FBlackB1RD-Development%2Ftools-kit.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FBlackB1RD-Development%2Ftools-kit?ref=badge_large)\n\n# Related Modules\n\n- [**supports-color**][supports-color] — Detect whether a terminal supports color.\n- [**color-convert**][color-convert] — Plain color conversion functions.\n- [**node-fetch**][node-fetch] — A light-weight module that brings window.fetch to Node.js.\n- [**moment**][moment] — A lightweight JavaScript date library for parsing, validating, manipulating, and formatting dates.\n- [**figlet**][figlet] — Creates ASCII Art from text. A full implementation of the FIGfont spec.\n\n[hastebin]:https://toptal.com/developers/hastebin/about.md\n[changelog]:https://github.com/BlackB1RD-Development/tools-kit/blob/master/CHANGELOG.md\n[contributors]:https://github.com/BlackB1RD-Development/tools-kit/contributors\n[documentations]:https://tools-kit.js.org/api\n[supports-color]: https://www.npmjs.com/package/supports-color\n[color-convert]: https://www.npmjs.com/package/color-convert\n[node-fetch]: https://www.npmjs.com/package/node-fetch\n[moment]: https://www.npmjs.com/package/moment\n[figlet]: https://www.npmjs.com/package/figlet\n[blackb1rd]: https://github.com/RealBlackB1RD\n[blackb1rd-development]: https://github.com/BlackB1RD-Development\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackb1rd-development%2Ftools-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackb1rd-development%2Ftools-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackb1rd-development%2Ftools-kit/lists"}