myutils

Some useful utils.

##installation

$ npm install myutils --save

###Example:

'use strict';
require('should');
var utils = require('myutils');

utils.version.compare("1.0" , "1.0.1").should.equal(-1);
utils.net.ipToInt('192.168.0.1').should.equal(3232235521);

##API: invoke convention: module.$method should use like this yield module.$method in co or koa envirment.

###hash

• md5(str) - md5 string in hex.
• sig(str,alg) - hash str with specified alg like 'md5,sha1...'.
• md5File(file, cb) - md5 a file.
• sigFile(file,alg ,cb) - signature a file with specified alg.
• timer33(str) -
• $md5File(file) - md5 file.eg. yield hash.$md5File('xx').
• $sigFile(file,alg) - signature a file with specified alg.eg.yield hash.$sigFile('xx','sha1')

###net

• ipToInt(ip) - ipToInt('192.168.0.1') == 3232235521;
• intToIp(ip) - '192.168.0.1' == intToIp(3232235521);

###random

• nextInt(max) - generate random integer in [0,max).

###version

• compare(v1,v2) - version compare. eg.compare("1.0" , "1.0.1") will be -1.v1 > v2 => 1; v1 == v2 => 0; v1 < v2 => -1

###object

• parse(jsonStr) - parse a json string to object with no exception throwing. if jsonStr is not a string type,it will return jsonStr directly;

###fsp implements with use system command

• mkdirs(dir, cb) -
• mv(src, dst, cb) -
• mvf(src, dst, cb) - force move ,if dst dir not exits ,create it.
• cp(src, dst, cb) - copy
• cpf(src, dst, cb) - force copy,if dst dir not exits ,create it.
• rm(src, cb) -
• $mkdirs(dir) -
• $mv(src, dst) -
• $mvf(src, dst) - force move ,if dst dir not exits ,create it.
• $cp(src, dst) - copy
• $cpf(src, dst) - force copy,if dst dir not exits ,create it.
• $rm(src) -

###mysql

• getSql(table,key,value,keys) - generate get sql.
• postSql(table,object) - generate post sql.
• putSql(table,key,value,keys) - generate put sql.
• delSql(table,key,value,keys) - generate delete sql.
• psql(startIndex,pageSize) - page sql. psql(0,20)->' limit 0,20';psql(1)->' limit 1' , psql()->'' ,psql(20 ,0) -> '';
• build(sql , params) - replace (':k1,:k2 ',{k1:"v1",k2:"v2"}) -> 'v1,v2'.
• ukvs(opt ,[prefix]) - {k1:'v1',k2:'v2'} -> k1=v1,k2=v2 .
• ks(table,key,value,keys) - keys. ['k1','k2'] -> k1,k2.
• cks(['k1','k2'] -> :k1,:k2) - colon keys. ['k1','k2'] -> :k1,:k2.
• kvs(ks ,[prefix]) - ['k1','k2'] -> k1=:k1,k2=:k2 .
• inSql(fieldName , array , [isAnd] ,[page]) - eg.('f' , [1,2,...,1000]) -> f in (1,2,3...200) or f in(201,...) .
• batch(con,sqls,page,needResult,cb) - batch execute sqls.
• $batch(con,sqls,page,needResult) - batch execute sqls, used in co,must use yield mysql.$batch(con,sqls,page,needResult) .

collection

• group(array,key) - group array by the key.array should like [{} ,{}].return {key:[]}
• groupOne(array,key) - group array by the key , each group only has the on record. return {key:{}}
• col(array,key,keepNullValue) - extract one column from array.if keepNullValue is true,the return will keep the null value.

###image heihei...