Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

chore(cli): use option source name for deprecation warnings#15581

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
ethanndickson merged 2 commits intomainfromethan/cli-deprecation-warnings
Nov 19, 2024
Merged
Show file tree
Hide file tree
Changes fromall commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 71 additions & 0 deletionscli/root.go
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -325,6 +325,15 @@ func (r *RootCmd) Command(subcommands []*serpent.Command) (*serpent.Command, err
}
})

// Add the PrintDeprecatedOptions middleware to all commands.
cmd.Walk(func(cmd *serpent.Command) {
if cmd.Middleware == nil {
cmd.Middleware = PrintDeprecatedOptions()
} else {
cmd.Middleware = serpent.Chain(cmd.Middleware, PrintDeprecatedOptions())
}
})

if r.agentURL == nil {
r.agentURL = new(url.URL)
}
Expand DownExpand Up@@ -1307,3 +1316,65 @@ func headerTransport(ctx context.Context, serverURL *url.URL, header []string, h
}
return transport, nil
}

// printDeprecatedOptions loops through all command options, and prints
// a warning for usage of deprecated options.
func PrintDeprecatedOptions() serpent.MiddlewareFunc {
return func(next serpent.HandlerFunc) serpent.HandlerFunc {
return func(inv *serpent.Invocation) error {
opts := inv.Command.Options
// Print deprecation warnings.
for _, opt := range opts {
if opt.UseInstead == nil {
continue
}

if opt.ValueSource == serpent.ValueSourceNone || opt.ValueSource == serpent.ValueSourceDefault {
continue
}

var warnStr strings.Builder
_, _ = warnStr.WriteString(translateSource(opt.ValueSource, opt))
_, _ = warnStr.WriteString(" is deprecated, please use ")
for i, use := range opt.UseInstead {
_, _ = warnStr.WriteString(translateSource(opt.ValueSource, use))
if i != len(opt.UseInstead)-1 {
_, _ = warnStr.WriteString(" and ")
}
}
_, _ = warnStr.WriteString(" instead.\n")

cliui.Warn(inv.Stderr,
warnStr.String(),
)
}

return next(inv)
}
}
}

// translateSource provides the name of the source of the option, depending on the
// supplied target ValueSource.
func translateSource(target serpent.ValueSource, opt serpent.Option) string {
switch target {
case serpent.ValueSourceFlag:
return fmt.Sprintf("`--%s`", opt.Flag)
case serpent.ValueSourceEnv:
return fmt.Sprintf("`%s`", opt.Env)
case serpent.ValueSourceYAML:
return fmt.Sprintf("`%s`", fullYamlName(opt))
default:
return opt.Name
}
}

func fullYamlName(opt serpent.Option) string {
var full strings.Builder
for _, name := range opt.Group.Ancestry() {
_, _ = full.WriteString(name.YAML)
_, _ = full.WriteString(".")
}
_, _ = full.WriteString(opt.YAML)
return full.String()
}
36 changes: 0 additions & 36 deletionscli/server.go
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -294,7 +294,6 @@ func (r *RootCmd) Server(newAPI func(context.Context, *coderd.Options) (*coderd.
Options: opts,
Middleware: serpent.Chain(
WriteConfigMW(vals),
PrintDeprecatedOptions(),
serpent.RequireNArgs(0),
),
Handler: func(inv *serpent.Invocation) error {
Expand DownExpand Up@@ -1240,41 +1239,6 @@ func templateHelpers(options *coderd.Options) map[string]any {
}
}

// printDeprecatedOptions loops through all command options, and prints
// a warning for usage of deprecated options.
func PrintDeprecatedOptions() serpent.MiddlewareFunc {
return func(next serpent.HandlerFunc) serpent.HandlerFunc {
return func(inv *serpent.Invocation) error {
opts := inv.Command.Options
// Print deprecation warnings.
for _, opt := range opts {
if opt.UseInstead == nil {
continue
}

if opt.ValueSource == serpent.ValueSourceNone || opt.ValueSource == serpent.ValueSourceDefault {
continue
}

warnStr := opt.Name + " is deprecated, please use "
for i, use := range opt.UseInstead {
warnStr += use.Name + " "
if i != len(opt.UseInstead)-1 {
warnStr += "and "
}
}
warnStr += "instead.\n"

cliui.Warn(inv.Stderr,
warnStr,
)
}

return next(inv)
}
}
}

// writeConfigMW will prevent the main command from running if the write-config
// flag is set. Instead, it will marshal the command options to YAML and write
// them to stdout.
Expand Down
1 change: 0 additions & 1 deletionenterprise/cli/proxyserver.go
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -110,7 +110,6 @@ func (r *RootCmd) proxyServer() *serpent.Command {
Options: opts,
Middleware: serpent.Chain(
cli.WriteConfigMW(cfg),
cli.PrintDeprecatedOptions(),
serpent.RequireNArgs(0),
),
Handler: func(inv *serpent.Invocation) error {
Expand Down
Loading

[8]ページ先頭

©2009-2025 Movatter.jp