Skip to content

Fluent (i.e. chainable) syntax for generating vows tests against CLI tools.

License

Notifications You must be signed in to change notification settings

vowsjs/cli-easy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLIeasy

A fluent (i.e. chainable) syntax for generating vows tests for CLI applications.

Purpose

CLIeasy is designed to be a simple way to test CLI applications in node.js and Javascript. The primary design goal was to reduce the number of lines of test code required to fully cover all primary and edge use cases of a given CLI application.

Getting Started

If you're going to use CLIeasy (and I hope you do), it's worth taking a moment to understand the way that vows manages flow control. Read up here on vowsjs.org (Under "Structure of a test suite"), or just remember vows uses this grammatical structure:

  Suite   → Batch*
  Batch   → Context*
  Context → Topic? Vow* Context*

Got it? Good. There is a 1-to-1 relationship between a CLIeasy suite and a vows suite; CLIeasy is essentially a simpler syntax to manage a particular set of vows-based tests that conform to this pattern:

  1. Tests are performed by starting a CLI application
  2. Assertions are made against the stdout and stderr output.
  3. Rinse. Repeat.

Here's a sample of the boilerplate code that CLIeasy eliminates:

  var exec = require('child_process').exec,
      vows = require('vows'),
      assert = require('assert');
  
  vows.describe('uname').addBatch({
    "When using uname": {
      "calling without arguments": {
        topic: function () {
          exec('uname', this.callback);
        },
        "should return `Linux`": function (err, stdout, stderr) {
          assert.match(stdout, /Linux/);
        }
      }
    }
  }).export(module);

This same code can be implemented like this using CLIeasy:

  var CLIeasy = require('cli-easy'),
      assert = require('assert');
      
  CLIeasy.describe('uname');
    .use('uname')
    .discuss('when using uname')
    .discuss('calling without arguments')
      .expect('should return Linux', 'Linux\n')
    .export(module);
## Using CLIeasy in your own project There are two ways to use CLIeasy in your own project:
  1. Using npm
  2. Using vows directly

If you've used the npm test command in [npm][5] before, this should be nothing new. You can read more about the npm test command here. All you need to do is add the following to your package.json file:

 {
   "dependencies": {
     "cli-easy": "0.1.x"
   },
   "scripts": {
     "test": "vows test/*-test.js"
   }
 }

Note: test/*-test.js is at your discretion. It's just an expression for all test files in your project.

After adding this to your package.json file you can run the following to execute your tests:

  $ cd path/to/your/project
  $ npm install
  $ npm test

Using CLIeasy with vows

When you install CLIeasy or take it as a dependency in your package.json file it will not install [vows][5] globally, so to use vows you must install it globally.

  $ [sudo] npm install vows -g

After installing vows you can simply run it from inside your project:

  $ cd /path/to/your/project
  $ vows

Installation

Installing npm (node package manager)

  $ curl http://npmjs.org/install.sh | sh

Installing CLIeasy

  $ [sudo] npm install cli-easy

Run Tests

Tests are written in vows and give complete coverage of all APIs and storage engines.

  $ npm test

Roadmap

  1. Get feedback on what else could be exposed through this library.
  2. Improve it.
  3. Repeat (1) + (2).

License: MIT

About

Fluent (i.e. chainable) syntax for generating vows tests against CLI tools.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published