feat: change path in description

src/rougail/output_doc/annotator.py

@@ -20,6 +20,7 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 """
 
 from typing import Union
+from re import compile
 
 from rougail.utils import undefined, PROPERTY_ATTRIBUTE
 from rougail.annotator.variable import Walk
@@ -55,6 +56,7 @@ class Annotator(Walk):
         self.change_default_value = self.objectspace.rougailconfig[
             "doc.change_default_value"
         ]
+        self.regexp_description_get_paths = None
         self.populate_family()
         self.populate_variable()
 
@@ -233,7 +235,30 @@ class Annotator(Walk):
         if not isinstance(values, Calculation):
             return {"value": values}
         if values.description:
-            return {"description": values.description}
+            if not self.regexp_description_get_paths:
+                self.regexp_description_get_paths = compile('"(.*?)"')
+            index = 0
+            description = values.description
+            variables = []
+            for r_path in self.regexp_description_get_paths.findall(description):
+                variable, identifiers = self.objectspace.paths.get_with_dynamic(
+                    r_path,
+                    path,
+                    values.version,
+                    values.namespace,
+                    values.xmlfiles,
+                )
+                if variable:
+                    description = description.replace(f'"{r_path}"', f'"{{{index}}}"')
+                    v = {"path": variable.path, "description": variable.description}
+                    if identifiers:
+                        v["identifiers"] = identifiers
+                    variables.append(v)
+                    index += 1
+            ret = {"description": description}
+            if variables:
+                ret["variables"] = variables
+            return ret
         if isinstance(values, JinjaCalculation):
             if values.description:
                 value = values.description

src/rougail/output_doc/doc.py

@@ -664,7 +664,7 @@ class RougailOutputDoc(Examples, Changelog):
             values = calculation["description"]
 #            if not values.endswith("."):
 #                values += "."
-            return values
+            return calculation
         if "type" not in calculation:
             return calculation["value"]
         if calculation["type"] == "jinja":

src/rougail/output_doc/utils.py

@@ -766,7 +766,7 @@ class CommonFormatter:
                 if p not in new:
                     properties.append(self.prop(p, italic=False, delete=True, underline=False))
                 if annotation is not None:
-                    local_calculated_properties[p] = [self.delete(annotation)]
+                    local_calculated_properties[p] = [{"annotation": annotation, "delete": True}]
 
         else:
             previous = new = []
@@ -788,9 +788,12 @@ class CommonFormatter:
                         prop_name not in previous
                         or new[prop_name] != previous[prop_name]
                     ):
-                        prop_annotation = self.underline(prop_annotation)
+                        underline_ = True
+#                        prop_annotation = self.underline(prop_annotation)
+                    else:
+                        underline_ = False
                     local_calculated_properties.setdefault(prop["name"], []).append(
-                        prop_annotation
+                            {"annotation": prop_annotation, "underline": underline_}
                     )
                 else:
                     italic = False
@@ -800,10 +803,19 @@ class CommonFormatter:
                 calculated_property_name,
                 calculated_property,
             ) in local_calculated_properties.items():
+#                calculated_property = calculated_property_data["annotation"]
+                data = []
+                for calc in calculated_property:
+                    annotation = self.message_to_string(calc["annotation"], None)[1]
+                    if calc.get("underline", False):
+                        annotation = self.underline(annotation)
+                    if calc.get("delete", False):
+                        annotation = self.delete(annotation)
+                    data.append(annotation)
                 if len(calculated_property) > 1:
-                    calculated_property = self.join(calculated_property)
+                    calculated_property = self.join(data)
                 else:
-                    calculated_property = calculated_property[0]
+                    calculated_property = data[0]
                 calculated_properties.append(
                     self.section(
                         calculated_property_name.capitalize(), calculated_property
@@ -862,6 +874,23 @@ class CommonFormatter:
                     msg["identifiers"] = [msg["path"]["identifiers"]]
                 path = self.link_variable(calc_path(msg["path"], self, identifiers), msg["path"]["path"], self.get_description("variable", msg, {}, None), filename=filename)
                 msg = msg["message"].format(path)
+            elif "description" in msg:
+                if "variables" in msg:
+                    paths = []
+                    for variable in msg["variables"]:
+                        filename = None
+                        if self.other_root_filenames:
+                            path = msg["path"]
+                            for root in self.other_root_filenames:
+                                if path == root or path.startswith(f'{root}.'):
+                                    filename = self.other_root_filenames[root]
+                                    break
+                        identifiers = variable.get("identifiers")
+                        path = calc_path(variable, self, identifiers)
+                        paths.append(self.link_variable(path, variable["path"], self.get_description("variable", variable, {}, force_identifiers=identifiers), filename=filename))
+                    msg = msg["description"].format(*paths)
+                else:
+                    msg = msg["description"]
         return ret, msg
 
     def section(

tests/mode_advanced.adoc

@@ -1,16 +1,10 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var1** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | My var1.      
-**var1** +
+| **var2** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | 
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | My var2. +
-My var1.               
-| 
-
-**var2** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
-My var2. +
 **Default**: the value of the variable "var1"               
 |====
 

tests/mode_basic.adoc

@@ -1,17 +1,11 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var2** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | My var2. +
-**var2** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
-My var2. +
 **Default**: depends on an undocumented variable               
-| 
+| **var3** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | My var3. +
-**var3** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | 
-My var3. +
 **Hidden**: var could be hidden               
 |====
 

tests/mode_basic_advanced.adoc

@@ -1,11 +1,8 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var2** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | My var2. +
-**var2** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | 
-My var2. +
 **Default**: depends on an undocumented variable               
 |====
 

tests/mode_basic_standard.adoc

@@ -1,11 +1,8 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var3** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | My var3. +
-**var3** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | 
-My var3. +
 **Hidden**: var could be hidden               
 |====
 

tests/mode_standard.adoc

@@ -1,16 +1,10 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var1** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | My var1.      
-**var1** +
+| **var3** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | 
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | My var3. +
-My var1.               
-| 
-
-**var3** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `advanced` `mandatory` `__hidden__`            | 
-My var3. +
 **Hidden**: var could be hidden               
 |====
 

tests/mode_standard_advanced.adoc

@@ -1,10 +1,7 @@
 [cols="1a,1a"]
 |====
 | Variable   | Description   
-| 
+| **var1** +
-
+`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | My var1.      
-**var1** +
-`https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `basic` `mandatory`            | 
-My var1.               
 |====
 

tests/results/test/00_2default_calculated.json

@@ -33,7 +33,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var1"
+      "values": {
+        "description": "the value of var1"
+      }
     },
     "properties": [
       {

tests/results/test/00_2default_calculated_multi.adoc

@@ -10,6 +10,6 @@
 * maybe               
 | **var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | A second variable. +
-**Default**: the value of _.var1               
+**Default**: the value of "var1"               
 |====
 

tests/results/test/00_2default_calculated_multi.gitlab.md

@@ -1,5 +1,5 @@
-| Variable                                                                                                                                                                | Description                                                        |
+| Variable                                                                                                                                                                | Description                                                                  |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
-| **<a id="var1" name="var1">var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe |
+| **<a id="var1" name="var1">var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe           |
-| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A second variable.<br/>**Default**: the value of _.var1            |
+| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A second variable.<br/>**Default**: the value of "[a first variable](#var1)" |
 

tests/results/test/00_2default_calculated_multi.html

@@ -6,7 +6,7 @@
 <tr><td><b>var1</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A first variable.<br/><b>Default</b>: <ul><li>no</li>
 <li>yes</li>
 <li>maybe</li></ul>                                                           </td></tr>
-<tr><td><b>var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A second variable.<br/><b>Default</b>: the value of _.var1</td></tr>
+<tr><td><b>var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A second variable.<br/><b>Default</b>: the value of "var1"</td></tr>
 </tbody>
 </table>
 

tests/results/test/00_2default_calculated_multi.json

@@ -49,7 +49,15 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of _.var1"
+      "values": {
+        "description": "the value of \"{0}\"",
+        "variables": [
+          {
+            "path": "var1",
+            "description": "a first variable"
+          }
+        ]
+      }
     },
     "properties": [
       {

tests/results/test/00_2default_calculated_multi.md

@@ -1,5 +1,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **<a id="var1" name="var1">var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A second variable.<br/>**Default**: the value of _.var1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | A second variable.<br/>**Default**: the value of "[a first variable](#var1)"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 

tests/results/test/00_2default_calculated_multi.sh

@@ -8,6 +8,6 @@
 │                                       │  • maybe                             │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ var2                                  │ A second variable.                   │
-│  string   standard   mandatory        │ Default: the value of _.var1         │
+│  string   standard   mandatory        │ Default: the value of "var1"         │
 │ unique   multiple                     │                                      │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/00_2default_calculated_variable_description.json

@@ -29,7 +29,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "value of a variable!"
+      "values": {
+        "description": "value of a variable!"
+      }
     },
     "properties": [
       {

tests/results/test/00_2default_calculated_variable_description_multi_line.json

@@ -29,7 +29,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "value\nof\na\nvariable!"
+      "values": {
+        "description": "value\nof\na\nvariable!"
+      }
     },
     "properties": [
       {

tests/results/test/00_6choice_calculation.json

@@ -21,7 +21,9 @@
     ],
     "choices": {
       "name": "Choices",
-      "values": "choices is 0 to 9"
+      "values": {
+        "description": "choices is 0 to 9"
+      }
     },
     "path": "var",
     "names": [

tests/results/test/00_8calculation_information.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "get information test_information"
+      "values": {
+        "description": "get information test_information"
+      }
     },
     "properties": [
       {

tests/results/test/00_9default_calculation.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "concat all parameters"
+      "values": {
+        "description": "concat all parameters"
+      }
     },
     "properties": [
       {

tests/results/test/00_9default_calculation_information.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "returns the information"
+      "values": {
+        "description": "returns the information"
+      }
     },
     "properties": [
       {

tests/results/test/00_9default_calculation_param_optional.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "returns a value"
+      "values": {
+        "description": "returns a value"
+      }
     },
     "properties": [
       {

tests/results/test/00_9default_integer.json

@@ -21,7 +21,9 @@
     ],
     "choices": {
       "name": "Choices",
-      "values": "choice for 0 to 9"
+      "values": {
+        "description": "choice for 0 to 9"
+      }
     },
     "path": "var",
     "names": [

tests/results/test/00_9default_number.json

@@ -21,7 +21,9 @@
     ],
     "choices": {
       "name": "Choices",
-      "values": "choice for 0 to 9"
+      "values": {
+        "description": "choice for 0 to 9"
+      }
     },
     "path": "var",
     "names": [

tests/results/test/01_6string_multi_length.json

@@ -33,7 +33,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "needs exactly 3 values"
+      "values": {
+        "description": "needs exactly 3 values"
+      }
     },
     "path": "var1",
     "names": [
@@ -83,8 +85,12 @@
     "validators": {
       "name": "Validators",
       "values": [
-        "needs a minimum of 1 values",
+        {
-        "needs a maximum of 4 values"
+          "description": "needs a minimum of 1 values"
+        },
+        {
+          "description": "needs a maximum of 4 values"
+        }
       ]
     },
     "path": "var2",

tests/results/test/01_8calculation_information_multi.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "get information test_information"
+      "values": {
+        "description": "get information test_information"
+      }
     },
     "properties": [
       {

tests/results/test/04_1auto_save_and_calculated_hidden.json

@@ -33,7 +33,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value is always yes"
+      "values": {
+        "description": "the value is always yes"
+      }
     },
     "properties": [
       {
@@ -51,7 +53,9 @@
       {
         "type": "property",
         "name": "hidden",
-        "annotation": "only if the variable var1 has value \"yes\""
+        "annotation": {
+          "description": "only if the variable var1 has value \"yes\""
+        }
       },
       {
         "type": "property",

tests/results/test/04_5disabled_calculation_boolean.json

@@ -47,7 +47,9 @@
       {
         "type": "property",
         "name": "disabled",
-        "annotation": "if condition is egal to \"yes\""
+        "annotation": {
+          "description": "if condition is egal to \"yes\""
+        }
       }
     ],
     "path": "variable1",
@@ -78,7 +80,9 @@
       {
         "type": "property",
         "name": "disabled",
-        "annotation": "if condition is not egal to \"yes\""
+        "annotation": {
+          "description": "if condition is not egal to \"yes\""
+        }
       }
     ],
     "path": "variable2",

tests/results/test/04_5disabled_calculation_optional.json

@@ -43,7 +43,9 @@
       {
         "type": "property",
         "name": "hidden",
-        "annotation": "calculation from an unknown variable"
+        "annotation": {
+          "description": "calculation from an unknown variable"
+        }
       }
     ],
     "path": "var1",
@@ -70,7 +72,9 @@
       {
         "type": "property",
         "name": "hidden",
-        "annotation": "calculation from an condition variable"
+        "annotation": {
+          "description": "calculation from an condition variable"
+        }
       }
     ],
     "path": "var2",

tests/results/test/04_5validators.json

@@ -17,7 +17,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "the max value is 100"
+      "values": {
+        "description": "the max value is 100"
+      }
     },
     "path": "int",
     "names": [

tests/results/test/04_5validators_differ.json

@@ -21,7 +21,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "var1 must be different than var2"
+      "values": {
+        "description": "var1 must be different than var2"
+      }
     },
     "path": "var1",
     "names": [

tests/results/test/04_5validators_multi.json

@@ -32,7 +32,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "check length is less than 10"
+      "values": {
+        "description": "check length is less than 10"
+      }
     },
     "path": "var1",
     "names": [

tests/results/test/04_5validators_multi2.json

@@ -32,7 +32,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "check length is less than 3"
+      "values": {
+        "description": "check length is less than 3"
+      }
     },
     "path": "var1",
     "names": [

tests/results/test/04_5validators_multi3.json

@@ -33,7 +33,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "value must be equal to index"
+      "values": {
+        "description": "value must be equal to index"
+      }
     },
     "path": "var1",
     "names": [

tests/results/test/04_5validators_warnings.json

@@ -21,7 +21,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "the max value is 100"
+      "values": {
+        "description": "the max value is 100"
+      }
     },
     "path": "int",
     "names": [

tests/results/test/16_5redefine_calculation.json

@@ -3,7 +3,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "returns yes"
+      "values": {
+        "description": "returns yes"
+      }
     },
     "properties": [
       {

tests/results/test/20_0validators_differ_redefine.json

@@ -81,7 +81,9 @@
     ],
     "validators": {
       "name": "Validator",
-      "values": "var3 must be different than var2"
+      "values": {
+        "description": "var3 must be different than var2"
+      }
     },
     "path": "var3",
     "names": [

tests/results/test/24_0family_hidden_condition_sub_family.json

@@ -45,7 +45,9 @@
         {
           "type": "property",
           "name": "hidden",
-          "annotation": "if condition is yes"
+          "annotation": {
+            "description": "if condition is yes"
+          }
         }
       ]
     },

tests/results/test/24_0family_hidden_param_condition_sub_family.json

@@ -45,7 +45,9 @@
         {
           "type": "property",
           "name": "hidden",
-          "annotation": "if condition is yes"
+          "annotation": {
+            "description": "if condition is yes"
+          }
         }
       ]
     },

tests/results/test/24_0family_mandatory_condition.json

@@ -43,7 +43,9 @@
       {
         "type": "property",
         "name": "mandatory",
-        "annotation": "only if rougail.condition has the value \"yes\""
+        "annotation": {
+          "description": "only if rougail.condition has the value \"yes\""
+        }
       }
     ],
     "path": "var",

tests/results/test/24_7validators_variable_optional.json

@@ -34,8 +34,12 @@
         "validators": {
           "name": "Validators",
           "values": [
-            "int and int2 must be different",
+            {
-            "int and int3 must be different"
+              "description": "int and int2 must be different"
+            },
+            {
+              "description": "int and int3 must be different"
+            }
           ]
         },
         "path": "general.int",

tests/results/test/40_0leadership_follower_default_calculation.json

@@ -90,7 +90,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns follower1 value"
+          "values": {
+            "description": "returns follower1 value"
+          }
         },
         "properties": [
           {

tests/results/test/40_8calculation_boolean.json

@@ -33,7 +33,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "a calculation"
+      "values": {
+        "description": "a calculation"
+      }
     },
     "properties": [
       {
@@ -73,7 +75,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "a calculation"
+      "values": {
+        "description": "a calculation"
+      }
     },
     "properties": [
       {

tests/results/test/44_5leadership_leader_hidden_calculation.json

@@ -45,7 +45,9 @@
         {
           "type": "property",
           "name": "hidden",
-          "annotation": "if condition is no"
+          "annotation": {
+            "description": "if condition is no"
+          }
         }
       ],
       "help": [

tests/results/test/44_6leadership_follower_disabled_calculation.json

@@ -102,7 +102,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "leader.follower",

tests/results/test/60_1family_dynamic_jinja.json

@@ -67,7 +67,9 @@
         }
       ],
       "identifier": [
-        "index of suffix value"
+        {
+          "description": "index of suffix value"
+        }
       ],
       "help": [
         "This family builds families dynamically"

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.adoc

@@ -42,6 +42,6 @@ This family builds families dynamically. +
 | Variable   | Description   
 | **var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory`            | A second variable. +
-**Default**: the value of var               
+**Default**: the value of "dyn__val1__.family.var"               
 |====
 

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.gitlab.md

@@ -26,7 +26,7 @@
 
 </details>
 
-| Variable                                                                                                                                            | Description                                          |
+| Variable                                                                                                                                            | Description                                                                                           |
-|-----------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|
+|-----------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
-| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | A second variable.<br/>**Default**: the value of var |
+| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` | A second variable.<br/>**Default**: the value of "[with a variable](#dyn:::identifier:::.family.var)" |
 

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.html

@@ -39,10 +39,10 @@ This family builds families dynamically.
 
 <table>
 <thead>
-<tr><th>Variable                                                                                                                                                             </th><th>Description                                            </th></tr>
+<tr><th>Variable                                                                                                                                                             </th><th>Description                                                                    </th></tr>
 </thead>
 <tbody>
-<tr><td><b>var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark></td><td>A second variable.<br/><b>Default</b>: the value of var</td></tr>
+<tr><td><b>var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark></td><td>A second variable.<br/><b>Default</b>: the value of "dyn<i>val1</i>.family.var"</td></tr>
 </tbody>
 </table>
 

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.json

@@ -149,7 +149,18 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of \"{0}\"",
+        "variables": [
+          {
+            "path": "dyn{{ identifier }}.family.var",
+            "description": "with a variable",
+            "identifiers": [
+              "val1"
+            ]
+          }
+        ]
+      }
     },
     "properties": [
       {

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.md

@@ -26,5 +26,5 @@
 
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | A second variable.<br/>**Default**: the value of var                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| **<a id="var2" name="var2">var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | A second variable.<br/>**Default**: the value of "[with a variable](#dyn:::identifier:::.family.var)"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 

tests/results/test/60_2family_dynamic_jinja_fill_sub_group.sh

@@ -37,5 +37,6 @@
 ┃ Variable                              ┃ Description                          ┃
 ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
 │ var2                                  │ A second variable.                   │
-│  string   standard   mandatory        │ Default: the value of var            │
+│  string   standard   mandatory        │ Default: the value of                │
+│                                       │ "dynval1.family.var"                 │
 └───────────────────────────────────────┴──────────────────────────────────────┘

tests/results/test/60_2family_dynamic_jinja_fill_sub_group_2.json

@@ -153,7 +153,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of var"
+      }
     },
     "properties": [
       {

tests/results/test/60_2family_dynamic_jinja_fill_sub_group_2_empty.json

@@ -149,7 +149,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of var"
+      }
     },
     "properties": [
       {

tests/results/test/60_2family_dynamic_jinja_fill_sub_group_empty.json

@@ -145,7 +145,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of var"
+      }
     },
     "properties": [
       {

tests/results/test/60_2family_dynamic_outside_calc.json

@@ -126,7 +126,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of var"
+      }
     },
     "properties": [
       {

tests/results/test/60_2family_dynamic_outside_calc_empty.json

@@ -122,7 +122,9 @@
     "type": "variable",
     "default": {
       "name": "Default",
-      "values": "the value of var"
+      "values": {
+        "description": "the value of var"
+      }
     },
     "properties": [
       {

tests/results/test/60_5family_dynamic_calc_suffix_param.json

@@ -98,7 +98,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "from suffix"
+          "values": {
+            "description": "from suffix"
+          }
         },
         "properties": [
           {

tests/results/test/60_5family_dynamic_calc_suffix_param_empty.json

@@ -94,7 +94,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "from suffix"
+          "values": {
+            "description": "from suffix"
+          }
         },
         "properties": [
           {

tests/results/test/60_5family_dynamic_hidden_suffix.json

@@ -24,7 +24,9 @@
         {
           "type": "property",
           "name": "hidden",
-          "annotation": "if suffix == 'val2'"
+          "annotation": {
+            "description": "if suffix == 'val2'"
+          }
         }
       ],
       "identifier": [

tests/results/test_namespace/00_2default_calculated.json

@@ -49,7 +49,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of var1"
+          "values": {
+            "description": "the value of var1"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_2default_calculated_multi.adoc

@@ -18,6 +18,6 @@
 * maybe               
 | **rougail.var2** +
 `https://rougail.readthedocs.io/en/latest/variable.html#variables-types[string]` `standard` `mandatory` `unique` `multiple`            | A second variable. +
-**Default**: the value of _.var1               
+**Default**: the value of "rougail.var1"               
 |====
 

tests/results/test_namespace/00_2default_calculated_multi.gitlab.md

@@ -4,10 +4,10 @@
 > **<a id="rougail" name="rougail">rougail</a>**\
 > `standard`
 
-| Variable                                                                                                                                                                                        | Description                                                        |
+| Variable                                                                                                                                                                                        | Description                                                                          |
-|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
+|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
-| **<a id="rougail.var1" name="rougail.var1">rougail.var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe |
+| **<a id="rougail.var1" name="rougail.var1">rougail.var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe                   |
-| **<a id="rougail.var2" name="rougail.var2">rougail.var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A second variable.<br/>**Default**: the value of _.var1            |
+| **<a id="rougail.var2" name="rougail.var2">rougail.var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple` | A second variable.<br/>**Default**: the value of "[a first variable](#rougail.var1)" |
 
 </details>
 

tests/results/test_namespace/00_2default_calculated_multi.html

@@ -6,13 +6,13 @@
 
 <table>
 <thead>
-<tr><th>Variable                                                                                                                                                                                                               </th><th>Description                                               </th></tr>
+<tr><th>Variable                                                                                                                                                                                                               </th><th>Description                                                       </th></tr>
 </thead>
 <tbody>
 <tr><td><b>rougail.var1</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A first variable.<br/><b>Default</b>: <ul><li>no</li>
 <li>yes</li>
-<li>maybe</li></ul>                                                           </td></tr>
+<li>maybe</li></ul>                                                                   </td></tr>
-<tr><td><b>rougail.var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A second variable.<br/><b>Default</b>: the value of _.var1</td></tr>
+<tr><td><b>rougail.var2</b><br/><mark><a href='https://rougail.readthedocs.io/en/latest/variable.html#variables-types'>string</a></mark> <mark>standard</mark> <mark>mandatory</mark> <mark>unique</mark> <mark>multiple</mark></td><td>A second variable.<br/><b>Default</b>: the value of "rougail.var1"</td></tr>
 </tbody>
 </table>
 

tests/results/test_namespace/00_2default_calculated_multi.json

@@ -65,7 +65,15 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of _.var1"
+          "values": {
+            "description": "the value of \"{0}\"",
+            "variables": [
+              {
+                "path": "rougail.var1",
+                "description": "a first variable"
+              }
+            ]
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_2default_calculated_multi.md

@@ -8,5 +8,5 @@
 | Variable                                                                                                                         | Description                                                                                                                      |
 |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | **<a id="rougail.var1" name="rougail.var1">rougail.var1</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A first variable.<br/>**Default**: <br/>• no<br/>• yes<br/>• maybe                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| **<a id="rougail.var2" name="rougail.var2">rougail.var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A second variable.<br/>**Default**: the value of _.var1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| **<a id="rougail.var2" name="rougail.var2">rougail.var2</a>**<br/>[`string`](https://rougail.readthedocs.io/en/latest/variable.html#variables-types) `standard` `mandatory` `unique` `multiple`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | A second variable.<br/>**Default**: the value of "[a first variable](#rougail.var1)"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 

tests/results/test_namespace/00_2default_calculated_multi.sh

@@ -15,7 +15,7 @@
 │                                       │  • maybe                             │
 ├───────────────────────────────────────┼──────────────────────────────────────┤
 │ rougail.var2                          │ A second variable.                   │
-│  string   standard   mandatory        │ Default: the value of _.var1         │
+│  string   standard   mandatory        │ Default: the value of "rougail.var1" │
 │ unique   multiple                     │                                      │
 └───────────────────────────────────────┴──────────────────────────────────────┘
 

tests/results/test_namespace/00_2default_calculated_variable_description.json

@@ -45,7 +45,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "value of a variable!"
+          "values": {
+            "description": "value of a variable!"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_2default_calculated_variable_description_multi_line.json

@@ -45,7 +45,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "value\nof\na\nvariable!"
+          "values": {
+            "description": "value\nof\na\nvariable!"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_6choice_calculation.json

@@ -37,7 +37,9 @@
         ],
         "choices": {
           "name": "Choices",
-          "values": "choices is 0 to 9"
+          "values": {
+            "description": "choices is 0 to 9"
+          }
         },
         "path": "rougail.var",
         "names": [

tests/results/test_namespace/00_8calculation_information.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "get information test_information"
+          "values": {
+            "description": "get information test_information"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_9default_calculation.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "concat all parameters"
+          "values": {
+            "description": "concat all parameters"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_9default_calculation_information.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns the information"
+          "values": {
+            "description": "returns the information"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_9default_calculation_param_optional.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns a value"
+          "values": {
+            "description": "returns a value"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_9default_integer.json

@@ -37,7 +37,9 @@
         ],
         "choices": {
           "name": "Choices",
-          "values": "choice for 0 to 9"
+          "values": {
+            "description": "choice for 0 to 9"
+          }
         },
         "path": "rougail.var",
         "names": [

tests/results/test_namespace/00_9default_number.json

@@ -37,7 +37,9 @@
         ],
         "choices": {
           "name": "Choices",
-          "values": "choice for 0 to 9"
+          "values": {
+            "description": "choice for 0 to 9"
+          }
         },
         "path": "rougail.var",
         "names": [

tests/results/test_namespace/00_9extra.json

@@ -67,7 +67,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "return no"
+          "values": {
+            "description": "return no"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/00_9extra_calculation.json

@@ -103,7 +103,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "copy the value of rougail.variable"
+          "values": {
+            "description": "copy the value of rougail.variable"
+          }
         },
         "properties": [
           {
@@ -133,7 +135,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "copy the value of rougail.variable"
+          "values": {
+            "description": "copy the value of rougail.variable"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/01_6string_multi_length.json

@@ -49,7 +49,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "needs exactly 3 values"
+          "values": {
+            "description": "needs exactly 3 values"
+          }
         },
         "path": "rougail.var1",
         "names": [
@@ -99,8 +101,12 @@
         "validators": {
           "name": "Validators",
           "values": [
-            "needs a minimum of 1 values",
+            {
-            "needs a maximum of 4 values"
+              "description": "needs a minimum of 1 values"
+            },
+            {
+              "description": "needs a maximum of 4 values"
+            }
           ]
         },
         "path": "rougail.var2",

tests/results/test_namespace/01_8calculation_information_multi.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "get information test_information"
+          "values": {
+            "description": "get information test_information"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/04_1auto_save_and_calculated_hidden.json

@@ -49,7 +49,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value is always yes"
+          "values": {
+            "description": "the value is always yes"
+          }
         },
         "properties": [
           {
@@ -67,7 +69,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "only if the variable var1 has value \"yes\""
+            "annotation": {
+              "description": "only if the variable var1 has value \"yes\""
+            }
           },
           {
             "type": "property",

tests/results/test_namespace/04_5disabled_calculation.json

@@ -63,7 +63,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is egal to \"yes\""
+            "annotation": {
+              "description": "if condition is egal to \"yes\""
+            }
           }
         ],
         "path": "rougail.variable1",
@@ -94,7 +96,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is egal to \"yes\""
+            "annotation": {
+              "description": "if condition is egal to \"yes\""
+            }
           }
         ],
         "path": "rougail.variable2",

tests/results/test_namespace/04_5disabled_calculation_boolean.json

@@ -63,7 +63,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is egal to \"yes\""
+            "annotation": {
+              "description": "if condition is egal to \"yes\""
+            }
           }
         ],
         "path": "rougail.variable1",
@@ -94,7 +96,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is not egal to \"yes\""
+            "annotation": {
+              "description": "if condition is not egal to \"yes\""
+            }
           }
         ],
         "path": "rougail.variable2",

tests/results/test_namespace/04_5disabled_calculation_default.json

@@ -49,7 +49,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of condition"
+          "values": {
+            "description": "the value of condition"
+          }
         },
         "properties": [
           {
@@ -67,7 +69,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var1",
@@ -84,7 +88,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of condition"
+          "values": {
+            "description": "the value of condition"
+          }
         },
         "properties": [
           {
@@ -102,7 +108,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var2",

tests/results/test_namespace/04_5disabled_calculation_multi.json

@@ -63,7 +63,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is egal to \"yes\""
+            "annotation": {
+              "description": "if condition is egal to \"yes\""
+            }
           },
           {
             "type": "property",
@@ -104,7 +106,9 @@
           {
             "type": "property",
             "name": "disabled",
-            "annotation": "if condition is egal to \"yes\""
+            "annotation": {
+              "description": "if condition is egal to \"yes\""
+            }
           },
           {
             "type": "property",

tests/results/test_namespace/04_5disabled_calculation_optional.json

@@ -59,7 +59,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "calculation from an unknown variable"
+            "annotation": {
+              "description": "calculation from an unknown variable"
+            }
           }
         ],
         "path": "rougail.var1",
@@ -86,7 +88,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "calculation from an condition variable"
+            "annotation": {
+              "description": "calculation from an condition variable"
+            }
           }
         ],
         "path": "rougail.var2",

tests/results/test_namespace/04_5hidden_calculation.json

@@ -67,7 +67,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var1",
@@ -102,7 +104,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var2",

tests/results/test_namespace/04_5hidden_calculation2.json

@@ -49,7 +49,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of condition"
+          "values": {
+            "description": "the value of condition"
+          }
         },
         "properties": [
           {
@@ -67,7 +69,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var1",
@@ -84,7 +88,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "the value of condition"
+          "values": {
+            "description": "the value of condition"
+          }
         },
         "properties": [
           {
@@ -102,7 +108,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var2",

tests/results/test_namespace/04_5hidden_calculation_default_calculation.json

@@ -49,7 +49,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns the condition value"
+          "values": {
+            "description": "returns the condition value"
+          }
         },
         "properties": [
           {
@@ -67,7 +69,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var1",
@@ -84,7 +88,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns the condition value"
+          "values": {
+            "description": "returns the condition value"
+          }
         },
         "properties": [
           {
@@ -102,7 +108,9 @@
           {
             "type": "property",
             "name": "hidden",
-            "annotation": "if condition is yes"
+            "annotation": {
+              "description": "if condition is yes"
+            }
           }
         ],
         "path": "rougail.var2",

tests/results/test_namespace/04_5validators.json

@@ -33,7 +33,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "the max value is 100"
+          "values": {
+            "description": "the max value is 100"
+          }
         },
         "path": "rougail.int",
         "names": [

tests/results/test_namespace/04_5validators_differ.json

@@ -37,7 +37,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "var1 must be different than var2"
+          "values": {
+            "description": "var1 must be different than var2"
+          }
         },
         "path": "rougail.var1",
         "names": [

tests/results/test_namespace/04_5validators_multi.json

@@ -48,7 +48,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "check length is less than 10"
+          "values": {
+            "description": "check length is less than 10"
+          }
         },
         "path": "rougail.var1",
         "names": [

tests/results/test_namespace/04_5validators_multi2.json

@@ -48,7 +48,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "check length is less than 3"
+          "values": {
+            "description": "check length is less than 3"
+          }
         },
         "path": "rougail.var1",
         "names": [

tests/results/test_namespace/04_5validators_multi3.json

@@ -49,7 +49,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "value must be equal to index"
+          "values": {
+            "description": "value must be equal to index"
+          }
         },
         "path": "rougail.var1",
         "names": [

tests/results/test_namespace/04_5validators_warnings.json

@@ -37,7 +37,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "the max value is 100"
+          "values": {
+            "description": "the max value is 100"
+          }
         },
         "path": "rougail.int",
         "names": [

tests/results/test_namespace/16_5redefine_calculation.json

@@ -19,7 +19,9 @@
         "type": "variable",
         "default": {
           "name": "Default",
-          "values": "returns yes"
+          "values": {
+            "description": "returns yes"
+          }
         },
         "properties": [
           {

tests/results/test_namespace/20_0validators_differ_redefine.json

@@ -97,7 +97,9 @@
         ],
         "validators": {
           "name": "Validator",
-          "values": "var3 must be different than var2"
+          "values": {
+            "description": "var3 must be different than var2"
+          }
         },
         "path": "rougail.var3",
         "names": [

tests/results/test_namespace/24_0family_hidden_condition.json

@@ -61,7 +61,9 @@
             {
               "type": "property",
               "name": "hidden",
-              "annotation": "if condition is yes"
+              "annotation": {
+                "description": "if condition is yes"
+              }
             }
           ]
         },

tests/results/test_namespace/24_0family_hidden_condition_boolean.json

@@ -61,7 +61,9 @@
             {
               "type": "property",
               "name": "hidden",
-              "annotation": "if not condition"
+              "annotation": {
+                "description": "if not condition"
+              }
             }
           ]
         },