Scrub tests.

test/all.js

@@ -7,6 +7,6 @@ require('./scripts/test-cli');
 require('./scripts/test-fresh-sheet');
 require('./scripts/test-jrs-sheet');
 require('./scripts/test-themes');
-require('./scripts/test-api');
+require('./scripts/test-verbs');
 require('./scripts/test-output');
 require('./scripts/test-dates');

test/scripts/test-cli.js

@@ -1,6 +1,8 @@
 /**
-CLI test routines for HackMyResume.
+CLI test routines for HackMyResume. Test the HackMyResume command-line interface
+by spawning HMR directly and observing the return code and std output.
 @module test-cli.js
+@license MIT. See LICENSE.md for details.
 */
 
 
@@ -13,12 +15,11 @@ var chai = require('chai')
   , EXEC = require('child_process').exec
 
 
+
 describe('Testing CLI interface', function () {
 
   this.timeout(5000);
 
-  // Run a test through the stub, gathering console.log output into "gather"
-  // and testing against it.
   function run( args, expErr ) {
     var title = args;
     it( 'Testing: "' + title + '"\n\n', function( done ) {
@@ -36,7 +37,8 @@ describe('Testing CLI interface', function () {
     });
   }
 
-  var lines = FS.readFileSync( PATH.join( __dirname, './test-hmr.txt'), 'utf8').split('\n');
+  var testFile = PATH.join( __dirname, './test-hmr.txt');
+  var lines = FS.readFileSync( testFile, 'utf8').split('\n');
   lines.forEach(function(l){
     if( l && l.trim() ) {
       if(l[0] !== '#') {

test/scripts/test-dates.js

@@ -1,7 +1,11 @@
 /**
+Test routines for HackMyResume dates, times, and datetimes.
 @module test-dates.js
+@license MIT. See LICENSE.md for details.
 */
 
+
+
 var chai = require('chai')
   , expect = chai.expect
   , should = chai.should()
@@ -12,8 +16,12 @@ var chai = require('chai')
   , validator = require('is-my-json-valid')
   , EXTEND = require('extend');
 
+
+
 chai.config.includeStack = true;
 
+
+
 var gig = {
   employer: 'E1'
 };
@@ -28,6 +36,8 @@ var r = {
   }
 };
 
+
+
 var tests = [
   // single job, concrete start, no end
   [ { start: '2010-01-01' } , { val: 6, unit: 'year' } ],
@@ -58,10 +68,14 @@ var tests = [
 
 ];
 
+
+
 tests.forEach(function(t){
    _.initial( t ).forEach(function(t){ t.employer = 'E1' });
 })
 
+
+
 describe('Testing DATES', function () {
 
   tests.forEach( function(t) {

test/scripts/test-fresh-sheet.js

@@ -1,3 +1,10 @@
+/**
+Test routines for the FRESHResume class.
+@module test-jrs-sheet.js
+@license MIT. See LICENSE.md for details.
+*/
+
+
 
 var chai = require('chai')
   , expect = chai.expect
@@ -8,8 +15,12 @@ var chai = require('chai')
   , ResumeFactory = require('../../dist/core/resume-factory')
   , validator = require('is-my-json-valid');
 
+
+
 chai.config.includeStack = false;
 
+
+
 function testResume(opts) {
 
   describe( opts.title + ' (FRESH)', function () {

test/scripts/test-jrs-sheet.js

@@ -1,3 +1,10 @@
+/**
+Test routines for the JRSResume class.
+@module test-jrs-sheet.js
+@license MIT. See LICENSE.md for details.
+*/
+
+
 
 var chai = require('chai')
   , expect = chai.expect
@@ -8,8 +15,12 @@ var chai = require('chai')
   , ResumeFactory = require('../../dist/core/resume-factory')
   , validator = require('is-my-json-valid');
 
+
+
 chai.config.includeStack = false;
 
+
+
 function testResume( opts ) {
 
   describe( opts.title + ' (JRS)', function() {

test/scripts/test-output.js

@@ -1,6 +1,7 @@
 /**
-CLI test routines for HackMyResume.
-@module test-cli.js
+Output test routines for HackMyResume. Make sure our outputs are consistent.
+@module test-output.js
+@license MIT. See LICENSE.md for details.
 */
 
 

test/scripts/test-themes.js

@@ -1,3 +1,11 @@
+/**
+Theme test routines for HackMyResume. Test all preinstalled HackMyResume themes
+along with a handful of JSON Resume themes for good measure. Uses the HMR verb
+interface.
+@module test-themes.js
+@license MIT. See LICENSE.md for details.
+*/
+
 
 var chai = require('chai')
   , expect = chai.expect

test/scripts/test-verbs.js

@@ -1,5 +1,8 @@
 /**
-@module test-api.js
+High-level API test routines for HackMyResume. Test HackMyResume verbs such
+as build, new, peek, etc., by creating and invoking a Verb object.
+@module test-verbs.js
+@license MIT. See LICENSE.md for details.
 */
 
 var chai = require('chai')
@@ -172,7 +175,8 @@ describe('Testing API interface', function () {
         shouldSucceed = false;
       }
 
-      it( 'The ' + verb.toUpperCase() + ' command should ' + (shouldSucceed ? ' NOT THROW' : ' THROW') + msg, function () {
+      it( 'The ' + verb.toUpperCase() + ' command should ' +
+          (shouldSucceed ? ' NOT THROW' : ' THROW') + msg, function () {
 
         function runIt() {
           try {