Merge pull request #119 from cybertk/generate_hooks

Generate hooks

Author: plroebuck

README.md

@@ -84,7 +84,16 @@ $ abao single-get.raml --names
 GET /machines -> 200
 ```
 
-Write a hookfile in *JavaScript* named `test_machines_hooks.js`:
+**Abao** can generate a hookfile to help validate more than just the
+response code for each path.
+
+```bash
+$ abao single-get.raml --generate-hooks > test_machines_hooks.js
+
+```
+
+Then edit the *JavaScript* hookfile `test_machines_hooks.js` created in the
+previous step to add request parameters and response validation logic.
 
 ```js
 var hooks = require('hooks'),

bin/abao

@@ -10,7 +10,7 @@ var argv = yargs
     .usage("Usage:\n  abao </path/to/raml> [OPTIONS]" +
     "\n\nExample:\n  " + "abao api.raml --server http://api.example.com")
     .options(Abao.options)
-    .wrap(80)
+    .implies('template', 'generate-hooks')
     .check(function (argv) {
       if (argv.reporters === true) {
         showReporters();
@@ -26,6 +26,7 @@ var argv = yargs
 
       return true;
     })
+    .wrap(80)
     .help('help', 'Show usage information and exit')
     .version().describe('version', 'Show version number and exit')
     .epilog("Website:\n  " + 'https://github.com/cybertk/abao')

lib/abao.coffee

@@ -1,5 +1,5 @@
 sms = require("source-map-support").install({handleUncaughtExceptions: false})
-raml = require 'raml-parser'
+ramlParser = require 'raml-parser'
 async = require 'async'
 
 options = require './options'
@@ -22,7 +22,7 @@ class Abao
     tests = @tests
     hooks = @hooks
 
-    # init the test factory to inject the json refs schemas
+    # Inject the JSON refs schemas
     factory = new TestFactory(config.options.schemas)
 
     async.waterfall [
@@ -33,7 +33,7 @@ class Abao
       ,
       # Load RAML
       (callback) ->
-        raml.loadFile(config.ramlPath).then (raml) ->
+        ramlParser.loadFile(config.ramlPath).then (raml) ->
           callback(null, raml)
         , callback
       ,
@@ -46,7 +46,7 @@ class Abao
       ,
       # Run tests
       (callback) ->
-        runner = new Runner config.options
+        runner = new Runner config.options, config.ramlPath
         runner.run tests, hooks, callback
     ], done
 

lib/add-hooks.coffee

@@ -1,8 +1,7 @@
-path = require 'path'
-
 require 'coffee-script/register'
 proxyquire = require('proxyquire').noCallThru()
 glob = require 'glob'
+path = require 'path'
 
 
 addHooks = (hooks, pattern) ->

lib/add-tests.coffee

@@ -2,6 +2,7 @@ async = require 'async'
 _ = require 'underscore'
 csonschema = require 'csonschema'
 
+
 parseSchema = (source) ->
   if source.contains('$schema')
     #jsonschema

lib/apply-configuration.coffee

@@ -1,4 +1,3 @@
-
 applyConfiguration = (config) ->
 
   coerceToArray = (value) ->
@@ -35,11 +34,11 @@ applyConfiguration = (config) ->
       invert: false
       'hooks-only': false
 
-  # normalize options and config
+  # Normalize options and config
   for own key, value of config
     configuration[key] = value
 
-  # coerce some options into an dict
+  # Coerce some options into an dict
   configuration.options.header = coerceToDict(configuration.options.header)
 
   # TODO(quanlong): OAuth2 Bearer Token

lib/generate-hooks.coffee

@@ -0,0 +1,30 @@
+fs = require 'fs'
+Mustache = require 'mustache'
+
+generateHooks = (names, ramlFile, templateFile, callback) ->
+  if !names
+    callback new Error 'no names found for which to generate hooks'
+
+  if !templateFile
+    callback new Error 'missing template file'
+
+  try
+    template = fs.readFileSync templateFile, 'utf8'
+    datetime = new Date().toISOString().replace('T', ' ').substr(0, 19)
+    view =
+      ramlFile: ramlFile
+      timestamp: datetime
+      hooks:
+        { 'name': name } for name in names
+    view.hooks[0].comment = true
+
+    content = Mustache.render template, view
+    console.log content
+  catch error
+    console.error 'failed to generate skeleton hooks'
+    callback error
+
+  callback
+
+module.exports = generateHooks
+

lib/hooks.coffee

@@ -1,6 +1,7 @@
 async = require 'async'
 _ = require 'underscore'
 
+
 class Hooks
   constructor: () ->
     @beforeHooks = {}

lib/options.coffee

@@ -1,27 +1,27 @@
 options =
   server:
-    description: 'Specify the API endpoint to use. The RAML-specified baseUri value will be used if not provided'
+    description: 'Specify API endpoint to use. The RAML-specified baseUri value will be used if not provided'
     type: 'string'
 
   hookfiles:
     alias: 'f'
-    description: 'Specify a pattern to match files with before/after hooks for running tests'
+    description: 'Specify pattern to match files with before/after hooks for running tests'
     type: 'string'
 
   schemas:
     alias: 's'
-    description: 'Specify a pattern to match schema files to be loaded for use as JSON refs'
+    description: 'Specify pattern to match schema files to be loaded for use as JSON refs'
     type: 'string'
 
   reporter:
     alias: 'r'
-    description: 'Specify the reporter to use'
+    description: 'Specify reporter to use'
     type: 'string'
     default: 'spec'
 
   header:
     alias: 'h'
-    description: 'Add header to include in each request. The header must be in KEY:VALUE format, e.g. "-h Accept:application/json".\nReuse to add multiple headers'
+    description: 'Add header to include in each request. Header must be in KEY:VALUE format (e.g., "-h Accept:application/json").\nReuse option to add multiple headers'
     type: 'string'
 
   'hooks-only':
@@ -45,11 +45,20 @@ options =
     type: 'number'
     default: 2000
 
+  template:
+    description: 'Specify template file to use for generating hooks'
+    type: 'string'
+    normalize: true
+
   names:
     alias: 'n'
     description: 'List names of requests and exit'
     type: 'boolean'
 
+  'generate-hooks':
+    description: 'Output hooks generated from template file and exit'
+    type: 'boolean'
+
   reporters:
     description: 'Display available reporters and exit'
     type: 'boolean'

lib/server.coffee

@@ -1,5 +1,6 @@
 express = require 'express'
 
+
 PORT = '3333'
 
 app = express()