ketch
Ketch helps you execute, one way or another.
Overview
Use this module to easily build commands for passing to child_process functions.
When called as a function, this module will return a new Ketch
instance.
Installation
npm install ketch
Example:
var ketch = ; // what branch am I on? // returns stdout, stderr as array ; // use a callback instead ;
Class: Ketch
Provides chainable functions to easily build and execute a command.
last_err: String
, Last error, if present
last_stdout: String
, Last stdout value, if present
last_stderr: String
, Last stderr value, if present
last_exec_cmd: String
, Last command run with child_process.exec()
last_execFile_cmd: String
, Last command run with child_process.execFile()
last_fork_cmd: String
, Last command run with child_process.fork()
last_spawn_cmd: String
, Last command run with child_process.spawn()
cmd: Array
, Internal array representation of this command.
ketch.Ketch.parseArgs()
Parse function arguments into an array. arguments
may be one of:
- an array
- a space-separated string
- one or more strings (not separated by space)
Returns: Array
, Command as an array
ketch.Ketch.append()
Append an argument or arguments to this command. Alias: push()
Returns: Ketch
, Ketch instance
ketch.Ketch.prepend()
Prepend an argument or arguments to this command. Alias: unshift()
Returns: Ketch
, Ketch instance
ketch.Ketch.opt()
Sugar function to append one or more options to the command.
Returns: Ketch
, Ketch instance
Example:
// becomes "git -q --short"
ketch.Ketch.toString()
Returns current command as a space-separated string.
Returns: String
, String representation of this command
ketch.Ketch.pop()
Pops the last argument off of the command. Does not return it. If you need that, use ketch('foo').cmd.pop()
Returns: Ketch
, Ketch instance
ketch.Ketch.shift()
Shifts the first argument off of the command. Does not return it. If you need that, use ketch('foo').cmd.shift()
Returns: Ketch
, Ketch instance
ketch.Ketch.splice()
Splice the command.
Returns: Ketch
, Ketch instance
ketch.Ketch.serialize()
"Serialize" this command into command/arguments array format, suitable for passing to execFile
or fork
. Aliases: get()
, toJSON
Returns: Array
, Array where first item is a string, second is array of commands
ketch.Ketch.exec(options, callback)
Wrapper around child_process.exec()
. Returns a promise, or
Parameters
options: Object
, Options for child_process.exec()
callback: function
, If present, will execute as NodeJS-style callback; otherwise will return a Promise.
Returns: ChildProcess | Promise
, ChildProcess
instance if callback
is specified, otherwise a Promise
.
ketch.Ketch.execFile(options, callback)
Wrapper around child_process.execFile()
. Returns a promise, or
Parameters
options: Object
, Options for child_process.execFile()
callback: function
, If present, will execute as NodeJS-style callback; otherwise will return a Promise.
Returns: ChildProcess | Promise
, ChildProcess
instance if callback
is specified, otherwise a Promise
.
ketch.Ketch.fork(options, callback)
Wrapper around child_process.fork()
. Returns a promise, or
Parameters
options: Object
, Options for child_process.fork()
callback: function
, If present, will execute as NodeJS-style callback; otherwise will return a Promise.
Returns: ChildProcess | Promise
, ChildProcess
instance if callback
is specified, otherwise a Promise
.
ketch.Ketch.spawn(options, callback)
Wrapper around child_process.spawn()
. Returns a promise, or
Parameters
options: Object
, Options for child_process.spawn()
callback: function
, If present, will execute as NodeJS-style callback; otherwise will return a Promise.
Returns: ChildProcess | Promise
, ChildProcess
instance if callback
is specified, otherwise a Promise
.
ketch.Ketch.clear()
Obliterates the current command. Alias: reset()
Returns: Ketch
, Ketch instance
ketch.Ketch.debug()
Debugging function to log the current command to console. Chainable, for your pleasure.
Returns: Ketch
, Ketch instance
ketch.Ketch.tap()
"Tap" into the chain.
Parameters
callback: function
, Which will be passed the Ketch
instance.
Returns: Ketch
, Ketch instance
License
© 2014-2015, Christopher Hiller. Licensed MIT.