@jdeighan/coffee-utils 10.0.5 → 10.0.8

package/package.json

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

package/src/block_utils.coffee

@@ -5,7 +5,7 @@ import readline from 'readline'
 
 import {assert, error, croak} from '@jdeighan/unit-tester/utils'
 import {
-	undef, defined, isEmpty, isString, isArray, nonEmpty, rtrim,
+	undef, pass, defined, isEmpty, isString, isArray, nonEmpty, rtrim,
 	} from '@jdeighan/coffee-utils'
 
 # ---------------------------------------------------------------------------
@@ -28,20 +28,45 @@ export blockToArray = (block) ->
 # ---------------------------------------------------------------------------
 #   toArray - split a block or array into lines w/o newlines
 
-export toArray = (item) ->
+export toArray = (item, option=undef) ->
+	# --- Valid options:
+	#     'noEmptyLines'
+	#     'noLeadingEmptyLines'
 
 	if isString(item)
-		return item.split(/\r?\n/)
+		lLines = item.split(/\r?\n/)
 	else if isArray(item)
-		# --- We still need to ensure that no strings contain newlines
-		lLines = []
-		for str in item
-			for substr in toArray(str)
-				lLines.push substr
-		return lLines
+		lLines = item
 	else
 		croak "Not a string or array"
 
+	# --- We need to ensure that no strings contain newlines
+	#     and possibly remove empty lines
+	lNewLines = []
+	nonEmptyFound = false
+	for line in lLines
+		if isEmpty(line)
+			if (option == 'noEmptyLines') \
+					|| ((option == 'noLeadingEmptyLines') && ! nonEmptyFound)
+				pass
+			else
+				lNewLines.push ''
+		else if (line.indexOf("\n") > -1)
+			for substr in toArray(line)
+				if isEmpty(substr)
+					if (option == 'noEmptyLines') \
+							|| ((option == 'noLeadingEmptyLines') && ! nonEmptyFound)
+						pass
+					else
+						lNewLines.push ''
+				else
+					nonEmptyFound = true
+					lNewLines.push substr
+		else
+			nonEmptyFound = true
+			lNewLines.push line
+	return lNewLines
+
 # ---------------------------------------------------------------------------
 #   arrayToBlock - block will have no trailing whitespace
 

package/src/block_utils.js

@@ -12,6 +12,7 @@ import {
 
 import {
   undef,
+  pass,
   defined,
   isEmpty,
   isString,
@@ -40,25 +41,51 @@ export var blockToArray = function(block) {
 
 // ---------------------------------------------------------------------------
 //   toArray - split a block or array into lines w/o newlines
-export var toArray = function(item) {
-  var i, j, lLines, len1, len2, ref, str, substr;
+export var toArray = function(item, option = undef) {
+  var i, j, lLines, lNewLines, len1, len2, line, nonEmptyFound, ref, substr;
+  // --- Valid options:
+  //     'noEmptyLines'
+  //     'noLeadingEmptyLines'
   if (isString(item)) {
-    return item.split(/\r?\n/);
+    lLines = item.split(/\r?\n/);
   } else if (isArray(item)) {
-    // --- We still need to ensure that no strings contain newlines
-    lLines = [];
-    for (i = 0, len1 = item.length; i < len1; i++) {
-      str = item[i];
-      ref = toArray(str);
+    lLines = item;
+  } else {
+    croak("Not a string or array");
+  }
+  // --- We need to ensure that no strings contain newlines
+  //     and possibly remove empty lines
+  lNewLines = [];
+  nonEmptyFound = false;
+  for (i = 0, len1 = lLines.length; i < len1; i++) {
+    line = lLines[i];
+    if (isEmpty(line)) {
+      if ((option === 'noEmptyLines') || ((option === 'noLeadingEmptyLines') && !nonEmptyFound)) {
+        pass;
+      } else {
+        lNewLines.push('');
+      }
+    } else if (line.indexOf("\n") > -1) {
+      ref = toArray(line);
       for (j = 0, len2 = ref.length; j < len2; j++) {
         substr = ref[j];
-        lLines.push(substr);
+        if (isEmpty(substr)) {
+          if ((option === 'noEmptyLines') || ((option === 'noLeadingEmptyLines') && !nonEmptyFound)) {
+            pass;
+          } else {
+            lNewLines.push('');
+          }
+        } else {
+          nonEmptyFound = true;
+          lNewLines.push(substr);
+        }
       }
+    } else {
+      nonEmptyFound = true;
+      lNewLines.push(line);
     }
-    return lLines;
-  } else {
-    return croak("Not a string or array");
   }
+  return lNewLines;
 };
 
 // ---------------------------------------------------------------------------

package/src/coffee_utils.coffee

@@ -21,6 +21,13 @@ export isComment = (line) ->
 
 # ---------------------------------------------------------------------------
 
+export isSubclassOf = (subClass, superClass) ->
+
+	return (subClass == superClass) \
+		|| (subClass.prototype instanceof superClass)
+
+# ---------------------------------------------------------------------------
+
 export eval_expr = (str) ->
 
 	str = str.replace(/\bundef\b/g, 'undefined')

package/src/coffee_utils.js

@@ -27,6 +27,11 @@ export var isComment = function(line) {
   return defined(lMatches);
 };
 
+// ---------------------------------------------------------------------------
+export var isSubclassOf = function(subClass, superClass) {
+  return (subClass === superClass) || (subClass.prototype instanceof superClass);
+};
+
 // ---------------------------------------------------------------------------
 export var eval_expr = function(str) {
   str = str.replace(/\bundef\b/g, 'undefined');

package/src/indent_utils.coffee

@@ -88,6 +88,7 @@ export indented = (input, level=1, oneIndent="\t") ->
 
 # ---------------------------------------------------------------------------
 #   undented - string with 1st line indentation removed for each line
+#            - ignore leading empty lines
 #            - unless level is set, in which case exactly that
 #              indentation is removed
 #            - returns same type as text, i.e. either string or array
@@ -97,9 +98,12 @@ export undented = (input, level=undef, oneIndent="\t") ->
 	if defined(level) && (level==0)
 		return input
 
-	lLines = toArray(input)
+	lLines = toArray(input, 'noLeadingEmptyLines')
 	if (lLines.length == 0)
-		return ''
+		if isString(input)
+			return ''
+		else
+			return []
 
 	# --- determine what to remove from beginning of each line
 	if defined(level)

package/src/indent_utils.js

@@ -108,6 +108,7 @@ export var indented = function(input, level = 1, oneIndent = "\t") {
 
 // ---------------------------------------------------------------------------
 //   undented - string with 1st line indentation removed for each line
+//            - ignore leading empty lines
 //            - unless level is set, in which case exactly that
 //              indentation is removed
 //            - returns same type as text, i.e. either string or array
@@ -116,9 +117,13 @@ export var undented = function(input, level = undef, oneIndent = "\t") {
   if (defined(level) && (level === 0)) {
     return input;
   }
-  lLines = toArray(input);
+  lLines = toArray(input, 'noLeadingEmptyLines');
   if (lLines.length === 0) {
-    return '';
+    if (isString(input)) {
+      return '';
+    } else {
+      return [];
+    }
   }
   // --- determine what to remove from beginning of each line
   if (defined(level)) {