@jdeighan/coffee-utils 7.0.33 → 7.0.36

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@jdeighan/coffee-utils",
 	"type": "module",
-	"version": "7.0.33",
+	"version": "7.0.36",
 	"description": "A set of utility functions for CoffeeScript",
 	"main": "coffee_utils.js",
 	"exports": {

package/src/coffee_utils.coffee

@@ -5,6 +5,14 @@ export sep_eq = '='.repeat(42)
 `export const undef = undefined`
 LOG = (lArgs...) -> console.log lArgs...   # synonym for console.log()
 
+export doHaltOnError = false
+
+# ---------------------------------------------------------------------------
+
+export haltOnError = () ->
+
+	doHaltOnError = true
+
 # ---------------------------------------------------------------------------
 #   pass - do nothing
 
@@ -15,8 +23,37 @@ export pass = () ->
 
 export error = (message) ->
 
+	if doHaltOnError
+		console.trace("ERROR: #{message}")
+		process.exit()
 	throw new Error(message)
 
+# ---------------------------------------------------------------------------
+
+getCallers = (stackTrace, lExclude=[]) ->
+
+	iter = stackTrace.matchAll(///
+			at
+			\s+
+			(?:
+				async
+				\s+
+				)?
+			([^\s(]+)
+			///g)
+	if !iter
+		return ["<unknown>"]
+
+	lCallers = []
+	for lMatches from iter
+		[_, caller] = lMatches
+		if (caller.indexOf('file://') == 0)
+			break
+		if caller not in lExclude
+			lCallers.push caller
+
+	return lCallers
+
 # ---------------------------------------------------------------------------
 #   assert - mimic nodejs's assert
 #   return true so we can use it in boolean expressions
@@ -24,7 +61,24 @@ export error = (message) ->
 export assert = (cond, msg) ->
 
 	if ! cond
-		error(msg)
+#		try
+#			throw new Error()
+#		catch e
+#			stackTrace = e.stack
+		stackTrace = new Error().stack
+		lCallers = getCallers(stackTrace, ['assert'])
+
+#		console.log 'STACK'
+#		console.log stackTrace
+		console.log '--------------------'
+		console.log 'CALL STACK:'
+		for caller in lCallers
+			console.log "   #{caller}"
+		console.log '--------------------'
+		console.log "ERROR: #{msg} (in #{lCallers[0]}())"
+		if doHaltOnError
+			process.exit()
+		error msg
 	return true
 
 # ---------------------------------------------------------------------------

package/src/coffee_utils.js

@@ -1,6 +1,7 @@
 // Generated by CoffeeScript 2.6.1
-// coffee_utils.coffee
-var LOG;
+  // coffee_utils.coffee
+var LOG, getCallers,
+  indexOf = [].indexOf;
 
 export var sep_dash = '-'.repeat(42);
 
@@ -12,6 +13,12 @@ LOG = function(...lArgs) {
   return console.log(...lArgs); // synonym for console.log()
 };
 
+export var doHaltOnError = false;
+
+// ---------------------------------------------------------------------------
+export var haltOnError = function() {
+  return doHaltOnError = true;
+};
 
 // ---------------------------------------------------------------------------
 //   pass - do nothing
@@ -20,14 +27,58 @@ export var pass = function() {};
 // ---------------------------------------------------------------------------
 //   error - throw an error
 export var error = function(message) {
+  if (doHaltOnError) {
+    console.trace(`ERROR: ${message}`);
+    process.exit();
+  }
   throw new Error(message);
 };
 
+// ---------------------------------------------------------------------------
+getCallers = function(stackTrace, lExclude = []) {
+  var _, caller, iter, lCallers, lMatches;
+  iter = stackTrace.matchAll(/at\s+(?:async\s+)?([^\s(]+)/g);
+  if (!iter) {
+    return ["<unknown>"];
+  }
+  lCallers = [];
+  for (lMatches of iter) {
+    [_, caller] = lMatches;
+    if (caller.indexOf('file://') === 0) {
+      break;
+    }
+    if (indexOf.call(lExclude, caller) < 0) {
+      lCallers.push(caller);
+    }
+  }
+  return lCallers;
+};
+
 // ---------------------------------------------------------------------------
 //   assert - mimic nodejs's assert
 //   return true so we can use it in boolean expressions
 export var assert = function(cond, msg) {
+  var caller, i, lCallers, len, stackTrace;
   if (!cond) {
+    //		try
+    //			throw new Error()
+    //		catch e
+    //			stackTrace = e.stack
+    stackTrace = new Error().stack;
+    lCallers = getCallers(stackTrace, ['assert']);
+    //		console.log 'STACK'
+    //		console.log stackTrace
+    console.log('--------------------');
+    console.log('CALL STACK:');
+    for (i = 0, len = lCallers.length; i < len; i++) {
+      caller = lCallers[i];
+      console.log(`   ${caller}`);
+    }
+    console.log('--------------------');
+    console.log(`ERROR: ${msg} (in ${lCallers[0]}())`);
+    if (doHaltOnError) {
+      process.exit();
+    }
     error(msg);
   }
   return true;

package/src/debug_utils.coffee

@@ -176,12 +176,12 @@ export debug = (lArgs...) ->
 	switch type
 		when 'enter'
 			log label, hOptions
-			if item
+			if (nArgs==2)
 				# --- don't repeat the label
 				logItem undef, item, hOptions
 		when 'return'
 			log label, hOptions
-			if item?
+			if (nArgs==2)
 				# --- don't repeat the label
 				logItem undef, item, hOptions
 		when 'string'

package/src/debug_utils.js

@@ -186,14 +186,14 @@ export var debug = function(...lArgs) {
   switch (type) {
     case 'enter':
       log(label, hOptions);
-      if (item) {
+      if (nArgs === 2) {
         // --- don't repeat the label
         logItem(undef, item, hOptions);
       }
       break;
     case 'return':
       log(label, hOptions);
-      if (item != null) {
+      if (nArgs === 2) {
         // --- don't repeat the label
         logItem(undef, item, hOptions);
       }

package/src/indent_utils.coffee

@@ -1,7 +1,7 @@
 # indent_utils.coffee
 
 import {
-	assert, undef, error, escapeStr,
+	assert, undef, error, escapeStr, defined,
 	OL, isInteger, isString, isArray, isEmpty, rtrim,
 	} from '@jdeighan/coffee-utils'
 import {arrayToBlock, blockToArray} from '@jdeighan/coffee-utils/block'
@@ -68,7 +68,7 @@ export indented = (input, level=1) ->
 
 export undented = (text, level=undef) ->
 
-	if level? && (level==0)
+	if defined(level) && (level==0)
 		return text
 
 	if isString(text)
@@ -85,7 +85,7 @@ export undented = (text, level=undef) ->
 		error "undented(): Not an array or string: #{OL(text)}"
 
 	# --- determine what to remove from beginning of each line
-	if level?
+	if defined(level)
 		assert isInteger(level), "undented(): level must be an integer"
 		toRemove = indentation(level)
 	else

package/src/indent_utils.js

@@ -5,6 +5,7 @@ import {
   undef,
   error,
   escapeStr,
+  defined,
   OL,
   isInteger,
   isString,
@@ -86,7 +87,7 @@ export var indented = function(input, level = 1) {
 //            - returns same type as text, i.e. either string or array
 export var undented = function(text, level = undef) {
   var i, j, lLines, lMatches, lNewLines, len, len1, line, nToRemove, toRemove;
-  if ((level != null) && (level === 0)) {
+  if (defined(level) && (level === 0)) {
     return text;
   }
   if (isString(text)) {
@@ -107,7 +108,7 @@ export var undented = function(text, level = undef) {
     error(`undented(): Not an array or string: ${OL(text)}`);
   }
   // --- determine what to remove from beginning of each line
-  if (level != null) {
+  if (defined(level)) {
     assert(isInteger(level), "undented(): level must be an integer");
     toRemove = indentation(level);
   } else {