Planetary Computer CLI extension by thisisdevanshu · Pull Request #9737 · Azure/azure-cli-extensions

thisisdevanshu · 2026-03-28T00:12:11Z

This checklist is used to make sure that common guidelines for a pull request are followed.

Related command

General Guidelines

Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
Have you run python scripts/ci/test_index.py -q locally? (pip install wheel==0.30.0 required)
My extension version conforms to the Extension version schema

For new extensions:

My extension description/summary conforms to the Extension Summary Guidelines.

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

azure-client-tools-bot-prd · 2026-03-28T00:12:14Z

Validation for Breaking Change Starting...

Thanks for your contribution!

azure-client-tools-bot-prd · 2026-03-28T00:12:17Z

Hi @thisisdevanshu,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in setup.py as well.

yonzhan · 2026-03-28T00:16:02Z

Thank you for your contribution! We will review the pull request and get back to you soon.

github-actions · 2026-03-28T00:16:05Z

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

github-actions · 2026-03-28T00:16:11Z

CodeGen Tools Feedback Collection

Thank you for using our CodeGen tool. We value your feedback, and we would like to know how we can improve our product. Please take a few minutes to fill our codegen survey

github-actions · 2026-03-28T00:19:11Z

For more info about extension versioning, please refer to Extension version schema

- AAZ-based extension for Microsoft.Orbital/geoCatalogs (API version 2026-04-15) - Commands: planetarycomputer geocatalog create/show/list/update/delete/wait - Identity commands: geocatalog identity assign/show/remove/wait - Short alias --scope for --auto-generated-domain-name-label-scope - Command examples for create, update, and identity assign - Help text for all command groups - 10 scenario tests with playback recordings - Version 1.0.0b1 (preview)

Copilot

Pull request overview

Introduces a new Azure CLI extension (planetarycomputer) for managing Planetary Computer GeoCatalog resources, including AAZ-generated command implementations and scenario tests with VCR recordings.

Changes:

Adds extension packaging metadata and documentation (setup files, README, history).
Adds AAZ-generated command groups/commands for GeoCatalog CRUD, identity management, and wait operations.
Adds ScenarioTest coverage with recordings for the new commands.

Reviewed changes

Copilot reviewed 38 out of 41 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
src/planetarycomputer/setup.py	Adds packaging metadata and setuptools configuration for the new extension.
src/planetarycomputer/setup.cfg	Adds placeholder setup.cfg file (repo-standard pattern).
src/planetarycomputer/README.md	Adds user-facing usage docs and command examples for the extension.
src/planetarycomputer/HISTORY.rst	Adds initial release notes for version `1.0.0b1`.
src/planetarycomputer/azext_planetarycomputer/init.py	Registers the extension command loader and wires AAZ command table loading.
src/planetarycomputer/azext_planetarycomputer/_help.py	Defines CLI help entries for command groups and key commands.
src/planetarycomputer/azext_planetarycomputer/_params.py	Stub for non-AAZ argument loading (currently no custom args).
src/planetarycomputer/azext_planetarycomputer/commands.py	Stub for non-AAZ command table loading (AAZ is the primary command source).
src/planetarycomputer/azext_planetarycomputer/custom.py	Placeholder module for future customizations (currently logger only).
src/planetarycomputer/azext_planetarycomputer/azext_metadata.json	Declares extension preview status and minimum CLI core version.
src/planetarycomputer/azext_planetarycomputer/aaz/init.py	Initializes the AAZ package for the extension.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/init.py	Initializes the `latest` AAZ profile package.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/init.py	Initializes the top-level AAZ command group package.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/__cmd_group.py	Defines the top-level AAZ command group registration for `planetarycomputer`.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/init.py	Exposes GeoCatalog commands in the AAZ module.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/__cmd_group.py	Registers the `planetarycomputer geocatalog` command group.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_create.py	Implements `az planetarycomputer geocatalog create` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_delete.py	Implements `az planetarycomputer geocatalog delete` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_list.py	Implements `az planetarycomputer geocatalog list` with paging (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_show.py	Implements `az planetarycomputer geocatalog show` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_update.py	Implements `az planetarycomputer geocatalog update` incl. generic update (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/_wait.py	Implements `az planetarycomputer geocatalog wait` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/init.py	Exposes GeoCatalog identity subcommands in the AAZ module.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/__cmd_group.py	Registers the `planetarycomputer geocatalog identity` command group.
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_assign.py	Implements `az planetarycomputer geocatalog identity assign` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_remove.py	Implements `az planetarycomputer geocatalog identity remove` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_show.py	Implements `az planetarycomputer geocatalog identity show` (AAZ).
src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_wait.py	Implements `az planetarycomputer geocatalog identity wait` (AAZ).
src/planetarycomputer/azext_planetarycomputer/tests/init.py	Initializes the tests package.
src/planetarycomputer/azext_planetarycomputer/tests/latest/init.py	Initializes the `latest` tests package.
src/planetarycomputer/azext_planetarycomputer/tests/latest/test_planetarycomputer.py	Adds scenario tests for GeoCatalog and identity workflows.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_show.yaml	Adds VCR recording for `geocatalog show`.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_list_by_resource_group.yaml	Adds VCR recording for `geocatalog list -g`.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_list_by_subscription.yaml	Adds VCR recording for `geocatalog list` (subscription scope).
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_update_tags.yaml	Adds VCR recording for `geocatalog update --tags` (including clearing tags).
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_wait.yaml	Adds VCR recording for `geocatalog wait`.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_identity_assign_user.yaml	Adds VCR recording for `identity assign` and subsequent `identity show`.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_identity_remove_user.yaml	Adds VCR recording for `identity remove` flow.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_crud.yaml	Adds VCR recording for create/show/list/update/delete end-to-end CRUD.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_create_with_options.yaml	Adds VCR recording for create with explicit options and identity.
src/planetarycomputer/azext_planetarycomputer/tests/latest/recordings/test_geocatalog_create_and_delete_no_wait.yaml	Adds VCR recording for `--no-wait` create/delete + wait assertions.

src/planetarycomputer/README.md

Copilot · 2026-04-01T00:21:48Z

src/planetarycomputer/setup.py

+    name='planetarycomputer',
+    version=VERSION,
+    description='Microsoft Azure Command-Line Tools Planetarycomputer Extension.',
+    long_description=README + '\n\n' + HISTORY,


The package description uses "Planetarycomputer" (no space), which is inconsistent with the extension’s help text using "Planetary Computer". Consider updating the description to use consistent product naming.

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_assign.py

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/identity/_remove.py

Copilot · 2026-04-01T00:21:49Z

src/planetarycomputer/azext_planetarycomputer/_help.py

+          text: |-
+            az planetarycomputer geocatalog create -g MyResourceGroup -n MyCatalog -l eastus
+        - name: Create a GeoCatalog with a user-assigned identity
+          text: |-
+            az planetarycomputer geocatalog create -g MyResourceGroup -n MyCatalog -l eastus \\
+                --user-assigned "/subscriptions/{sub}/resourcegroups/{rg}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{name}"
+"""


The help examples use four backslashes at line breaks (e.g., \\\\ in the source), which will render as two backslashes in the CLI help output. Other extensions use a single rendered continuation (\), so this should be reduced to \\ in the Python string to display one backslash to users.

Copilot · 2026-04-01T00:21:49Z

src/planetarycomputer/azext_planetarycomputer/_help.py

+    examples:
+        - name: Assign a user-assigned managed identity
+          text: |-
+            az planetarycomputer geocatalog identity assign -g MyResourceGroup -n MyCatalog \\
+                --user-assigned "/subscriptions/{sub}/resourcegroups/{rg}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{name}"
+"""


The help example here uses four backslashes for line continuation, which will display two backslashes to users. Reduce to a single rendered continuation (use \\ in the Python string) to match other extension help output.

src/planetarycomputer/README.md

- Fix 'Planetarycomputer' -> 'Planetary Computer' in README title and setup.py description - Fix --user-assigned-identities -> --user-assigned in identity assign docstring example - Fix identity remove help strings from 'Set the...' to 'Remove the...' - Use full resource IDs in README identity examples

- Remove --system-assigned from create, identity assign, identity remove (API only supports user-assigned) - Update assign/remove docstrings to not reference system identities - Fix 'Manage Spatio' and 'Manage Geo Catalog' docstrings - Add identity remove help entry with example in _help.py

azure-client-tools-bot-prd bot added this to the April 2026 (2026-04-07) milestone Mar 28, 2026

thisisdevanshu force-pushed the add-planetarycomputer-extension branch from db78d69 to 1e77591 Compare March 28, 2026 00:15

yonzhan requested review from necusjz and yanzhudd March 28, 2026 01:27

yonzhan assigned necusjz Mar 28, 2026

thisisdevanshu force-pushed the add-planetarycomputer-extension branch from 3efdc0f to ad26d3e Compare March 28, 2026 02:11

thisisdevanshu-ms added 2 commits March 31, 2026 16:53

Sanitize test catalog names in recordings and test constants

f30b5f3

Restore inline examples in AAZ command docstrings

d248fb4

thisisdevanshu marked this pull request as ready for review April 1, 2026 00:14

Copilot AI review requested due to automatic review settings April 1, 2026 00:14

Copilot started reviewing on behalf of thisisdevanshu April 1, 2026 00:15 View session

Copilot AI reviewed Apr 1, 2026

View reviewed changes

thisisdevanshu-ms added 2 commits April 1, 2026 20:39

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Planetary Computer CLI extension#9737

Planetary Computer CLI extension#9737
thisisdevanshu wants to merge 5 commits intoAzure:mainfrom
thisisdevanshu:add-planetarycomputer-extension

thisisdevanshu commented Mar 28, 2026 •

edited

Loading

Uh oh!

azure-client-tools-bot-prd bot commented Mar 28, 2026

Uh oh!

azure-client-tools-bot-prd bot commented Mar 28, 2026

Uh oh!

yonzhan commented Mar 28, 2026

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Apr 1, 2026

Uh oh!

Uh oh!

Uh oh!

Copilot AI Apr 1, 2026

Uh oh!

Copilot AI Apr 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

thisisdevanshu commented Mar 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related command

General Guidelines

About Extension Publish

Uh oh!

azure-client-tools-bot-prd bot commented Mar 28, 2026

Uh oh!

azure-client-tools-bot-prd bot commented Mar 28, 2026

Uh oh!

yonzhan commented Mar 28, 2026

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

github-actions bot commented Mar 28, 2026

CodeGen Tools Feedback Collection

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 1, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

thisisdevanshu commented Mar 28, 2026 •

edited

Loading