aftc-node-tools
v0.7.18
Published
<br>
Downloads
3
Readme
AFTC NODE TOOLS v0.7.17
A collection of tools/utilities that I find useful when working with node.
Available Methods & Class's:
- enableLog()
- disableLog()
- log()
- cls()
- concatFiles(filesArray)
- isFile(filePath)
- isDir(dir)
- getFilesSync(dir,ext,recurse,includeHidden)
- writeFile(filePath)
- promiseWriteFile(filePath)
- readFileToString(filePath)
- isArray(input)
- isObject(a)
- isEven(n)
- isOdd(n)
- roundTo(v,dec)
- parseObjectToObject(source,target,strict)
- cutStringTo(s,len)
- escapeHTML(str)
- getCleanJSONString(str)
- getFileExtension(filePath)
- getFileExtension2(filePath)
- getLastPartOfUrl(url)
- getRandomString(len)
- getStringBetween(str,start,end)
- getStringsBetween2(str,start,end)
- inString(needle,haystack)
- leftTrim(str,noOfChars)
- rightTrim(str,noOfChars)
- ucFirst(str)
- isEmail(email)
Documentation
enableLog()
Information: Enables log command globally.
disableLog()
Information: Disables log command globally.
log()
Information: Shortcut for console.log supports logging in colors.
const aftc = require('aftc-node-tools');
const cls = aftc.cls;
const log = aftc.log;
cls();
log( ('All For The Code ' + 44).green );
log('All For The Code'.red);
log('All For The Code'.green);
log('All For The Code'.blue);
log('All For The Code'.cyan);
log('All For The Code'.yellow);
log('All For The Code'.underline.red);
log('All For The Code'.underline.green);
log('All For The Code'.inverse);
log('All For The Code'.rainbow);
log('All For The Code'.trap);
log('All For The Code'.trap.bgRed.white);
cls()
Information: Clears the console.
cls();
concatFiles(filesArray)
Information: Concatinates all files in the array into a string.
Parameters:
- Name: filesArray Type: Array Required: true Info: Array of files.
Returns: String
let files = ['file1.js','file2.js']
concatFiles(arr)
isFile(filePath)
Information: Checks if path is a file.
Parameters:
- Name: filePath Type: String Required: true Info: Path you want to check is a file.
Returns: Boolean
if ( isFile('./file1.js') ){
log('Its a file!')
} else {
log('That aint no file!')
}
isDir(dir)
Information: Checks if path is a directory.
Parameters:
- Name: dir Type: String Required: true Info: Path you want to check is a directory.
Returns: Boolean
if ( isDir('./mydir') ){
log('It exists!')
} else {
log('Nooooo!')
}
getFilesSync(dir,ext,recurse,includeHidden)
Information: Gets an array of files in a directory. Hidden files start with a . (linux style, not windows)
Parameters:
Name: dir Type: Array Required: true Default: null Info: Directory.
Name: ext Type: String Required: true Default: * Info: Array of files.
Name: recurse Type: Boolean Required: false Default: false Info: Array of files.
Name: includeHidden Type: Boolean Required: false Default: false Info: Array of files.
Returns: Array
let files = getFilesSync('./src', '.js', true);
writeFile(filePath)
Information: Writes data to a file.
Parameters:
- Name: filePath Type: String Required: true Info: Path to file you want to write to (will create it if it doesnt exist).
Returns: Promise
let data = 'hello world'
writeFile('./test.txt',data)
.then((res)=>{ console.log('complete')} )
promiseWriteFile(filePath)
Information: Writes data to a file but returns a promise.
Parameters:
- Name: filePath Type: String Required: true Info: Path to file you want to write to (will create it if it doesnt exist).
Returns: Promise
let data = 'hello world';
writeFile('./test.txt', data)
.then(() => {
log('success')
});
.catch(() => {
log('failure')
});
readFileToString(filePath)
Information: Returns a file as a string.
Parameters:
- Name: filePath Type: String Required: true Info: Path to file you want read.
Returns: String
let data = readFileToString('./test.txt');
isArray(input)
Information: Detects if the supplied variable is an array or not (instance of returns object).
Parameters:
- Name: input Type: * Required: true Info: The variable to check.
Returns: Boolean
let varIsArray = isArray(3);
isObject(a)
Information: Detects if the supplied variable is an object or not.
Parameters:
- Name: a Type: * Required: true Info: The variable to check.
Returns: Boolean
let varIsObj = isObject(3);
isEven(n)
Information: Detects if a number is even or not.
Parameters:
- Name: n Type: Number Required: true Info: The number you want to check is even.
Returns: Boolean
let answer = isEven(input);
isOdd(n)
Information: Detects if a number is odd or not.
Parameters:
- Name: n Type: Number Required: true Info: The number you want to check is odd.
Returns: Boolean
let answer = isOdd(input);
roundTo(v,dec)
Information: Rounds a number to a specific amount of decimal places.
Parameters:
Name: v Type: Number Required: true Info: The number you want to round.
Name: dec Type: Number Required: true Info: The number of decimal places you wish to round to.
Returns: Number
let v = roundTo(3.142,1);
parseObjectToObject(source,target,strict)
Information: Parse an object into another object (good for processing arguments dynamically with strict on).
Parameters:
Name: source Type: Object Required: true Info: The source object to pull values from.
Name: target Type: Object Required: true Info: The target object to push values into.
Name: strict Type: Boolean Required: false Info: To only parse indexes/params that exist in both objects.
Returns: Boolean
let args = {
a:4
}
parseObjectToObject(arguments[0],args,true);
cutStringTo(s,len)
Information: Returns the string but to the specified length.
Parameters:
Name: s Type: Number Required: true Info: The string you want to cut.
Name: len Type: Number Required: true Info: The length (number of chars) you want returned.
Returns: String
let answer = cutStringTo(str,5);
escapeHTML(str)
Information: Escapes special characters in a string.
Parameters:
- Name: str Type: String Required: true Info: The string you want to process.
Returns: String
let newString = escapeHTML(str);
getCleanJSONString(str)
Information: Cleans a JSON string.
Parameters:
- Name: str Type: String Required: true Info: The string you want to process.
Returns: String
let newJsonString = getCleanJSONString(jsonString);
getFileExtension(filePath)
Information: Gets the extension of the supplied file path string.
Parameters:
- Name: filePath Type: String Required: true Info: File path string.
Returns: String
let ext = getFileExtension(filePath);
getFileExtension2(filePath)
Information: Gets the extension of the supplied file path string (method 2).
Parameters:
- Name: filePath Type: String Required: true Info: File path string.
Returns: String
let ext = getFileExtension2(filePath);
getLastPartOfUrl(url)
Information: Gets the last segment of a url.
Parameters:
- Name: url Type: String Required: true Info: URL string.
Returns: String
let urlLastSeg = getLastPartOfUrl(url);
getRandomString(len)
Information: Returns a string to a specified length of random characters.
Parameters:
- Name: len Type: Number Required: true Info: The number of random character you want to get.
Returns: String
let randomString = getRandomString(256);
getStringBetween(str,start,end)
Information: Returns a sub string of of a string between specified start and end characters.
Parameters:
Name: str Type: String Required: true Info: The source string you want to process.
Name: start Type: Number Required: true Info: Start char position.
Name: end Type: Number Required: true Info: End char position.
Returns: String
let result = getStringBetween('test test test',5,10);
getStringsBetween2(str,start,end)
Information: Returns a sub string of of a string between specified start and end characters. (method 2)
Parameters:
Name: str Type: String Required: true Info: The source string you want to process.
Name: start Type: Number Required: true Info: Start char position.
Name: end Type: Number Required: true Info: End char position.
Returns: String
let result = getStringBetween('test test test',5,10);
inString(needle,haystack)
Information: Looks for a string inside a string.
Parameters:
Name: needle Type: String Required: true Info: String to search for.
Name: haystack Type: String Required: true Info: String to search.
Returns: Boolean
let result = getStringBetween('test test test',5,10);
leftTrim(str,noOfChars)
Information: Trims a string from the left.
Parameters:
Name: str Type: String Required: true Info: String to trim.
Name: noOfChars Type: Number Required: true Info: Number of characters to trim off.
Returns: String
let result = leftTrim('test test test',5);
rightTrim(str,noOfChars)
Information: Trims a string from the right.
Parameters:
Name: str Type: String Required: true Info: String to trim.
Name: noOfChars Type: Number Required: true Info: Number of characters to trim off.
Returns: String
let result = rightTrim('test test test',5);
ucFirst(str)
Information: Returns a string with the first character uppercase.
Parameters:
- Name: str Type: String Required: true Info: String to trim.
Returns: String
let UpperFirstString = ucFirst('mooo');
isEmail(email)
Information: Checks if the supplied email is valid or not.
Parameters:
- Name: email Type: String Required: true Info: Email to validate.
Returns: Boolean
let isValidEmail = isEmail('[email protected]');