shellopts 2.0.21 → 2.0.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2e9d4e1a3ad5eca9fd21a3bad085a252ff7b6921ec889e4da404c989304bf9c
-  data.tar.gz: fa9f67483fcfb303e76f8b6b2282948f117f2497b734b6fdd6ca6f91a29b3d96
+  metadata.gz: d3f9f19d62ccf36d5de39421163eb70e7aa8ae621cee13381d48ce68e7ab593d
+  data.tar.gz: 13351ee8dceceea7c5da573de7c5bd257aa2efd1c4690be760f6ebe1445ca8c9
 SHA512:
-  metadata.gz: 29c8d07d8fdf63c8b4e04d031ec1c7b779ed3410265103514ade6f8e5fd2b45d3f5b804de934722e0f49d11119e14e463507b7d63c0c6d2059018b75fec281a6
-  data.tar.gz: 2f7cad783bd109dc264574cb6ed76ec1f947d1591e15267bf071ebd243b5b646039bdec9fc2dac7983db38463fb6eddb328d920beaa35052647e647f9020ed49
+  metadata.gz: 4afd636e92e1ff74b45c77399d4dbaba6afaccd441ee528800a727ed5e4db802d481d8dcaaddcd46bdbcd7c28f3b121b35e42b63e44f02d006c557eafda29692
+  data.tar.gz: 7c12cd6d9f0dede5c7931cf82b8e1ff32d4de738c2d3dd42fb5c2f65740ed0804078eb65ca0b951ce28a1095fd9b43289df01501275a5f9c178a965e569aa054

data/lib/shellopts/formatter.rb

@@ -30,8 +30,8 @@ module ShellOpts
     class Command
       using Ext::Array::Wrap
 
-      def puts_usage(bol: false)
-        width = [Formatter.rest, Formatter::USAGE_MAX_WIDTH].min
+      def puts_usage(bol: false, max_width: Formatter::USAGE_MAX_WIDTH)
+        width = [Formatter.rest, max_width].min
         if descrs.size == 0
           print (lead = Formatter.command_prefix || "")
           indent(lead.size, ' ', bol: bol && lead == "") { 
@@ -41,7 +41,7 @@ module ShellOpts
           lead = Formatter.command_prefix || ""
           descrs.each { |descr|
             print lead
-            puts render(:single, width, args: [descr.text]) 
+            puts render(:multi, width, args: descr.text.split(' ')) 
           } 
         end
       end
@@ -58,7 +58,7 @@ module ShellOpts
         end
 
         puts "Usage"
-        indent { puts_usage(bol: true) }
+        indent { puts_usage(bol: true, max_width: Formatter::HELP_MAX_WIDTH) }
 
         if options.any?
           puts
@@ -112,14 +112,13 @@ module ShellOpts
         puts
 
         puts Ansi.bold "USAGE"
-        indent { puts_usage(bol: true) }
+        indent { puts_usage(bol: true, max_width: Formatter::HELP_MAX_WIDTH) }
 
         section = {
           Paragraph => "DESCRIPTION",
           OptionGroup => "OPTION",
           Command => "COMMAND"
         }
-
         seen_sections = {}
         newline = false # True if a newline should be printed before child 
         indent {
@@ -173,7 +172,10 @@ module ShellOpts
     end
 
     module WrappedNode
-      def puts_descr(width = Formatter.rest) puts lines(width) end
+      def puts_descr
+        width = [Formatter.rest, Formatter::HELP_MAX_WIDTH].min
+        puts lines(width) 
+      end
     end
 
     class Code
@@ -217,6 +219,9 @@ module ShellOpts
     # Indent to use in help output
     HELP_INDENT = 4
 
+    # Max. width of help text (not including indent)
+    HELP_MAX_WIDTH = 85 
+
     # Command prefix when subject is a sub-command
     def self.command_prefix() @command_prefix end
 

data/lib/shellopts/renderer.rb

@@ -15,9 +15,9 @@ require 'terminfo'
 #
 # Command rendering
 #   cmd --all --beta [cmd1|cmd2] ARG1 ARG2    # Single-line formats (:single)
-#   cmd --all --beta [cmd1|cmd2] ARGS...     
+#   cmd --all --beta [cmd1|cmd2] ARGS...      # Not used
 #   cmd -a -b [cmd1|cmd2] ARG1 ARG2
-#   cmd -a -b [cmd1|cmd2] ARGS...
+#   cmd -a -b [cmd1|cmd2] ARGS...             # Not used
 #
 #   cmd -a -b [cmd1|cmd2] ARG1 ARG2           # One line for each argument description (:enum)
 #   cmd -a -b [cmd1|cmd2] ARG3 ARG4           # (used in the USAGE section)
@@ -108,7 +108,7 @@ module ShellOpts
       def get_args(args: nil)
         case descrs.size
           when 0; []
-          when 1; [descrs.first.text]
+          when 1; descrs.first.text.split(' ')
           else [DESCRS_ABBR]
         end
       end
@@ -120,6 +120,7 @@ module ShellOpts
       end
 
       # Force one line. Compact options, commands, arguments if needed
+      #
       def render_single(width, args: nil)
         long_options = options.map { |option| option.render(:long) }
         short_options = options.map { |option| option.render(:short) }
@@ -164,32 +165,30 @@ module ShellOpts
       def render_multi(width, args: nil)
         long_options = options.map { |option| option.render(:long) }
         short_options = options.map { |option| option.render(:short) }
-        short_commands = commands.empty? ? [] : ["[#{commands.map(&:name).join("|")}]"]
-        compact_commands = [COMMANDS_ABBR]
+        compact_options = options.empty? ? [] : [OPTIONS_ABBR]
+
+        # Only compact commands if they can't fit on one line
+        if commands.empty?
+          use_commands = []
+        else
+          short_command = "[#{commands.map(&:name).join("|")}]"
+          use_commands = [short_command.size > width ? COMMANDS_ABBR : short_command]
+        end
 
         args ||= get_args
 
         # On one line
-        words = [name] + long_options + short_commands + args
+        words = [name] + long_options + use_commands + args
         return [words.join(" ")] if pass?(words, width)
-        words = [name] + short_options + short_commands + args
+        words = [name] + short_options + use_commands + args
+        return [words.join(" ")] if pass?(words, width)
+        words = [name] + compact_options + use_commands + args
         return [words.join(" ")] if pass?(words, width)
 
         # On multiple lines
         lead = name + " "
-        options = long_options.wrap(width - lead.size)
-        options = [lead + options[0]] + indent_lines(lead.size, options[1..-1])
-
-        begin
-          words = short_commands + args
-          break if pass?(words, width)
-          words = compact_commands + args
-          break if pass?(words, width)
-          words = compact_commands + [DESCRS_ABBR]
-        end while false
-
-        cmdargs = words.empty? ? [] : [words.join(" ")]
-        options + indent_lines(lead.size, cmdargs)
+        words = (long_options + use_commands + args).wrap(width - lead.size)
+        lines = [lead + words[0]] + indent_lines(lead.size, words[1..-1])
       end
 
     protected

data/lib/shellopts/version.rb

@@ -1,3 +1,3 @@
 module ShellOpts
-  VERSION = "2.0.21"
+  VERSION = "2.0.22"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shellopts
 version: !ruby/object:Gem::Version
-  version: 2.0.21
+  version: 2.0.22
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-04-21 00:00:00.000000000 Z
+date: 2022-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: forward_to