Improve extension help (#294)

src/index.json

@@ -1024,9 +1024,9 @@
         ],
         "resource-graph": [
             {
-                "filename": "resource_graph-0.1.6-py2.py3-none-any.whl",
-                "sha256Digest": "e63eaec3129434029ac542e457eb4c097e6c9212e218abe2b109393f6d15a1f1",
-                "downloadUrl": "https://files.pythonhosted.org/packages/50/bd/f2b8fdabcd0eda287f66af294c19e0b1cd8092ab90a3d8a6343dfd0d7f3c/resource_graph-0.1.6-py2.py3-none-any.whl",
+                "filename": "resource_graph-0.1.8-py2.py3-none-any.whl",
+                "sha256Digest": "f95896b07f9a16d47307e4f6b38ffc8ba9f335f90a8661acfa2b980599d14b32",
+                "downloadUrl": "https://files.pythonhosted.org/packages/b3/a8/6862d447037fa699364c081d90ef0d39a222e93ad0b93d30711618859ee2/resource_graph-0.1.8-py2.py3-none-any.whl",
                 "metadata": {
                     "azext.minCliCoreVersion": "2.0.45",
                     "azext.isPreview": true,
@@ -1057,7 +1057,7 @@
                     "metadata_version": "2.0",
                     "name": "resource-graph",
                     "summary": "Support for querying Azure resources with Resource Graph.",
-                    "version": "0.1.6"
+                    "version": "0.1.8"
                 }
             }
         ],

src/resource-graph/HISTORY.rst

@@ -1,4 +1,4 @@
-0.1.6
+0.1.8
 ++++++++++++++++++
 
 * Initial release.

src/resource-graph/azext_resourcegraph/_help.py

@@ -10,13 +10,15 @@ from knack.help_files import helps
 helps['graph'] = """
     type: group
     short-summary: Query the resources managed by Azure Resource Manager.
+    long-summary: >
+        Run 'az graph query --help' for detailed help.
 """
 
 helps['graph query'] = """
     type: command
     short-summary: Query the resources managed by Azure Resource Manager.
     long-summary: >
-        Learn more about the query syntax here: https://aka.ms/AzureResourceGraph-QueryLanguage
+        See https://aka.ms/AzureResourceGraph-QueryLanguage to learn more about query language and browse examples
     parameters:
         - name: --graph-query --q -q
           type: string

src/resource-graph/azext_resourcegraph/_params.py

@@ -9,17 +9,17 @@
 from azure.cli.core.commands.parameters import get_generic_completion_list
 
 _QUERY_EXAMPLES = [
-    ''' summarize count()''',
-    ''' project name, type, location | order by name asc''',
-    ''' where type =~ 'Microsoft.Compute/virtualMachines' | project name, location, type | order by name desc''',
-    ''' where type =~ 'Microsoft.Compute/virtualMachines' | project name, location''',
-    ''' summarize count() by subscriptionId''',
-    ''' summarize count() by subscriptionId, location''',
-    ''' where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by tostring(properties.storageProfile.osDisk.osType)''',
-    ''' where type =~ 'Microsoft.Compute/virtualMachines'  and properties.storageProfile.osDisk.osType =~ 'Windows' | project name''',
-    ''' where name contains 'sql'| project location, name''',
-    ''' where isnotempty(tags) and tags != '{}' | project tags''',
-    ''' where isnotempty(tags.environment) | project name, Environment=tags.environment | limit 10'''
+    '''summarize count()''',
+    '''project name, type, location | order by name asc''',
+    '''where type =~ 'Microsoft.Compute/virtualMachines' | project name, location, type | order by name desc''',
+    '''where type =~ 'Microsoft.Compute/virtualMachines' | project name, location''',
+    '''summarize count() by subscriptionId''',
+    '''summarize count() by subscriptionId, location''',
+    '''where type =~ 'Microsoft.Compute/virtualMachines' | summarize count() by tostring(properties.storageProfile.osDisk.osType)''',
+    '''where type =~ 'Microsoft.Compute/virtualMachines'  and properties.storageProfile.osDisk.osType =~ 'Windows' | project name''',
+    '''where name contains 'sql'| project location, name''',
+    '''where isnotempty(tags) and tags != '{}' | project tags''',
+    '''where isnotempty(tags.environment) | project name, Environment=tags.environment | limit 10'''
 ]
 
 

src/resource-graph/setup.py

@@ -8,7 +8,7 @@
 from codecs import open
 from setuptools import setup, find_packages
 
-VERSION = "0.1.6"
+VERSION = "0.1.8"
 
 CLASSIFIERS = [
     'Development Status :: 4 - Beta',