id       = "aliyun-cli"
name     = "Alibaba Cloud CLI"
homepage = "https://github.com/aliyun/aliyun-cli"
description = "Alibaba Cloud Command Line Interface."
executables = ["aliyun"]

[dotfiles]

# Alibaba Cloud's credential guide (https://help.aliyun.com/zh/cli/configure-credentials/)
# gives ~/.aliyun/config.json for Linux/macOS and ~/.aliyun/config.json under
# the user's home on Windows. The file contains the selected profile and
# credential material, so it is withheld whole rather than partially parsed.
paths = []
secret = ["~/.aliyun/config.json"]

[commands]
format = 1
label = "Alibaba Cloud CLI"
description = "Configure a credential profile with the aliyun CLI. API calls (aliyun <product> <Api>) are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["configure"]
label = "Configure a profile"
description = "Create or update a credential profile, by default through OAuth. Other credential modes and secrets are not offered."

[[commands.subcommand.source]]
id = "readme"
kind = "help"
url = "https://raw.githubusercontent.com/aliyun/aliyun-cli/HEAD/README.md"
revision = "2026-10-27"
evidence = """
aliyun configure --mode OAuth --profile default
aliyun configure --mode OAuth --profile default --no-browser
"""

[[commands.subcommand.field]]
id = "mode"
label = "Authentication mode"
description = "The README demonstrates OAuth; other modes such as AK need secrets and are left out."
type = "string"
option = ["--mode"]
suggestions = [{ value = "OAuth", label = "OAuth" }]
sources = ["readme"]

[[commands.subcommand.field]]
id = "profile"
label = "Profile name"
type = "string"
option = ["--profile"]
suggestions = [{ value = "default", label = "default" }]
sources = ["readme"]

[[commands.subcommand.field]]
id = "no_browser"
label = "No local browser"
description = "Print an authorization link to open on another device."
type = "boolean"
option = ["--no-browser"]
sources = ["readme"]

[[commands.subcommand.task]]
id = "oauth"
label = "Configure via OAuth"
fields = ["mode", "profile", "no_browser"]
required = ["profile"]
set = { mode = ["OAuth"] }

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["mode", "profile", "no_browser"]