azdev 0.2.8__tar.gz → 0.2.9__tar.gz

{azdev-0.2.8 → azdev-0.2.9}/HISTORY.rst

@@ -2,6 +2,10 @@
 
 Release History
 ===============
+0.2.9
++++++
+* `azdev latest-index`: Add `generate` and `verify` commands to manage Azure CLI packaged latest indices (`commandIndex.latest.json`, `helpIndex.latest.json`) with CI-friendly verify exit behavior.
+
 0.2.8
 ++++++
 * Pin pip to 25.2 as pip 25.3 remove support for the legacy setup.py develop editable method in setuptools editable installs; setuptools >= 64 is now required. (#11457)

{azdev-0.2.8/azdev.egg-info → azdev-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: azdev
-Version: 0.2.8
+Version: 0.2.9
 Summary: Microsoft Azure CLI Developer Tools
 Home-page: https://github.com/Azure/azure-cli-dev-tools
 Author: Microsoft Corporation
@@ -122,6 +122,49 @@ Setting up your development environment
 
     This will launch the interactive setup process. To see non-interactive options run `azdev setup -h`.
 
+Latest packaged indices
++++++++++++++++++++++++
+
+Use azdev wrappers around Azure CLI's latest index generation script:
+
+::
+
+    azdev latest-index generate
+    azdev latest-index verify
+
+You can pass an explicit Azure CLI checkout path when needed:
+
+::
+
+    azdev latest-index generate --cli /path/to/azure-cli
+    azdev latest-index verify --repo /path/to/azure-cli
+
+``azdev latest-index verify`` exits non-zero when generated output differs from checked-in
+``commandIndex.latest.json`` or ``helpIndex.latest.json``.
+
+Common azdev commands
++++++++++++++++++++++++++++++
+
+This README is not an exhaustive command reference. For the complete command surface, use:
+
+::
+
+    azdev --help
+    azdev <group> --help
+
+Frequently used commands include:
+
+::
+
+    azdev setup
+    azdev style <module-or-extension>
+    azdev linter <module-or-extension>
+    azdev test <module-or-extension>
+    azdev extension add <extension-name>
+    azdev extension build <extension-name>
+    azdev latest-index generate
+    azdev latest-index verify
+
 Reporting issues and feedback
 +++++++++++++++++++++++++++++
 
@@ -160,6 +203,10 @@ License
 
 Release History
 ===============
+0.2.9
++++++
+* `azdev latest-index`: Add `generate` and `verify` commands to manage Azure CLI packaged latest indices (`commandIndex.latest.json`, `helpIndex.latest.json`) with CI-friendly verify exit behavior.
+
 0.2.8
 ++++++
 * Pin pip to 25.2 as pip 25.3 remove support for the legacy setup.py develop editable method in setuptools editable installs; setuptools >= 64 is now required. (#11457)

{azdev-0.2.8 → azdev-0.2.9}/README.md

@@ -148,6 +148,25 @@ For instructions on manually writing the commands and tests, see more in
 
     By default, test is running in `once` mode. If there are no corresponding recording files (in yaml format), it will run live tests and generate recording files. If recording files are found, the tests will be run in `playback` mode against the recording files. You can use `--live` to force a test run in `live` mode and regenerate the recording files.
 
+## Latest packaged indices
+
+Use azdev wrappers around Azure CLI's latest index generation script:
+
+```
+azdev latest-index generate
+azdev latest-index verify
+```
+
+You can pass an explicit Azure CLI checkout path when needed:
+
+```
+azdev latest-index generate --cli /path/to/azure-cli
+azdev latest-index verify --repo /path/to/azure-cli
+```
+
+`azdev latest-index verify` exits non-zero when generated output differs from the checked-in
+`commandIndex.latest.json` or `helpIndex.latest.json`, making it CI-friendly.
+
 ## Submitting a pull request to merge the code
 
 1. After committing your code locally, push it to your forked repository:

{azdev-0.2.8 → azdev-0.2.9}/README.rst

@@ -66,6 +66,49 @@ Setting up your development environment
 
     This will launch the interactive setup process. To see non-interactive options run `azdev setup -h`.
 
+Latest packaged indices
++++++++++++++++++++++++
+
+Use azdev wrappers around Azure CLI's latest index generation script:
+
+::
+
+    azdev latest-index generate
+    azdev latest-index verify
+
+You can pass an explicit Azure CLI checkout path when needed:
+
+::
+
+    azdev latest-index generate --cli /path/to/azure-cli
+    azdev latest-index verify --repo /path/to/azure-cli
+
+``azdev latest-index verify`` exits non-zero when generated output differs from checked-in
+``commandIndex.latest.json`` or ``helpIndex.latest.json``.
+
+Common azdev commands
++++++++++++++++++++++++++++++
+
+This README is not an exhaustive command reference. For the complete command surface, use:
+
+::
+
+    azdev --help
+    azdev <group> --help
+
+Frequently used commands include:
+
+::
+
+    azdev setup
+    azdev style <module-or-extension>
+    azdev linter <module-or-extension>
+    azdev test <module-or-extension>
+    azdev extension add <extension-name>
+    azdev extension build <extension-name>
+    azdev latest-index generate
+    azdev latest-index verify
+
 Reporting issues and feedback
 +++++++++++++++++++++++++++++
 

{azdev-0.2.8 → azdev-0.2.9}/azdev/__init__.py

@@ -4,4 +4,4 @@
 # license information.
 # -----------------------------------------------------------------------------
 
-__VERSION__ = '0.2.8'
+__VERSION__ = '0.2.9'

{azdev-0.2.8 → azdev-0.2.9}/azdev/commands.py

@@ -82,6 +82,10 @@ def load_command_table(self, _):
     with CommandGroup(self, 'cli', operation_group('help')) as g:
         g.command('generate-docs', 'generate_cli_ref_docs')
 
+    with CommandGroup(self, 'latest-index', operation_group('latest_index')) as g:
+        g.command('generate', 'generate_latest_index')
+        g.command('verify', 'verify_latest_index')
+
     with CommandGroup(self, 'extension', operation_group('help')) as g:
         g.command('generate-docs', 'generate_extension_ref_docs')
 

{azdev-0.2.8 → azdev-0.2.9}/azdev/help.py

@@ -99,6 +99,34 @@ helps['verify history'] = """
     short-summary: Verify the README and HISTORY files for each module so they format correctly on PyPI.
 """
 
+helps['latest-index'] = """
+    short-summary: Generate or verify Azure CLI packaged latest index files.
+    long-summary: >
+        Wraps azure-cli's scripts/generate_latest_indices.py for deterministic, CI-friendly
+        generation and verification of commandIndex.latest.json and helpIndex.latest.json.
+"""
+
+helps['latest-index generate'] = """
+    short-summary: Generate commandIndex.latest.json and helpIndex.latest.json in an Azure CLI repo.
+    examples:
+        - name: Generate latest index files using the configured Azure CLI repo.
+          text: azdev latest-index generate
+
+        - name: Generate latest index files for an explicit repo checkout.
+          text: azdev latest-index generate --cli /path/to/azure-cli
+"""
+
+helps['latest-index verify'] = """
+    short-summary: Verify latest index files are up-to-date.
+    long-summary: Returns a non-zero exit code when generated content differs from checked-in files.
+    examples:
+        - name: Verify latest index files in CI.
+          text: azdev latest-index verify
+
+        - name: Verify latest index files for an explicit repo checkout.
+          text: azdev latest-index verify --repo /path/to/azure-cli
+"""
+
 
 helps['style'] = """
     short-summary: Check code style (pylint and PEP8).

azdev-0.2.9/azdev/operations/latest_index.py

@@ -0,0 +1,71 @@
+# -----------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# -----------------------------------------------------------------------------
+
+import os
+import sys
+
+from knack.util import CLIError
+
+from azdev.utilities import display, heading, py_cmd
+from azdev.utilities.path import get_cli_repo_path
+
+
+_LATEST_INDEX_SCRIPT = os.path.join('scripts', 'generate_latest_indices.py')
+
+
+def _resolve_cli_repo_path(cli_path):
+    if cli_path:
+        resolved = os.path.abspath(os.path.expanduser(cli_path))
+    else:
+        resolved = get_cli_repo_path()
+
+    if not resolved or resolved == '_NONE_':
+        raise CLIError('Azure CLI repo path is not configured. Specify `--cli` or run `azdev setup`.')
+
+    if not os.path.isdir(resolved):
+        raise CLIError('Azure CLI repo path does not exist: {}'.format(resolved))
+
+    return resolved
+
+
+def _run_latest_index(mode, cli_path=None, profile='latest', all_profiles=False):
+    if all_profiles:
+        raise CLIError('`--all-profiles` is not supported yet. Use `--profile latest`.')
+
+    if profile != 'latest':
+        raise CLIError("Unsupported profile '{}'. Only `latest` is currently supported.".format(profile))
+
+    repo_path = _resolve_cli_repo_path(cli_path)
+    script_path = os.path.join(repo_path, _LATEST_INDEX_SCRIPT)
+    if not os.path.isfile(script_path):
+        raise CLIError('Unable to find azure-cli script: {}'.format(script_path))
+
+    heading('Latest Index: {}'.format(mode.capitalize()))
+    display('Azure CLI repo: {}'.format(repo_path))
+
+    command = '{} {}'.format(_LATEST_INDEX_SCRIPT, mode)
+    result = py_cmd(command, is_module=False, cwd=repo_path)
+
+    output = result.result
+    if isinstance(output, bytes):
+        output = output.decode('utf-8', errors='replace')
+    if output:
+        output = output.replace(
+            'python scripts/generate_latest_indices.py generate',
+            'azdev latest-index generate'
+        )
+        display(output)
+
+    if result.exit_code:
+        sys.exit(result.exit_code)
+
+
+def generate_latest_index(cli_path=None, profile='latest', all_profiles=False):
+    _run_latest_index('generate', cli_path=cli_path, profile=profile, all_profiles=all_profiles)
+
+
+def verify_latest_index(cli_path=None, profile='latest', all_profiles=False):
+    _run_latest_index('verify', cli_path=cli_path, profile=profile, all_profiles=all_profiles)

{azdev-0.2.8 → azdev-0.2.9}/azdev/params.py

@@ -282,3 +282,11 @@ def load_arguments(self, _):
         c.argument('no_tail', action='store_true', help='Skip tail when displaying as markdown.')
         c.argument('include_whl_extensions', action='store_true',
                    help="Allow scanning on extensions installed by `az extension add --source xxx.whl`.")
+
+    with ArgumentsContext(self, 'latest-index') as c:
+        c.argument('cli_path', options_list=['--cli', '--repo'],
+                   help='Path to an Azure CLI repo checkout. If omitted, use the path configured by `azdev setup`.')
+        c.argument('profile', choices=['latest'], default='latest',
+                   help='Cloud profile to process. Only `latest` is currently supported.')
+        c.argument('all_profiles', action='store_true',
+                   help='Not supported yet. Reserved for future multi-profile support.')

{azdev-0.2.8 → azdev-0.2.9/azdev.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: azdev
-Version: 0.2.8
+Version: 0.2.9
 Summary: Microsoft Azure CLI Developer Tools
 Home-page: https://github.com/Azure/azure-cli-dev-tools
 Author: Microsoft Corporation
@@ -122,6 +122,49 @@ Setting up your development environment
 
     This will launch the interactive setup process. To see non-interactive options run `azdev setup -h`.
 
+Latest packaged indices
++++++++++++++++++++++++
+
+Use azdev wrappers around Azure CLI's latest index generation script:
+
+::
+
+    azdev latest-index generate
+    azdev latest-index verify
+
+You can pass an explicit Azure CLI checkout path when needed:
+
+::
+
+    azdev latest-index generate --cli /path/to/azure-cli
+    azdev latest-index verify --repo /path/to/azure-cli
+
+``azdev latest-index verify`` exits non-zero when generated output differs from checked-in
+``commandIndex.latest.json`` or ``helpIndex.latest.json``.
+
+Common azdev commands
++++++++++++++++++++++++++++++
+
+This README is not an exhaustive command reference. For the complete command surface, use:
+
+::
+
+    azdev --help
+    azdev <group> --help
+
+Frequently used commands include:
+
+::
+
+    azdev setup
+    azdev style <module-or-extension>
+    azdev linter <module-or-extension>
+    azdev test <module-or-extension>
+    azdev extension add <extension-name>
+    azdev extension build <extension-name>
+    azdev latest-index generate
+    azdev latest-index verify
+
 Reporting issues and feedback
 +++++++++++++++++++++++++++++
 
@@ -160,6 +203,10 @@ License
 
 Release History
 ===============
+0.2.9
++++++
+* `azdev latest-index`: Add `generate` and `verify` commands to manage Azure CLI packaged latest indices (`commandIndex.latest.json`, `helpIndex.latest.json`) with CI-friendly verify exit behavior.
+
 0.2.8
 ++++++
 * Pin pip to 25.2 as pip 25.3 remove support for the legacy setup.py develop editable method in setuptools editable installs; setuptools >= 64 is now required. (#11457)

{azdev-0.2.8 → azdev-0.2.9}/azdev.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ azdev/mod_templates/test_service_scenario.py
 azdev/operations/__init__.py
 azdev/operations/code_gen.py
 azdev/operations/constant.py
+azdev/operations/latest_index.py
 azdev/operations/legal.py
 azdev/operations/performance.py
 azdev/operations/pypi.py