Merge pull request #620 from DannyBen/add/header_override

Add `help_header_override` command option

Author: DannyBen

lib/bashly/config_validator.rb

@@ -186,6 +186,7 @@ def assert_command(key, value)
 
       assert_string "#{key}.name", value['name']
       assert_optional_string "#{key}.help", value['help']
+      assert_optional_string "#{key}.help_header_override", value['help_header_override']
       assert_optional_string "#{key}.footer", value['footer']
       assert_optional_string "#{key}.group", value['group']
       assert_optional_string "#{key}.filename", value['filename']

lib/bashly/script/command.rb

@@ -17,7 +17,7 @@ def option_keys
             alias args catch_all commands completions
             default dependencies environment_variables examples
             extensible expose filename filters flags
-            footer function group help name
+            footer function group help help_header_override name
             private variables version
           ]
         end

lib/bashly/views/command/usage.gtx

@@ -1,12 +1,16 @@
 = view_marker
 
 > {{ function_name }}_usage() {
-if summary == help
+if summary == help && !help_header_override
   >   printf "{{ caption_string.sanitize_for_print }}\n\n"
 else
   >   if [[ -n $long_usage ]]; then
-  >     printf "{{ full_name }}\n\n"
-  >     printf "{{ help.wrap(78).indent(2).sanitize_for_print }}\n\n"
+  if help_header_override
+    = help_header_override.indent 4
+  else
+    >     printf "{{ full_name }}\n\n"
+    >     printf "{{ help.wrap(78).indent(2).sanitize_for_print }}\n\n"
+  end
   >   else
   >     printf "{{ caption_string.sanitize_for_print }}\n\n"
   >   fi