Function buildMethodCommand

cmd/service/service.go:251–363

buildMethodCommand assembles the cobra command for a service method from its static spec: the standard flags, the conditional --data/--file/--yes flags, the generated typed param flags (via paramFlagBinder), and the risk/identity policy annotations.

(ctx context.Context, f *cmdutil.Factory, spec methodCommandSpec, runF func(*ServiceMethodOptions) error, reserved *pflag.FlagSet)

// the generated typed param flags (via paramFlagBinder), and the risk/identity
// policy annotations.
func buildMethodCommand(ctx context.Context, f *cmdutil.Factory, spec methodCommandSpec, runF func(*ServiceMethodOptions) error, reserved *pflag.FlagSet) *cobra.Command {
	m := spec.method
	opts := &ServiceMethodOptions{
		Factory:     f,
		ServicePath: spec.servicePath,
		Method:      m,
		SchemaPath:  spec.schemaPath,
		FileFields:  spec.fileFields,
	}
	var asStr string

	cmd := &cobra.Command{
		Use:   m.Name,
		Short: m.Description,
		// Long is assembled below, once the binder knows which params got no
		// typed flag.
		RunE: func(cmd *cobra.Command, args []string) error {
			opts.Cmd = cmd
			opts.Ctx = cmd.Context()
			opts.As = core.Identity(asStr)
			if runF != nil {
				return runF(opts)
			}
			return serviceMethodRun(opts)
		},
	}
	cmdmeta.SetSource(cmd, cmdmeta.SourceService, true)

	cmd.Flags().StringVar(&opts.Params, "params", "", "Raw URL/query params JSON. Supports - and @file.")
	if spec.acceptsBody {
		dataUsage := "JSON request body. Supports - and @file."
		if !spec.declaresBody {
			// POST/etc. with no documented body fields: --data is a raw escape
			// hatch, not a declared body — say so rather than imply structure.
			dataUsage = "Raw JSON request body (no documented fields; see schema). Supports - and @file."
		}
		cmd.Flags().StringVar(&opts.Data, "data", "", dataUsage)
	}
	cmdutil.AddAPIIdentityFlag(ctx, cmd, f, &asStr)
	cmd.Flags().StringVarP(&opts.Output, "output", "o", "", "output file path for binary responses")
	cmd.Flags().BoolVar(&opts.PageAll, "page-all", false, "automatically paginate through all pages")
	cmd.Flags().IntVar(&opts.PageLimit, "page-limit", 10, "max pages to fetch with --page-all (0 = unlimited)")
	cmd.Flags().IntVar(&opts.PageDelay, "page-delay", 200, "delay in ms between pages")
	// Keep the pagination flags registered (a harmless no-op if passed) but hide
	// them from help on non-paginating commands, so help doesn't imply a
	// get/write can paginate.
	if !spec.paginates {
		for _, name := range []string{"page-all", "page-limit", "page-delay"} {
			_ = cmd.Flags().MarkHidden(name)
		}
	}
	cmd.Flags().StringVar(&opts.Format, "format", "json", "output format: json|ndjson|table|csv")
	cmd.Flags().Bool("json", false, "shorthand for --format json")
	cmd.Flags().StringVarP(&opts.JqExpr, "jq", "q", "", "jq expression to filter JSON output")
	cmd.Flags().BoolVar(&opts.DryRun, "dry-run", false, "print request without executing")
	if spec.risk == cmdutil.RiskHighRiskWrite {
		cmd.Flags().Bool("yes", false, "confirm high-risk operation")
	}