Skip to content

Add completion spec: Azure CLI (az)#222

Merged
lucieleblanc merged 2 commits into
mainfrom
app-3512/command-spec-azure-cli
Apr 3, 2026
Merged

Add completion spec: Azure CLI (az)#222
lucieleblanc merged 2 commits into
mainfrom
app-3512/command-spec-azure-cli

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

Summary

Add a comprehensive completion spec for the Azure CLI (az) command.

Resolves APP-3512

What's included

JSON Spec (az.json)

  • All 70+ top-level subgroups and commands with descriptions
  • Detailed subcommand specs for the most commonly used groups:
    • account, group, vm, aks, webapp, functionapp, storage, network, keyvault, acr, extension, ad, container, containerapp, deployment, sql, monitor, role, config, bicep, disk
  • Global options (--output, --query, --subscription, --debug, --verbose, --help, --only-show-errors)
  • Static suggestions for enum-type arguments (output formats, SKUs, authentication types, runtimes, etc.)

Generators (az.rs)

11 dynamic generators for contextual completions:

  • resource_groups — Lists Azure resource groups
  • subscriptions — Lists Azure subscriptions
  • installed_extensions / available_extensions — Lists CLI extensions
  • aks_clusters — Lists AKS clusters
  • vms — Lists virtual machines
  • webapps — Lists web apps
  • functionapps — Lists function apps
  • acr_registries — Lists container registries
  • storage_accounts — Lists storage accounts
  • keyvaults — Lists key vaults

Testing

Verified in local Warp build:

  • az (Tab): Shows all top-level subgroups (account, acr, ad, advisor, afd, aks, etc.) with descriptions
  • az login (Tab): Shows login options (--allow-no-subscriptions, --certificate, --federated-token, --identity, etc.)
  • az group (Tab): Shows group subcommands (create, delete, exists, export, list, lock, show, update, wait)
  • az aks get-credentials (Tab): Shows get-credentials flags (--admin, --file, --name, --overwrite-existing, etc.)
  • az vm create --authentication-type (Tab): Shows enum value suggestions (all, password, ssh)
  • az extension add (Tab): Shows add flags (--name, --source, --version, --yes)

Screenshots will be uploaded as a comment on this PR.


Conversation: https://staging.warp.dev/conversation/a704899d-d661-4985-8fa5-a4b526deb2ba
Run: https://oz.staging.warp.dev/runs/019d4a9e-f2c7-75df-81d1-9a0767a07f52

This PR was generated with Oz.

Add a comprehensive completion spec for the Azure CLI (az) with:
- All 70+ top-level subgroups and commands with descriptions
- Detailed subcommand specs for the most commonly used groups:
  account, group, vm, aks, webapp, functionapp, storage, network,
  keyvault, acr, extension, ad, container, containerapp, deployment,
  sql, monitor, role, config, bicep, disk
- Global options (--output, --query, --subscription, --debug, etc.)
- Static suggestions for enum-type arguments (output formats, SKUs,
  authentication types, runtimes, etc.)
- 11 dynamic generators for: resource groups, subscriptions,
  installed/available extensions, AKS clusters, VMs, web apps,
  function apps, ACR registries, storage accounts, key vaults

Co-Authored-By: Oz <oz-agent@warp.dev>
@linear
Copy link
Copy Markdown

linear Bot commented Apr 1, 2026

APP-3512 Add Azure CLI (az) completion spec

No az.json spec exists. Need to create from scratch.

See GitHub #244 (moved to #652, never implemented)

Copy link
Copy Markdown
Contributor Author

Completion Screenshots

All completions verified in local Warp build:

  1. az (Tab): Shows all 70+ top-level subgroups (account, acr, ad, advisor, afd, aks...) with descriptions
  2. az login (Tab): Shows login flags (--allow-no-subscriptions, --certificate, --debug, --federated-token, --help, --identity...)
  3. az group (Tab): Shows group subcommands (create, delete, exists, export, list, lock, show, update, wait)
  4. az aks get-credentials (Tab): Shows get-credentials flags (--admin, --file, --name, --only-show-errors, --overwrite-existing...)
  5. az vm create --authentication-type (Tab): Shows enum value suggestions (all, password, ssh) along with other flags
  6. az extension add (Tab): Shows add flags (--name, --source, --version, --yes) and global options

Copy link
Copy Markdown
Contributor Author

Azure CLI (az) Completion Screenshots

az_completions_1

az_completions_2

az_completions_3

az_completions_4

az_completions_5

az_completions_6

@zachlloyd
Copy link
Copy Markdown
Contributor

Generator Validation Screenshots

All 11 generators for the Azure CLI (az) completion spec have been tested in a local Warp build. Each generator was triggered by typing the relevant command prefix and pressing Tab to open the completions dropdown.

Note: Mock data was used for generators that require Azure authentication (resource groups, subscriptions, etc.). The available_extensions generator uses real data from az extension list-available.

1. subscriptions generator

Command: az account set -s <Tab>
subscriptions

2. resource_groups generator

Command: az group delete --name <Tab>
resource_groups

3. acr_registries generator

Command: az acr build --registry <Tab>
acr_registries

4. aks_clusters generator

Command: az aks browse --name <Tab>
aks_clusters

5. available_extensions generator (real data)

Command: az extension add --name <Tab>
available_extensions

6. installed_extensions generator

Command: az extension remove --name <Tab>
installed_extensions

7. vms generator

Command: az vm delete --name <Tab>
vms

8. webapps generator

Command: az webapp delete --name <Tab>
webapps

9. storage_accounts generator

Command: az storage account delete --name <Tab>
storage_accounts

10. functionapps generator

Command: az functionapp delete --name <Tab>
functionapps

11. keyvaults generator

Command: az keyvault delete --name <Tab>
keyvaults


All generators correctly produce completions with appropriate descriptions matching their resource types.

@lucieleblanc
Copy link
Copy Markdown
Contributor Author

Screenshots:
subscription
image

resource group:
image

ACR registry:
image

AKS cluster:
image

available extension:
image

installed extension:
image

VM:
image

web app:
image

storage account:
image

function app:
image

key vault:
image

@lucieleblanc lucieleblanc marked this pull request as ready for review April 3, 2026 17:01
@lucieleblanc lucieleblanc enabled auto-merge (squash) April 3, 2026 18:43
@lucieleblanc lucieleblanc merged commit d103c62 into main Apr 3, 2026
3 checks passed
@lucieleblanc lucieleblanc deleted the app-3512/command-spec-azure-cli branch April 3, 2026 18:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants