From 4a073cbc795b64686083eb06ce401526a6412c93 Mon Sep 17 00:00:00 2001
From: Peter Verhas <peter@verhas.com>
Date: Tue, 5 Dec 2023 17:04:56 +0100
Subject: [PATCH] jrf files now contain comments to make them more readable

---
 README.adoc                                   |   2 +-
 README.jrf                                    |   3 ++
 jamal-snippet/README.adoc                     |   4 +-
 jamal-snippet/sample.jrf                      |   3 ++
 .../java/javax0/jamal/snippet/References.java |  47 +++++++++++++-----
 .../src/test/resources/demoConverted.docx     | Bin 12793 -> 12793 bytes
 .../test/resources/includetestConverted.docx  | Bin 34572 -> 34572 bytes
 .../src/test/resources/pictureConverted.docx  | Bin 21869 -> 21869 bytes
 .../src/test/resources/sampleConverted.docx   | Bin 40809 -> 40815 bytes
 9 files changed, 44 insertions(+), 15 deletions(-)

diff --git a/README.adoc b/README.adoc
index a71535b6c..66e144f0d 100644
--- a/README.adoc
+++ b/README.adoc
@@ -536,4 +536,4 @@ See the separate document: link:FAQ.adoc[FAQ].
 
 
 
-The documents of this project are formatted as Asciidoc documents with Jamal meta markup.
\ No newline at end of file
+The documents of this project are formatted as Asciidoc documents with Jamal meta markup.
diff --git a/README.jrf b/README.jrf
index 0fc242d77..bf2003f1e 100644
--- a/README.jrf
+++ b/README.jrf
@@ -1 +1,4 @@
+# This is a Jama reference file containing serialized base64 encoded macros
+# id|openStr|closeStr|verbatim|tailParameter|pure|content|parameters
+# TOC
 VE9D|eyU=|JX0=|0|0|0|Ci4gPDxJbnN0YWxsYXRpb24+PgouIDw8R1M+PgouIDw8Q29uZmlndXJhdGlvbj4+Ci4gPDxGZWF0dXJlcz4+Ci4gPDxDb250cmlidXRpbmc+PgouIDw8RG9jdW1lbnRhdGlvbj4+Ci4gPDxMaWNlbnNlPj4KLiA8PENoYW5nZWxvZz4+Ci4gPDxSb2FkbWFwPj4KLiA8PFN1cHBvcnQ+PgouIDw8RkFRPj4KLiA8PE1haW50ZW5hbmNlPj4=|
diff --git a/jamal-snippet/README.adoc b/jamal-snippet/README.adoc
index b88410ec8..e73e9fa34 100644
--- a/jamal-snippet/README.adoc
+++ b/jamal-snippet/README.adoc
@@ -3339,7 +3339,7 @@ will result
 - ShellVar.java: 3,837 bytes
 - Locate.java: 5,965 bytes
 - XmlDocument.java: 5,671 bytes
-- References.java: 7,745 bytes
+- References.java: 9,022 bytes
 - Java.java: 11,623 bytes
 - ReplaceLines.java: 3,479 bytes
 - SkipLines.java: 2,801 bytes
@@ -3600,7 +3600,7 @@ will result in the output
 
 [source]
 ----
-2023-12-05 15:42:11
+2023-12-05 17:02:16
 ----
 
 
diff --git a/jamal-snippet/sample.jrf b/jamal-snippet/sample.jrf
index b9e2cb5cf..d8572f9b7 100644
--- a/jamal-snippet/sample.jrf
+++ b/jamal-snippet/sample.jrf
@@ -1 +1,4 @@
+# This is a Jama reference file containing serialized base64 encoded macros
+# id|openStr|closeStr|verbatim|tailParameter|pure|content|parameters
+# a
 YQ==|ew==|fQ==|0|0|0|VGhlIHZhbHVlIG9mIGE=|
diff --git a/jamal-snippet/src/main/java/javax0/jamal/snippet/References.java b/jamal-snippet/src/main/java/javax0/jamal/snippet/References.java
index 2f118f563..fb0e11e32 100644
--- a/jamal-snippet/src/main/java/javax0/jamal/snippet/References.java
+++ b/jamal-snippet/src/main/java/javax0/jamal/snippet/References.java
@@ -57,7 +57,7 @@ public String evaluate(final Input in, final Processor processor) throws BadSynt
             closer.addSerializedLines(macrosSerialized);
             final var deserializer = getDeserializerMacroObject(processor);
             for (var macroSerialized : macrosSerialized) {
-                if (macroSerialized.length() > 0) {// empty lines are ignored
+                if (notComment(macroSerialized)) {// empty and comment lines are ignored
                     final var macro = deserializer.deserialize(macroSerialized);
                     processor.defineGlobal(macro);
                 }
@@ -70,6 +70,10 @@ public String evaluate(final Input in, final Processor processor) throws BadSynt
         return "";
     }
 
+    private static boolean notComment(String macroSerialized) {
+        return !macroSerialized.isEmpty() && macroSerialized.charAt(0) != '#';
+    }
+
     /**
      * Create a macro object that will be used to deserialize the strings into macro objects.
      * This deserializer macro object will (should) NOT be registered in the macro registry, hence the name is not
@@ -140,7 +144,8 @@ void addSerializedLines(final List<String> serialized) {
 
         @Override
         public void close() throws Exception {
-            final var sb = new StringBuilder();
+            final var sb = new StringBuilder("# This is a Jama reference file containing serialized base64 encoded macros\n"
+                    + "# id|openStr|closeStr|verbatim|tailParameter|pure|content|parameters\n");
             final var missing = new ArrayList<String>();
             for (final var ref : holder.getObject()) {
                 final var serialized = processor.getRegister()
@@ -149,32 +154,50 @@ public void close() throws Exception {
                         .map(macro -> (UserDefinedMacro) macro)
                         .map(Serializing::serialize);
                 if (serialized.isPresent()) {
+                    sb.append("# ").append(ref).append('\n');
                     sb.append(serialized.get()).append('\n');
                 } else {
                     missing.add(ref);
                 }
             }
-            Files.writeString(Paths.get(file.toURI()), sb.toString(), StandardCharsets.UTF_8, StandardOpenOption.WRITE, StandardOpenOption.TRUNCATE_EXISTING, StandardOpenOption.CREATE);
-            BadSyntax.when(missing.size() > 0, "The following references are missing: " + String.join(", ", missing));
+            Files.writeString(Paths.get(file.toURI()), sb.toString(), StandardCharsets.UTF_8,
+                    StandardOpenOption.WRITE, StandardOpenOption.TRUNCATE_EXISTING, StandardOpenOption.CREATE);
+            BadSyntax.when(!missing.isEmpty(), "The following references are missing: " + String.join(", ", missing));
             if (macrosSerialized != null) {
                 final var diff = checkIdempotency(macrosSerialized, sb.toString().split("\n"));
-                IdempotencyFailed.when(diff.length() > 0, "The following references are not idempotent: " + diff);
+                IdempotencyFailed.when(!diff.isEmpty(), "The following references are not idempotent: " + diff);
             }
         }
 
+        /**
+         * Check if the two sets of serialized macros are idempotent. The first set is the old set, and the second set is
+         * the new set. The method returns a string that contains the list of the macros that are new, deleted or
+         * changed.
+         * <p>
+         * The serialization set may contain empty and comment lines. These are ignored.
+         *
+         * @param oldSet the old set of serialized macros as string
+         * @param newSet the new set of serialized macros as string
+         * @return the list of the macros that are new, deleted or changed, essentially a difference
+         * @throws BadSyntax if the deserialization of the serialized macro fails
+         */
         private String checkIdempotency(String[] oldSet, String[] newSet) throws BadSyntax {
             final var diffMap = new HashMap<String, String[]>();
             final var deserializer = getDeserializerMacroObject(processor);
             for (final var line : oldSet) {
-                final var id = deserializer.deserialize(line).getId();
-                diffMap.put(id, new String[]{line, null});
+                if (notComment(line)) {
+                    final var id = deserializer.deserialize(line).getId();
+                    diffMap.put(id, new String[]{line, null});
+                }
             }
             for (final var line : newSet) {
-                final var id = deserializer.deserialize(line).getId();
-                if (diffMap.containsKey(id)) {
-                    diffMap.get(id)[1] = line;
-                } else {
-                    diffMap.put(id, new String[]{null, line});
+                if (notComment(line)) {
+                    final var id = deserializer.deserialize(line).getId();
+                    if (diffMap.containsKey(id)) {
+                        diffMap.get(id)[1] = line;
+                    } else {
+                        diffMap.put(id, new String[]{null, line});
+                    }
                 }
             }
             final var err = new StringBuilder();
diff --git a/jamal-word/src/test/resources/demoConverted.docx b/jamal-word/src/test/resources/demoConverted.docx
index ba10e2ebceedb94416489a21da081eb9b8008f2c..48f7cee4ad3fb98e9f3b079a77bf08a5ef68cc13 100644
GIT binary patch
delta 169
zcmeyF{4<#+z?+#xgn@&DgCV+OBhNlY#*WRW8C5~lN2X2?Rn0O5NKF=CI|bz2W;5po
zQo=&!ASrL*86fJ3$Z}>N)guAc?JaeZ7swOUxXlLC_EFCPNE+!|0Lg59TOheo-wsH=
j&<BZY8i3dt2A)82lYu>u`~)VA3_;?BhBiQQouM}XVEQ=C

delta 169
zcmeyF{4<#+z?+#xgn@&DgCV+hBhNlY#@fxN8C5~lN2X2?Rn0O5NKF=CI|bz2W;5po
zQo=&!ASrL*86fJ3$Z}>N)guAc?JaeZ7swOUxXlLC_EFCPNE+!|0Lg59TOheo-wsH=
j&<BZY8i3dt2A)82lYu>u`~)VA3_;?BhBiQQouM}X5t28>

diff --git a/jamal-word/src/test/resources/includetestConverted.docx b/jamal-word/src/test/resources/includetestConverted.docx
index b2fc6c13ee88b48c480667a6495d502bea85f95a..70a82cc3532f110079fea887b81a74ca4996f486 100644
GIT binary patch
delta 176
zcmeC_W9sQ+;tB9(W)WfF;NW10?%2pPi;=No^KwRM5OtX82Z-9kQVgOD*kU+=R4>05
zh<8IkjR{Eo7rGk4*fH6FO?>m4^bc%6k-K?&c!1Qb>YE^5NmCb4_2mD}4nWeO#R5oH
tw%7v6?Jagd@*9{mZS@4Q>s#%C<o;G?Aj#YYl67jc0g1Oc0m(ycUI5;pK>q*$

delta 176
zcmeC_W9sQ+;tB9(W)WfF;NW10uHDEpi;=N*^KwRM5OtX82Z-9kQVgOD*kU+=R4>05
zh<8IkjR{Eo7rGk4SUcH(O?>m4^bc%6k-K?&c!1Qb>YE^5NmCb4_2mD}4nWeO#R5oH
tw%7v6?Jagd@*9{mZS@4Q>s#%C<o;G?Aj#YYl67jc0g1Oc0m(ycUI2}CKlcCt

diff --git a/jamal-word/src/test/resources/pictureConverted.docx b/jamal-word/src/test/resources/pictureConverted.docx
index bc211655dfcdfa55a44366e874493c4546fff1c0..a6cfb1e0a17fce331bced386ee1473061589c2b8 100644
GIT binary patch
delta 237
zcmaF6it+6#MxFp~W)=|!4h{~6=#Gs%7a18lHs50m1W^Xe|G^Y%8HifWmJFh}IoddY
z)Fgp05bvenG$tU`AR;UQq^9V&vjV9*hAeDA>Y@1q9w2qd<tB(X$J-dB;ernjh`Q@r
z3!<X^yMWZ>X8{gCQa#WDNG1f@0?B!Sc0lrOAV^#;2*i#J@&uC0gY1Fi^B`v+sT~Yr
iX9t61R|VUE#DkrHq*jP8kgN!a0FoC&0)eD*s22bp&r<LJ

delta 237
zcmaF6it+6#MxFp~W)=|!4h{~6=-Q1u7a19AH{W9n1W^Xe|G^Y%8HifWmJFh}IoddY
z)Fgp05bvenG$tU`AR;UQq^9V&vjV9*hAeDA>Y@1q9w2qd<tB(X$J-dB;ernjh`Q@r
z3!<X^yMWZ>X8{gCQa#WDNG1f@0?B!Sc0lrOAV^#;2*i#J@&uC0gY1Fi^B`v+sT~Yr
iX9t61R|VUE#DkrHq*jP8kgN!a0FoC&0)eD*s22c$NKtwK

diff --git a/jamal-word/src/test/resources/sampleConverted.docx b/jamal-word/src/test/resources/sampleConverted.docx
index d986cd131e77cc5f201645ea94996c9adaf9d803..8c81f34a0aaec7941f54f363114449fc4e40c18c 100644
GIT binary patch
delta 2269
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

delta 2358
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