v1.10 Indented Text output

Author: MartinPacker

README.md

@@ -41,7 +41,8 @@ To a very limited extent the format is documented [here](https://www.toketaware.
         * [HTML Output](#htmloutput)
         * [Freemind And OPML XML Output](#freemindandopmlxmloutput)
         * [GraphViz .dot Format](#graphviz.dotformat)
-        * [iThoughts CSV File Format](#ithoughtscsvfileformat)
+        * [Indented Text](#indentedtext)
+    * [iThoughts CSV File Format](#ithoughtscsvfileformat)
     * [Command Files](#commandfiles)
     * [Test Files](#testfiles)
     * [iThoughts Shape Names](#ithoughtsshapenames)
@@ -470,6 +471,32 @@ You can use the dot command (part of GraphViz) to turn this into a PNG graphic:
 
 In the above example the parameter `vertical` was used to align the root nodes next to each other, with descendants down the page. \ If you specify any other value, for example 'horizontal' or '.' the alignment will be horizontal. (You can use `v` for short, for `vertical`.)
 
+#### Indented Text
+
+You can write out the data as a text file where indentation is used to denote levels in the tree hierarchy. \
+Use the `indented` command to write out the text in this format. \
+There are numerous options for how to indent the text:
+
+* Code `original` to use the same indentation characters as on input. (This will only work if you read in an indented-text file; Otherwise the indentation will be an empty string.)
+
+* Code `tab` to use the tab character to indent.
+
+* Code `space:n` to use n spaces for each indentation level.
+
+* Code `.` as a shorthand to indent using two spaces for each level.
+
+* Code any other characters to use them for indentation.
+
+Here are two examples of usage:
+
+    filterCSV < input.csv > output.txt indented space:4
+
+will write out a file where four space characters are used for each level of indentation.
+
+    filterCSV < input.csv > output.txt indented "--"
+
+will write out a file where two dashes are used for each level of indentation.
+
 ### iThoughts CSV File Format
 
 The CSV format that iThoughts understands has a tree-like structure, within a table. As well as the tree of nodes, colour, position, node shape and other attributes of a node can be specified in the CSV file. To a very limited extent the format is documented [here](https://www.toketaware.com/ithoughts-howto-csv). A better way to understand the format is to export a mind map from iThoughts as CSV and look at the resulting file.

filterCSV

@@ -34,8 +34,10 @@ import xml.etree.ElementTree as ElementTree
 
 # from CSVTree import CSVTree
 
-filterCSV_level = "1.9"
-filterCSV_date = "15 August, 2020"
+filterCSV_level = "1.10"
+filterCSV_date = "16 August, 2020"
+
+inputIndentCharacters = ""
 
 
 class streamHandler:
@@ -315,6 +317,7 @@ class TreeReader:
         return self.ensureMandatoryColumns(csvRows) + (output,)
 
     def readMarkdownOrTextTree(self, inputFile):
+        global inputIndentCharacters
         output = []
 
         # Build array of rows
@@ -330,6 +333,7 @@ class TreeReader:
 
                 # Save the indentation whitespace
                 indentCharacters = line[0:indentLength]
+                inputIndentCharacters = indentCharacters
 
                 # Print the detected indentation - so user can debug
                 output.append(
@@ -1559,6 +1563,36 @@ class CSVTree:
         for childNode in self.childNodes:
             childNode.repairSubtreeLevels(parentLevel + 1)
 
+    def exportToIndentedText(self, actionsList):
+        indentationType = actionsList[0].lower()
+        if indentationType == "tab":
+            indentationCharacters = "\t"
+        if indentationType == "original":
+            indentationCharacters = inputIndentCharacters
+        elif indentationType == ".":
+            indentationCharacters = "  "
+        elif indentationType.startswith("space:"):
+            spaceCount = int(indentationType[6:])
+            indentationCharacters = " " * spaceCount
+        else:
+            indentationCharacters = indentationType
+
+        return self._exportToIndentedText(indentationCharacters)
+
+    def _exportToIndentedText(self, indentationCharacters):
+        output = []
+
+        level = int(self.data["level"])
+
+        if level > -1:
+            indentationText = indentationCharacters * level
+            output.append(indentationText + self.data["cell"])
+
+        for childNode in self.childNodes:
+            output += childNode._exportToIndentedText(indentationCharacters)
+
+        return output
+
     def exportToMarkdown(self, actionsList):
         # Get the number of heading levels to allow before going to nested bulleted
         # lists
@@ -2467,6 +2501,7 @@ manual.
                 "hspread": csvTree.doHorizontalSpread,
                 "html": csvTree.exportToHTML,
                 "markdown": csvTree.exportToMarkdown,
+                "indented": csvTree.exportToIndentedText,
                 "promote": csvTree.promoteLevel,
                 "stats": csvTree.writeStatistics,
                 "vspread": csvTree.doVerticalSpread,