Web-based help

awscli/__init__.py

@@ -104,3 +104,5 @@ def find_spec(self, fullname, path, target=None):
 
 
 TopLevelImportAliasFinder.add_alias_finder(sys.meta_path)
+
+_DEFAULT_BASE_REMOTE_URL = f"https://awscli.amazonaws.com/v2/documentation/api/{__version__}"   # noqa

awscli/clidriver.py

@@ -270,6 +270,9 @@ def _update_config_chain(self):
         config_store.set_config_provider(
             'cli_auto_prompt', self._construct_cli_auto_prompt_chain()
         )
+        config_store.set_config_provider(
+            'cli_help_output', self._construct_cli_help_output_chain()
+        )
 
     def _construct_cli_region_chain(self):
         providers = [
@@ -308,6 +311,16 @@ def _construct_cli_output_chain(self):
         ]
         return ChainProvider(providers=providers)
 
+    def _construct_cli_help_output_chain(self):
+        providers = [
+            ScopedConfigProvider(
+                config_var_name='cli_help_output',
+                session=self.session,
+            ),
+            ConstantProvider(value='terminal'),
+        ]
+        return ChainProvider(providers=providers)
+
     def _construct_cli_pager_chain(self):
         providers = [
             EnvironmentProvider(

awscli/customizations/commands.py

@@ -347,9 +347,10 @@ def __init__(
         command_table,
         arg_table,
         event_handler_class=None,
+        base_remote_url=None,
     ):
         super(BasicHelp, self).__init__(
-            session, command_object, command_table, arg_table
+            session, command_object, command_table, arg_table, base_remote_url
         )
         # This is defined in HelpCommand so we're matching the
         # casing here.
@@ -383,6 +384,12 @@ def examples(self):
     def event_class(self):
         return '.'.join(self.obj.lineage_names)
 
+    @property
+    def url(self):
+        if len(self.command_table) > 0:
+            return f"{self._base_remote_url}/reference/{self.event_class.replace('.', '/')}/index.html"
+        return f"{self._base_remote_url}/reference/{self.event_class.replace('.', '/')}.html"
+
     def _get_doc_contents(self, attr_name):
         value = getattr(self, attr_name)
         if isinstance(value, BasicCommand.FROM_FILE):
@@ -408,7 +415,12 @@ def __call__(self, args, parsed_globals):
         # We pass ourselves along so that we can, in turn, get passed
         # to all event handlers.
         docevents.generate_events(self.session, self)
-        self.renderer.render(self.doc.getvalue())
+
+        if self._help_output_format == 'url':
+            self.renderer.render(self.url.encode())
+        else:
+            self.renderer.render(self.doc.getvalue())
+
         instance.unregister()