README
Javascript easy string manipulation, file access, ascii conversions, statistics, json, and more ..
by @sha0coder
require('protos.js');
var users = [];
users.load('users.txt'); // arrays can load data
if (!users.has('Peter')) { // arrays can check content
users.push('Peter')
users.save('users.txt') // arrays can save data
}
if ('Peter'.in(users)) { // strings can also check if exists in arrays
'Peter is here'.log(); // strings can console.log
'some error'.err(); // same as console.error()
'John'.appendFile('users.txt') // strings can append to file
}
var str = 'test';
str.log(); // same as console.log(str);
str.save('file.txt');
str.save('file.txt', function() {
'async saved!'.log();
});
var str = ''.load('data.txt');
'myfolder'.mkdir();
> ['a','b','c','d'].cut(1,3);
[ 'b', 'c' ]
> ['a','b','c','d'].cut(0,-1); // -1 means last item
[ 'a', 'b', 'c', 'd' ]
> ['a','b','c','d'].cut(1,-1);
[ 'b', 'c', 'd' ]
> ['a','b','c','d'].cut(-2);
'c'
// walking objects, but only (hasOwnProperty)
> obj.each(function(name, obj) { ...
// STRING MANIPULATION MADE EASY (python style)
> 'hello'.cut(0)
'h'
> 'hello'.cut(-1)
'o'
> 'hello'.cut(0,-1)
'hello'
> 'hello'.cut(-5,-1)
'hello'
> 'hello'.cut(-2,-1)
'lo'
> '<td>prize:</td><td>$100</td>'.between('<td>','</td>')
['prize:','$100']
> 'this is a test'.getChr('s');
[3,6,12]
> 'test is a test'.getStr('test');
[0,10]
'I have {0} years old'.fmt(age).log();
> 'hello'.cut(0,4).log();
'hell'
> 'A'.repeat(3);
AAA
> '3'.toInt();
3
> '3.3'.toFloat();
3.3
> 'a'.toInt().isNum();
false
> 'john'.capitalize()
'John'
// JSON FILES
var struct = {}.load('file.json'); // load json files into js object
struct.save('file.json'); // save js object into json file
struct.save('file.json', function() { // save async
'saved'.log();
});
struct.dir() // same as console.dir(struct);
// FUZZY HASHING thanks to ctph.js
'hello'.compare('hell') // 50%
'hello'.compare('hello') // 100%
'hello'.compare('abcd') // 0%
var hash = 'hello'.fuzzyHash();
// calling a function on all items
objects.call('method',[params]);
// ARRAY USEFUL METHODS
> ['cats','dogs','birds'].choice()
'dogs'
> [3, 1, 2, 3].unique()
[ 3, 1, 2 ]
> [1,2,3,4].common([5,6,1,2]);
[ 1, 2 ]
> [1,2,3,4].notIn([9,3,5,1,2]);
[ 4 ]
> [1,2,3].has(4)
false
> [ 'hola', 'cara', 'cola' ].grep('la');
[ 'hola', 'cola' ]
> [ 'hola', 'cara', 'cola' ].vgrep('la');
[ 'cara' ]
> var n = [1,2,3,4,5];
> n.smap(function(n) { return n*2; });
[ 2, 4, 6, 8, 10 ]
// SHELL EXECUTION
'ls'.exec(function(stdout,stderr) {
stdout.log();
stderr.err();
});
// STATISTICS
> [1,3,2].max()
3
> [1,3,2].min()
1
> [1,3,2].average()
2
> var n = [];
> n.fillNums(1,10);
> n.cut(0,1)
[ 1 ]
> n.cut(-3,-1) // -1 means last item
[ 9, 10 ]
> var n = 0/0;
> n.isNum();
false
>var n=1;
>n.in([1,2,3]);
true
>(1).in([1,2,3]);
true
// INTROSPECT
> var a = {b:1};
> a.dir();
{ b: 1 }
> var a = [1,2,3];
> a.dir();
[ 1, 2, 3 ]
// ASCII chr()
> (0x41).chr();
'A'
> 'a'.chr()
97
> 'HELLO'.chr();
[ 72, 69, 76, 76, 79 ]
> [72,69,76,76,79].chr()
'HELLO'
// ITERATION knowing the index
['dog','cat','bird'].each(function(i,pet) {
pet.log();
});
// TYPES
x.isNumber();
x.isObject();
x.isArray();
x.isString();
x.isBoolean();
// BOOLEANS callback based conditions
(cmd == 'install').call(doInstall); // boleans can call if true
(1 == 2).call(ghostbusters);
true.call(function() {
'always here'.log();
});
false.call(ghostbusters)
'help'.in(process.args).call(doHelp);
// SCHEDULER
> function sayHello() { 'hello'.log(); }
> sayHello.sched(1000) // function will be launched in a setTimeout until return true;
hello
hello
hello
hello
...
// ALL THE PROTOTYPES:
Object.prototype.load = function(filename)
Object.prototype.save = function(filename, cb)
Object.prototype.each = function(cb)
Object.prototype.dir = function()
Object.prototype.has = function(name)
Object.prototype.isNumeric = function()
Object.prototype.isBoolean = function()
Object.prototype.isArray = function()
Object.prototype.isString = function()
Object.prototype.isObject = function()
Object.prototype.isDate = function()
Object.prototype.clone = function()
Array.prototype.dir = function()
Array.prototype.log = function()
Array.prototype.choice = function()
Array.prototype.removeId = function(id)
Array.prototype.grep = function(kw)
Array.prototype.vgrep = function(kw)
Array.prototype.hasSimilar = function(str, min_ratio)
Array.prototype.unique = function()
Array.prototype.load = function(filename)
Array.prototype.save = function(filename)
Array.prototype.clear = function()
Array.prototype.sched = function(millis, cb)
Array.prototype.max = function()
Array.prototype.min = function()
Array.prototype.average = function()
Array.prototype.smap = function(fn)
Array.prototype.has = function(item)
Array.prototype.cut = function(b,e)
Array.prototype.call = function(params)
Array.prototype.fillNums = function(b,e)
Array.prototype.chr = function()
Array.prototype.each = function(cb)
Array.prototype.common = function(arr)
Array.prototype.notIn = function(arr)
Array.prototype.isNumeric = function()
Array.prototype.isBoolean = function()
Array.prototype.isArray = function()
Array.prototype.isString = function()
Array.prototype.isObject = function()
Array.prototype.isDate = function()
Array.prototype.clone = function()
String.prototype.exec = function(cb)
String.prototype.strip = function()
String.prototype.fuzzyHash = function()
String.prototype.log = function()
String.prototype.err = function()
String.prototype.compare = function(str)
String.prototype.capitalize = function()
String.prototype.fmt = function()
String.prototype.load = function(filename, cb)
String.prototype.save = function(filename,cb)
String.prototype.mkdir = function()
String.prototype.appendFile = function(filename)
String.prototype.toInt = function()
String.prototype.toFloat = function()
String.prototype.in = function(arr)
String.prototype.cut = function(b,e)
String.prototype.contains = function(str)
String.prototype.getChr = function()
String.prototype.getStr = function()
String.prototype.between = function()
String.prototype.findChar = function(c) {
String.prototype.isNumeric = function()
String.prototype.isBoolean = function()
String.prototype.isArray = function()
String.prototype.isString = function()
String.prototype.isObject = function()
String.prototype.isDate = function()
Number.prototype.in = function(arr)
Number.prototype.isNaN = function()
Number.prototype.isNum = function()
Number.prototype.log = function()
Number.prototype.chr = function()
Boolean.prototype.call = function(cb)
Boolean.prototype.isNumeric = function()
Boolean.prototype.isBoolean = function()
Boolean.prototype.isArray = function()
Boolean.prototype.isString = function()
Boolean.prototype.isObject = function()
Boolean.prototype.isDate = function()
Number.prototype.isNumber = function()
Number.prototype.isBoolean = function()
Number.prototype.isArray = function()
Number.prototype.isString = function()
Number.prototype.isObject = function()
Number.prototype.isDate = function()
Date.prototype.isNumeric = function()
Date.prototype.isBoolean = function()
Date.prototype.isArray = function()
Date.prototype.isString = function()
Date.prototype.isObject = function()
Date.prototype.isDate = function()
Function.prototype.sched = function(millis)
Function.prototype.clone = function()