Sync eng/common directory with azure-sdk-tools for PR 12867 (#6825)

Co-authored-by: jennypng <63012604+JennyPng@users.noreply.github.com>
This commit is contained in:
Azure SDK Bot 2025-11-13 09:46:53 -08:00 committed by GitHub
parent 5699876dd5
commit 75c821f7d2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -3,18 +3,17 @@ description: 'Verify Setup'
---
## Goal
This tool verifies the developer's environment for SDK development and release tasks. It returns what requirements are missing for the specified languages and repo.
This tool verifies the developer's environment for SDK development and release tasks. It returns what requirements are missing for the specified languages and repo, or success if all requirements are satisfied.
Your goal is to identify the project repo root, and pass in the `packagePath` to the Verify Setup tool. For a language repo, pass in the language of the repo.
## Examples
- in `azure-sdk-for-js`, run `azsdk_verify_setup` with `(langs=javascript, packagePath=<path>/azure-sdk-for-js)`.
- in `azure-sdk-for-python`, run `azsdk_verify_setup` with `(langs=python, packagePath=<path>/azure-sdk-for-python, venvPath=<path-to-venv>)`.
## Parameter Requirements
WHENEVER Python is included in `langs`, BEFORE RUNNING `azsdk_verify_setup`, you MUST ASK THE USER TO SPECIFY WHICH virtual environment they want to check. DO NOT ASSUME THE VENV WITHOUT ASKING THE USER. After obtaining the `venvPath`, you can run the tool.
The user can specify multiple languages to check. If the user wants to check all languages, pass in ALL supported languages and STILL ASK for a `venvPath`. Passing in no languages will only check the core requirements.
The user can specify multiple languages to check. If the user wants to check all languages, pass in ALL supported languages. Passing in no languages will only check the core requirements.
## Output
Display results in a user-friendly and concise format, highlighting any missing dependencies that need to be addressed.
Display results in a user-friendly and concise format, highlighting any missing dependencies that need to be addressed and how to resolve them.
WHENEVER Python related requirements fail, ALWAYS ASK the user if they have set the `AZSDKTOOLS_PYTHON_VENV_PATH` system environment variable to their desired virtual environment. This tool can only check requirements in the venv path specified by that environment variable.