81 lines (50 loc) · 2.05 KB

Development setup

Install pre-reqs

Install Python 3.5 or later from python.org, apt-get, or some other installer.
Install Virtual Python Environment (virtualenv):
```
pip install virtualenv
```

Get the source

Clone the Azure Devops CLI extension repository.

git clone https://github.com/Microsoft/azure-devops-cli-extension

Checkout master branch.
```
git checkout master
```

Create a virtual environment

From the azure-devops-cli-extension directory, create a new virtual environment:
```
virtualenv env
```
Activate the new virtual environment:

On Linux:
```
source env/bin/activate
```
On Windows:
```
env\Scripts\activate.bat
```
Run the dev_setup.py script to install the Azure Devops CLI packages and other dependencies into your virtual environment:
```
python scripts/dev_setup.py
```

Developing

Run az extension list and az devops -h to verify your environment is setup properly.

Follow instructions to install powershell from here
dev_setup.py script has already set your AZURE_EXTENSION_DIR environment variable to .azure\devcliextensions directory that will hold the extensions being developed

On Windows

Run below command any time you make changes to your extension and want to see them reflected in the CLI.
```
pip install --upgrade --target %AZURE_EXTENSION_DIR%\azure-devops Dev\azure-devops-cli-extension\azure-devops
```
- %AZURE_EXTENSION_DIR%\azure-devops is the directory pip will install the extension to.
- Dev\azure-devops-cli-extension\azure-devops is the directory with the source code of your extension.
On Linux
```
pip install --upgrade --target $AZURE_EXTENSION_DIR/azure-devops Dev\azure-devops-cli-extension\azure-devops/
```
Run az devops -h again to verify if extension is installed properly.