Skip to main content

Microsoft Azure Command-Line Interactive Shell

Project description

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.4.4

  • Minor fixes

0.4.3

  • Minor fixes

0.4.2

  • Fix incompatibility with Interactive extension installed through azdev.

0.4.1

  • Minor fixes

0.4.0

  • Interactive now installs the ‘interactive’ extension, which will allow for faster updates and support.

0.3.31

  • Ensure global subscription parameter appears in parameters.

0.3.30

  • Fix error found on windows where commands fail to run properly.

0.3.29

  • Fix command loading problem in interactive that was caused by deprecated objects.

0.3.28

  • Minor fixes

0.3.27

  • Minor fixes

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

  • 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

opal-azure-cli-interactive-0.4.7.tar.gz (7.1 kB view details)

Uploaded Source

Built Distribution

opal_azure_cli_interactive-0.4.7-py2.py3-none-any.whl (7.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file opal-azure-cli-interactive-0.4.7.tar.gz.

File metadata

  • Download URL: opal-azure-cli-interactive-0.4.7.tar.gz
  • Upload date:
  • Size: 7.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for opal-azure-cli-interactive-0.4.7.tar.gz
Algorithm Hash digest
SHA256 03044e6d5dc0414ba4bcafceec5835ee70ffde9fcefff06a7294ad984114353b
MD5 07fb48913f40235f917afc03d1e3dd27
BLAKE2b-256 2290115a45aad6f8c723cf658e1e55a74834998ada5a1d03ca204022f16cf336

See more details on using hashes here.

File details

Details for the file opal_azure_cli_interactive-0.4.7-py2.py3-none-any.whl.

File metadata

  • Download URL: opal_azure_cli_interactive-0.4.7-py2.py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for opal_azure_cli_interactive-0.4.7-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 80b3b940d675b74b669e6c99bd93059fb0a8954a5fe00ff4e5fe0f53823f5b79
MD5 0bcd679275b43070a8956327cdde5218
BLAKE2b-256 697cd8588330318a463c2131a67de76345f1b27dd53c1b7f90aa833eb629bafd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page