Add support for v0.20 plugins detection and warning in DataLab v1.0

Author: PierreRaybaut

datalab/config.py

@@ -121,6 +121,7 @@ class MainSection(conf.Section, metaclass=conf.SectionMeta):
     plugins_enabled = conf.Option()
     plugins_path = conf.Option()
     tour_enabled = conf.Option()
+    v020_plugins_warning_ignore = conf.Option()  # True: do not warn, False: warn
 
 
 class ConsoleSection(conf.Section, metaclass=conf.SectionMeta):
@@ -341,6 +342,7 @@ def initialize():
     Conf.main.plugins_enabled.get(True)
     Conf.main.plugins_path.get(Conf.get_path("plugins"))
     Conf.main.tour_enabled.get(True)
+    Conf.main.v020_plugins_warning_ignore.get(False)
     # Console section
     Conf.console.console_enabled.get(True)
     Conf.console.show_console_on_error.get(False)

datalab/gui/main.py

@@ -63,7 +63,7 @@
 from datalab.gui.h5io import H5InputOutput
 from datalab.gui.panel import base, image, macro, signal
 from datalab.gui.settings import edit_settings
-from datalab.plugins import PluginRegistry, discover_plugins
+from datalab.plugins import PluginRegistry, discover_plugins, discover_v020_plugins
 from datalab.utils import dephash
 from datalab.utils import qthelpers as qth
 from datalab.utils.qthelpers import (
@@ -641,10 +641,64 @@ def check_for_previous_crash(self) -> None:  # pragma: no cover
             if choice == QW.QMessageBox.StandardButton.Yes:
                 self.__show_logviewer()
 
+    def check_for_v020_plugins(self) -> None:  # pragma: no cover
+        """Check for v0.20 plugins and warn user if any are found"""
+        if Conf.main.v020_plugins_warning_ignore.get(False):
+            return
+
+        v020_plugins = discover_v020_plugins()
+        if execenv.unattended or not v020_plugins:
+            return
+
+        # Build plugin list with clickable directory paths
+        plugin_items = []
+        for name, directory_path in v020_plugins:
+            if directory_path:
+                # Create clickable file:// link to directory
+                dir_url = QC.QUrl.fromLocalFile(directory_path).toString()
+                plugin_items.append(
+                    f'<li>{name} (<a href="{dir_url}">{directory_path}</a>)</li>'
+                )
+            else:
+                plugin_items.append(f"<li>{name}</li>")
+        plugin_list = "<ul>" + "".join(plugin_items) + "</ul>"
+
+        txtlist = [
+            "<b>" + _("DataLab v0.20 plugins detected") + "</b>",
+            "",
+            _("The following plugins are using the old DataLab v0.20 format:"),
+            plugin_list,
+            _(
+                "These plugins will <b>not be loaded</b> in DataLab v1.0 because "
+                "they are not compatible with the new architecture."
+            ),
+            "",
+            _(
+                "To use these plugins with DataLab v1.0, you need to update them. "
+                "Please refer to the migration guide on the DataLab website "
+            )
+            + '(<a href="https://datalab-platform.com/en/features/advanced/'
+            'migration_v020_to_v100.html">Migration guide</a>)'
+            + _(" or in the PDF documentation."),
+            "",
+            _("Choosing to ignore this message will prevent it from appearing again."),
+        ]
+
+        answer = QW.QMessageBox.question(
+            self,
+            APP_NAME,
+            "<br>".join(txtlist),
+            QW.QMessageBox.Ok | QW.QMessageBox.Ignore,
+        )
+
+        if answer == QW.QMessageBox.Ignore:
+            Conf.main.v020_plugins_warning_ignore.set(True)
+
     def execute_post_show_actions(self) -> None:
         """Execute post-show actions"""
         self.check_stable_release()
         self.check_for_previous_crash()
+        self.check_for_v020_plugins()
         tour = Conf.main.tour_enabled.get()
         if tour:
             Conf.main.tour_enabled.set(False)

datalab/gui/settings.py

@@ -69,6 +69,14 @@ class MainSettings(gds.DataSet):
             "as well as in your PYTHONPATH."
         ),
     )
+    v020_plugins_warning_ignore = gds.BoolItem(
+        _("Ignore compatibility issues warning"),
+        _("DataLab v0.20 plugins"),
+        help=_(
+            "If enabled, DataLab will not warn you about v0.20 plugins that are "
+            "no longer compatible with v1.0."
+        ),
+    )
     _g0 = gds.EndGroup("")
 
 
@@ -137,17 +145,17 @@ class ProcSettings(gds.DataSet):
         % ("→", "→"),
     )
     use_signal_bounds = gds.BoolItem(
-        "",
-        _("Use signal bounds for new signals"),
+        _("Use current signal bounds"),
+        _("New signals"),
         help=_(
             "If enabled, when creating a new signal, the xmin and xmax values will be "
             "initialized from the current signal's bounds.<br>"
             "If disabled, the default values from the New Signal dialog will be used."
         ),
     )
     use_image_dims = gds.BoolItem(
-        "",
-        _("Use image dimensions for new images"),
+        _("Use current image dimensions"),
+        _("New images"),
         help=_(
             "If enabled, when creating a new image, the width and height values will "
             "be initialized from the current image's dimensions.<br>"

datalab/locale/fr/LC_MESSAGES/datalab.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version:  datalab\n"
 "Report-Msgid-Bugs-To: p.raybaut@codra.fr\n"
-"POT-Creation-Date: 2025-10-16 17:55+0200\n"
+"POT-Creation-Date: 2025-10-18 11:18+0200\n"
 "PO-Revision-Date: 2025-05-22 15:46+0200\n"
 "Last-Translator: Christophe Debonnel <c.debonnel@codra.fr>\n"
 "Language: fr\n"
@@ -622,6 +622,24 @@ msgstr "Cela signifie que l'application n'a pas été officiellement qualifiée
 msgid "Do you want to see available log files?"
 msgstr "Souhaitez-vous consulter les journaux de bord disponibles ?"
 
+msgid "DataLab v0.20 plugins detected"
+msgstr "Plugins DataLab v0.20 détectés"
+
+msgid "The following plugins are using the old DataLab v0.20 format:"
+msgstr "Les plugins suivants utilisent l'ancien format DataLab v0.20 :"
+
+msgid "These plugins will <b>not be loaded</b> in DataLab v1.0 because they are not compatible with the new architecture."
+msgstr "Ces plugins ne seront <b>pas chargés</b> dans DataLab v1.0 car ils ne sont pas compatibles avec la nouvelle architecture."
+
+msgid "To use these plugins with DataLab v1.0, you need to update them. Please refer to the migration guide on the DataLab website "
+msgstr "Pour utiliser ces plugins avec DataLab v1.0, vous devez les mettre à jour. Veuillez vous référer au guide de migration sur le site web de DataLab "
+
+msgid " or in the PDF documentation."
+msgstr " ou dans la documentation PDF."
+
+msgid "Choosing to ignore this message will prevent it from appearing again."
+msgstr "Ignorer ce message empêchera son affichage ultérieur."
+
 #, python-format
 msgid "Welcome to %s!"
 msgstr "Bienvenue dans %s !"
@@ -1846,6 +1864,15 @@ msgstr "Chemin des plugins"
 msgid "Path to third-party plugins.<br><br>DataLab will discover plugins in this path, as well as in your PYTHONPATH."
 msgstr "Chemin d'accès aux plugins tiers.<br><br>DataLab découvrira les plugins dans ce chemin, ainsi que dans votre PYTHONPATH."
 
+msgid "Ignore compatibility issues warning"
+msgstr "Ignorer l'avertissement de compatibilité"
+
+msgid "DataLab v0.20 plugins"
+msgstr "Plugins DataLab v0.20"
+
+msgid "If enabled, DataLab will not warn you about v0.20 plugins that are no longer compatible with v1.0."
+msgstr "Si activé, DataLab ne vous avertira pas des plugins v0.20 qui ne sont plus compatibles avec v1.0."
+
 msgid "Settings for internal console, used for debugging or advanced users"
 msgstr "Réglages de la console interne, utilisée pour le débogage ou les utilisateurs avancés"
 
@@ -1895,14 +1922,20 @@ msgstr "Mode d'opération"
 msgid "Operation mode for computations taking <i>N</i> inputs:<ul><li><b>single</b>: single operand mode</li><li><b>pairwise</b>: pairwise operation mode</li></ul><br>Computations taking <i>N</i> inputs are the ones where:<ul><li>N(>=2) objects in %s 1 object out</li><li>N(>=1) objects + 1 object in %s N objects out</li></ul>"
 msgstr "Mode d'opération pour les calculs prenant <i>N</i> entrées:<ul><li><b>single</b>: mode d'opération avec un seul opérande</li><li><b>pairwise</b>: mode d'opération par paire</li></ul><br>Les calculs prenant <i>N</i> entrées sont ceux où :<ul><li>N(>=2) objets en %s 1 objet en sortie</li><li>N(>=1) objets + 1 objet en %s N objets en sortie</li></ul>"
 
-msgid "Use signal bounds for new signals"
-msgstr "Utiliser les bornes du signal pour les nouveaux signaux"
+msgid "Use current signal bounds"
+msgstr "Utiliser les bornes du signal courant"
+
+msgid "New signals"
+msgstr "Nouveaux signaux"
 
 msgid "If enabled, when creating a new signal, the xmin and xmax values will be initialized from the current signal's bounds.<br>If disabled, the default values from the New Signal dialog will be used."
 msgstr "Si activé, lors de la création d'un nouveau signal, les valeurs xmin et xmax seront initialisées à partir des bornes du signal actuel.<br>Si désactivé, les valeurs par défaut de la boîte de dialogue Nouveau signal seront utilisées."
 
-msgid "Use image dimensions for new images"
-msgstr "Utiliser les dimensions de l'image pour les nouvelles images"
+msgid "Use current image dimensions"
+msgstr "Utiliser les dimensions de l'image courante"
+
+msgid "New images"
+msgstr "Nouvelles images"
 
 msgid "If enabled, when creating a new image, the width and height values will be initialized from the current image's dimensions.<br>If disabled, the default values from the New Image dialog will be used."
 msgstr "Si activé, lors de la création d'une nouvelle image, les valeurs de largeur et de hauteur seront initialisées à partir des dimensions de l'image actuelle.<br>Si désactivé, les valeurs par défaut de la boîte de dialogue Nouvelle image seront utilisées."
@@ -2852,4 +2885,3 @@ msgstr "Merci de sélectionner le fichier à importer."
 
 msgid "Example Wizard"
 msgstr "Assistant exemple"
-

datalab/plugins.py

@@ -316,6 +316,33 @@ def discover_plugins() -> list[type[PluginBase]]:
     return []
 
 
+def discover_v020_plugins() -> list[tuple[str, str]]:
+    """Discover v0.20 plugins (with ``cdl_`` prefix) without importing them
+
+    Returns:
+        List of tuples (plugin_name, directory_path) for discovered v0.20 plugins
+    """
+    v020_plugins = []
+    if Conf.main.plugins_enabled.get():
+        for path in [
+            Conf.main.plugins_path.get(),
+            PLUGINS_DEFAULT_PATH,
+        ] + OTHER_PLUGINS_PATHLIST:
+            rpath = osp.realpath(path)
+            if rpath not in sys.path:
+                sys.path.append(rpath)
+        for finder, name, _ispkg in pkgutil.iter_modules():
+            if name.startswith("cdl_"):
+                # Get the directory path from the module finder
+                if hasattr(finder, "path"):
+                    directory_path = finder.path
+                    v020_plugins.append((name, directory_path))
+                else:
+                    # Fallback if path is not available
+                    v020_plugins.append((name, ""))
+    return v020_plugins
+
+
 def get_available_plugins() -> list[PluginBase]:
     """Instantiate and get available plugins
 

doc/locale/fr/LC_MESSAGES/features/advanced/plugins.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: DataLab \n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-10-18 09:53+0200\n"
+"POT-Creation-Date: 2025-10-18 10:43+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -281,6 +281,12 @@ msgstr "Découvrir les plugins en utilisant la convention de nommage"
 msgid "List of discovered plugins (as classes)"
 msgstr "Liste des plugins découverts (en tant que classes)"
 
+msgid "Discover v0.20 plugins (with ``cdl_`` prefix) without importing them"
+msgstr "Découvrir les plugins v0.20 (avec le préfixe ``cdl_``) sans les importer"
+
+msgid "List of discovered v0.20 plugin names"
+msgstr "Liste des noms de plugins v0.20 découverts"
+
 msgid "Instantiate and get available plugins"
 msgstr "Instancier et obtenir les plugins disponibles"