mirror of
https://github.com/larksuite/cli.git
synced 2026-07-07 09:11:44 +08:00
0ff2957c6e
Replace <capabilities_dir> placeholders with resolved paths so models can see actual file locations before execution. Add version_source, types_output, and scan_dir fields to describe implicit behaviors.
95 lines
2.9 KiB
Go
95 lines
2.9 KiB
Go
// Copyright (c) 2026 Lark Technologies Pte. Ltd.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package apps
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"io"
|
|
"path/filepath"
|
|
"strings"
|
|
|
|
"github.com/larksuite/cli/shortcuts/common"
|
|
)
|
|
|
|
// AppsPluginInstanceGet reads a single plugin instance (capability JSON) by id.
|
|
var AppsPluginInstanceGet = common.Shortcut{
|
|
Service: appsService,
|
|
Command: "+plugin-instance-get",
|
|
Description: "Get a plugin instance by id",
|
|
Risk: "read",
|
|
Flags: []common.Flag{
|
|
{Name: "id", Desc: "instance id (filename without .json in capabilities/)", Required: true},
|
|
{Name: "project-path", Desc: "project root path (defaults to current directory)"},
|
|
{Name: "capabilities-dir", Desc: "explicit capabilities directory (relative to project or absolute)"},
|
|
},
|
|
DryRun: func(ctx context.Context, rctx *common.RuntimeContext) *common.DryRunAPI {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
projectPath, _ := pluginResolveProjectPath(rctx.Str("project-path"))
|
|
capDir, _ := pluginResolveCapDir(projectPath, rctx.Str("capabilities-dir"))
|
|
return common.NewDryRunAPI().
|
|
Desc("Get plugin instance (read capability JSON)").
|
|
Set("action", "get").
|
|
Set("id", id).
|
|
Set("source", filepath.Join(capDir, id+".json"))
|
|
},
|
|
Validate: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
if id == "" {
|
|
return appsValidationParamError("--id", "--id is required")
|
|
}
|
|
projectPath, err := pluginResolveProjectPath(rctx.Str("project-path"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return pluginCheckProjectDir(projectPath)
|
|
},
|
|
Execute: func(ctx context.Context, rctx *common.RuntimeContext) error {
|
|
id := strings.TrimSpace(rctx.Str("id"))
|
|
projectPath, err := pluginResolveProjectPath(rctx.Str("project-path"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
capDir, err := pluginResolveCapDir(projectPath, rctx.Str("capabilities-dir"))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
cap, err := pluginGetCapability(capDir, id)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
rctx.OutFormat(cap, nil, func(w io.Writer) {
|
|
pluginPrintInstance(w, cap)
|
|
})
|
|
return nil
|
|
},
|
|
}
|
|
|
|
func pluginPrintInstance(w io.Writer, cap map[string]interface{}) {
|
|
fmt.Fprintf(w, "ID: %v\n", cap["id"])
|
|
fmt.Fprintf(w, "Plugin: %v\n", cap["pluginKey"])
|
|
fmt.Fprintf(w, "Version: %v\n", cap["pluginVersion"])
|
|
fmt.Fprintf(w, "Name: %v\n", cap["name"])
|
|
|
|
if ts := common.FormatTime(cap["createdAt"]); ts != "" {
|
|
fmt.Fprintf(w, "Created: %s\n", ts)
|
|
}
|
|
if ts := common.FormatTime(cap["updatedAt"]); ts != "" {
|
|
fmt.Fprintf(w, "Updated: %s\n", ts)
|
|
}
|
|
|
|
if ps, ok := cap["paramsSchema"]; ok && ps != nil {
|
|
b, _ := json.MarshalIndent(ps, " ", " ")
|
|
fmt.Fprintf(w, "ParamsSchema: %s\n", b)
|
|
}
|
|
if fv, ok := cap["formValue"]; ok && fv != nil {
|
|
b, _ := json.MarshalIndent(fv, " ", " ")
|
|
fmt.Fprintf(w, "FormValue: %s\n", b)
|
|
}
|
|
}
|