Sort by when writing datasets

.gitignore

@@ -27,6 +27,7 @@ blog/planets.json
 feed.xml
 *.txt
 *.csv
+planetMeasures.tsv
 
 # Do not check in external assets copied by Scroll
 blog/dataTables.dataTables.min.css

blog/datasets.scroll

@@ -1,8 +1,8 @@
 date 4/21/2024
 groups All
-writeConcepts planets.csv
-writeConcepts planets.json
-writeConcepts planets.tsv
+writeConcepts planets.csv planets.json planets.tsv
+writeMeasures planetMeasures.tsv
+ sortBy -Values
 
 import header.scroll
 keyboardNav

grammar/concepts.grammar

@@ -34,3 +34,6 @@ writeConceptsParser
  catchAllCellType filePathCell
  description Compiles concepts to a delimited file and write to disk.
  extends abstractCommandParser
+ sortByParser
+  cruxFromId
+  cells keywordCell anyCell

grammar/measures.grammar

@@ -6,6 +6,9 @@ writeMeasuresParser
  catchAllCellType filePathCell
  description Writes measure statistics to a delimited file and write to disk.
  extends abstractCommandParser
+ sortByParser
+  cruxFromId
+  cells keywordCell anyCell
 
 printMeasuresParser
  description Print measures statistics in a page into an HTML table.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "scroll-cli",
-  "version": "85.4.0",
+  "version": "85.5.0",
   "description": "A language for bloggers. A curated collection of tools for thoughts.",
   "main": "scroll.js",
   "engines": {

releaseNotes.scroll

@@ -4,6 +4,9 @@ title Scroll Release Notes
 
 thinColumns
 
+# 85.5.0 5/10/2024
+- 🎉 `writeConcepts` and `writeMeasures` can now take multiple filenames in one line and also include a `sortBy` condition.
+
 # 85.4.0 5/10/2024
 - 🎉 Scroll now auto-adds a "filename" measure as to which file the concept appears in.
 

scroll.js

@@ -300,12 +300,15 @@ class ScrollFile {
     return tree.toString()
   }
 
-  compileConcepts(format = "csv") {
-    return this._compileArray(format, this.concepts)
+  compileConcepts(format = "csv", sortBy = "") {
+    if (!sortBy) return this._compileArray(format, this.concepts)
+    return this._compileArray(format, lodash.sortBy(this.concepts, sortBy))
   }
 
-  compileMeasures(format = "csv") {
-    return this._compileArray(format, addMeasureStats(this.concepts, this.measures))
+  compileMeasures(format = "csv", sortBy = "") {
+    const withStats = addMeasureStats(this.concepts, this.measures)
+    if (!sortBy) return this._compileArray(format, withStats)
+    return this._compileArray(format, lodash.sortBy(withStats, sortBy))
   }
 
   evalVariables(code, originalScrollCode) {
@@ -776,20 +779,26 @@ import footer.scroll
     if (!file.has(scrollKeywords.writeConcepts)) return
     const { permalink } = file
     file.scrollProgram.findNodes(scrollKeywords.writeConcepts).forEach(node => {
-      const link = node.getWord(1) || permalink.replace(".html", ".tsv")
-
-      const extension = link.split(".").pop()
-      fileSystem.write(folder + link, file.compileConcepts(extension))
-      this.log(`💾 Wrote concepts in ${file.filename} to ${link}`)
+      const files = node.getWordsFrom(1)
+      if (!files.length) files.push(permalink.replace(".html", ".tsv"))
+      const sortBy = node.get("sortBy")
+      files.forEach(link => {
+        const extension = link.split(".").pop()
+        fileSystem.write(folder + link, file.compileConcepts(extension, sortBy))
+        this.log(`💾 Wrote concepts in ${file.filename} to ${link}`)
+      })
     })
 
     if (!file.has(scrollKeywords.writeMeasures)) return
     file.scrollProgram.findNodes(scrollKeywords.writeMeasures).forEach(node => {
-      const link = node.getWord(1) || permalink.replace(".html", ".tsv")
-
-      const extension = link.split(".").pop()
-      fileSystem.write(folder + link, file.compileMeasures(extension))
-      this.log(`💾 Wrote measures in ${file.filename} to ${link}`)
+      const files = node.getWordsFrom(1)
+      if (!files.length) files.push(permalink.replace(".html", ".tsv"))
+      const sortBy = node.get("sortBy")
+      files.forEach(link => {
+        const extension = link.split(".").pop()
+        fileSystem.write(folder + link, file.compileMeasures(extension, sortBy))
+        this.log(`💾 Wrote measures in ${file.filename} to ${link}`)
+      })
     })
   }