Add Icon Browser utility for browsing icon collections

- New guidata.widgets.iconbrowser module with IconBrowserWindow widget
- Command-line tool: giconbrowser [folder]
- Split-pane UI: tree view (folder hierarchy) + icon grid display
- Single-click icons to open file location in system explorer
- Adjustable thumbnail sizes (16-256px), multiple format support
- Dynamic folder icons (open/closed), responsive layout
- Includes About dialog and pytest-compatible test suite

Author: PierreRaybaut

.vscode/tasks.json

@@ -388,5 +388,30 @@
                 "🧹 Clean Up",
             ],
         },
+        {
+            "label": "🖼️ Icon Browser",
+            "command": "${command:python.interpreterPath}",
+            "args": [
+                "-m",
+                "guidata.widgets.iconbrowser",
+                "${workspaceFolder}/guidata/data/icons",
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}",
+            },
+            "group": {
+                "kind": "build",
+                "isDefault": true,
+            },
+            "presentation": {
+                "clear": true,
+                "echo": true,
+                "focus": false,
+                "panel": "dedicated",
+                "reveal": "always",
+                "showReuseMessage": true,
+            },
+            "type": "shell",
+        },
     ],
 }

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog #
 
+## Version 3.14.0 ##
+
+✨ New features:
+
+* **Icon Browser utility**: Added a new GUI tool for browsing and exploring icon collections
+  * New `guidata.widgets.iconbrowser` module with `IconBrowserWindow` widget
+  * Command-line tool: `giconbrowser [folder]` or `python -m guidata.widgets.iconbrowser [folder]`
+  * Features a split-pane interface with tree view for folder navigation and icon grid display
+  * Tree view shows folder hierarchy with open/closed folder icons and file counts
+  * Single-click on icons opens file location in system file explorer (Windows/macOS/Linux)
+  * Adjustable thumbnail sizes (16-256 pixels) via toolbar
+  * Supports PNG, SVG, ICO, JPG, GIF, and BMP formats
+  * Responsive grid layout adapts to window resizing
+  * Useful for developers managing icons for their applications and libraries
+
 ## Version 3.13.3 ##
 
 🛠️ Bug fixes:

guidata/tests/widgets/test_iconbrowser.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+#
+# Licensed under the terms of the BSD 3-Clause
+# (see guidata/LICENSE for details)
+
+"""
+Icon Browser Test
+==================
+
+Test for the icon browser widget.
+"""
+
+# guitest: show
+
+from __future__ import annotations
+
+import os.path as osp
+
+from guidata.env import execenv
+from guidata.qthelpers import qt_app_context
+from guidata.widgets.iconbrowser import IconBrowserWindow
+
+
+def get_guidata_icons_path() -> str:
+    """Get the path to guidata's icon directory.
+
+    Returns:
+        Path to the icons directory
+    """
+    import guidata
+
+    guidata_path = osp.dirname(guidata.__file__)
+    icons_path = osp.join(guidata_path, "data", "icons")
+    return icons_path
+
+
+def test_iconbrowser():
+    """Test the icon browser widget."""
+    with qt_app_context(exec_loop=not execenv.unattended):
+        icons_dir = get_guidata_icons_path()
+        window = IconBrowserWindow(init_folder=icons_dir)
+        window.resize(900, 600)
+        window.show()
+        if not execenv.unattended:
+            window.activateWindow()
+
+
+if __name__ == "__main__":
+    test_iconbrowser()

guidata/widgets/__init__.py

@@ -29,4 +29,11 @@
 
 .. autoclass:: guidata.widgets.codeeditor.CodeEditor
 
+Utilities
+^^^^^^^^^
+
+.. autoclass:: guidata.widgets.iconbrowser.IconBrowserWindow
+
+.. autofunction:: guidata.widgets.iconbrowser.main
+
 """

guidata/widgets/arrayeditor/datamodel.py

@@ -491,7 +491,7 @@ def data(self, index: QModelIndex, role=Qt.ItemDataRole.DisplayRole) -> Any:
                 return ""
             try:
                 return self._format % value
-            except TypeError:
+            except (TypeError, ValueError, ZeroDivisionError):
                 self.readonly = True
                 return repr(value)
         elif role == Qt.ItemDataRole.TextAlignmentRole:
@@ -508,7 +508,7 @@ def data(self, index: QModelIndex, role=Qt.ItemDataRole.DisplayRole) -> Any:
                 hue = float(np.abs(hue))
                 color = QColor.fromHsvF(hue, self.sat, self.val, self.alp)
                 return color
-            except TypeError:
+            except (TypeError, ValueError, ZeroDivisionError):
                 return None
         elif role == Qt.ItemDataRole.FontRole:
             return get_font(CONF, "arrayeditor", "font")