Azure CLI Interactive Shell

The interactive shell for Microsoft Azure CLI (Command Line Interface)

Interactive Tutorials
Lightweight Drop Down Completions
Auto Cached Suggestions
Dynamic parameter completion
Defaulting scopes of commands
On the fly descriptions of the commands AND parameters
On the fly examples of how to utilize each command
Optional “az” component
Query the previous command
Navigation of example pane
Optional layout configurations
Fun Colors

Running

To start the application

$ az shell

Then type your commands and hit [Enter]

To use commands outside the application

$ #[command]

To Search through the last command as json jmespath format for querying

$ ? [param]

Note: Only if the previous command dumps out json, e.g. vm list

To only see the commands for a command

$ %% [top-level command] [sub-level command] etc

To undefault a value

$ %% ..

Use Examples

Type a command, for example:

$ vm create

Look at the examples

Scroll through the pane with Control Y for up and Control N for down #

Pick the example you want with:

$ vm create :: [Example Number]

Dev Setup

Fork and clone repository

$ . dev_setup.py

To get the Exit Code of the previous command:

$ $

Clear History

Only clears the appended suggestion when you restart the shell

$ clear-history

Release History

0.3.26

Minor fixes

0.3.25

Update PyYAML dependency to 4.2b4

0.3.24

Minor fixes

0.3.23

Minor fixes

0.3.22

Fix dependency versions.

0.3.21

Mute logging from parser for completions.
Made interactive more resistant to stale/corrupted help caches.

0.3.20

Allow interactive completers to function with positional arguments.
More user-friendly output when users type ‘'.
Fix completions for parameters with no help.
Fix descriptions for command-groups.

0.3.19

Stops completions upon unrecognized commands.
Add event hooks before and after command subtree is created.
Allow completions for –ids parameters.
sdist is now compatible with wheel 0.31.0

0.3.18

Completions kick in as soon as command table loading is done.
Fix bug with using –style parameter.
Interactive lexer instantiated after command table dump if missing.
Improvements to completer support.

0.3.17

Persist history across different sessions
Fixed history while in scope
Updates to interactive telemetry
Fixed progress meter for long running operations
Completions more robust to command table exceptions

0.3.16

Fix issue where user is prompted to login when using interactive mode in Cloud Shell.
Fixed regression with missing parameter completions.

0.3.15

Fixed issue where command option completions no longer appeared.

0.3.14

Clean up unused test files

0.3.13

Fix issue where interactive would not start on Python 2.
Fix errors on start up
Fix some commands not running in interactive mode

0.3.12

Update for CLI core changes.

0.3.11

minor fixes

0.3.10 (2017-09-22)

minor fixes

0.3.9 (2017-08-31)

minor fixes

0.3.8 (2017-08-28)

minor fixes

0.3.7 (2017-07-27)

Improves the start up time by using cached commands

0.3.7 (2017-07-27)

Increase test coverage

0.3.5 (2017-06-21)

Enhance the ‘?’ gesture to also inject into the next command

0.3.4 (2017-06-13)

Fixes Interactive errors with the profile 2017-03-09-profile-preview (#3587)
Allows ‘–version’ as a parameter for interactive mode (#3645)
Stop Interactive Mode from Throwing errors from Validation completions (#3570)
Progress Reporting for template deployments (#3510)

0.3.3 (2017-05-30)

–progress flag
Removed –debug and –verbose from completions

0.3.2 (2017-05-18)

Bug fixes.
Remove ‘interactive’ from completions (#3324)

0.3.1 (2017-05-09)

Add link to blog in ‘az interactive —help’ (#3252)

0.3.0 (2017-05-05)

Integrate interactive into az
Colors Options
Rename ‘shell’ => ‘interactive’

0.2.1

CLI Performance changes integrated

0.2.0

Public Preview release

0.1.1

Preview release

Metadata

Release files for azure-cli-interactive 0.3.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for azure-cli-interactive 0.3.26
File	Size	Uploaded
azure-cli-interactive-0.3.26.tar.gz	27.9 kB	Jul 18, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for azure-cli-interactive 0.3.26
File	Interpreter	ABI	Platform	Reset
azure_cli_interactive-0.3.26-py2.py3-none-any.whl 36.0 kB Jul 18, 2018	Python 2, Python 3	none	any	Details

Total release size: 63.9 kB

Release files / azure-cli-interactive-0.3.26.tar.gz

Download URL	azure-cli-interactive-0.3.26.tar.gz
Size	27.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`c04e9da38d810abf8e42c1b4113580db9acc5804029086d58926e0097274a316`
BLAKE2b-256 checksum How to use checksums	`d2de9b4cb5f517e89580038914d2545fc76d02ecabc8ea44ecbf3c9f6fad5bea`
Upload date	Jul 18, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / azure_cli_interactive-0.3.26-py2.py3-none-any.whl

Download URL	azure_cli_interactive-0.3.26-py2.py3-none-any.whl
Size	36.0 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`e47d9dc13dc5c628d254eaa90432c8e5f8ba86d30e4f0abcc6703d50f74fd50d`
BLAKE2b-256 checksum How to use checksums	`a8eca86eaca0cb92b6cab0f8d2f79448489e11d6cf93043c3b957936053b1165`
Upload date	Jul 18, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No