@jdeighan/coffee-utils 4.1.19 → 4.1.23

package/package.json

@@ -1,11 +1,12 @@
 {
 	"name": "@jdeighan/coffee-utils",
 	"type": "module",
-	"version": "4.1.19",
+	"version": "4.1.23",
 	"description": "A set of utility functions for CoffeeScript",
 	"main": "coffee_utils.js",
 	"exports": {
 		".": "./src/coffee_utils.js",
+		"./external": "./src/external.js",
 		"./fs": "./src/fs_utils.js",
 		"./log": "./src/log_utils.js",
 		"./block": "./src/block_utils.js",
@@ -24,8 +25,7 @@
 	},
 	"scripts": {
 		"build": "cls && rm -f ./src/*.js && coffee -c ./src",
-		"old_pretest": "npm run build && rm -f ./test/*.js && rm -f ./test/*.coffee && cielo -fq ./test",
-		"pretest": "cls && coffee -c .",
+		"pretest": "cls && cielo -qfc ./test && coffee -c ./test",
 		"test": "ava ./test/*.test.js",
 		"prefinaltest": "npm run pretest",
 		"finaltest": "cross-env FINALTEST=yes ava ./test/*.test.js"

package/src/coffee_utils.coffee

@@ -1,24 +1,11 @@
 # coffee_utils.coffee
 
-import getline from 'readline-sync'
-import {execSync} from 'child_process'
-
 import {log} from '@jdeighan/coffee-utils/log'
 
 export sep_dash = '-'.repeat(42)
 export sep_eq = '='.repeat(42)
 `export const undef = undefined`
 
-# ---------------------------------------------------------------------------
-#   exec - run external commands
-
-export exec = (cmd) ->
-
-	buffer = execSync cmd, {
-		windowsHide: true
-		}
-	return buffer.toString()
-
 # ---------------------------------------------------------------------------
 #   pass - do nothing
 
@@ -261,15 +248,6 @@ export say = (x) ->
 		console.log x
 	return
 
-# ---------------------------------------------------------------------------
-#   ask - ask a question
-#         later, on a web page, prompt the user for answer to question
-
-export ask = (prompt) ->
-
-	answer = getline.question("{prompt}? ")
-	return answer
-
 # ---------------------------------------------------------------------------
 
 export titleLine = (title, char='=', padding=2, linelen=42) ->

package/src/coffee_utils.js

@@ -2,12 +2,6 @@
 // coffee_utils.coffee
 var commentRegExp;
 
-import getline from 'readline-sync';
-
-import {
-  execSync
-} from 'child_process';
-
 import {
   log
 } from '@jdeighan/coffee-utils/log';
@@ -18,16 +12,6 @@ export var sep_eq = '='.repeat(42);
 
 export const undef = undefined;
 
-// ---------------------------------------------------------------------------
-//   exec - run external commands
-export var exec = function(cmd) {
-  var buffer;
-  buffer = execSync(cmd, {
-    windowsHide: true
-  });
-  return buffer.toString();
-};
-
 // ---------------------------------------------------------------------------
 //   pass - do nothing
 export var pass = function() {};
@@ -265,15 +249,6 @@ export var say = function(x) {
   }
 };
 
-// ---------------------------------------------------------------------------
-//   ask - ask a question
-//         later, on a web page, prompt the user for answer to question
-export var ask = function(prompt) {
-  var answer;
-  answer = getline.question("{prompt}? ");
-  return answer;
-};
-
 // ---------------------------------------------------------------------------
 export var titleLine = function(title, char = '=', padding = 2, linelen = 42) {
   var nLeft, nRight, strLeft, strMiddle, strRight, titleLen;

package/src/debug_utils.coffee

@@ -33,7 +33,7 @@ export resetDebugging = (funcDoDebug=undef, funcDoLog=undef) ->
 	debugging = false
 	debugLevel = 0
 	stack.reset()
-	shouldDebug = (funcName) -> debugging
+	shouldDebug = (funcName, curDebugging) -> curDebugging
 	shouldLog   = (str)      -> debugging
 	if funcDoDebug
 		setDebugging funcDoDebug, funcDoLog
@@ -49,8 +49,8 @@ export setDebugging = (funcDoDebug=undef, funcDoLog=undef) ->
 		debugging = false
 		lFuncNames = words(funcDoDebug)
 		assert isArray(lFuncNames), "words('#{funcDoDebug}') returned non-array"
-		shouldDebug = (funcName) ->
-			debugging || funcMatch(funcName, lFuncNames)
+		shouldDebug = (funcName, curDebugging) ->
+			curDebugging || funcMatch(funcName, lFuncNames)
 	else if isFunction(funcDoDebug)
 		shouldDebug = funcDoDebug
 	else
@@ -126,6 +126,17 @@ getPrefix = (level) ->
 
 # ---------------------------------------------------------------------------
 
+envSaysDebug = (curFunc) ->
+
+	if process.env.DEBUG_FUNC?
+		return curFunc == process.env.DEBUG_FUNC
+	else if process.env.DEBUG_FUNCS?
+		return process.env.DEBUG_FUNCS.split(',').indexOf(curFunc) > -1
+	else
+		return false
+
+# ---------------------------------------------------------------------------
+
 export debug = (lArgs...) ->
 	# --- either 1 or 2 args
 
@@ -158,7 +169,7 @@ export debug = (lArgs...) ->
 		entering = true
 		curFunc = lMatches[1]
 		stack.call(curFunc, curEnv())
-		debugging = shouldDebug(curFunc, debugging)
+		debugging = envSaysDebug(curFunc) || shouldDebug(curFunc, debugging)
 	else if (lMatches = str.match(///^
 			\s*
 			return

package/src/debug_utils.js

@@ -1,6 +1,6 @@
 // Generated by CoffeeScript 2.6.1
 // debug_utils.coffee
-var arrow, arrowhead, corner, curEnv, debugLevel, getPrefix, hbar, indent, logger, reMethod, setEnv, shouldDebug, shouldLog, stack, stdLogger, stripArrow, vbar;
+var arrow, arrowhead, corner, curEnv, debugLevel, envSaysDebug, getPrefix, hbar, indent, logger, reMethod, setEnv, shouldDebug, shouldLog, stack, stdLogger, stripArrow, vbar;
 
 import {
   assert,
@@ -63,8 +63,8 @@ export var resetDebugging = function(funcDoDebug = undef, funcDoLog = undef) {
   debugging = false;
   debugLevel = 0;
   stack.reset();
-  shouldDebug = function(funcName) {
-    return debugging;
+  shouldDebug = function(funcName, curDebugging) {
+    return curDebugging;
   };
   shouldLog = function(str) {
     return debugging;
@@ -83,8 +83,8 @@ export var setDebugging = function(funcDoDebug = undef, funcDoLog = undef) {
     debugging = false;
     lFuncNames = words(funcDoDebug);
     assert(isArray(lFuncNames), `words('${funcDoDebug}') returned non-array`);
-    shouldDebug = function(funcName) {
-      return debugging || funcMatch(funcName, lFuncNames);
+    shouldDebug = function(funcName, curDebugging) {
+      return curDebugging || funcMatch(funcName, lFuncNames);
     };
   } else if (isFunction(funcDoDebug)) {
     shouldDebug = funcDoDebug;
@@ -153,6 +153,17 @@ getPrefix = function(level) {
   return '   '.repeat(level);
 };
 
+// ---------------------------------------------------------------------------
+envSaysDebug = function(curFunc) {
+  if (process.env.DEBUG_FUNC != null) {
+    return curFunc === process.env.DEBUG_FUNC;
+  } else if (process.env.DEBUG_FUNCS != null) {
+    return process.env.DEBUG_FUNCS.split(',').indexOf(curFunc) > -1;
+  } else {
+    return false;
+  }
+};
+
 // ---------------------------------------------------------------------------
 export var debug = function(...lArgs) {
   var curFunc, entering, hInfo, item, lMatches, nArgs, prefix, returning, str;
@@ -177,7 +188,7 @@ export var debug = function(...lArgs) {
     entering = true;
     curFunc = lMatches[1];
     stack.call(curFunc, curEnv());
-    debugging = shouldDebug(curFunc, debugging);
+    debugging = envSaysDebug(curFunc) || shouldDebug(curFunc, debugging);
   } else if ((lMatches = str.match(/^\s*return.+from\s+([A-Za-z_][A-Za-z0-9_\.]*)/))) {
     returning = true;
     curFunc = lMatches[1];

package/src/external.coffee

@@ -0,0 +1,24 @@
+# external.coffee
+
+import getline from 'readline-sync'
+import {execSync} from 'child_process'
+
+# ---------------------------------------------------------------------------
+#   exec - run external commands
+
+export exec = (cmd) ->
+
+	buffer = execSync cmd, {
+		windowsHide: true
+		}
+	return buffer.toString()
+
+# ---------------------------------------------------------------------------
+#   ask - ask a question
+#         later, on a web page, prompt the user for answer to question
+
+export ask = (prompt) ->
+
+	answer = getline.question("{prompt}? ")
+	return answer
+

package/src/external.js

@@ -0,0 +1,26 @@
+// Generated by CoffeeScript 2.6.1
+// external.coffee
+import getline from 'readline-sync';
+
+import {
+  execSync
+} from 'child_process';
+
+// ---------------------------------------------------------------------------
+//   exec - run external commands
+export var exec = function(cmd) {
+  var buffer;
+  buffer = execSync(cmd, {
+    windowsHide: true
+  });
+  return buffer.toString();
+};
+
+// ---------------------------------------------------------------------------
+//   ask - ask a question
+//         later, on a web page, prompt the user for answer to question
+export var ask = function(prompt) {
+  var answer;
+  answer = getline.question("{prompt}? ");
+  return answer;
+};