Enhance DataSet representation: add detailed __repr__ method and include attribute names in HTML output for improved usability in interactive sessions

Author: PierreRaybaut

doc/release_notes/release_3.14.md

@@ -9,6 +9,12 @@
   * New `_repr_html_()` method on `LabeledEnum` class for formatted display of enum values with labels
   * CSS styling with `.guidata-dataset-table` class for consistent visual appearance
   * Automatically called by Jupyter when displaying objects as cell output
+  * HTML representation now includes attribute names in a third column for easier programmatic access
+
+* **Interactive Python experience**: Improved DataSet representation in Python interpreters
+  * New `__repr__()` method on `DataSet` class shows attribute names instead of labels
+  * Makes it easy to discover attribute names when working interactively in a Python shell or notebook
+  * `print(dataset)` still shows user-friendly labels, while `repr(dataset)` or just typing the variable shows attribute names
 
 * **Secure build utility**: Added `--prebuild` option to run commands before package build
   * New `--prebuild` command-line argument for `guidata.utils.securebuild`

guidata/dataset/datatypes.py

@@ -1606,6 +1606,14 @@ def __str__(self) -> str:
         """Return string representation of the data set"""
         return self.to_string(debug=False)
 
+    def __repr__(self) -> str:
+        """Return detailed representation showing attribute names.
+
+        This is useful in interactive Python sessions to discover
+        the attribute names needed to access/modify dataset items.
+        """
+        return self.to_string(debug=True)
+
     def check(self) -> list[str]:
         """Check the dataset item values
 
@@ -1858,12 +1866,19 @@ def to_html(self) -> str:
             # Get string representation of value
             value_str = item.get_string_value(self)
 
+            # Get attribute name for programmatic access
+            attr_name = item._name
+
             html += (
                 f'<tr><td style="text-align: right; vertical-align: top;">{label}:</td>'
             )
             html += (
-                f'<td style="text-align: left; padding-left: 10px;">'
-                f"{value_str}</td></tr>"
+                f'<td style="text-align: left; padding-left: 10px;">{value_str}</td>'
+            )
+            html += (
+                f'<td style="text-align: left; padding-left: 15px; '
+                f'color: #888; font-family: monospace; font-size: 0.9em;">'
+                f"({attr_name})</td></tr>"
             )
 
         html += "</table>"