@jdeighan/coffee-utils 4.1.35 → 5.0.2

package/src/UnitTester.coffee

@@ -1,258 +0,0 @@
-# UnitTester.coffee
-
-import test from 'ava'
-
-import {
-	assert, undef, pass, error, croak,
-	isString, isFunction, isInteger, isArray,
-	} from '@jdeighan/coffee-utils'
-import {blockToArray} from '@jdeighan/coffee-utils/block'
-import {log, currentLogger, setLogger} from '@jdeighan/coffee-utils/log'
-import {debug, debugging, setDebugging} from '@jdeighan/coffee-utils/debug'
-
-# ---------------------------------------------------------------------------
-
-export class UnitTester
-
-	constructor: (@file='unknown file') ->
-		@hFound = {}
-		@whichTest = 'deepEqual'
-		@justshow = false
-		@testing = true
-		@maxLineNum = undef
-
-	# ........................................................................
-
-	initialize: () ->     # override to do any initialization
-
-		pass
-
-	# ........................................................................
-
-	justshow: (flag) ->
-
-		@justshow = flag
-		return
-
-	# ........................................................................
-
-	just_show: (flag) ->
-
-		@justshow = flag
-		return
-
-	# ........................................................................
-
-	setMaxLineNum: (n) ->
-
-		@maxLineNum = n
-		return
-
-	# ........................................................................
-
-	setWhichTest: (testName) ->
-		@whichTest = testName
-		return
-
-	# ........................................................................
-
-	truthy: (lineNum, input, expected=undef) ->
-		@setWhichTest 'truthy'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	falsy: (lineNum, input, expected=undef) ->
-		@setWhichTest 'falsy'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	equal: (lineNum, input, expected) ->
-		@setWhichTest 'deepEqual'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	notequal: (lineNum, input, expected) ->
-		@setWhichTest 'notDeepEqual'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	same: (lineNum, input, expected) ->
-		@setWhichTest 'is'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	different: (lineNum, input, expected) ->
-		@setWhichTest 'not'
-		@test lineNum, input, expected
-		return
-
-	# ........................................................................
-
-	fails: (lineNum, func, expected) ->
-
-		assert ! expected?, "UnitTester: fails doesn't allow expected"
-		assert isFunction(func), "UnitTester: fails requires a function"
-
-		# --- disable logging
-		logger = currentLogger()
-		setLogger (x) -> pass
-		try
-			func()
-			ok = true
-		catch err
-			ok = false
-		setLogger logger
-		@setWhichTest 'falsy'
-		@test lineNum, ok, expected
-		return
-
-	# ........................................................................
-
-	succeeds: (lineNum, func, expected) ->
-
-		assert ! expected?, "UnitTester: succeeds doesn't allow expected"
-		assert isFunction(func), "UnitTester: succeeds requires a function"
-		try
-			func()
-			ok = true
-		catch err
-			ok = false
-		@setWhichTest 'truthy'
-		@test lineNum, ok, expected
-		return
-
-	# ........................................................................
-
-	same_list: (lineNum, list, expected) ->
-		assert ! list? || isArray(list), "UnitTester: not an array"
-		assert ! expected? || isArray(expected),
-			"UnitTester: expected is not an array"
-
-		@setWhichTest 'deepEqual'
-		@test lineNum, list.sort(), expected.sort()
-		return
-
-	# ........................................................................
-
-	not_same_list: (lineNum, list, expected) ->
-		assert ! list? || isArray(list), "UnitTester: not an array"
-		assert ! expected? || isArray(expected),
-			"UnitTester: expected is not an array"
-
-		@setWhichTest 'notDeepEqual'
-		@test lineNum, list.sort(), expected.sort()
-		return
-
-	# ........................................................................
-
-	normalize: (input) ->
-
-		# --- Convert all whitespace to single space character
-		#     Remove empty lines
-
-		if isString(input)
-			lLines = for line in blockToArray(input)
-				line = line.trim()
-				line.replace(/\s+/g, ' ')
-			lLines = lLines.filter (line) -> line != ''
-			return lLines.join('\n')
-		else
-			return input
-
-	# ........................................................................
-
-	test: (lineNum, input, expected) ->
-
-		assert isInteger(lineNum),
-			"UnitTester.test(): arg 1 must be an integer"
-
-		if process.env.TEST_LINE_NUMBER
-			if Math.abs(lineNum) != parseInt(process.env.TEST_LINE_NUMBER)
-				return
-
-		@initialize()
-		@lineNum = lineNum    # set an object property
-
-		if (lineNum < 0) && process.env.FINALTEST
-			error "Negative line numbers not allowed in FINALTEST in #{@file}"
-
-		if ! @testing || (@maxLineNum && (lineNum > @maxLineNum))
-			return
-
-		if lineNum < -100000
-			setDebugging true
-
-		lineNum = @getLineNum(lineNum)   # corrects for duplicates
-		errMsg = undef
-		try
-			got = @transformValue(input)
-			if isString(got)
-				got = @normalize(got)
-		catch err
-			errMsg = err.message || 'UNKNOWN ERROR'
-			log "got ERROR in unit test: #{errMsg}"
-
-		expected = @transformExpected(expected)
-		if isString(expected)
-			expected = @normalize(expected)
-
-		if @justshow
-			log "line #{lineNum}"
-			if errMsg
-				log "GOT ERROR #{errMsg}"
-			else
-				log got, "GOT:"
-			log expected, "EXPECTED:"
-			if lineNum < -100000
-				setDebugging false
-			return
-
-		# --- We need to save this here because in the tests themselves,
-		#     'this' won't be correct
-		whichTest = @whichTest
-
-		if lineNum < 0
-			test.only "line #{lineNum}", (t) ->
-				t[whichTest](got, expected)
-			@testing = false
-		else
-			test "line #{lineNum}", (t) ->
-				t[whichTest](got, expected)
-		if lineNum < -100000
-			setDebugging false
-		return
-
-	# ........................................................................
-
-	transformValue: (input) ->
-		return input
-
-	# ........................................................................
-
-	transformExpected: (input) ->
-		return input
-
-	# ........................................................................
-
-	getLineNum: (lineNum) ->
-
-		# --- patch lineNum to avoid duplicates
-		while @hFound[lineNum]
-			if lineNum < 0
-				lineNum -= 1000
-			else
-				lineNum += 1000
-		@hFound[lineNum] = true
-		return lineNum
-
-# ---------------------------------------------------------------------------

package/src/UnitTester.js

@@ -1,278 +0,0 @@
-// Generated by CoffeeScript 2.6.1
-// UnitTester.coffee
-import test from 'ava';
-
-import {
-  assert,
-  undef,
-  pass,
-  error,
-  croak,
-  isString,
-  isFunction,
-  isInteger,
-  isArray
-} from '@jdeighan/coffee-utils';
-
-import {
-  blockToArray
-} from '@jdeighan/coffee-utils/block';
-
-import {
-  log,
-  currentLogger,
-  setLogger
-} from '@jdeighan/coffee-utils/log';
-
-import {
-  debug,
-  debugging,
-  setDebugging
-} from '@jdeighan/coffee-utils/debug';
-
-// ---------------------------------------------------------------------------
-export var UnitTester = class UnitTester {
-  constructor(file = 'unknown file') {
-    this.file = file;
-    this.hFound = {};
-    this.whichTest = 'deepEqual';
-    this.justshow = false;
-    this.testing = true;
-    this.maxLineNum = undef;
-  }
-
-  // ........................................................................
-  initialize() { // override to do any initialization
-    return pass;
-  }
-
-  // ........................................................................
-  justshow(flag) {
-    this.justshow = flag;
-  }
-
-  // ........................................................................
-  just_show(flag) {
-    this.justshow = flag;
-  }
-
-  // ........................................................................
-  setMaxLineNum(n) {
-    this.maxLineNum = n;
-  }
-
-  // ........................................................................
-  setWhichTest(testName) {
-    this.whichTest = testName;
-  }
-
-  // ........................................................................
-  truthy(lineNum, input, expected = undef) {
-    this.setWhichTest('truthy');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  falsy(lineNum, input, expected = undef) {
-    this.setWhichTest('falsy');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  equal(lineNum, input, expected) {
-    this.setWhichTest('deepEqual');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  notequal(lineNum, input, expected) {
-    this.setWhichTest('notDeepEqual');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  same(lineNum, input, expected) {
-    this.setWhichTest('is');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  different(lineNum, input, expected) {
-    this.setWhichTest('not');
-    this.test(lineNum, input, expected);
-  }
-
-  // ........................................................................
-  fails(lineNum, func, expected) {
-    var err, logger, ok;
-    assert(expected == null, "UnitTester: fails doesn't allow expected");
-    assert(isFunction(func), "UnitTester: fails requires a function");
-    // --- disable logging
-    logger = currentLogger();
-    setLogger(function(x) {
-      return pass;
-    });
-    try {
-      func();
-      ok = true;
-    } catch (error1) {
-      err = error1;
-      ok = false;
-    }
-    setLogger(logger);
-    this.setWhichTest('falsy');
-    this.test(lineNum, ok, expected);
-  }
-
-  // ........................................................................
-  succeeds(lineNum, func, expected) {
-    var err, ok;
-    assert(expected == null, "UnitTester: succeeds doesn't allow expected");
-    assert(isFunction(func), "UnitTester: succeeds requires a function");
-    try {
-      func();
-      ok = true;
-    } catch (error1) {
-      err = error1;
-      ok = false;
-    }
-    this.setWhichTest('truthy');
-    this.test(lineNum, ok, expected);
-  }
-
-  // ........................................................................
-  same_list(lineNum, list, expected) {
-    assert((list == null) || isArray(list), "UnitTester: not an array");
-    assert((expected == null) || isArray(expected), "UnitTester: expected is not an array");
-    this.setWhichTest('deepEqual');
-    this.test(lineNum, list.sort(), expected.sort());
-  }
-
-  // ........................................................................
-  not_same_list(lineNum, list, expected) {
-    assert((list == null) || isArray(list), "UnitTester: not an array");
-    assert((expected == null) || isArray(expected), "UnitTester: expected is not an array");
-    this.setWhichTest('notDeepEqual');
-    this.test(lineNum, list.sort(), expected.sort());
-  }
-
-  // ........................................................................
-  normalize(input) {
-    var lLines, line;
-    // --- Convert all whitespace to single space character
-    //     Remove empty lines
-    if (isString(input)) {
-      lLines = (function() {
-        var i, len, ref, results;
-        ref = blockToArray(input);
-        results = [];
-        for (i = 0, len = ref.length; i < len; i++) {
-          line = ref[i];
-          line = line.trim();
-          results.push(line.replace(/\s+/g, ' '));
-        }
-        return results;
-      })();
-      lLines = lLines.filter(function(line) {
-        return line !== '';
-      });
-      return lLines.join('\n');
-    } else {
-      return input;
-    }
-  }
-
-  // ........................................................................
-  test(lineNum, input, expected) {
-    var err, errMsg, got, whichTest;
-    assert(isInteger(lineNum), "UnitTester.test(): arg 1 must be an integer");
-    if (process.env.TEST_LINE_NUMBER) {
-      if (Math.abs(lineNum) !== parseInt(process.env.TEST_LINE_NUMBER)) {
-        return;
-      }
-    }
-    this.initialize();
-    this.lineNum = lineNum; // set an object property
-    if ((lineNum < 0) && process.env.FINALTEST) {
-      error(`Negative line numbers not allowed in FINALTEST in ${this.file}`);
-    }
-    if (!this.testing || (this.maxLineNum && (lineNum > this.maxLineNum))) {
-      return;
-    }
-    if (lineNum < -100000) {
-      setDebugging(true);
-    }
-    lineNum = this.getLineNum(lineNum); // corrects for duplicates
-    errMsg = undef;
-    try {
-      got = this.transformValue(input);
-      if (isString(got)) {
-        got = this.normalize(got);
-      }
-    } catch (error1) {
-      err = error1;
-      errMsg = err.message || 'UNKNOWN ERROR';
-      log(`got ERROR in unit test: ${errMsg}`);
-    }
-    expected = this.transformExpected(expected);
-    if (isString(expected)) {
-      expected = this.normalize(expected);
-    }
-    if (this.justshow) {
-      log(`line ${lineNum}`);
-      if (errMsg) {
-        log(`GOT ERROR ${errMsg}`);
-      } else {
-        log(got, "GOT:");
-      }
-      log(expected, "EXPECTED:");
-      if (lineNum < -100000) {
-        setDebugging(false);
-      }
-      return;
-    }
-    // --- We need to save this here because in the tests themselves,
-    //     'this' won't be correct
-    whichTest = this.whichTest;
-    if (lineNum < 0) {
-      test.only(`line ${lineNum}`, function(t) {
-        return t[whichTest](got, expected);
-      });
-      this.testing = false;
-    } else {
-      test(`line ${lineNum}`, function(t) {
-        return t[whichTest](got, expected);
-      });
-    }
-    if (lineNum < -100000) {
-      setDebugging(false);
-    }
-  }
-
-  // ........................................................................
-  transformValue(input) {
-    return input;
-  }
-
-  // ........................................................................
-  transformExpected(input) {
-    return input;
-  }
-
-  // ........................................................................
-  getLineNum(lineNum) {
-    // --- patch lineNum to avoid duplicates
-    while (this.hFound[lineNum]) {
-      if (lineNum < 0) {
-        lineNum -= 1000;
-      } else {
-        lineNum += 1000;
-      }
-    }
-    this.hFound[lineNum] = true;
-    return lineNum;
-  }
-
-};
-
-// ---------------------------------------------------------------------------