vitals

Give Your JS Life

vitals is a foundational JavaScript library designed to replace all native string, object and array methods with just 16 base methods. It will improve your project's readability, stability and performance. It fixes core JS issues such as + overloading and unequal equality. Its additional methods will also allow you to more efficiently utilize immutability, strong typing, and node.js interactions with the file system or shell. Built with simplicity vitals hopes to inspire you to use functional JavaScript as the bedrock for all of your projects!

Own That String Example

// every root vitals method handles multiple operations
// most handle responses for objects, arrays, and strings
// sub vitals methods offer fine-grained control
// watch this example of vitals owning stringy things

var v, i, t, a, l, s;
var functional, life;

life = '123abc345XYZ';
v = require('node-vitals')('base');
i = v.cut(life, 3, /[a-z]/g); // "1245XYZ"
t = v.remap(life, 3, 'w$&');  // "12w3abcw345XYZ"
a = v.slice(life, -3, -1);    // "XY"
l = v.get(life, /[A-Z]/);     // [ "X", "Y", "Z" ]
s = v.fuse('v', life);        // "v123abc345XYZ"
v.has(life, 'Z');             // true
v.is('str|arr', i, t, a, l);  // true
v.is.str(i, t, a, l);         // false
l = v.to.str(l, '~');         // "X~Y~Z"
v.is.str(i, t, a, l);         // true

// goodbye confusing equality
var same = require('node-vitals')('same');
var v =  1;
var _ = '1';
same.ish(v, _); // true
same(v, _);    // false

Install & Use

node.js

• npm install node-vitals
• var vitals = require('node-vitals')([...method|section])

browser

• download vitals.min.js
• <script src="vitals.min.js"></script> (add to html)
• vitals.<method> (appended to window)

amd

• download vitals.min.js
• require([ 'vitals' ], function(null) { ... })
• vitals.<method> (appended to window)

API

| Base Methods | Strict Methods | File System Methods | Shell Methods | | :------------------------------------------------------------: | :--------------------------------------------------------------: | :----------------------------------------------------------: | :--------------------------------------------------------: | | bind* | amend | copy | run | | copy | cap* | cut* | | | cut | create | get | | | each | freeze | to | | | fill | seal | | | | fuse | | | | | get | | | | | has | | | | | is | | | | | remap | | | | | roll | | | | | same | | | | | slice | | | | | to | | | | | trim* | | | | | until | | | | * Scheduled for future release.

Other Details

contributing: see contributing guideline bugs/improvements: open an issue questions: [email protected]

-- Happy Developing,