npm install js.utilsjs.utils
==============
Utilities for:
* Object
+ copy/clone an object
+ contains - Validates if an object contains a given value
+ empty - Validates is the object empty
* NPM
+ info - Get information about the list of installed packages
+ installed - Check if a package has already been installed
* Template
+ Load and compile a template with underscore
* Task
+ Lint, concat and/or minify a set of resources (currently JS file type supported)
require("js.utils").init({log: false});
var destobj = {},
srcobj = {foo: 'foo'};
require("js.utils").Object.copy(srcobj, destobj);
* Validates if 'foo' exists in a given array
require("js.utils").Object.contains(['foo'], 'foo');
* Validates if an object is empty
require("js.utils").Object.empty({});
require("js.utils").NPM.info({details: true}, function(err) {
var data = this.data;
// go over the array data
data.forEach(function(item) {
if (item) {
console.log(" details: ",
JSON.stringify(item.get("details")));
}
});
});
* check if the package 'bower' was installed
require("js.utils").NPM.installed({list: ["bower"]},
function(err) {
console.log("Bower was: ",
(this.data.bower ? "" : "not"),
" installed");
});
var out = require("js.utils").Template.template({
content: "Custom content Test was loaded {{status}}.",
name: "templateTest",
data: {
status: "successfully"
}
});
require("js.utils").Task.dev([{
src: ["./test/resources/test1.js","./test/resources/test2.js" ],
out: {
banner: "This is a test minified content",
name: "testx-min.js",
path: "./test/out"
}
}, {
src: ["./test/resources/test1.js","./test/resources/test2.js" ],
out: {
banner: "This is a test minified content",
name: "testy-min.js",
path: "./test/out"
}
}]);
* Or use separate API minify/jshint/concat
require("js.utils").Task.jshint({
src: ["./test/resources/test1.js"]
}); require("js.utils").Task.minify({
src: ["./test/resources/test1.js","./test/resources/test2.js" ]
})
* AMD
* See jsutilswebRequire-min.js file, as an example of requirejs project style
define([], function() {
var jsutilsOnReady = function(obj, arr, tpl) {
// use object, array or template
};
return jsutilsOnReady;
});
* None AMD
+ js.utils global variables for the web:
+ jsutilsObject;
+ jsutilsArray;
+ jsutilsTemplate;
* None AMD
* with NO dependencies: jsutils-min.js
* manually download
* Underscore
* with dependencies: jsutils-min-all.js
* underscore is already inside
* AMD
* jsutils-require-min.js
Copy the source object's properties to the destination object.
* copy(srcobj, destobj, override)
+ srcobj {Object} The source object
+ destobj {Object} The destination object
+ override {Object} Override the existing property (deault to false)
Check if a given object contains a value
* contains(obj, value)
+ obj {Object} The referenced object
+ value {Object} The value to be searched
Is the object empty ?
* empty(srcobj)
+ srcobj {Object} The object reference
returns {boolean} If the object is [null || undefined || has no values {}] return true or else false
Inspect a given string and try to resolve its object
* resolve(srcobj)
+ srcobj {Object} The object reference
Get information about the list of installed packages
* info(config, callback)
+ config properties:
+ global {Boolean} the packages are global, optional values are true/false (defaults to false)
+ details {Boolean} Whether to display the full details or just the basic details. (defaults to false)
+ list {Array} specific list of packages names (or else result all)
+ depth {string} npm argument for how deep the rabbit hole goes (defaults to 10)
+ -1 for unlimited (Not recommended, NPM will might throw an error about "max depth reached")
+ callback {Function} callback function for collecting the results. (get the data: this.data)
+ err {String} In case an error occurred this variable will contain the error data or else 'undefined'
+ this.data {Object} Array object containing the information about the packages that was found.
Array item - instance of Package class
* installed(config, callback)
+ config properties:
+ global {Boolean} the packages are global, optional values are true/false
+ list {Array} specific list of packages names (or else result all)
+ depth {string} npm argument for how deep the rabbit hole goes.
+ -1 for unlimited (Not recommended, NPM will might throw an error about "max depth reached")
+ callback {Function} callback function for collecting the results. (get the data: this.data)
+ err {String} In case an error occurred this variable will contain the error data or else 'undefined'
+ this.data {Object} An object containing the packages names with a true/false value indicating if the package installed.
* Package class
+ getDetails Get the full details if the 'details' flag was set to true
+ getName Get the package name
+ get(key) Get the property by its key
+ opt keys 'name', 'dependencies', 'detail', etc.. (see package.json for more information)
Load and compile template with underscore
* template(config)
+ Config properties:
+ name {String} The name of the template e.g. /scraps/test (optional in case content exists)
+ path {String} The full path where the templates exists (optional) e.g. /home/../test.tpl
+ content {String} The string content instead of the file content (optional in case name exists & overrides the file content)
+ data {Object} The data object properties (see underscore template)
Prepare your project for development / production using, JSHint & UglifyJS
* NPM List
For getting the installed packages I'm using The NPM list command that might throw an error about problems.
Those problems will be described as part of the NPM information tree. Those errors are not really functional errors but more like packages problems.
The methods used in this module will still function as expected. I just forward the NPM error. (you can turn the log off if needed) NPM problems:
For more information see the NPM docs