About Task, Bench and Test runners

[tunnckoCore]

Actually they are same things.

• should handle asynchronous and sync code (returning something)
• should have title
• should have subs - sub task, sub test, sub bench

// task runner
.task('name', asyncFn);
.task('task2', asyncFn);
.run('name', 'task2');

// bench - matcha
suite('title', function() {
  bench('sub-title', asyncFn)
});

// test - mocha
describe('title', function() {
  it('sub-title', asyncFn)
});

// test - mukla
mukla('package-name:').should('have title').then('and sub-title', asyncFn);

// or
mukla('package-name:').should('title', asyncFn)

• should be based on Promises
• should have streaming api in server-side

One basic task runner, actually, is just simple event emitter.

var runner = new DualEmitter();
runner
.on('task1', asyncFn)
.on('task2', asyncFn)
.emit('task1', 'task2')

[tunnckoCore]

the proof

• Erasm - Task runner with array dependencies
• Berck - Benchmark runner built with Undertaker
• Mukla - Test runner built with Undertaker

note Undertaker is awesome!

possible problems

• only async flow
• hard to implement beforeEach and afterEach idea

plus

• very small
• very fast
• already known api
• interfaces
• custom reporters

---

Soon will be commited to own repos and published.

[tunnckoCore]

Goddie will power more awesome task, test and bench runners than Undertaker can currently.

[tunnckoCore]

Erasm, Mukla, Berck, Docks, Ock, Bruck, Barrack, Blitzcrank, benz, godware, goddie.

• Tasck - Task runner in 50 lines
• Erasm - Task runner with array dependencies
• Mukla - Test runner built with Undertaker
• Muckla - Test runner built with Godware
• Berck - Bench runner built with Undertaker
• Bruck - Bench runner built with Godware
• Ock - Project generator and scaffolder
• Docks - Documentation generator and scaffolder
• Blitzcrank - Library for interactive command line user interfaces
• benz - Control flow utopia
• vez - Middleware composition library built with benz

names

• goddie
• godware

[tunnckoCore]

future assertion

// .ok(value, [message]) / .truthy
// Assert that value is truthy.

// .notOk(value, [message]) / .falsey
// Assert that value is falsy.

// .true(value, [message])
// Assert that value is true.

// .false(value, [message])
// Assert that value is false.

// .is(value, expected, [message]) - not strict / (.equal - strict?) / (.strictEqual - maybe as .same fallback)
// Assert that value is (strict) equal to expected.

// .not(value, expected, [message]) - not strict / (.notEqual - strict?) / (.notStrictEqual - maybe as .notSame fallback)
// Assert that value is not (strict) equal to expected.

// .same(value, expected, [message]) / .deepEqual / .deep
// Assert that value is deep equal to expected.

// .notSame(value, expected, [message]) / .notDeepEqual / .notDeep
// Assert that value is not deep equal to expected.

// .ifError(value, [message])
// Assert that value is error.

// experimental thoughts
mukla('package-name header')
.parallel(function () {
  return this
    .equal('fs.readFile should be function', typeof fs.readFile, 'function')
    .true('not have body property', isEmptyFunction('(a) => {}'))
    .same('abc should be [1, 2, 3]', abc, [1, 2, 3])
    .true('fs.readFile should be function', Array.isArray([1, 2]))
    .it('should have some test title', function (cb) {
      mukla.plan(3)
      fs.readFile('./package.json', function (err, res) {
        mukla.ifError(err)
        mukla.equal(typeof res, 'function')
        mukla.equal(JSON.parse(res).name, 'mukla')
        cb() // or mukla.end()
      })
    })
    .series(function () {
      return this
        .true('not have body property', isEmptyFunction('(a) => {}'))
        .same('abc should be [1, 2, 3]', abc, [1, 2, 3])
        .equal('fs.readFile should be function', typeof fs.readFile, 'function')
    })
})
.on('pass', function (title, info) {
  console.log('ok:', title, info)
})