doc: add doctest for ConfigNamelist

also add the last 2 missing `kw_only=True` to @DataClass

src/sirocco/core/_tasks/shell_task.py

@@ -6,6 +6,6 @@
 from sirocco.parsing._yaml_data_models import ConfigShellTaskSpecs
 
 
-@dataclass
+@dataclass(kw_only=True)
 class ShellTask(ConfigShellTaskSpecs, Task):
     pass

src/sirocco/parsing/_yaml_data_models.py

@@ -417,14 +417,13 @@ class ConfigNamelist:
     - specs is a dictionnary containing the specifications of parameters
       to change in the original namelist file
 
-    For example:
-
-    ... python
+    Example:
 
-        ConfigNamelist(path="/some/path/to/icon.nml",
-                       specs={"first_nml_block":{"first_param": first_value,
-                                                 "second_param": second_value},
-                              "second_nml_block":{"third_param": third_value}})
+        >>> path="/some/path/to/icon.nml"
+        >>> specs = {"first_nml_block": {"first_param": "a string value",
+        ...                              "second_param": 0},
+        ...          "second_nml_block": {"third_param": False}}
+        >>> config_nml = ConfigNamelist(path=path, specs=specs)
     """
 
     path: Path

src/sirocco/pretty_print.py

@@ -8,7 +8,7 @@
 from sirocco import core
 
 
-@dataclasses.dataclass
+@dataclasses.dataclass(kw_only=True)
 class PrettyPrinter:
     """
     Pretty print unrolled workflow graph elements in a reproducible and human readable format.