[Az CLI Min Version Updated] Mark Preview using new Knack feature (#685)

* Mark Preview using new Knack feature

* Setting minimum version to 2.0.69 which fixed a issue with git bash and preview kwarg

Author: atbagga

README.md

@@ -8,7 +8,7 @@ The Azure DevOps Extension for Azure CLI adds Pipelines, Boards, Repos, Artifact
 
 ## Quick start
 
-1. [Install the Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli). You must have at least `v2.0.49`, which you can verify with `az --version` command.
+1. [Install the Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli). You must have at least `v2.0.69`, which you can verify with `az --version` command.
 
 1. Add the Azure DevOps Extension `az extension add --name azure-devops`
 

azure-devops/azext_devops/azext_metadata.json

@@ -1,3 +1,3 @@
 {
-    "azext.minCliCoreVersion": "2.0.49"
+    "azext.minCliCoreVersion": "2.0.69"
 }

azure-devops/azext_devops/dev/boards/_help.py

@@ -27,19 +27,19 @@ def load_boards_help():
 
     helps['boards iteration'] = """
     type: group
-    short-summary: (PREVIEW) Manage iterations.
+    short-summary: Manage iterations.
     long-summary:
     """
 
     helps['boards iteration team'] = """
     type: group
-    short-summary: (PREVIEW) Manage iterations for a team.
+    short-summary: Manage iterations for a team.
     long-summary:
     """
 
     helps['boards iteration project'] = """
     type: group
-    short-summary: (PREVIEW) Manage iterations for a project.
+    short-summary: Manage iterations for a project.
     long-summary:
     """
 
@@ -50,13 +50,13 @@ def load_boards_help():
 
     helps['boards area'] = """
     type: group
-    short-summary: (PREVIEW) Manage area paths.
+    short-summary: Manage area paths.
     long-summary:
     """
 
     helps['boards area project'] = """
     type: group
-    short-summary: (PREVIEW) Manage areas for a project.
+    short-summary: Manage areas for a project.
     long-summary:
     """
 
@@ -67,7 +67,7 @@ def load_boards_help():
 
     helps['boards area team'] = """
     type: group
-    short-summary: (PREVIEW) Manage areas for a team.
+    short-summary: Manage areas for a team.
     long-summary:
     """
 

azure-devops/azext_devops/dev/boards/area.py

@@ -17,7 +17,7 @@
 
 
 def get_project_areas(depth=1, path=None, organization=None, project=None, detect=None):
-    """(PREVIEW) List areas for a project.
+    """List areas for a project.
     :param depth: Depth of child nodes to be fetched. Example: --depth 3
     :type depth: int
     """
@@ -34,7 +34,7 @@ def get_project_areas(depth=1, path=None, organization=None, project=None, detec
 
 
 def delete_project_area(path, organization=None, project=None, detect=None):
-    """(PREVIEW) Delete area.
+    """Delete area.
     """
     organization, project = resolve_instance_and_project(detect=detect,
                                                          organization=organization,
@@ -48,7 +48,7 @@ def delete_project_area(path, organization=None, project=None, detect=None):
 
 
 def create_project_area(name, path=None, organization=None, project=None, detect=None):
-    """(PREVIEW) Create area.
+    """Create area.
     :param name: Name of the area.
     :type: str
     """
@@ -68,7 +68,7 @@ def create_project_area(name, path=None, organization=None, project=None, detect
 
 
 def get_project_area(id, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Show area details for a project.
+    """Show area details for a project.
     :param id: Area ID.
     :type id: int
     """
@@ -83,7 +83,7 @@ def get_project_area(id, organization=None, project=None, detect=None):  # pylin
 
 
 def update_project_area(path, name=None, child_id=None, organization=None, project=None, detect=None):
-    """(PREVIEW) Update area.
+    """Update area.
     :param name: New name of the area.
     :type: str
     :param child_id: Move an existing area and add as child node for this area.
@@ -116,7 +116,7 @@ def update_project_area(path, name=None, child_id=None, organization=None, proje
 
 
 def get_team_areas(team, organization=None, project=None, detect=None):
-    """(PREVIEW) List areas for a team.
+    """List areas for a team.
     """
     organization, project = resolve_instance_and_project(detect=detect,
                                                          organization=organization,
@@ -129,7 +129,7 @@ def get_team_areas(team, organization=None, project=None, detect=None):
 
 def add_team_area(path, team, set_as_default=False, include_sub_areas=None,
                   organization=None, project=None, detect=None):
-    """(PREVIEW) Add area to a team.
+    """Add area to a team.
     :param set_as_default: Set this area path as default area for this team. Default: False
     :type set_as_default: bool
     """
@@ -157,7 +157,7 @@ def add_team_area(path, team, set_as_default=False, include_sub_areas=None,
 
 
 def remove_team_area(path, team, organization=None, project=None, detect=None):
-    """(PREVIEW) Remove area from a team.
+    """Remove area from a team.
     """
     organization, project = resolve_instance_and_project(detect=detect,
                                                          organization=organization,
@@ -189,7 +189,7 @@ def remove_team_area(path, team, organization=None, project=None, detect=None):
 
 def update_team_area(path, team, include_sub_areas=None, set_as_default=False,
                      organization=None, project=None, detect=None):
-    """(PREVIEW) Update team area.
+    """Update team area.
     :param set_as_default: Set as default team area path. Default: False
     :type set_as_default: bool
     """

azure-devops/azext_devops/dev/boards/commands.py

@@ -62,52 +62,50 @@ def load_work_commands(self, _):
                   confirmation='Are you sure you want to remove this relation(s)?')
         g.command('relation show', 'show_work_item', table_transformer=transform_work_item_relations)
 
-    with self.command_group('boards iteration team', command_type=workProjectAndTeamIterationOps) as g:
+    with self.command_group('boards iteration', command_type=workProjectAndTeamIterationOps, is_preview=True) as g:
         # team iteration commands
-        g.command('list', 'get_team_iterations', table_transformer=transform_work_item_team_iterations_table_output)
-        g.command('list-work-items', 'list_iteration_work_items',
+        g.command('team list', 'get_team_iterations',
+                  table_transformer=transform_work_item_team_iterations_table_output)
+        g.command('team list-work-items', 'list_iteration_work_items',
                   table_transformer=transform_work_item_team_iteration_work_items)
-        g.command('set-default-iteration', 'set_default_iteration',
+        g.command('team set-default-iteration', 'set_default_iteration',
                   table_transformer=transform_work_item_team_default_iteration_table_output)
-        g.command('set-backlog-iteration', 'set_backlog_iteration',
+        g.command('team set-backlog-iteration', 'set_backlog_iteration',
                   table_transformer=transform_work_item_team_backlog_iteration_table_output)
-        g.command('show-default-iteration', 'show_default_iteration',
+        g.command('team show-default-iteration', 'show_default_iteration',
                   table_transformer=transform_work_item_team_default_iteration_table_output)
-        g.command('show-backlog-iteration', 'show_backlog_iteration',
+        g.command('team show-backlog-iteration', 'show_backlog_iteration',
                   table_transformer=transform_work_item_team_backlog_iteration_table_output)
-        g.command('remove', 'delete_team_iteration', table_transformer=transform_work_item_team_iteration_table_output)
-        g.command('add', 'post_team_iteration', table_transformer=transform_work_item_team_iteration_table_output)
-
-    with self.command_group('boards iteration project', command_type=workProjectAndTeamIterationOps) as g:
+        g.command('team remove', 'delete_team_iteration',
+                  table_transformer=transform_work_item_team_iteration_table_output)
+        g.command('team add', 'post_team_iteration', table_transformer=transform_work_item_team_iteration_table_output)
         # team iteration commands
-        g.command('list', 'get_project_iterations',
+        g.command('project list', 'get_project_iterations',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
-        g.command('update', 'update_project_iteration',
+        g.command('project update', 'update_project_iteration',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
-        g.command('delete', 'delete_project_iteration',
+        g.command('project delete', 'delete_project_iteration',
                   confirmation='Are you sure you want to delete this iteration?')
-        g.command('show', 'get_project_iteration',
+        g.command('project show', 'get_project_iteration',
                   table_transformer=transform_work_item_project_classification_node_table_output)
-        g.command('create', 'create_project_iteration',
+        g.command('project create', 'create_project_iteration',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
 
-    with self.command_group('boards area project', command_type=workProjectAndTeamAreaOps) as g:
+    with self.command_group('boards area', command_type=workProjectAndTeamAreaOps, is_preview=True) as g:
         # team iteration commands
-        g.command('list', 'get_project_areas',
+        g.command('project list', 'get_project_areas',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
-        g.command('delete', 'delete_project_area',
+        g.command('project delete', 'delete_project_area',
                   confirmation='Are you sure you want to delete this area?')
-        g.command('create', 'create_project_area',
+        g.command('project create', 'create_project_area',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
-        g.command('update', 'update_project_area',
+        g.command('project update', 'update_project_area',
                   table_transformer=transform_work_item_project_classification_nodes_table_output)
-        g.command('show', 'get_project_area',
+        g.command('project show', 'get_project_area',
                   table_transformer=transform_work_item_project_classification_node_table_output)
-
-    with self.command_group('boards area team', command_type=workProjectAndTeamAreaOps) as g:
         # team iteration commands
-        g.command('list', 'get_team_areas', table_transformer=transform_work_item_team_areas_table_output)
-        g.command('add', 'add_team_area', table_transformer=transform_work_item_team_areas_table_output)
-        g.command('remove', 'remove_team_area', table_transformer=transform_work_item_team_areas_table_output)
-        g.command('update', 'update_team_area',
+        g.command('team list', 'get_team_areas', table_transformer=transform_work_item_team_areas_table_output)
+        g.command('team add', 'add_team_area', table_transformer=transform_work_item_team_areas_table_output)
+        g.command('team remove', 'remove_team_area', table_transformer=transform_work_item_team_areas_table_output)
+        g.command('team update', 'update_team_area',
                   table_transformer=transform_work_item_team_areas_table_output)

azure-devops/azext_devops/dev/boards/iteration.py

@@ -23,7 +23,7 @@
 
 
 def get_project_iterations(depth=1, path=None, organization=None, project=None, detect=None):
-    """(PREVIEW) List iterations for a project.
+    """List iterations for a project.
     :param depth: Depth of child nodes to be fetched. Example: --depth 3.
     :type depth: int
     """
@@ -41,7 +41,7 @@ def get_project_iterations(depth=1, path=None, organization=None, project=None,
 
 def update_project_iteration(path, child_id=None, name=None, start_date=None,
                              finish_date=None, organization=None, project=None, detect=None):
-    """(PREVIEW) Update project iteration.
+    """Update project iteration.
     :param name: New name of the iteration.
     :type: str
     :param child_id: Move an existing iteration and add as child node for this iteration.
@@ -86,7 +86,7 @@ def update_project_iteration(path, child_id=None, name=None, start_date=None,
 
 
 def delete_project_iteration(path, organization=None, project=None, detect=None):
-    """(PREVIEW) Delete iteration.
+    """Delete iteration.
     """
     organization, project = resolve_instance_and_project(detect=detect,
                                                          organization=organization,
@@ -100,7 +100,7 @@ def delete_project_iteration(path, organization=None, project=None, detect=None)
 
 
 def get_project_iteration(id, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Show iteration details for a project.
+    """Show iteration details for a project.
     :param id: Iteration ID.
     :type id: int
     """
@@ -116,7 +116,7 @@ def get_project_iteration(id, organization=None, project=None, detect=None):  #
 
 def create_project_iteration(name, path=None, start_date=None, finish_date=None,
                              organization=None, project=None, detect=None):
-    """(PREVIEW) Create iteration.
+    """Create iteration.
     :param name: Name of the iteration.
     :type: str
     """
@@ -150,7 +150,7 @@ def create_project_iteration(name, path=None, start_date=None, finish_date=None,
 
 
 def get_team_iterations(team, timeframe=None, organization=None, project=None, detect=None):
-    """(PREVIEW) List iterations for a team.
+    """List iterations for a team.
     :param team: The name or id of the team.
     :type team: str
     :param timeframe: A filter for which iterations are returned based on relative time.
@@ -168,7 +168,7 @@ def get_team_iterations(team, timeframe=None, organization=None, project=None, d
 
 
 def delete_team_iteration(id, team, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Remove iteration from a team.
+    """Remove iteration from a team.
     :param id: Identifier of the iteration.
     :type: str
     :param team: Name or ID of the team.
@@ -185,7 +185,7 @@ def delete_team_iteration(id, team, organization=None, project=None, detect=None
 
 
 def post_team_iteration(id, team, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Add iteration to a team.
+    """Add iteration to a team.
     :param id: Identifier of the iteration.
     :type: str
     :param team: Name or ID of the team.
@@ -203,7 +203,7 @@ def post_team_iteration(id, team, organization=None, project=None, detect=None):
 
 
 def list_iteration_work_items(id, team, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) List work-items for an iteration.
+    """List work-items for an iteration.
     :param id: Identifier of the iteration.
     :type: str
     :param team: Name or ID of the team.
@@ -221,7 +221,7 @@ def list_iteration_work_items(id, team, organization=None, project=None, detect=
 
 
 def set_default_iteration(team, id=None, default_iteration_macro=None, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Set default iteration for a team.
+    """Set default iteration for a team.
     :param id: Identifier of the iteration which needs to be set as default.
     :type: str
     :param team: Name or ID of the team.
@@ -244,7 +244,7 @@ def set_default_iteration(team, id=None, default_iteration_macro=None, organizat
 
 
 def set_backlog_iteration(team, id, organization=None, project=None, detect=None):  # pylint: disable=redefined-builtin
-    """(PREVIEW) Set backlog iteration for a team.
+    """Set backlog iteration for a team.
     :param id: Identifier of the iteration which needs to be set as backlog iteration.
     :type: str
     :param team: Name or ID of the team.
@@ -260,7 +260,7 @@ def set_backlog_iteration(team, id, organization=None, project=None, detect=None
 
 
 def show_default_iteration(team, organization=None, project=None, detect=None):
-    """(PREVIEW) Show default iteration for a team.
+    """Show default iteration for a team.
     :param team: Name or ID of the team.
     :type: str
     """
@@ -272,7 +272,7 @@ def show_default_iteration(team, organization=None, project=None, detect=None):
 
 
 def show_backlog_iteration(team, organization=None, project=None, detect=None):
-    """(PREVIEW) Show backlog iteration for a team.
+    """Show backlog iteration for a team.
     :param team: Name or ID of the team.
     :type: str
     """