Simple and unmistakable terminal interface for NodeJS.
- Based in NodeJS
execandspawnnative interface. - Automatically provide a polyfill for non native compatible node versions (for example,
execSyncunder0.10). - Uniform methods for synchronously and asynchronously, just decide providing or not a callback.
- Little improvements, like posibility for run a set of commands in the same command or more information about the process status in
syncversions.
npm install oh-my-terminal --saveFirst load the library:
var terminal = require('oh-my-terminal');Now, you can run a command using exec or spawn methods. Exists slight difference between us (as you know from child_process.
Using exec:
var term = terminal.exec('echo hello world');
console.log(term);
// => {
// stdout: 'hello world\n',
// stderr: '',
// status: 0
// }Using spawn:
var term = terminal.spawn('echo hello world');
console.log(term);
// => {
// pid: 95109,
// output: [ null, 'hello world\n', '' ],
// stdout: 'hello world\n',
// stderr: '',
// status: 0,
// signal: null
// }Like exec or spawn, you can provide a custom options for the command:
var options = {
timeout: 1000
};
var term = terminal.exec('echo hello world', options);
console.log(term.stdout);
// => 'hello world\n'If you need to run one command, maybe you need to run more than one. Just instead of string pass an array of command (with or without callback for user synchronously or asynchronously behavior):
terminal.exec(['echo hello', 'echo world'], function(err, commands) {
console.log(commands[0].stdout);
// => 'hello world\n'
console.log(commands[1].stdout);
// => 'hello world\n'
});Just providing a standard NodeJS callback you activate the async mode for the command:
terminal.exec('echo hello world', function(err, command) {
console.log(command.stdout);
// => 'hello world\n'
});You can run a set of command in async mode as well:
terminal.exec(['echo hello world', 'echo hello world'], function(err, commands) {
console.log(commands[0].stdout);
// => 'hello world\n'
console.log(commands[1].stdout);
// => 'hello world\n'
});Invoke child_process.exec (or execSync if you don't provide a callback) function. You can provide just one String command or an Array of command to be executed.
Options are child_process.exec options. { encoding: 'utf8' } by default.
Invoke child_process.spawn (or spawnSync if you don't provide a callback) function. You can provide just one String command or an Array of command to be executed.
Options are child_process.spawn options. { encoding: 'utf8' } by default.
Note that in this case the response is a Stream Object that starts sending back data from the child process in a stream as soon as the child process starts executing.
MIT © Kiko Beats
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent