azdev 0.1.66__tar.gz → 0.1.68__tar.gz

{azdev-0.1.66 → azdev-0.1.68}/HISTORY.rst

@@ -2,6 +2,14 @@
 
 Release History
 ===============
+0.1.68
+++++++
+* `azdev command-change tree-export`: Add new command to support export command tree of CLI modules.
+
+0.1.67
+++++++
+* `azdev extension cal-next-version`: Justify preview/exp tag operation based on last version's tag and next version's stable/preview tag.
+
 0.1.66
 ++++++
 * `azdev style`: Use azdev config files when .flake8 and pylintrc are not found in azure cli/ext repo.

{azdev-0.1.66/azdev.egg-info → azdev-0.1.68}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: azdev
-Version: 0.1.66
+Version: 0.1.68
 Summary: Microsoft Azure CLI Developer Tools
 Home-page: https://github.com/Azure/azure-cli-dev-tools
 Author: Microsoft Corporation
@@ -145,6 +145,14 @@ License
 
 Release History
 ===============
+0.1.68
+++++++
+* `azdev command-change tree-export`: Add new command to support export command tree of CLI modules.
+
+0.1.67
+++++++
+* `azdev extension cal-next-version`: Justify preview/exp tag operation based on last version's tag and next version's stable/preview tag.
+
 0.1.66
 ++++++
 * `azdev style`: Use azdev config files when .flake8 and pylintrc are not found in azure cli/ext repo.

{azdev-0.1.66 → azdev-0.1.68}/azdev/__init__.py

@@ -4,4 +4,4 @@
 # license information.
 # -----------------------------------------------------------------------------
 
-__VERSION__ = '0.1.66'
+__VERSION__ = '0.1.68'

{azdev-0.1.66 → azdev-0.1.68}/azdev/commands.py

@@ -40,6 +40,7 @@ def load_command_table(self, _):
     with CommandGroup(self, 'command-change', operation_group('command_change')) as g:
         g.command('meta-export', 'export_command_meta')
         g.command('meta-diff', 'cmp_command_meta')
+        g.command('tree-export', 'export_command_tree')
 
     with CommandGroup(self, 'cli', operation_group('pypi')) as g:
         g.command('check-versions', 'verify_versions')

{azdev-0.1.66 → azdev-0.1.68}/azdev/operations/command_change/__init__.py

@@ -12,7 +12,7 @@ from knack.log import get_logger
 import azure_cli_diff_tool
 from azdev.utilities import display, require_azure_cli, heading, get_path_table, filter_by_git_diff
 from .custom import DiffExportFormat, get_commands_meta, STORED_DEPRECATION_KEY
-from .util import export_commands_meta
+from .util import export_commands_meta, dump_command_tree, add_to_command_tree
 from ..statistics import _create_invoker_and_load_cmds, _get_command_source, \
     _command_codegen_info  # pylint: disable=protected-access
 from ..statistics.util import filter_modules
@@ -129,3 +129,60 @@ def export_command_meta(modules=None, git_source=None, git_target=None, git_repo
 
 def cmp_command_meta(base_meta_file, diff_meta_file, only_break=False, output_type="text", output_file=None):
     return azure_cli_diff_tool.meta_diff(base_meta_file, diff_meta_file, only_break, output_type, output_file)
+
+
+def export_command_tree(modules, output_file=None):
+    require_azure_cli()
+
+    # allow user to run only on CLI or extensions
+    cli_only = modules == ['CLI']
+    ext_only = modules == ['EXT']
+    if cli_only or ext_only:
+        modules = None
+
+    selected_modules = get_path_table(include_only=modules)
+
+    if cli_only:
+        selected_modules['ext'] = {}
+    if ext_only:
+        selected_modules['core'] = {}
+        selected_modules['mod'] = {}
+
+    if not any(selected_modules.values()):
+        logger.warning('No commands selected to check.')
+
+    selected_mod_names = list(selected_modules['mod'].keys())
+    selected_mod_names += list(selected_modules['ext'].keys())
+    selected_mod_names += list(selected_modules['core'].keys())
+
+    if selected_mod_names:
+        display('Modules selected: {}\n'.format(', '.join(selected_mod_names)))
+
+    heading('Export Command Tree')
+    start = time.time()
+    display('Initializing with loading command table...')
+    from azure.cli.core import get_default_cli  # pylint: disable=import-error
+    az_cli = get_default_cli()
+
+    # load commands, args, and help
+    _create_invoker_and_load_cmds(az_cli)
+
+    stop = time.time()
+    logger.info('Commands loaded in %i sec', stop - start)
+    display('Commands loaded in {} sec'.format(stop - start))
+    command_loader = az_cli.invocation.commands_loader
+
+    # trim command table to selected_modules
+    command_loader = filter_modules(command_loader, modules=selected_mod_names)
+
+    if not command_loader.command_table:
+        logger.warning('No commands selected to check.')
+
+    command_tree = {}
+
+    for command_name, command in command_loader.command_table.items():
+        module_source = _get_command_source(command_name, command)['module']
+        # The command tree is a tree structure like our azExtCmdTree: https://aka.ms/azExtCmdTree
+        add_to_command_tree(command_tree, command_name, module_source)
+
+    dump_command_tree(command_tree, output_file)

{azdev-0.1.66 → azdev-0.1.68}/azdev/operations/command_change/util.py

@@ -73,3 +73,18 @@ def export_commands_meta(commands_meta, meta_output_path=None):
             os.makedirs(file_folder)
         with open(file_name, "w") as f_out:
             f_out.write(jsbeautifier.beautify(json.dumps(module_info), options))
+
+
+def add_to_command_tree(tree, key, value):
+    parts = key.split()
+    subtree = tree
+    for part in parts[:-1]:
+        if not subtree.get(part):
+            subtree[part] = {}
+        subtree = subtree[part]
+    subtree[parts[-1]] = value
+
+
+def dump_command_tree(command_tree, output_file):
+    with open(output_file, 'w', encoding='utf-8') as f:
+        json.dump(command_tree, f, indent=4)

{azdev-0.1.66 → azdev-0.1.68}/azdev/operations/extensions/version_upgrade.py

@@ -195,12 +195,30 @@ class VersionUpgradeMod:
         except Exception as e:
             raise ValueError(str(e))
 
+    def gen_preview_exp_tags(self, res_dict):
+        """
+        if next_version is preview: due to doc generation requirement, preview tag is needed
+        1. preview tag need to be reserved which had previous preview tag, nothing to do
+        2. preview tag need to be added if previous version does not have preview tag
+
+        if next_version is stable:
+        remove previous existed preview tag
+
+        exp tag should be removed for stable/preview
+        """
+        if self.has_exp_tag:
+            res_dict["exp_tag"] = "remove"
+        if self.next_version.pre:
+            if not self.has_preview_tag:
+                res_dict["preview_tag"] = "add"
+        else:
+            if self.has_preview_tag:
+                res_dict["preview_tag"] = "remove"
+
     def format_outputs(self):
-        has_preview_tag = bool(self.next_version.pre and (self.has_preview_tag or self.has_exp_tag))
         result = {
             "version": str(self.next_version),
-            "is_stable": self.next_version.pre is None,
-            "has_preview_tag": has_preview_tag,
-            "has_exp_tag": False
+            "is_stable": self.next_version.pre is None
         }
+        self.gen_preview_exp_tags(result)
         return result

{azdev-0.1.66 → azdev-0.1.68}/azdev/params.py

@@ -129,6 +129,10 @@ def load_arguments(self, _):
                    help='format to print diff and suggest message')
         c.argument('output_file', help='command meta diff json file path to store')
 
+    with ArgumentsContext(self, 'command-change tree-export') as c:
+        c.positional('modules', modules_type)
+        c.argument('output_file', help='command tree json file path to store')
+
     # region cmdcov
     with ArgumentsContext(self, 'cmdcov') as c:
         c.positional('modules', modules_type)

{azdev-0.1.66 → azdev-0.1.68/azdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: azdev
-Version: 0.1.66
+Version: 0.1.68
 Summary: Microsoft Azure CLI Developer Tools
 Home-page: https://github.com/Azure/azure-cli-dev-tools
 Author: Microsoft Corporation
@@ -145,6 +145,14 @@ License
 
 Release History
 ===============
+0.1.68
+++++++
+* `azdev command-change tree-export`: Add new command to support export command tree of CLI modules.
+
+0.1.67
+++++++
+* `azdev extension cal-next-version`: Justify preview/exp tag operation based on last version's tag and next version's stable/preview tag.
+
 0.1.66
 ++++++
 * `azdev style`: Use azdev config files when .flake8 and pylintrc are not found in azure cli/ext repo.