cloudcmd/lib/util.js

799 lines
No EOL
20 KiB
JavaScript

/*
* Licensed under MIT License http://www.opensource.org/licenses/mit-license
* Module contain additional system functional
*/
var Util, exports;
Util = exports || {};
(function(Util){
'use strict';
var Scope = exports ? global : window;
/** setting function context
* @param {function} pFunction
* @param {object} pContext
*/
Util.bind = function(pFunction, pContext){
var lRet = false;
if( Util.isFunction(pFunction) )
lRet = pFunction.bind(pContext);
return lRet;
};
Util.breakpoint = function(){
var lRet = Util.tryCatch(function(){
debugger;
});
Util.log(lRet);
return lRet;
};
/**
* callback for functions(pError, pData)
* thet moves on our parameters.
*
* @param pFunc
* @param pParams
*/
Util.call = function(pFunc, pParams){
var lFunc = function(pError, pData){
Util.exec(pFunc, {
error : pError,
data : pData,
params : pParams
});
};
return lFunc;
};
/**
* Функция ищет в имени файла расширение
* и если находит возвращает true
* @param pName - получает имя файла
* @param pExt - расширение
*/
Util.checkExtension = function(pName, pExt){
var lRet = false,
lLength = pName.length; /* длина имени*/
/* если длина имени больше
* длинны расширения -
* имеет смысл продолжать
*/
if (Util.isString(pExt) && pName.length > pExt.length) {
var lExtNum = pName.lastIndexOf(pExt), /* последнее вхождение расширения*/
lExtSub = lLength - lExtNum; /* длина расширения*/
/* если pExt - расширение pName */
lRet = lExtSub === pExt.length;
}else if(Util.isObject(pExt) && pExt.length){
for(var i=0; i < pName.length; i++){
lRet = Util.checkExtension(pName, pExt[i]);
if(lRet)
break;
}
}
return lRet;
};
/**
* Check is Properties exists and they are true if neaded
*
* @param pObj
* @param pPropArr
* @param pTrueArr
*/
Util.checkObj = function(pObj, pPropArr, pTrueArr){
var lRet = Util.isObject(pObj),
i, n;
if( lRet ){
lRet = Util.isArray(pPropArr);
if(lRet){
n = pPropArr.length;
for(i = 0; i < n; i++){
var lProp = pPropArr[i];
lRet = pObj.hasOwnProperty( lProp );
if(!lRet){
Util.logError(lProp + ' not in Obj!');
Util.log(pObj);
break;
}
}
}
if( lRet && Util.isArray(pTrueArr) )
lRet = Util.checkObjTrue( pObj, pTrueArr );
}
return lRet;
};
/**
* Check is Properties exists and they are true
*
* @param pObj
* @param pPropArr
* @param pTrueArr
*/
Util.checkObjTrue = function(pObj, pTrueArr){
var lRet = Util.isObject(pObj),
i, n;
if( lRet ){
lRet = Util.isArray(pTrueArr);
if(lRet){
n = pTrueArr.length;
for(i = 0; i < n; i++){
var lProp = pTrueArr[i];
lRet = pObj[lProp];
if( !lRet){
Util.logError(lProp + ' not true!');
Util.log(pObj);
break;
}
}
}
}
return lRet;
};
/** for function
* @param pI
* @param pN
* @param pFunc
*/
Util.for = function(pI, pN, pFunc){
if(Util.isFunction(pFunc))
for(var i = pI, n = pN; i < n; i++){
if(pFunc(i))
break;
}
};
/** for function with i = 0
* @param pN
* @param pFunc
*/
Util.fori = function(pN, pFunc){
var lRet = Util.for(0, pN, pFunc);
return lRet;
};
/**
* @pJSON
*/
Util.parseJSON = function(pJSON){
var lRet;
Util.tryCatchLog(function(){
lRet = JSON.parse(pJSON);
});
return lRet;
};
/**
* pObj
*/
Util.stringifyJSON = function(pObj){
var lRet;
Util.tryCatchLog(function(){
lRet = JSON.stringify(pObj, null, 4);
});
return lRet;
};
/* STRINGS */
/**
* function check is strings are equal
* @param pStr1
* @param pStr2
*/
Util.strCmp = function (pStr1, pStr2){
var lRet = Util.isString(pStr1);
if(lRet){
if( Util.isArray(pStr2) )
for(var i = 0, n = pStr2.length; i < n; i++){
lRet = Util.strCmp( pStr1, pStr2[i] );
if(lRet)
break;
}
else if( Util.isString(pStr2) )
lRet = Util.isContainStr(pStr1, pStr2) &&
pStr1.length === pStr2.length;
}
return lRet;
};
/**
* function returns is pStr1 contains pStr2
* @param pStr1
* @param pStr2
*/
Util.isContainStr = function(pStr1, pStr2){
var lRet = Util.isString(pStr1);
if( lRet ){
if( Util.isArray(pStr2) )
for(var i = 0, n = pStr2.length; i < n; i++){
lRet = Util.isContainStr( pStr1, pStr2[i] );
if(lRet)
break;
}
else if( Util.isString(pStr2) )
lRet = pStr1.indexOf(pStr2) >= 0;
}
return lRet;
};
/**
* function log pArg if it's not empty
* @param pArg
*/
Util.log = function(pArg){
var lConsole = Scope.console,
lDate = '[' + Util.getDate() + '] ';
if(lConsole && pArg)
lConsole.log(lDate, pArg);
return pArg;
};
/**
* function log pArg if it's not empty
* @param pArg
*/
Util.logError = function(pArg){
var lConsole = Scope.console,
lDate = '[' + Util.getDate() + '] ';
if(lConsole && pArg){
var lMsg = pArg.message;
if( lMsg )
lDate += pArg.message + ' ';
lConsole.error(lDate, pArg);
}
return pArg;
};
/**
* load functions thrue callbacks one-by-one
* @param pFunc_a {Array} - array of functions
* @param pData - not necessarily
*/
Util.loadOnLoad = function(pFunc_a, pData){
if( Util.isArray(pFunc_a) && pFunc_a.length) {
var lFunc_a = pFunc_a.slice(),
lFunc = lFunc_a.pop(),
lCallBack = function(pData){
return Util.loadOnLoad(lFunc_a, pData);
};
if( !Util.isUndefined(pData) )
pData = {
data : pData,
callback : lCallBack
};
Util.exec(lFunc , pData || lCallBack);
}
};
/**
* function remove substring from string
* @param pStr
* @param pSubStr
*/
Util.removeStr = function(pStr, pSubStr){
var lRet = Util.isString(pStr) && pSubStr;
if( lRet ){
var n = pSubStr.length;
if( Util.isArray(pSubStr) )
Util.fori(n, function(i){
lRet = pStr = pStr.replace(pSubStr[i], '');
});
else
lRet = pStr.replace(pSubStr, '');
}
else
lRet = pStr;
return lRet;
};
/**
* function replase pFrom to pTo in pStr
* @pStr
* @pFrom
* @pTo
*/
Util.replaceStr = function(pStr, pFrom, pTo){
var lRet;
if(pStr && pFrom && pTo)
lRet = pStr.replace(new RegExp(pFrom, 'g'), pTo);
return lRet;
};
/**
* function render template with view
* @pTempl
* @pView
*/
Util.render = function(pTempl, pView){
var lRet = Util.ownRender(pTempl, pView, ['{', '}']);
return lRet;
};
/**
* function render template with view and own symbols
* @pTempl
* @pView
* @pSymbols
*/
Util.ownRender = function(pTempl, pView, pSymbols){
if(!pSymbols)
pSymbols = ['{', '}'];
var lRet = pTempl,
lFirstChar,
lSecondChar;
lFirstChar = pSymbols[0];
lSecondChar = pSymbols[1] || lFirstChar;
for(var lVar in pView){
var lStr = pView[lVar];
lStr = Util.exec(lStr) || lStr;
lRet = Util.replaceStr(lRet, lFirstChar + lVar + lSecondChar, lStr);
}
return lRet;
};
/**
* invoke a couple of functions in paralel
*
* @param {Array} pFuncs
* @param {function} pCallback
*
* Example:
* i >=0, pFuncs[i] = function(param, callback){}
*/
Util.paralelExec = function(pFuncs, pCallback){
var done = [];
/* add items to array done*/
function addFunc(pNum){
done.push(pNum);
}
/*
* improve callback of funcs so
* we pop number of function and
* if it's last we call pCallBack
*/
function doneFunc(pParams){
Util.exec(pParams.callback);
var lNum = done.pop (pParams.number);
if(!lNum){
Util.exec(pCallback);
}
}
for(var i = 0, n = pFuncs.length; i < n; i++){
addFunc(i);
var lFunc = pFuncs[i].callback;
pFuncs[i].callback = Util.retExec(doneFunc, {
number : i,
callback : lFunc
});
}
};
/**
* functions check is pVarible is array
* @param pVarible
*/
Util.isArray = function(pVarible){
return pVarible instanceof Array;
};
/**
* functions check is pVarible is boolean
* @param pVarible
*/
Util.isBoolean = function(pVarible){
return Util.isType(pVarible, 'boolean');
};
/**
* functions check is pVarible is function
* @param pVarible
*/
Util.isFunction = function(pVarible){
return Util.isType(pVarible, 'function');
};
/**
* functions check is pVarible is object
* @param pVarible
*/
Util.isObject = function(pVarible){
return Util.isType(pVarible, 'object');
};
/**
* functions check is pVarible is string
* @param pVarible
*/
Util.isString = function(pVarible){
return Util.isType(pVarible, 'string');
};
/**
* functions check is pVarible is string
* @param pVarible
*/
Util.isUndefined = function(pVarible){
return Util.isType(pVarible, 'undefined');
};
/**
* functions check is pVarible is pType
* @param pVarible
* @param pType
*/
Util.isType = function(pVarible, pType){
return typeof pVarible === pType;
};
/**
* return save exec function
* @param pCallBack
* @param pArg
*/
Util.retExec = function(pCallBack, pArg){
return function(pArgument){
if( !Util.isUndefined(pArg) )
pArgument = pArg;
Util.exec(pCallBack, pArgument);
};
};
/**
* return function wich exec function in params
* @param pCallBack
* @param pArg
*/
Util.retFunc = function(pCallBack, pArg){
return function(){
return Util.exec(pCallBack, pArg);
};
};
/**
* function return false
*/
Util.retFalse = function(){
var lRet = false;
return lRet;
};
/**
* return load functions thrue callbacks one-by-one
* @param pFunc_a {Array} - array of functions
* @param pData - not necessarily
*/
Util.retLoadOnLoad = function(pFunc_a, pData){
return function(){
Util.loadOnLoad(pFunc_a, pData);
};
};
/**
* set value to property of object, if object exist
* @param pArgs {object, property, value}
*/
Util.setValue = function(pArgs){
var lRet = false;
if( Util.isObject(pArgs) ){
var lObj = pArgs.object,
lProp = pArgs.property,
lVal = pArgs.lVal;
if(lObj){
lObj[lProp] = lVal;
lRet = true;
}
}
return lRet;
};
/**
* set timout before callback would be called
* @param pArgs {func, callback, time}
*/
Util.setTimeout = function(pArgs){
var lDone,
lFunc = pArgs.func,
lTime = pArgs.time || 1000,
lCallBack = function(pArgument){
if(!lDone){
lDone = Util.exec(pArgs.callback, pArgument);
}
};
var lTimeoutFunc = function(){
setTimeout(function(){
Util.exec(lFunc, lCallBack);
if(!lDone)
lTimeoutFunc();
}, lTime);
};
lTimeoutFunc();
};
/**
* function execute param function in
* try...catch block
*
* @param pCallBack
*/
Util.tryCatch = function(pCallBack){
var lRet;
try{
lRet = pCallBack();
}
catch(pError){
lRet = pError;
}
return lRet;
};
/**
* function execute param function in
* try...catch block and log result
*
* @param pTryFunc
*/
Util.tryCatchDebug = function(pTryFunc){
var lRet = Util.tryCatch(pTryFunc);
if(lRet)
Util.debug();
return lRet;
};
/**
* function execute param function in
* try...catch block and log result
*
* @param pTryFunc
*/
Util.tryCatchLog = function(pTryFunc){
var lRet;
lRet = Util.tryCatch(pTryFunc);
return Util.logError(lRet);
};
/**
* function execute param function in
* try...catch block and log result
*
* @param pCallBack
*/
Util.tryCatchCall = function(pTryFunc, pCallBack){
var lRet;
lRet = Util.tryCatch(pTryFunc);
if(lRet)
Util.exec(pCallBack, lRet);
return lRet;
};
/**
* function do save exec of function
* @param pCallBack
* @param pArg
*/
Util.exec = function(pCallBack, pArg){
var lRet;
if(pCallBack){
if( Util.isFunction(pCallBack) )
lRet = pCallBack(pArg);
else {
var lCallBack = pCallBack.callback || pCallBack.success;
lRet = Util.exec(lCallBack, pArg);
}
}
return lRet;
};
/**
* exec function if it exist in object
* @pArg
*/
Util.execIfExist = function(pObj, pName, pArg){
var lRet;
if(pObj)
lRet = Util.exec(pObj[pName], pArg);
return lRet;
};
/**
* function do conditional save exec of function
* @param pCondition
* @param pCallBack
* @param pFunc
*/
Util.ifExec = function(pCondition, pCallBack, pFunc){
var lRet;
if(pCondition)
Util.exec(pCallBack, pCondition);
else
Util.exec(pFunc, pCallBack);
return lRet;
};
/**
* function gets file extension
* @param pFileName
* @return Ext
*/
Util.getExtension = function(pFileName){
var lRet, lDot;
if( Util.isString(pFileName) ){
lDot = pFileName.lastIndexOf('.');
lRet = pFileName.substr(lDot);
}
return lRet;
};
/**
* get values from Object Array name properties
* or
* @pObj
*/
Util.getNamesFromObjArray = function(pArr){
var lRet = [];
if(pArr && !Util.isArray(pArr))
pArr = pArr.data;
if(pArr)
Util.fori(pArr.length, function(i){
lRet[i] = pArr[i].name || pArr[i];
});
return lRet;
};
/**
* find object by name in arrray
* or
* @pObj
*/
Util.findObjByNameInArr = function(pArr, pObjName){
var lRet;
if(pArr){
for(var i = 0, n = pArr.length; i < n; i++ )
if(pArr[i].name === pObjName) break;
lRet = pArr[i].data;
}
return lRet;
};
/**
* Gets current time in format hh:mm:ss
*/
Util.getTime = function(){
var lRet,
date = new Date(),
hours = date.getHours(),
minutes = date.getMinutes(),
seconds = date.getSeconds();
minutes = minutes < 10 ? '0' + minutes : minutes;
seconds = seconds < 10 ? '0' + seconds : seconds;
lRet = hours + ":" + minutes + ":" + seconds;
return lRet;
};
/**
* start timer
* @pArg
*/
Util.time = function(pArg){
var lRet,
lConsole = Scope.console;
lRet = Util.execIfExist(lConsole, 'time', pArg);
return lRet;
};
/**
* stop timer
* @pArg
*/
Util.timeEnd = function(pArg){
var lRet,
lConsole = Scope.console;
lRet = Util.execIfExist(lConsole, 'timeEnd', pArg);
return this;
};
/**
* Gets current date in format yy.mm.dd hh:mm:ss
*/
Util.getDate = function(){
var date = new Date(),
day = date.getDate(),
month = date.getMonth() + 1,
year = date.getFullYear(),
lRet = year + "-" + month + "-" + day + " " + Util.getTime();
return lRet;
};
})(Util, exports);