FEAT: New extension manager (#6406)

Co-authored-by: Eduardo Blanco <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: pyansys-ci-bot <[email protected]>
(cherry picked from commit 2e2f96c)

Author: 4 people

codecov.yml

@@ -2,7 +2,6 @@ ignore:
   - "src/ansys/aedt/core/rpc/*.py"
   - "src/ansys/aedt/core/misc/*.py"
   - "src/ansys/aedt/core/visualization/advanced/sbrplus/hdm_utils.py"
-  - "src/ansys/aedt/core/extensions/installer"
   - "src/ansys/aedt/core/extensions/templates"
   - "src/ansys/aedt/core/common_rpc.py"
   - "src/ansys/aedt/core/internal/grpc_plugin_dll_class.py"

doc/changelog.d/6406.added.md

@@ -0,0 +1 @@
+New extension manager

doc/source/Getting_started/Installation.rst

@@ -49,8 +49,15 @@ If you have installation problems, visit :ref:`Troubleshooting<panel_error>`.
 Extension manager
 ~~~~~~~~~~~~~~~~~
 
-The user can install or uninstall automated workflows using the extension manager.
-There are three options:
+The **PyAEDT Extension Manager** provides a centralized interface for accessing, launching, and managing automation workflows directly within AEDT.
+
+From this window, you can:
+
+- Browse and launch **project-level toolkits** organized by design type.
+- Add **custom extensions** from your local environment.
+- Control whether extensions appear in the **AEDT Automation ribbon** for quick access.
+
+There are three types of extensions supported:
 
 - **Pre-installed extensions** already available in the PyAEDT library.
 
@@ -64,13 +71,27 @@ See `Extension Manager <https://aedt.docs.pyansys.com/version/stable/User_guide/
   :width: 800
   :alt: PyAEDT toolkit manager 1
 
-The user can select the AEDT application to install the specific workflow.
+Each extension tile shows its name, icon, and a **Launch** button.
+Extensions that are not currently linked to the AEDT ribbon show a muted icon.
+Pinned extensions are marked and appears in the corresponding AEDT design ribbon tab.
+
+
+Selecting the **Custom** tile in the Extension Manager opens a dialog where you can add your own PyAEDT-based extension.
 
 .. image:: ../Resources/toolkit_manager_2.png
   :width: 400
   :alt: PyAEDT toolkit manager 2
 
-Once the toolkit is installed, its icon only appears in the ribbon when you either create a new design or open an existing one that is compatible with the toolkit. Toolkit icons are visible only within the corresponding design environment.
+In the dialog, you can:
+
+- **Browse for a Python script** that implements the extension behavior.
+- **Optionally leave the script path empty**. If no script is provided, a default extension script is automatically generated using a predefined template.
+
+You must also specify an **Extension Name**, which appears in the AEDT Automation.
+
+Once configured, click **OK** to register the extension. It then appears alongside other extensions in the manager interface.
+
+A message bar at the bottom provides real-time feedback about actions, such as launching extensions or errors.
 
 For additional information about AEDT extensions, 
 see `Extensions <https://aedt.docs.pyansys.com/version/stable/User_guide/extensions.html>`_.

doc/source/Resources/my_custom_extension.png

@@ -284,30 +284,24 @@ Here are some links to existing toolkits:
 Now, you need to download the installer from the Releases section of each toolkit.
 You can access it by clicking the "Install" button in the corresponding repository.
 
-After installing it, you can add the toolkit to AEDT as a Custom extension by pointing to the .exe file.
-
-.. image:: ../Resources/toolkit_manager_3.png
-  :width: 500
-  :alt: PyAEDT toolkit manager 3
-
 
 Custom extensions
 -----------------
 
 Custom extensions are custom workflows (Python script) that can be installed both at project and application level.
-From the Extension manager select the target destination:
+From the Extension manager select the target destination and `Custom` as the extension type:
 
 .. image:: ../Resources/toolkit_manager_1.png
   :width: 500
   :alt: PyAEDT toolkit manager 1
 
-Select `Custom` as the extension type.
-Provide the path of the Python script containing the workflow.
+Provide the path of the Python script containing the workflow. If you do not specify any script, the template is assigned.
+
 Enter the extension name. This is the name that appears beneath the button in the Automation tab after a successful installation.
 
-.. image:: ../Resources/my_custom_extension.png
+.. image:: ../Resources/toolkit_manager_2.png
   :width: 500
-  :alt: Custom Extension
+  :alt: PyAEDT toolkit manager 2
 
 After the normal completion of the installation a new button appears:
 

doc/source/Resources/toolkit_manager_1.png

@@ -21,3 +21,7 @@
 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
+
+from pathlib import Path
+
+EXTENSIONS_PATH = Path(__file__).parent

doc/source/Resources/toolkit_manager_2.png

@@ -4,11 +4,13 @@ script = "import_schematic.py"
 icon = "images/large/schematic.png"
 template = "run_pyaedt_toolkit_script"
 pip = ""
+url = "https://aedt.docs.pyansys.com/version/stable/User_guide/pyaedt_extensions_doc/circuit/import_schematic.html"
 
 [CircuitConfiguration]
 name = "Circuit Configuration"
 script = "circuit_configuration.py"
 icon = "images/large/circuit_config.png"
 template = "run_pyaedt_toolkit_script"
 pip = ""
+url = "https://aedt.docs.pyansys.com/version/stable/User_guide/pyaedt_extensions_doc/circuit/circuit_configuration.html"