runio.js

Tired of npm-bash-script-foo? 😫

Try runio! 🤓

Write your npm scripts in.... 🎉 SURPRISE 🎉... JavaScript!

runio.js - is JavaScript replacement for Bash scripts

Why runio.js

Everyone ❤️ npm scripts. However, when you need something more sophisticated, when you need to use conditionals, loops, regexp and parsers for your scripts, you end up writing JavaScript.

runio.js gives you a tool to transform your JavaScript scripts into commands.

Each exported function will be a command which can be executed from CLI. You can use full power of JavaScript & bundled tasks like:

• exec
• git
• npmRun
• npx
• ...and others

How to use

Write a module that exports commands per function.

• Each argument of function will be an argument of a command
• If you provide options argument, with default value of an object, this will declate options.

#!/usr/bin/env node
const {
  tasks: { git, exec, npx },
  runio
} = require('runio');

module.exports = {

  async deploy(env = 'prod') {
    await this.test();
    await git(cmd => {
      cmd.add('-A');
      cmd.commit('releasing');
      cmd.pull();
      cmd.push();      
    });
    await exec(`ansible-playbook deploy.yml -i hosts ${env}`);
  }

  async test() {
    await npx('mocha');
  },
}

if (require.main === module) runio(module.exports);

• Run ./runio.js to list all available commands
• Run ./runio deploy to run a deploy script
• Run ./runio deploy staging to run a deploy script to staging

Installation

npm i runio.js --save

Create a new runio.js scripts file:

npx runio init

Each exported function of this file will be command.

Usage

When file is created execute runio script to see all available commands:

./runio.js

Credits

Created by Michael Bodnarchuk @davertmik.

Inspired by Robo PHP Task Runner

LICENSE MIT