feat(cli): add cli file to be used for configuring test files

cli.js

@@ -0,0 +1,134 @@
+'use strict'
+
+/*
+ * japa-cli
+ *
+ * (c) Harminder Virk <virk@adonisjs.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+*/
+
+class JapaCli {
+  constructor () {
+    this._initiate()
+  }
+
+  /**
+   * Initiate private and public properties
+   *
+   * @method _initiate
+   *
+   * @return {void}
+   *
+   * @private
+   */
+  _initiate () {
+    this._timeout = null
+    this._grep = null
+    this._bail = false
+
+    // public
+    this.filterCallback = null
+    this.ignorePattern = []
+    this.testsGlob = 'test/*.spec.js'
+  }
+
+  /**
+   * Filter files to be used for running the tests. You can
+   * return a string, an array of globs or a function
+   * which is called for each file.
+   *
+   * @method filter
+   *
+   * @param  {String|Array|Function} patternOrCallback
+   *
+   * @chainable
+   */
+  filter (patternOrCallback) {
+    if (typeof (patternOrCallback) === 'function') {
+      this.filterCallback = patternOrCallback
+      return this
+    }
+
+    if (typeof (patternOrCallback) === 'string') {
+      this.ignorePattern = [patternOrCallback]
+      return this
+    }
+
+    if (patternOrCallback instanceof Array === true) {
+      this.ignorePattern = patternOrCallback
+      return this
+    }
+
+    throw new Error('japaCli.filter only excepts a glob string, array or a callback function')
+  }
+
+  /**
+   * Set global timeout on each test
+   *
+   * @method timeout
+   *
+   * @param  {Number} timeout
+   *
+   * @chainable
+   */
+  timeout (timeout) {
+    this._timeout = Number(timeout)
+    return this
+  }
+
+  /**
+   * Whether or not to exist tests earlier. Passed
+   * to japa runner
+   *
+   * @method bail
+   *
+   * @param  {Boolean} status
+   *
+   * @chainable
+   */
+  bail (status) {
+    this._bail = !!status
+    return this
+  }
+
+  /**
+   * The pattern to be used for grepping over
+   * tests. Passed to japa runner
+   *
+   * @method grep
+   *
+   * @param  {String} pattern
+   *
+   * @chainable
+   */
+  grep (pattern) {
+    this._grep = pattern
+    return this
+  }
+
+  /**
+   * Set the glob to be used for picking tests
+   * files and then running the tests.
+   *
+   * @method run
+   *
+   * @param  {String} glob
+   *
+   * @return {void}
+   */
+  run (glob) {
+    if (!glob) {
+      return
+    }
+
+    if (typeof (glob) !== 'string') {
+      throw new Error(`japaCli.run excepts glob pattern to be a string. You passed ${typeof (glob)}`)
+    }
+
+    this.testsGlob = glob
+  }
+}
+
+module.exports = new JapaCli()

examples/caller.js

@@ -0,0 +1,4 @@
+'use strict'
+
+require('./string.spec.js')
+require('./fizzbuzz.spec.js')

index.js

@@ -10,6 +10,7 @@
 */
 
 const runner = new (require('./src/Runner'))()
+const cli = require('./cli')
 
 const nextTick = typeof (setImmediate) !== 'undefined' ? setImmediate : process.nextTick
 
@@ -32,3 +33,4 @@ exports.timeout = runner.timeout.bind(runner)
 exports.use = runner.use.bind(runner)
 exports.bail = runner.bail.bind(runner)
 exports.grep = runner.grep.bind(runner)
+exports.cli = cli