1.0.1 • Published 3 years ago

@redeakaa/tooljs v1.0.1

Weekly downloads
5
License
MIT
Repository
github
Last release
3 years ago

NPM Downloads NPM License | Like us a lot? Help others know why you like us! Review this package on pkgreview.dev | ➡ | Review us on pkgreview.dev | | ----------------------------------------------------------------------------------------------------------------------------------------- | --- | --------------------------------------------------------------------------------------------------------------------- |

ToolJS 🛠⚙

This is an open-source collection of functions, methods and routine javascript operations which every front-end developer might have a use for at some point in their project.

It bascially simplifies your work flow by shorthanding some of the long boring codes you write everytime which may consist of so many functions, variables, methods and so on, into a single function. From DOM manipulation, to mathematical calculations to string manipulations and so on all in one library(Pretty useful uh!😎).

Why write or copy the same code over and over again when you could just have it all in one library for easy access (Well step right up ToolJS 👏).

Table of Content 📜

Documentation

See the full documentation and api here ToolJS Documentation and API

Installation:

In Node.js

npm install @redeakaa/tooljs

For Browser

<script src="https://unpkg.com/@redeakaa/tooljs@1.0.1/dist/umd/tooljs.min.js"></script>

For Browser(As a module)

<script type="module" src="https://unpkg.com/@redeakaa/tooljs@1.0.1/dist/esm/tooljs.esm.js"></script>

Usage

Usage In Node.js

To include the libraries default export

const ToolJS = require("@redeakaa/tooljs).default;

Then export a module or an array of modules to a variable and use as needed

var $ = ToolJS.export(["Str", "Calc", "Utils"]);

var total = $.add(10, 50, 40);
console.log(total);
// => 100

var toCamelCase = $.camelCase("Hello World from ToolJS");
console.log(toCamelCase);
// => "helloWorldFromToolJS"

var type = $.typeOf(400);
console.log(type);
// => "number"

Or you can include any of the libraries named exports and call any of its registered methods.

const { DOM, Obj, Str, Num, Calc, Utils } = require("@redeakaa/tooljs");

var capitalized = DOM.capitalize("hello world from toolJS");
console.log(capitalized);
// => "Hello World From ToolJS"

var obj = Obj.push({ name: "John Doe", age: 25 }, { gender: "Male" });
console.log(obj);
// => { name: "John Doe", age: 25, gender: "Male" }

Usage In Browser

If you included the tooljs.min.js file or the tooljs.umd.js, then the ToolJS namespace is automatically exposed to the window object.

// export all methods in all registered module
var _ = ToolJS.export();

// increment 10 by 5.
var val = _.increment(10, 5);
console.log(val);
// => 15

var odd = _.isOdd(27);
console.log(odd);
// => true"

// gets the element whose id = "#myElement"
var el = _.getEl("#myElement");

For ES6 Module's Import Style

var url = "https://unpkg.com/@redeakaa/tooljs@1.0.1/dist/esm/tooljs.esm.js";

import { Utils, Obj } from url;

// sets a cookie which expires in days
Utils.setCookie("username", "John Doe", 14, "/");

// gets the cookie named "username"
var user = Utils.getCookie("username",);
console.log(user);
// => "John Doe"

var myObj = Obj.toObj(["John Doe", "Male"]);
console.log(myObj);
// => { 0: "John Doe", 1: "Male" }

Check out the libraries official documentation page to see a list of all available methods for each module and how to create a module/plugin of your own.

Contributions

Please feel free to make contributions to this project at any point in time. Find any bug, open an issue and we'll fix it together.

Credits

  • Made with 💝 by Okoro Redemption.