Metadata-Version: 2.0
Name: azure-shell
Version: 0.1.0
Summary: An interactive Azure CLI 2.0 command line interface
Home-page: https://github.com/yokawasa/azure-shell
Author: Yoichi Kawasaki
Author-email: UNKNOWN
License: Apache License 2.0
Keywords: azure azure-shell,shell,azure-cli
Platform: any
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: Pygments (<3.0.0,>=2.1.3)
Requires-Dist: configparser (>=3.5.0)
Requires-Dist: prompt-toolkit (<1.1.0,>=1.0.0)

# azure-shell 

An interactive Azure CLI 2.0 command line interface

![](https://github.com/yokawasa/azure-shell/raw/master/img/azure-shell-console.gif)

## Supported Environments

* Python versions: 2.7, 3.3, 3.4, 3.5, 3.5 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](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli) 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
```

Once you've installed the azure-shell, you can run azure-shell now:

```
azure-shell
```

## Configuration

You can basically run without making any configurations by default but you can give options to azure-shell to configure:

```
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)
```


## 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](https://docs.microsoft.com/en-us/cli/azure/get-started-with-azure-cli)
* [Install Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli)



