yokawasa/azure-shell

[Unofficial] interactive Azure CLI 2.0 command line interface

azure-shell

An interactive Azure CLI 2.0 command line interface.

[Note] Microsoft official Azure CLI 2.0 shell can be found at Azure/azure-cli-shell

Features

• Auto-completion of Azure CLI group, subgroups, commands, and parameters
• Syntax highlighting
• Command history

Supported Environments

• Python versions: 2.7, 3.3, 3.4, 3.5, 3.5, 3.6 and maybe more
• OS: Mac, Ubuntu, CentOS, Bash-on-Windows, or any platform where azure-cli can be installed

Prerequisites

You need Azure CLI 2.0 installed as prerequisites for azure-shell. Please refer to Install Azure CLI 2.0 and install it if not yet installed

Installation

The azure-shell requires python and pip to install. You can install the azure-shell using pip:

pip install azure-shell

If you've already have azure-shell installed and want to upgrade to the latest version, you can upgrade like this:

pip install --upgrade azure-shell

Usage

Once you've installed the azure-shell, you can run azure-shell by simply typing azure-shell:

azure-shell

You can exit the azure-shell by typing either exit or quit:

azure> exit

Basically you can run azure-shell without making any configurations but you can give options to azure-shell to change its default behabior:

azure-shell --help

Usage: azure-shell [-h] [--version] [--basedir BASEDIR] [--config CONFIG]
                   [--index INDEX]

An interactive Azure CLI command line interface

optional arguments:
  -h, --help         show this help message and exit
  --version          show program's version number and exit
  --basedir BASEDIR  Azure Shell base dir path ($HOME/.azureshell by default)
  --config CONFIG    Azure Shell config file path
                     ($HOME/.azureshell/azureshell.conf by default)
  --index INDEX      Azure Shell index file to load ($HOME/.azureshel/cli-
                     index-<azure_cli_version>.json)

Azure Shell Index Generator

You can generate an index for azure-shell using azure-shell-index-generator command. Please be noted that it will take time before all data generation works are done

azure-shell-index-generator --output ~/.azureshell/cli-index.json

Basically you don't need to generate the index by yourself as azure-shell automatically downloads an index from its repository and load it for commands and parameters completion in startup time. But you also can give azure-shell your index using --index option.

azure-shell --index ~/.azureshell/cli-index.json

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/yokawasa/azure-shell

More Information

• Get started with Azure CLI 2.0
• Install Azure CLI 2.0

azure-shell's Issues

az webapp option is not available

Hi ,
When using azure-shell , i'm not getting option to create webapp . az webapp is missing in the this tool.

after installing Azure-shell i get urllib2 error on MacOS

After installing azure-shell ( which didnt give any issues)

i get the following error:

File "/Library/Frameworks/Python.framework/Versions/3.5/bin/azure-shell", line 7, in
from azureshell import main
File "/Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site-packages/azureshell/init.py", line 11, in
from .index import AzureShellIndex, AzureShellIndexException
File "/Library/Frameworks/Python.framework/Versions/3.5/lib/python3.5/site-packages/azureshell/index.py", line 6, in
import urllib2
ImportError: No module named 'urllib2'

as far as i can tell i use python 3.5

any suggestions where to look for ?

index_generator.py failed due to azure-cli's incompatible issue

index_generator.py failed due to azure-cli's incompatible issue.
index_generator.py has used get_command_table() that had been included azure.cli.core.application.APPLICATION, however get_command_table() has moved to azure.cli.core.application.Configuration since azure-cli-2.0.3.