minimal order in dumped config, for better readability (#44)

eole/config/__init__.py

@@ -1,4 +1,5 @@
 import os
+from collections import OrderedDict
 from pydantic import Field
 from eole.config.config import Config
 from eole.utils.logging import logger
@@ -9,6 +10,47 @@
     os.environ["EOLE_MODEL_DIR"] = os.getcwd()
 
 
+def calculate_depth(value, current_depth=0):
+    if isinstance(value, (dict, Config)):
+        if isinstance(value, Config):
+            value = value.__dict__
+        return (
+            max(calculate_depth(v, current_depth + 1) for v in value.values())
+            if value
+            else current_depth
+        )
+    return current_depth
+
+
+def reorder_fields(fields):
+    """
+    Put non nested fields before nested ones in config json dump,
+    for better readability.
+    """
+    ordered_fields = OrderedDict()
+    non_nested_fields = []
+    nested_fields = []
+
+    for field, value in fields.items():
+        if isinstance(value, dict):
+            nested_fields.append((field, value))
+        else:
+            non_nested_fields.append((field, value))
+
+    # Add non-nested fields first
+    for field, value in non_nested_fields:
+        ordered_fields[field] = value
+
+    # Calculate depths and sort nested fields
+    nested_fields.sort(key=lambda x: calculate_depth(x[1]))
+
+    # Add nested fields
+    for field, value in nested_fields:
+        ordered_fields[field] = reorder_fields(value)
+
+    return ordered_fields
+
+
 def recursive_model_fields_set(model):
     fields = {}
     if isinstance(model, dict):
@@ -31,10 +73,12 @@ def recursive_model_fields_set(model):
         else:
             field_value = getattr(model, field, None)
         if isinstance(field_value, Config) or isinstance(field_value, dict):
-            fields[field] = recursive_model_fields_set(field_value)
+            _fields = recursive_model_fields_set(field_value)
+            if _fields != {}:
+                fields[field] = _fields
         else:
             fields[field] = field_value
-    return fields
+    return reorder_fields(fields)
 
 
 def recursive_update_dict(_dict, new_dict, defaults):