package descriptor import ( "bytes" "context" "fmt" "strconv" "strings" "text/template" "time" "gitoa.ru/go-4devs/console/input" "gitoa.ru/go-4devs/console/input/flag" "gitoa.ru/go-4devs/console/input/value" "gitoa.ru/go-4devs/console/output" ) const ( defaultSpace = 2 infoLen = 13 ) //nolint:gochecknoglobals var ( txtFunc = template.FuncMap{ "synopsis": txtSynopsis, "definition": txtDefinition, "help": txtHelp, "commands": txtCommands, } txtHelpTemplate = template.Must(template.New("txt_template"). Funcs(txtFunc). Parse(` {{- if .Description -}} Description: {{ .Description }} {{ end -}} Usage: {{ .Name }} {{ synopsis .Definition }} {{- definition .Definition }} {{- help . }} `)) txtListTemplate = template.Must(template.New("txt_list"). Funcs(txtFunc). Parse(`Usage: command [options] [arguments] {{- definition .Definition }} {{- commands .Commands -}} `)) ) type txt struct{} func (t *txt) Command(ctx context.Context, out output.Output, cmd Command) error { var tpl bytes.Buffer if err := txtHelpTemplate.Execute(&tpl, cmd); err != nil { return fmt.Errorf("execute txt help tpl:%w", err) } out.Println(ctx, tpl.String()) return nil } func (t *txt) Commands(ctx context.Context, out output.Output, cmds Commands) error { var buf bytes.Buffer if err := txtListTemplate.Execute(&buf, cmds); err != nil { return fmt.Errorf("execute txt list tpl:%w", err) } out.Println(ctx, buf.String()) return nil } //nolint:cyclop func txtDefaultArray(val value.Value, fl flag.Flag) string { st := val.Strings() switch { case fl.IsInt(): for _, i := range val.Ints() { st = append(st, strconv.Itoa(i)) } case fl.IsInt64(): for _, i := range val.Int64s() { st = append(st, strconv.FormatInt(i, 10)) } case fl.IsUint(): for _, u := range val.Uints() { st = append(st, strconv.FormatUint(uint64(u), 10)) } case fl.IsUint64(): for _, u := range val.Uint64s() { st = append(st, strconv.FormatUint(u, 10)) } case fl.IsFloat64(): for _, f := range val.Float64s() { st = append(st, strconv.FormatFloat(f, 'g', -1, 64)) } case fl.IsDuration(): for _, d := range val.Durations() { st = append(st, d.String()) } case fl.IsTime(): for _, d := range val.Times() { st = append(st, d.Format(time.RFC3339)) } } return strings.Join(st, ",") } //nolint:cyclop func txtDefault(val value.Value, fl flag.Flag) []byte { var buf bytes.Buffer buf.WriteString(" [default: ") switch { case fl.IsArray(): buf.WriteString(txtDefaultArray(val, fl)) case fl.IsInt(): buf.WriteString(strconv.Itoa(val.Int())) case fl.IsInt64(): buf.WriteString(strconv.FormatInt(val.Int64(), 10)) case fl.IsUint(): buf.WriteString(strconv.FormatUint(uint64(val.Uint()), 10)) case fl.IsUint64(): buf.WriteString(strconv.FormatUint(val.Uint64(), 10)) case fl.IsFloat64(): buf.WriteString(strconv.FormatFloat(val.Float64(), 'g', -1, 64)) case fl.IsDuration(): buf.WriteString(val.Duration().String()) case fl.IsTime(): buf.WriteString(val.Time().Format(time.RFC3339)) case fl.IsAny(): buf.WriteString(fmt.Sprint(val.Any())) default: buf.WriteString(val.String()) } buf.WriteString("]") return buf.Bytes() } func txtCommands(cmds []NSCommand) string { max := commandsTotalWidth(cmds) showNS := len(cmds) > 1 var buf bytes.Buffer buf.WriteString("\nAvailable commands") if len(cmds) == 1 && cmds[0].Name != "" { buf.WriteString("for the \"") buf.WriteString(cmds[0].Name) buf.WriteString(`" namespace`) } buf.WriteString(":\n") for _, ns := range cmds { if ns.Name != "" && showNS { buf.WriteString("") buf.WriteString(ns.Name) buf.WriteString("\n") } for _, cmd := range ns.Commands { buf.WriteString(" ") buf.WriteString(cmd.Name) buf.WriteString("") buf.WriteString(strings.Repeat(" ", max-len(cmd.Name)+defaultSpace)) buf.WriteString(cmd.Description) buf.WriteString("\n") } } return buf.String() } func txtHelp(cmd Command) string { if cmd.Help == "" { return "" } tpl := template.Must(template.New("help").Parse(cmd.Help)) var buf bytes.Buffer buf.WriteString("\nHelp:") _ = tpl.Execute(&buf, cmd) return buf.String() } func txtDefinitionOption(maxLen int, def *input.Definition) string { buf := bytes.Buffer{} opts := def.Options() buf.WriteString("\n\nOptions:\n") for _, name := range opts { opt, _ := def.Option(name) if opt.IsHidden() { continue } var op bytes.Buffer op.WriteString(" ") if opt.HasShort() { op.WriteString("-") op.WriteString(opt.Alias) op.WriteString(", ") } else { op.WriteString(" ") } op.WriteString("--") op.WriteString(opt.Name) if !opt.IsBool() { if !opt.IsRequired() { op.WriteString("[") } op.WriteString("=") op.WriteString(strings.ToUpper(opt.Name)) if !opt.IsRequired() { op.WriteString("]") } } op.WriteString("") buf.Write(op.Bytes()) buf.WriteString(strings.Repeat(" ", maxLen+17-op.Len())) buf.WriteString(opt.Description) if opt.HasDefault() { buf.Write(txtDefault(opt.Default, opt.Flag)) } if opt.IsArray() { buf.WriteString(" (multiple values allowed)") } buf.WriteString("\n") } return buf.String() } func txtDefinition(def *input.Definition) string { max := totalWidth(def) var buf bytes.Buffer if args := def.Arguments(); len(args) > 0 { buf.WriteString("\n\nArguments:\n") for pos := range args { var ab bytes.Buffer arg, _ := def.Argument(pos) ab.WriteString(" ") ab.WriteString(arg.Name) ab.WriteString("") ab.WriteString(strings.Repeat(" ", max+infoLen+defaultSpace-ab.Len())) buf.Write(ab.Bytes()) buf.WriteString(arg.Description) if arg.HasDefault() { buf.Write(txtDefault(arg.Default, arg.Flag)) } } } if opts := def.Options(); len(opts) > 0 { buf.WriteString(txtDefinitionOption(max, def)) } return buf.String() } func txtSynopsis(def *input.Definition) string { var buf bytes.Buffer if len(def.Options()) > 0 { buf.WriteString("[options] ") } if buf.Len() > 0 && len(def.Arguments()) > 0 { buf.WriteString("[--]") } var opt int for pos := range def.Arguments() { buf.WriteString(" ") arg, _ := def.Argument(pos) if !arg.IsRequired() { buf.WriteString("[") opt++ } buf.WriteString("<") buf.WriteString(arg.Name) buf.WriteString(">") if arg.IsArray() { buf.WriteString("...") } } buf.WriteString(strings.Repeat("]", opt)) return buf.String() } func commandsTotalWidth(cmds []NSCommand) int { var max int for _, ns := range cmds { for _, cmd := range ns.Commands { if len(cmd.Name) > max { max = len(cmd.Name) } } } return max } func totalWidth(def *input.Definition) int { var max int for pos := range def.Arguments() { arg, _ := def.Argument(pos) l := len(arg.Name) if l > max { max = l } } for _, name := range def.Options() { opt, _ := def.Option(name) current := len(opt.Name) + 6 if !opt.IsBool() { current = current*2 + 1 } if opt.HasDefault() { current += 2 } if current > max { max = current } } return max }