x-util v0.0.9

#x-util Utility package for node applications.

#Usage npm install x-util --save

var xutil = require('x-util');
var strings = xutil.strings;

var obj = xutil.extend({ name1: 'Hello' }, { name2: 'World!' });
console.log(strings.format("{{name1}} {{name2}}", obj));

#Modules

##x-util Root module that exposes all the utility objects/methods.

#####Properties

• common - Access to most commonly used functions like extend.
• strings - Access to common string functions like format.
• command - Access to common command line functions like parse.
• json - Contains json helper functions like find.
• path - Contains path helper functions like find.

#####Functions

• extend - See common extend function.

##common Contains most commonly used functions like extend.

#####Properties None

#####Functions

• extend - Recursively extends an object.javascript extend({{object}}, {{extended}})

##command Contains functions to support a command line interface.

#####Properties None

#####Functions

• parse - Parse command line arguments.javascript parse(process.args)

##strings Contains helper string functions.

#####Properties None

#####Functions

• format - Replace placeholders using object properties.javascript format("Hello {{name}}!", { name: "World" })

#####Extensions

• String.startsWith - Returns true is the string starts with startStr. javascript 'Hello World'.startsWith('Hello')
• String.endsWith - Returns true is the string ends with endStr. javascript 'Hello World'.endsWith('World')

##path Contains path helper functions.

#####Properties None

#####Functions

• find - Traverses up a path to find a file or folder. javascript find('/my/full/path', 'package.json')

##json Contains json helper functions.

#####Properties None

#####Functions

• find - Returns the value of an object based on a path.

find({ a: { b: 'Hello' c: 'World' } }, '/a/b') // returns 'Hello'

• resolveLinks - Resolves object links.

resolveLinks({ a: { b: 'Hello' _c: 'b' } }); // returns { a: { b: 'Hello', c: 'Hello' } }

##object Contains function used for managing objects.

#####Properties None

#####Functions

• createProvider(config) - Create an object based on a configuration.

Create a new object by invoking a function and passing args.

createProvider({ "module": "test-module", "args": { "function-arg1": "test" } })

Create a new instance of the module and passing the ctorArgs into ctor.

createProvider({ "module": "test-module", "ctorArgs": { "ctor-arg1": "test" } })