Blueprint

package main

import (
	"context"
	"os"

	loaders "github.com/hedzr/cmdr-loaders"
	"github.com/hedzr/cmdr-tests/examples/blueprint/cmd"
	"github.com/hedzr/cmdr/v2"
	"github.com/hedzr/cmdr/v2/cli"
	"github.com/hedzr/cmdr/v2/examples/devmode"
	"github.com/hedzr/cmdr/v2/pkg/logz"
)

const (
	appName = "blueprint"
	desc    = `a good blueprint for you.`
	version = cmdr.Version
	author  = `The Examples Authors`
)

func main() {
	ctx := context.Background()	app := prepareApp(cmd.Commands...) // define your own commands implementations with cmd/*.go
	if err := app.Run(ctx); err != nil {
		logz.ErrorContext(ctx, "Application Error:", "err", err) // stacktrace if in debug mode/build
		os.Exit(app.SuggestRetCode())
	} else if rc := app.SuggestRetCode(); rc != 0 {
		os.Exit(rc)
	}
}

func prepareApp(commands ...cli.CmdAdder) cli.App {
	return loaders.Create(
		appName, version, author, desc,

		cmdr.WithAutoEnvBindings(true),  // default it's false
		cmdr.WithSortInHelpScreen(true), // default it's false
		// cmdr.WithDontGroupInHelpScreen(false), // default it's false
		// cmdr.WithForceDefaultAction(false),
	).
		// importing devmode package and run its init():
		With(func(app cli.App) { logz.Debug("in dev mode?", "mode", devmode.InDevelopmentMode()) }).
		WithBuilders(
			// common.AddHeadLikeFlagWithoutCmd, // add a `--line` option, feel free to remove it.
			// common.AddToggleGroupFlags,       //
			// common.AddTypedFlags,             //
			// common.AddKilobytesFlag,          //
			// common.AddValidArgsFlag,          //
		).
		WithAdders(commands...).
		Build()
}

package cmd

import (
	"github.com/hedzr/cmdr/v2/cli"
)

var Commands = append(
	[]cli.CmdAdder{
		sndx{},
	},
	// cmd.Commands...,
)

package cmd

import (
	"context"
	"fmt"

	"github.com/hedzr/cmdr/v2/cli"
	"github.com/hedzr/cmdr/v2/pkg/text"
)

type sndx struct{}

func (sndx) Add(app cli.App) {
	app.Cmd("soundex", "snd", "sndx", "sound").
		Description("soundex test").
		Group("Test").
		TailPlaceHolders("[text1, text2, ...]").
		OnAction(soundex).
		Build()
}

func soundex(ctx context.Context, cmd cli.Cmd, args []string) (err error) {
	_, _ = cmd, args
	for ix, s := range args {
		fmt.Printf("%5d. %s => %s\n", ix, s, text.Soundex(s))
	}
	return
}