feat(plugin): execute from function

changelog.md

@@ -6,6 +6,11 @@
 
 - [#3835](https://github.com/ignite/cli/pull/3835) Add `--minimal` flag to `scaffold chain` to scaffold a chain with the least amount of sdk modules
 
+
+### Changes
+
+- [#3899](https://github.com/ignite/cli/pull/3899) Introduce plugin.Execute function
+
 ## [`v28.1.1`](https://github.com/ignite/cli/releases/tag/v28.1.1)
 
 ### Fixes

ignite/services/plugin/internal/execute.go

@@ -0,0 +1,21 @@
+package plugininternal
+
+import (
+	"context"
+
+	pluginsconfig "github.com/ignite/cli/v28/ignite/config/plugins"
+	"github.com/ignite/cli/v28/ignite/services/plugin"
+)
+
+// Execute starts and executes a plugin, then shutdowns it.
+func Execute(ctx context.Context, path string, args ...string) error {
+	plugins, err := plugin.Load(ctx, []pluginsconfig.Plugin{{Path: path}})
+	if err != nil {
+		return err
+	}
+	defer plugins[0].KillClient()
+	if plugins[0].Error != nil {
+		return plugins[0].Error
+	}
+	return plugins[0].Interface.Execute(ctx, &plugin.ExecutedCommand{Args: args}, plugin.NewClientAPI())
+}

ignite/services/plugin/internal/execute_test.go

@@ -0,0 +1,47 @@
+package plugininternal
+
+import (
+	"context"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+
+	"github.com/ignite/cli/v28/ignite/services/plugin"
+)
+
+func TestPluginExecute(t *testing.T) {
+	tests := []struct {
+		name           string
+		scaffoldPlugin func(t *testing.T) string
+		expectedError  string
+	}{
+		{
+			name: "fail: plugin doesnt exist",
+			scaffoldPlugin: func(t *testing.T) string {
+				return "/not/exists"
+			},
+			expectedError: "local app path \"/not/exists\" not found: stat /not/exists: no such file or directory",
+		},
+		{
+			name: "ok: plugin exists",
+			scaffoldPlugin: func(t *testing.T) string {
+				path, err := plugin.Scaffold(context.Background(), t.TempDir(), "foo", false)
+				require.NoError(t, err)
+				return path
+			},
+		},
+	}
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			path := tt.scaffoldPlugin(t)
+
+			err := Execute(context.Background(), path, "args")
+
+			if tt.expectedError != "" {
+				require.EqualError(t, err, tt.expectedError)
+				return
+			}
+			require.NoError(t, err)
+		})
+	}
+}