PR: Make plugins.py a package (API)

.github/scripts/modules_test.sh

@@ -85,6 +85,9 @@ for f in spyder/*/*/*.py; do
     if [[ $f == spyder/plugins/tours/widgets.py ]]; then
         continue
     fi
+    if [[ $f == spyder/api/plugins/*.py ]]; then
+        continue
+    fi
     python "$f"
     if [ $? -ne 0 ]; then
         exit 1

spyder/api/plugin_registration/registry.py

@@ -15,10 +15,9 @@
 
 # Local imports
 from spyder.config.manager import CONF
-from spyder.api.plugins_enum import Plugins
 from spyder.api.exceptions import SpyderAPIError
 from spyder.api.plugins import (
-    SpyderPluginV2, SpyderDockablePlugin, SpyderPluginWidget,
+    Plugins, SpyderPluginV2, SpyderDockablePlugin, SpyderPluginWidget,
     SpyderPlugin)
 
 

spyder/api/plugins/__init__.py

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright © Spyder Project Contributors
+# Licensed under the terms of the MIT License
+# (see spyder/__init__.py for details)
+
+"""
+spyder.api.plugins
+==================
+
+Here, 'plugins' are Qt objects that can make changes to Spyder's main window
+and call other plugins directly.
+
+There are two types of plugins available:
+
+1. SpyderPluginV2 is a plugin that does not create a new dock/pane on Spyder's
+   main window. Note: SpyderPluginV2 will be renamed to SpyderPlugin once the
+   migration to the new API is finished
+
+2. SpyderDockablePlugin is a plugin that does create a new dock/pane on
+   Spyder's main window.
+"""
+
+from .enum import Plugins  # noqa
+from .old_api import SpyderPlugin, SpyderPluginWidget  # noqa
+from .new_api import SpyderDockablePlugin, SpyderPluginV2  # noqa

spyder/api/plugins_enum.py → spyder/api/plugins/enum.py

@@ -7,11 +7,6 @@
 """Enum of Spyder internal plugins."""
 
 
-##############################################################################
-#
-# New API: Migrate plugins one by one and test changes on the way.
-#
-##############################################################################
 class Plugins:
     """
     Convenience class for accessing Spyder internal plugins.