Files
container/Tests/ContainerCommandsTests/HelpCommandTests.swift
T
NONE 685966d026 cli: resolve subcommand path in container help (#1587)
- Fixes #1509. The CLI's own help text tells users to
  run `container help <subcommand>`, but every form
  of that results in an error.
- Added a captured subcommand path, walked 
  Application`'s `subcommands` + `groupedSubcommands`
  tree (matching `commandName` and `aliases`), and
  printed `Application.helpMessage(for:)` for the resolved
  target. Empty path keeps existing plugin-aware top-level
  help; unknown path throws `ValidationError`.
2026-05-27 10:54:49 -07:00

58 lines
2.3 KiB
Swift

//===----------------------------------------------------------------------===//
// Copyright © 2026 Apple Inc. and the container project authors.
//
// 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
//
// https://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.
//===----------------------------------------------------------------------===//
import ArgumentParser
import Foundation
import Testing
@testable import ContainerCommands
struct HelpCommandTests {
@Test
func everyStaticSubcommandReachableViaHelp() {
func walk(_ command: ParsableCommand.Type, path: [String]) {
let cfg = command.configuration
var children = cfg.subcommands
for group in cfg.groupedSubcommands {
children.append(contentsOf: group.subcommands)
}
for child in children {
guard let name = child.configuration.commandName else { continue }
let canonical = path + [name]
#expect(
HelpCommand.resolveSubcommand(path: canonical) != nil,
"help should resolve '\(canonical.joined(separator: " "))' but returned nil"
)
for alias in child.configuration.aliases {
let aliasPath = path + [alias]
#expect(
HelpCommand.resolveSubcommand(path: aliasPath) != nil,
"help should resolve alias path '\(aliasPath.joined(separator: " "))' but returned nil"
)
}
walk(child, path: canonical)
}
}
walk(Application.self, path: [])
}
@Test
func unknownSubcommandReturnsNil() {
#expect(HelpCommand.resolveSubcommand(path: ["nonexistent"]) == nil)
#expect(HelpCommand.resolveSubcommand(path: ["image", "nonexistent"]) == nil)
}
}