Planetary Computer CLI extension

src/planetarycomputer/HISTORY.rst

@@ -0,0 +1,8 @@
+.. :changelog:
+
+Release History
+===============
+
+1.0.0b1
+++++++
+* Initial release.

src/planetarycomputer/README.md

@@ -0,0 +1,47 @@
+# Azure CLI Planetary Computer Extension #
+This is an extension to Azure CLI to manage Planetary Computer GeoCatalog resources.
+
+## How to use ##
+
+### Install the extension ###
+```bash
+az extension add --name planetarycomputer
+```
+
+### Commands ###
+
+#### GeoCatalog Management ####
+```bash
+# Create a GeoCatalog
+az planetarycomputer geocatalog create -g MyResourceGroup -n MyCatalog -l eastus
+
+# Show a GeoCatalog
+az planetarycomputer geocatalog show -g MyResourceGroup -n MyCatalog
+
+# List GeoCatalogs in a resource group
+az planetarycomputer geocatalog list -g MyResourceGroup
+
+# List all GeoCatalogs in a subscription
+az planetarycomputer geocatalog list
+
+# Update tags on a GeoCatalog
+az planetarycomputer geocatalog update -g MyResourceGroup -n MyCatalog --tags env=prod
+
+# Delete a GeoCatalog
+az planetarycomputer geocatalog delete -g MyResourceGroup -n MyCatalog
+
+# Wait for a GeoCatalog to reach a desired state
+az planetarycomputer geocatalog wait -g MyResourceGroup -n MyCatalog --created
+```
+
+#### GeoCatalog Identity Management ####
+```bash
+# Assign a user-assigned managed identity
+az planetarycomputer geocatalog identity assign -g MyResourceGroup -n MyCatalog --user-assigned /subscriptions/<subscription-id>/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity
+
+# Show identity information
+az planetarycomputer geocatalog identity show -g MyResourceGroup -n MyCatalog
+
+# Remove a user-assigned managed identity
+az planetarycomputer geocatalog identity remove -g MyResourceGroup -n MyCatalog --user-assigned /subscriptions/<subscription-id>/resourceGroups/MyResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity
+```

src/planetarycomputer/azext_planetarycomputer/__init__.py

@@ -0,0 +1,42 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+from azure.cli.core import AzCommandsLoader
+from azext_planetarycomputer._help import helps  # pylint: disable=unused-import
+
+
+class PlanetarycomputerCommandsLoader(AzCommandsLoader):
+
+    def __init__(self, cli_ctx=None):
+        from azure.cli.core.commands import CliCommandType
+        custom_command_type = CliCommandType(
+            operations_tmpl='azext_planetarycomputer.custom#{}')
+        super().__init__(cli_ctx=cli_ctx,
+                         custom_command_type=custom_command_type)
+
+    def load_command_table(self, args):
+        from azext_planetarycomputer.commands import load_command_table
+        from azure.cli.core.aaz import load_aaz_command_table
+        try:
+            from . import aaz
+        except ImportError:
+            aaz = None
+        if aaz:
+            load_aaz_command_table(
+                loader=self,
+                aaz_pkg_name=aaz.__name__,
+                args=args
+            )
+        load_command_table(self, args)
+        return self.command_table
+
+    def load_arguments(self, command):
+        from azext_planetarycomputer._params import load_arguments
+        load_arguments(self, command)
+
+
+COMMAND_LOADER_CLS = PlanetarycomputerCommandsLoader

src/planetarycomputer/azext_planetarycomputer/_help.py

@@ -0,0 +1,68 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: disable=line-too-long
+# pylint: disable=too-many-lines
+
+from knack.help_files import helps  # pylint: disable=unused-import
+
+helps['planetarycomputer'] = """
+    type: group
+    short-summary: Manage Planetary Computer resources.
+"""
+
+helps['planetarycomputer geocatalog'] = """
+    type: group
+    short-summary: Manage Planetary Computer GeoCatalog resources.
+"""
+
+helps['planetarycomputer geocatalog create'] = """
+    type: command
+    short-summary: Create a GeoCatalog.
+    examples:
+        - name: Create a GeoCatalog with default settings
+          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}"
+"""
+
+helps['planetarycomputer geocatalog update'] = """
+    type: command
+    short-summary: Update a GeoCatalog.
+    examples:
+        - name: Update tags on a GeoCatalog
+          text: |-
+            az planetarycomputer geocatalog update -g MyResourceGroup -n MyCatalog --tags env=prod team=platform
+"""
+
+helps['planetarycomputer geocatalog identity'] = """
+    type: group
+    short-summary: Manage identities for a Planetary Computer GeoCatalog.
+"""
+
+helps['planetarycomputer geocatalog identity assign'] = """
+    type: command
+    short-summary: Assign an identity to a GeoCatalog.
+    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}"
+"""
+
+helps['planetarycomputer geocatalog identity remove'] = """
+    type: command
+    short-summary: Remove an identity from a GeoCatalog.
+    examples:
+        - name: Remove a user-assigned managed identity
+          text: |-
+            az planetarycomputer geocatalog identity remove -g MyResourceGroup -n MyCatalog \\
+                --user-assigned "/subscriptions/{sub}/resourcegroups/{rg}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{name}"
+"""

src/planetarycomputer/azext_planetarycomputer/_params.py

@@ -0,0 +1,13 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: disable=too-many-lines
+# pylint: disable=too-many-statements
+
+
+def load_arguments(self, _):  # pylint: disable=unused-argument
+    pass

src/planetarycomputer/azext_planetarycomputer/aaz/__init__.py

@@ -0,0 +1,6 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------

src/planetarycomputer/azext_planetarycomputer/aaz/latest/__init__.py

@@ -0,0 +1,10 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/__cmd_group.py

@@ -0,0 +1,23 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from azure.cli.core.aaz import *
+
+
+@register_command_group(
+    "planetarycomputer",
+)
+class __CMDGroup(AAZCommandGroup):
+    """Manage Planetary Computer resources.
+    """
+    pass
+
+
+__all__ = ["__CMDGroup"]

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/__init__.py

@@ -0,0 +1,11 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from .__cmd_group import *

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/__cmd_group.py

@@ -0,0 +1,23 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from azure.cli.core.aaz import *
+
+
+@register_command_group(
+    "planetarycomputer geocatalog",
+)
+class __CMDGroup(AAZCommandGroup):
+    """Manage GeoCatalog
+    """
+    pass
+
+
+__all__ = ["__CMDGroup"]

src/planetarycomputer/azext_planetarycomputer/aaz/latest/spatio/geo_catalog/__init__.py

@@ -0,0 +1,17 @@
+# --------------------------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for license information.
+#
+# Code generated by aaz-dev-tools
+# --------------------------------------------------------------------------------------------
+
+# pylint: skip-file
+# flake8: noqa
+
+from .__cmd_group import *
+from ._create import *
+from ._delete import *
+from ._list import *
+from ._show import *
+from ._update import *
+from ._wait import *