Documentation
¶
Index ¶
- func NewCmdServiceMethod(f *cmdutil.Factory, svc meta.Service, m meta.Method, name, resName string, ...) *cobra.Command
- func NewCmdServiceMethodWithContext(ctx context.Context, f *cmdutil.Factory, svc meta.Service, m meta.Method, ...) *cobra.Command
- func PrepareDomainHelp(cmd *cobra.Command, skillFS fs.FS) bool
- func PrepareMethodHelp(cmd *cobra.Command) bool
- func RegisterServiceCommands(parent *cobra.Command, f *cmdutil.Factory)
- func RegisterServiceCommandsFromCatalog(ctx context.Context, parent *cobra.Command, f *cmdutil.Factory, ...)
- func RegisterServiceCommandsWithContext(ctx context.Context, parent *cobra.Command, f *cmdutil.Factory)
- func RenderAffordanceForCmd(cmd *cobra.Command) string
- type ServiceMethodOptions
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NewCmdServiceMethod ¶
func NewCmdServiceMethod(f *cmdutil.Factory, svc meta.Service, m meta.Method, name, resName string, runF func(*ServiceMethodOptions) error) *cobra.Command
NewCmdServiceMethod creates a command for a dynamically registered service method.
func NewCmdServiceMethodWithContext ¶ added in v1.0.16
func NewCmdServiceMethodWithContext(ctx context.Context, f *cmdutil.Factory, svc meta.Service, m meta.Method, name, resName string, runF func(*ServiceMethodOptions) error) *cobra.Command
NewCmdServiceMethodWithContext builds the command for one service method from its (service, resource, method) coordinates, deriving the methodCommandSpec via an apicatalog.MethodRef so direct callers and the catalog-driven registration assemble the command identically.
func PrepareDomainHelp ¶ added in v1.0.60
PrepareDomainHelp appends navigational guidance (routing line, risk legend, skill pointer) to a top-level Lark domain's description, returning false for anything that is not such a domain. Built lazily at help time because shortcuts attach after service registration. skillFS (nil-safe) gates the skill pointer.
A hand-authored Long is preserved as the base (e.g. event's "Use 'event consume <EventKey>'…"); service domains carry only a Short at this point, so we fall back to it. The pristine base is captured once into an annotation so re-rendering does not append the guidance twice.
func PrepareMethodHelp ¶ added in v1.0.60
PrepareMethodHelp rebuilds a generated method command's Long with the agent guidance at the TOP (Risk, then the affordance block, then the schema pointer), returning false for non-method commands. The overlay is parsed here — only when help is rendered.
func RegisterServiceCommands ¶
RegisterServiceCommands registers all service commands from from_meta specs.
func RegisterServiceCommandsFromCatalog ¶ added in v1.0.56
func RegisterServiceCommandsWithContext ¶ added in v1.0.16
func RenderAffordanceForCmd ¶ added in v1.0.60
RenderAffordanceForCmd renders a method command's affordance block, or "" when it carries none.
Types ¶
type ServiceMethodOptions ¶
type ServiceMethodOptions struct {
Factory *cmdutil.Factory
Cmd *cobra.Command
Ctx context.Context
ServicePath string
Method meta.Method
SchemaPath string
// Flags
Params string
Data string
As core.Identity
Output string
PageAll bool
PageLimit int
PageDelay int
Format string
JqExpr string
DryRun bool
File string // --file flag value
FileFields []string // auto-detected file field names from metadata
// contains filtered or unexported fields
}
ServiceMethodOptions holds all inputs for a dynamically registered service method command.