101 lines
4.4 KiB
Go
101 lines
4.4 KiB
Go
// Copyright 2026 Alibaba Group
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
package helpers
|
||
|
||
import (
|
||
"strings"
|
||
"testing"
|
||
|
||
"github.com/spf13/cobra"
|
||
)
|
||
|
||
// TestDevLeafFormatFlagVisibility 是队列 B189 的 dev 域叶子 --format flag 可见性
|
||
// 断言。--format 是生产根命令的持久 flag（internal/app/flags.go bindPersistentFlags），
|
||
// 叶子自身不声明 local --format，而是经 cmd.InheritedFlags() 继承可见。本测试：
|
||
//
|
||
// 1. 在完整命令树下执行 dev app/dev connect 叶子，--format 必须被 resolveCommandFormat
|
||
// 识别（table 生效），证明其可见；
|
||
//
|
||
// 2. 叶子 --help 必须展示 --format 于 Global Flags 段（继承可见性的人读证据）。
|
||
func TestDevLeafFormatFlagVisibility(t *testing.T) {
|
||
leaves := []struct {
|
||
name string
|
||
args []string
|
||
helpPath []string
|
||
}{
|
||
{"dev-app-get", []string{"dev", "app", "get", "--unified-app-id", "u-1"}, []string{"dev", "app", "get"}},
|
||
{"dev-app-list", []string{"dev", "app", "list", "--name", "DemoApp"}, []string{"dev", "app", "list"}},
|
||
{"dev-version-list", []string{"dev", "app", "version", "list", "--unified-app-id", "u-1"}, []string{"dev", "app", "version", "list"}},
|
||
{"dev-event-list", []string{"dev", "app", "event", "list", "--unified-app-id", "u-1"}, []string{"dev", "app", "event", "list"}},
|
||
{"dev-permission-list", []string{"dev", "app", "permission", "list", "--unified-app-id", "u-1"}, []string{"dev", "app", "permission", "list"}},
|
||
{"dev-member-list", []string{"dev", "app", "member", "list", "--unified-app-id", "u-1"}, []string{"dev", "app", "member", "list"}},
|
||
}
|
||
|
||
for _, lc := range leaves {
|
||
t.Run(lc.name, func(t *testing.T) {
|
||
// --format table 必须生效：输出为表（含列头/业务值），且不泄漏信封外壳键。
|
||
args := append(append([]string{}, lc.args...), "--format", "table")
|
||
root := newDevAppTestRoot(devAppFamilyContentRunner(map[string]any{"items": []any{map[string]any{"id": "one"}}}))
|
||
out, errBuf, err := runRootBuffered(t, root, args...)
|
||
if err != nil {
|
||
t.Fatalf("Execute() error = %v\nstdout:\n%s\nstderr:\n%s", err, out.String(), errBuf.String())
|
||
}
|
||
s := out.String()
|
||
if strings.Contains(s, `"outcome"`) || strings.Contains(s, `"ok":`) {
|
||
t.Fatalf("--format table not effective (envelope shell leaked):\n%s", s)
|
||
}
|
||
if strings.TrimSpace(s) == "" {
|
||
t.Fatalf("--format table produced empty stdout (format not visible?):\n%s", s)
|
||
}
|
||
|
||
// --help 必须展示 --format 于 Global Flags 段。
|
||
helpArgs := append(append([]string{}, lc.helpPath...), "--help")
|
||
helpRoot := newDevAppTestRoot(&captureRunner{})
|
||
helpOut, _, herr := runRootBuffered(t, helpRoot, helpArgs...)
|
||
if herr != nil {
|
||
t.Fatalf("--help error = %v", herr)
|
||
}
|
||
if !strings.Contains(helpOut.String(), "--format") {
|
||
t.Fatalf("leaf --help must expose --format (global inherited flag):\n%s", helpOut.String())
|
||
}
|
||
})
|
||
}
|
||
}
|
||
|
||
// TestDevLeafFormatFlagHelpShowsGlobalSection 是队列 B189 的补充观察断言：dev 叶子
|
||
// 的 --help 中 --format 出现在 "Global Flags" 段而非本地 Flags 段（flag 可见性来源
|
||
// 为根命令持久继承，而非叶子自声明）。这是 B189 结论的形式化——若某叶子把
|
||
// --format 放回本地段，本测试会因 --format 出现在非 Global 段而暴露。
|
||
func TestDevLeafFormatFlagHelpShowsGlobalSection(t *testing.T) {
|
||
root := newDevAppTestRoot(&captureRunner{})
|
||
out, _, err := runRootBuffered(t, root, "dev", "app", "get", "--help")
|
||
if err != nil {
|
||
t.Fatalf("--help error = %v", err)
|
||
}
|
||
help := out.String()
|
||
globalIdx := strings.Index(help, "Global Flags")
|
||
if globalIdx < 0 {
|
||
t.Fatalf("leaf help missing 'Global Flags' section:\n%s", help)
|
||
}
|
||
formatIdx := strings.LastIndex(help, "--format")
|
||
if formatIdx < 0 {
|
||
t.Fatalf("leaf help missing --format in Global Flags:\n%s", help)
|
||
}
|
||
if formatIdx < globalIdx {
|
||
t.Fatalf("--format found before 'Global Flags' section (should be inherited global):\n%s", help)
|
||
}
|
||
}
|
||
|
||
var _ = cobra.Command{}
|