[Config] az config: Add new config command module

[jiasli]

Description

Resolve #13981

Add new config command module. This PR relies on Knack change microsoft/knack#217.

Testing Guide

Set

Disable color with core.no_color.

az config set core.no_color=true

Hide warnings and only show errors with core.only_show_errors.

az config set core.only_show_errors=true

Turn on client-side telemetry.

az config set core.collect_telemetry=true

Turn on file logging and set its location.

az config set logging.enable_log_file=true
az config set logging.log_dir=~/az-logs

Set the default resource group to myRG.

az config set default.group=myRG

Set the default resource group to myRG on a local scope.

az config set default.group=myRG --local

Get

Get all configurations.

az config get

Get configurations in core section.

az config get core

Get configuration of key core.no_color.

az config get core.no_color

Unset

Unset configurations of key core.no_color.

az config unset core.no_color

[yonzhan]

Config refactor

[fengzhou-msft]

extra e?

[jiasli]

Oh! Nice catch. Perhaps our CI should check it? @haroldrandom @myronfanqiu

[arrownj]

Another option for this case is to return empty string. Personally, I prefer empty string for this case.

[jiasli]

Empty string means the config is actually set to '', which is different from the concept of "not set".

[arrownj]

Make sense to me. Maybe we should also confirm this with PM.

[arrownj]

What will be returned if key is not set?

[jiasli]

It will ignore the operation and return False. See remove_option:

remove_option(section, option)
Remove the specified option from the specified section. If the section does not exist, raise NoSectionError. If the option existed to be removed, return True; otherwise return False.

[jiasli]

However, configparser.NoSectionError is ignored by Knack.

https://github.com/microsoft/knack/blob/148173e6fd02bd721920e6b33c9f508b4d584ae9/knack/config.py#L219-L223

            try:
                existed = self.config_parser.remove_option(section, option)
                self.set(self.config_parser)
            except configparser.NoSectionError:
                pass

We'd better confirm with PM about the behavior later.

[arrownj]

Agree with your suggestion.

[mmyyrroonn]

Approved for linter_exclusions.yml file

[jiasli]

An excerpt from the design spec https://github.com/jiasli/azure-cli-spec/blob/master/az-config.md:

Additional work - migrate to settings.json

settings.json is the latest unwritten convention of Microsoft open source project, like Visual Studio Code and Windows Terminal.

Visual Studio Code

The config file is at C:\Users\xxx\AppData\Roaming\Code\User\settings.json:

{
    "terminal.integrated.shell.windows": "C:\\WINDOWS\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
    "terminal.integrated.scrollback": 99999,
    "editor.minimap.enabled": false,
    ...
}

Windows Terminal

The config file is at C:\Users\xxx\AppData\Local\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json:

{
    "$schema": "https://aka.ms/terminal-profiles-schema",

    "defaultProfile": "{574e775e-4f2a-5b96-ac1e-a2962a402336}",

    "profiles":
    [
        {
            // Make changes here to the powershell.exe profile
            "guid": "{61c54bbd-c2c6-5271-96e7-009a87ff44bf}",
            "name": "Windows PowerShell",
            "commandline": "powershell.exe",
            "hidden": false
        },
        ...
    ],
    ...
}

Using settings.json will open up more possibilities like "hover" help (controlled by editor.hover.enabled in VSCode) using the "$schema" property: