shellopts 2.0.7 → 2.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e8933ca7084aea3e51858cd679eec2a6b34b2fc7ae9a55ccce131947ccc7375
-  data.tar.gz: 125309b75338e9205fb05c5c556fca54cbc1cc77ef890a4ca2d6992c69eff302
+  metadata.gz: 812078e64c677a6aff78081e25a04b81be3b3a1fe9496709838e2abb80573b4a
+  data.tar.gz: 92c14741c409697f543820d656683b9552d4c6c7ce5c29b01a30677a174549c2
 SHA512:
-  metadata.gz: 123b17ded3c4943267612959f3b8ab56a37249e38ea9c338c577ad254ebc1c7c9c305ca9a7a3ee2661d9474e905ddd193c5da8e7a5adc3e711c236349095a636
-  data.tar.gz: a3115c875274fccf6628d4c839e3eac36804157f7c56e90b599e8201c1bf8f1070b5b92b7e22cbe2c6615e20b81f4de8b81233227aaccdb873f1016e129d99ae
+  metadata.gz: 3b1ac7453a534a50cf250e489688aa82ad1928220a615b9e4f7076c27b588d19a7b355e866f3e3cc789fd2259bb2e5de14ac92e905b7b033528c11be26564356
+  data.tar.gz: d50433ec49a4bf67fd9947d2028ed81be9c8310e7410d93c691e2cd59ed36ef622937c861ef1f4608e7ef5869804cd0f1a4197abf03fd4c2d96cef4985d5dab4

data/TODO

@@ -1,18 +1,13 @@
 
-o Add brackets to optional option arguments: '--all=FILE?' -> '--all[=FILE]'
 o Ignore all text after ' # ' (doesn't conflict with option flag)
 o Command aliases
 o Add user-defined setions
 o Add a SOURCE section with link to git repo
 o Bullet-lists
 o Allow a USAGE section (and NAME)
-o Find source in code an adjust line number in error messages 
-o Rename line and char to lineno and charno
 o Client-defined argument types
 o Rename Expr -> ?
 o Find clean(er) procedural object model
-o Allow assignment to options (this makes practical stuff easier)
-o Special handling of --help arguments so that '--help command' is possible
 o Support for paging of help:
     begin 
       file = Tempfile.new("prick") 
@@ -23,6 +18,11 @@ o Support for paging of help:
       file.close 
     end 
 
++ Special handling of --help arguments so that '--help command' is possible
++ Allow assignment to options (this makes practical stuff easier)
++ Rename line and char to lineno and charno
++ Find source in code an adjust line number in error messages 
++ Add brackets to optional option arguments: '--all=FILE?' -> '--all[=FILE]'
 + Bold text output
 + Recursive format of commands
 + Rename Compiler -> Interpreter

data/lib/shellopts/analyzer.rb

@@ -20,18 +20,17 @@ module ShellOpts
     end
 
     class Command
-      def set_supercommand
-        commands.each { |child| child.instance_variable_set(:@supercommand, self) }
-      end
-
       def collect_options
         @options = option_groups.map(&:options).flatten
       end
 
-      # Move options before first command
+      # Move options before first command or before explicit COMMAND section
       def reorder_options
         if commands.any?
-          if i = children.find_index { |child| child.is_a?(Command) }
+          i = children.find_index { |child| 
+            child.is_a?(Command) || child.is_a?(Section) && child.name == "COMMAND"
+          }
+          if i
             options, rest = children[i+1..-1].partition { |child| child.is_a?(OptionGroup) }
             @children = children[0, i] + options + children[i..i] + rest
           end
@@ -51,9 +50,9 @@ module ShellOpts
         }
       end
 
+      # TODO Check for dash-collision
       def compute_command_hashes
         commands.each { |command|
-          # TODO Check for dash-collision
           !@commands_hash.key?(command.name) or 
               analyzer_error command.token, "Duplicate command name: #{command.name}"
           @commands_hash[command.name] = command
@@ -73,41 +72,74 @@ module ShellOpts
       @grammar = grammar
     end
 
-    # Move commands that are nested within a different command than it belongs to
-    def move_commands
+    def create_implicit_commands(cmd)
+      path = cmd.path[0..-2]
+
+      
+    end
+
+    # Link up commands with supercommands. This is only done for commands that
+    # are nested within a different command than it belongs to. The
+    # parent/child relationship is not changed Example:
+    #
+    #   cmd!
+    #   cmd.subcmd! 
+    #
+    # Here subcmd is added to cmd's list of commands. It keeps its position in
+    # the program's parent/child relationship so that documentation will print the
+    # commands in the given order and with the given indentation level
+    #
+    def link_commands
       # We can't use Command#[] at this point so we collect the commands here
       h = {}
       @grammar.traverse(Grammar::Command) { |command|
         h[command.path] = command
+        # TODO: Pick up parent-less commands
+      }
+
+      # Command to link
+      link = []
+
+      # Create implicit commands
+      h.sort { |l,r| l.size <=> r.size }.each { |path, command|
+        path = path[0..-2]
+        while !h.key?(path)
+          cmd = Grammar::Command.new(nil, command.token)
+          cmd.set_name(path.last.to_s.sub(/!/, ""), path.dup)
+          link << cmd
+          h[cmd.path] = cmd
+          path.pop
+        end
       }
 
-      # Find commands to move
+      # Find commands to link
       #
-      # Commands are moved in two steps because the behaviour of #traverse is
-      # not defined when the data structure changes beneath it
-      move = []
+      # Commands are linked in two steps because the behaviour of #traverse is
+      # not defined when the data structure changes beneath it. (FIXME: Does it
+      # change when we don't touch the parent/child relationship?)
       @grammar.traverse(Grammar::Command) { |command|
         if command.path.size > 1 && command.parent && command.parent.path != command.path[0..-2]
-          move << command
+#       if command.path.size > 1 && command.parent.path != command.path[0..-2]
+          link << command
         else
           command.instance_variable_set(:@command, command.parent)
         end
       }
 
-      # Move commands but do not change parent/child relationship
-      move.each { |command|
-        supercommand = h[command.path[0..-2]] or analyzer_error "Can't find #{command.ident}!"
-        command.parent.commands.delete(command)
+      # Link commands but do not change parent/child relationship
+      link.each { |command|
+        path = command.path[0..-2]
+        path.pop while (supercommand = h[path]).nil?
+        command.parent.commands.delete(command) if command.parent
         supercommand.commands << command
         command.instance_variable_set(:@command, supercommand)
       }
     end
 
     def analyze()
-      move_commands
+      link_commands
 
       @grammar.traverse(Grammar::Command) { |command|
-        command.set_supercommand
         command.reorder_options
         command.collect_options
         command.compute_option_hashes

data/lib/shellopts/args.rb

@@ -5,6 +5,11 @@ module ShellOpts
   # methods raise a ShellOpts::Error exception in case of errors
   #
   class Args < Array
+    def initialize(*args, exception: false)
+      super(*args)
+      @exception = exception
+    end
+
     # :call-seq:
     #   extract(count, message = nil)
     #   extract(range, message = nil)
@@ -21,7 +26,7 @@ module ShellOpts
     # #extract raise a ShellOpts::Error exception if there's is not enough
     # elements in the array to satisfy the request
     #
-    def extract(count_or_range, message = nil) 
+    def extract(count_or_range, message = nil)
       case count_or_range
         when Range
           range = count_or_range
@@ -59,8 +64,10 @@ module ShellOpts
     end
 
   private
-    def inoa(message = nil) 
-      raise ShellOpts::Error, message || "Illegal number of arguments"
+    def inoa(message = nil)
+      message ||= "Illegal number of arguments"
+      raise Error, message if @exception
+      ::ShellOpts.error(message)
     end
   end
 end

data/lib/shellopts/formatter.rb

@@ -81,7 +81,15 @@ module ShellOpts
       end
 
       def puts_descr(prefix, brief: !self.brief.nil?, name: :path)
-        puts Ansi.bold([prefix, render(:single, Formatter.rest)].flatten.compact.join(" "))
+        # Use one-line mode if all options are declared on one line
+        if options.all? { |option| option.token.lineno == token.lineno }
+          puts Ansi.bold([prefix, render(:single, Formatter.rest)].flatten.compact.join(" "))
+          puts_options = false
+        else
+          puts Ansi.bold([prefix, render(:abbr, Formatter.rest)].flatten.compact.join(" "))
+          puts_options = true
+        end
+
         indent {
           if brief
             puts self.brief.words.wrap(Formatter.rest)
@@ -93,7 +101,10 @@ module ShellOpts
 
               if child.is_a?(Command)
                 child.puts_descr(prefix, name: :path)
-               else
+              elsif child.is_a?(OptionGroup)
+                child.puts_descr if puts_options
+                newline = false
+              else
                 child.puts_descr
               end
             }
@@ -112,37 +123,34 @@ module ShellOpts
 
         section = {
           Paragraph => "DESCRIPTION",
-          OptionGroup => "OPTIONS",
-          Command => "COMMANDS"
+          OptionGroup => "OPTION",
+          Command => "COMMAND"
         }
 
+        seen_sections = {}
         newline = false # True if a newline should be printed before child 
         indent {
           children.each { |child|
-            if child.is_a?(Section) # Explicit section
-#             p :A
-              puts
-              indent(-1).puts Ansi.bold child.name
-              section.delete_if { |_,v| v == child.name }
+            klass = child.is_a?(Section) ?  section.key(child.name) : child.class
+            if s = section[klass] # Implicit section
+              section.delete(klass)
               section.delete(Paragraph)
-              newline = false
-              next
-            elsif s = section[child.class] # Implicit section
-#             p :B
-              puts  
+              if klass <= OptionGroup
+                s += "S" if options.size > 1
+              elsif klass <= Command
+                s += "S" if commands.size > 1 || commands.size == 1 && commands.first.commands.size > 1
+              end
+              puts
               indent(-1).puts Ansi.bold s
-              section.delete(child.class)
-              section.delete(Paragraph)
               newline = false
-            else # Any other node add a newline
-#             p :C
+              next if child.is_a?(Section)
+            else # Any other node adds a newline
               puts if newline
               newline = true
             end
 
             if child.is_a?(Command)
-#             prefix = child.parent != self ? nil : child.supercommand&.name
-              prefix = child.supercommand == self ? nil : child.supercommand&.name
+              prefix = child.path[path.size..-2].map { |sym| sym.to_s.sub(/!/, "") }
               child.puts_descr(prefix, brief: false, name: :path)
               newline = true
              else
@@ -153,9 +161,10 @@ module ShellOpts
 
           # Also emit commands not declared in nested scope
           (commands - children.select { |child| child.is_a?(Command) }).each { |cmd|
+            next if cmd.parent.nil? # Skip implicit commands
             puts if newline
             newline = true
-            prefix = cmd.supercommand == self ? nil : cmd.supercommand&.name
+            prefix = cmd.command == self ? nil : cmd.command&.name
             cmd.puts_descr(prefix, brief: false, name: path)
           }
         }

data/lib/shellopts/grammar.rb

@@ -45,16 +45,18 @@ module ShellOpts
     end
 
     class IdrNode < Node
-      # Command of this object. This is different from #parent when a
-      # subcommand is nested on a higher level than its supercommand.
-      # Initialized by the analyzer
+      # Command of this object (nil for the top-level Program object). This is
+      # different from #parent when a subcommand is nested textually on a
+      # higher level than its supercommand.  Initialized by the analyzer
       attr_reader :command
 
       # Unique identifier of node (String) within the context of a program. nil
-      # for the Program object. It is the list of path elements concatenated
-      # with '.' and with internal '!' removed (eg. "cmd.opt" or "cmd.cmd!").
-      # Initialized by the parser
-      attr_reader :uid
+      # for the Program object. It is the dot-joined elements of path with
+      # internal exclamation marks removed (eg. "cmd.opt" or "cmd.cmd!").
+      # Initialize by the analyzer
+      def uid() 
+        @uid ||= command && [command.uid, ident].compact.join(".").sub(/!\./, ".") 
+      end
 
       # Path from Program object and down to this node. Array of identifiers.
       # Empty for the Program object. Initialized by the parser
@@ -84,6 +86,13 @@ module ShellOpts
       # #ident is a reserved word. Initialized by the parser
       attr_reader :attr
 
+      def set_name(name, path)
+        @name = name.to_s
+        @path = path
+        @ident = @path.last || :!
+        @attr = ::ShellOpts::Command::RESERVED_OPTION_NAMES.include?(@ident.to_s) ? nil : @ident
+      end
+
     protected
       def lookup(path)
         path.empty? or raise ArgumentError, "Argument should be empty"
@@ -151,6 +160,10 @@ module ShellOpts
     class OptionGroup < Node
       alias_method :command, :parent
 
+      # Duck typing for compatibility with IdrNode (TODO: maybe just make
+      # OptionGroup an IdrNode and be over with it)
+      def name() options.first&.name end
+
       # Array of options in declaration order
       attr_reader :options
 
@@ -185,10 +198,6 @@ module ShellOpts
     # methods are initialized by the analyzer
     #
     class Command < IdrNode
-      # Supercommand or nil if this is the top-level Program object.
-      # Initialized by the analyzer
-      attr_reader :supercommand
-
       # Brief description of command
       attr_accessor :brief
 
@@ -352,6 +361,10 @@ module ShellOpts
     end
 
     class Section < Node
+      def initialize(parent, token)
+        constrain token.source, *%w(DESCRIPTION OPTION COMMAND)
+        super
+      end
       def name() token.source end
     end
 

data/lib/shellopts/interpreter.rb

@@ -32,7 +32,7 @@ module ShellOpts
           end
         end
       end
-      [@expr, Args.new(@args + @argv)]
+      [@expr, Args.new(@args + @argv, exception: @exception)]
     end
 
     def self.interpret(grammar, argv, **opts)

data/lib/shellopts/lexer.rb

@@ -45,7 +45,7 @@ module ShellOpts
     # Match ArgDescr words (should be at least two characters long)
     DESCR_RE = /^[^a-z]{2,}$/
 
-    SECTIONS = %w(DESCRIPTION OPTIONS COMMANDS)
+    SECTIONS = %w(DESCRIPTION OPTION OPTIONS COMMAND COMMANDS)
 
     using Ext::Array::ShiftWhile
 
@@ -109,7 +109,7 @@ module ShellOpts
 
         # Sections
         elsif SECTIONS.include?(line.text)
-          @tokens << Token.new(:section, line.lineno, line.charno, line.text)
+          @tokens << Token.new(:section, line.lineno, line.charno, line.text.sub(/S$/, ""))
 
         # Options, commands, usage, arguments, and briefs
         elsif line =~ DECL_RE

data/lib/shellopts/parser.rb

@@ -16,9 +16,9 @@ module ShellOpts
     class IdrNode
       # Assumes that @name and @path has been defined
       def parse
-        @ident = @path.last || :!
-        @attr = ::ShellOpts::Command::RESERVED_OPTION_NAMES.include?(ident.to_s) ? nil : ident
-        @uid = parent && @path.join(".").sub(/!\./, ".") # uid is nil for the Program object
+#       @ident = @path.last || :!
+#       @attr = ::ShellOpts::Command::RESERVED_OPTION_NAMES.include?(ident.to_s) ? nil : ident
+#       @uid = parent && @path.join(".").sub(/!\./, ".") # uid is nil for the Program object
       end
     end
 
@@ -56,8 +56,9 @@ module ShellOpts
         @long_names = names.map { |name| "--#{name}" }
         @long_idents = names.map { |name| name.tr("-", "_").to_sym }
 
-        @name = @long_names.first || @short_names.first
-        @path = command.path + [@long_idents.first || @short_idents.first]
+        set_name(
+          @long_names.first || @short_names.first,
+          command.path + [@long_idents.first || @short_idents.first])
 
         @argument = !arg.nil?
 
@@ -108,11 +109,11 @@ module ShellOpts
       def parse
         if parent
           path_names = token.source.sub("!", "").split(".")
-          @name = path_names.last
-          @path = path_names.map { |cmd| "#{cmd}!".to_sym }
+          set_name(
+              path_names.last,
+              path_names.map { |cmd| "#{cmd}!".to_sym })
         else
-          @path = []
-          @name = token.source
+          set_name(token.source, [])
         end
         super
       end
@@ -123,16 +124,19 @@ module ShellOpts
         super(nil, token)
       end
 
-      def add_stdopts
+      def add_version_option
         option_token = Token.new(:option, 1, 1, "--version")
         brief_token = Token.new(:brief, 1, 1, "Write version number and exit")
         group = OptionGroup.new(self, option_token)
         option = Option.parse(group, option_token)
         brief = Brief.parse(group, brief_token)
+      end
 
+      def add_help_options
         option_token = Token.new(:option, 1, 1, "-h,help")
         brief_token = Token.new(:brief, 1, 1, "Write help text and exit")
-        paragraph_token = Token.new(:text, 1, 1, "-h prints a brief help text, --help prints a longer man-style description of the command")
+        paragraph_token = Token.new(:text, 1, 1, 
+            "-h prints a brief help text, --help prints a longer man-style description of the command")
         group = OptionGroup.new(self, option_token)
         option = Option.parse(group, option_token)
         brief = Brief.parse(group, brief_token)
@@ -162,14 +166,6 @@ module ShellOpts
       @nodes = {}
     end
 
-#   def add_stdopts
-#     version_token = Token.new(:option, 1, 1, "--version")
-#     version_brief = Token.new(:brief, 1, 1, "Gryf gryf")
-#     group = Grammar::OptionGroup.new(@program, version_token)
-#     option = Grammar::Option.parse(group, version_token)
-#     brief = Grammr::Brief.parse(option, version_brief)
-#   end
-
     def parse()
       @program = Grammar::Program.parse(@tokens.shift)
       oneline = @tokens.first.lineno == @tokens.last.lineno

data/lib/shellopts/program.rb

@@ -49,10 +49,10 @@ module ShellOpts
         singleton_method_removed singleton_method_undefined
     )
 
-    # These methods can be overridden by an option (the value is not used -
+    # These methods can be overridden by an option or a command (the value is not used -
     # this is just for informational purposes)
-    OVERRIDEABLE_METHODS = %w(
-        subcommand
+    OVERRIDEABLE_METHOD_NAMES = %w(
+        subcommand subcommand! supercommand!
     )
 
     # Redefine ::new to call #__initialize__
@@ -107,6 +107,7 @@ module ShellOpts
     #
     # Note: Can be overridden by option, in that case use #__subcommand__ or
     # ShellOpts.subcommand(object) instead
+    #
     def subcommand() __subcommand__ end
 
     # The subcommand object or nil if not present. Per-subcommand methods
@@ -120,7 +121,12 @@ module ShellOpts
     def subcommand!() __subcommand__! end
 
     # The parent command or nil. Initialized by #add_command
-    attr_accessor :__supercommand__
+    #
+    # Note: Can be overridden by a subcommand declaration (but not an
+    # option), in that case use #__supercommand__! or
+    # ShellOpts.supercommand!(object) instead
+    #
+    def supercommand!() __supercommand__ end
 
     # UID of command/program
     def __uid__() @__grammar__.uid end
@@ -149,6 +155,9 @@ module ShellOpts
     # Map from identifier to option object or to a list of option objects if
     # the option is repeatable
     attr_reader :__option_hash__
+
+    # The parent command or nil. Initialized by #add_command
+    attr_accessor :__supercommand__
     
     # The subcommand identifier (a Symbol incl. the exclamation mark) or nil
     # if not present. Use #subcommand!, or the dynamically generated

data/lib/shellopts/renderer.rb

@@ -38,13 +38,19 @@ module ShellOpts
       #
       def render(format)
         constrain format, :enum, :long, :short
-        case format
-          when :enum; names.join(", ")
-          when :long; name
-          when :short; short_names.first || name
+        s = 
+            case format
+              when :enum; names.join(", ")
+              when :long; name
+              when :short; short_names.first || name
+            else
+              raise ArgumentError, "Illegal format: #{format.inspect}"
+            end 
+        if argument?
+          s + (optional? ? "[=#{argument_name}]" : "=#{argument_name}")
         else
-          raise ArgumentError, "Illegal format: #{format.inspect}"
-        end + (argument? ? "=#{argument_name}" : "")
+          s
+        end
       end
     end
 
@@ -75,17 +81,19 @@ module ShellOpts
       COMMANDS_ABBR = "[COMMANDS]"
       DESCRS_ABBR = "ARGS..."
 
-      # Format can be one of :single, :enum, or :multi. :single force one-line
-      # output and compacts options and commands if needed. :enum outputs a
-      # :single line for each argument specification/description, :multi tries
-      # one-line output but wrap options if needed. Multiple argument
-      # specifications/descriptions are always compacted
+      # Format can be one of :abbr, :single, :enum, or :multi. :abbr
+      # lists the command on one line with options abbreviated. :single force
+      # one-line output and compacts options and commands if needed. :enum
+      # outputs a :single line for each argument specification/description,
+      # :multi tries one-line output but wrap options if needed. Multiple
+      # argument specifications/descriptions are always compacted
       #
       def render(format, width, root: false, **opts)
         case format
+          when :abbr; render_abbr
           when :single; render_single(width, **opts)
           when :enum; render_enum(width, **opts)
-          when :multi; render_multi2(width, **opts)
+          when :multi; render_multi(width, **opts)
         else
           raise ArgumentError, "Illegal format: #{format.inspect}"
         end
@@ -96,6 +104,21 @@ module ShellOpts
       end
 
     protected
+      # TODO: Refactor and implement recursive detection of any argument
+      def get_args(args: nil)
+        case descrs.size
+          when 0; []
+          when 1; [descrs.first.text]
+          else [DESCRS_ABBR]
+        end
+      end
+
+      # Force one line and compact options to "[OPTIONS]"
+      def render_abbr
+        args = get_args 
+        ([name] + [options.empty? ? nil : "[OPTIONS]"] + args).compact.join(" ")
+      end
+
       # Force one line. Compact options, commands, arguments if needed
       def render_single(width, args: nil)
         long_options = options.map { |option| option.render(:long) }
@@ -104,13 +127,7 @@ module ShellOpts
         short_commands = commands.empty? ? [] : ["[#{commands.map(&:name).join("|")}]"]
         compact_commands = commands.empty? ? [] : [COMMANDS_ABBR]
 
-        # TODO: Refactor and implement recursive detection of any argument
-        args ||= 
-            case descrs.size
-              when 0; args = []
-              when 1; [descrs.first.text]
-              else [DESCRS_ABBR]
-            end
+        args ||= get_args
 
         begin # to be able to use 'break' below
           words = [name] + long_options + short_commands + args
@@ -149,36 +166,8 @@ module ShellOpts
         short_options = options.map { |option| option.render(:short) }
         short_commands = commands.empty? ? [] : ["[#{commands.map(&:name).join("|")}]"]
         compact_commands = [COMMANDS_ABBR]
-        args ||= self.descrs.size != 1 ? [DESCRS_ABBR] : descrs.map(&:text)
-
-        # On one line
-        words = long_options + short_commands + args
-        return [words.join(" ")] if pass?(words, width)
-        words = short_options + short_commands + args
-        return [words.join(" ")] if pass?(words, width)
-
-        # On multiple lines
-        options = long_options.wrap(width)
-        commands = [[short_commands, args].join(" ")]
-        return options + commands if pass?(commands, width)
-        options + [[compact_commands, args].join(" ")]
-      end
-
-      # Try to keep on one line but wrap options if needed. Multiple argument
-      # specifications/descriptions are always compacted
-      def render_multi2(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]
 
-        # TODO: Refactor and implement recursive detection of any argument
-        args ||= 
-            case descrs.size
-              when 0; args = []
-              when 1; [descrs.first.text]
-              else [DESCRS_ABBR]
-            end
+        args ||= get_args
 
         # On one line
         words = [name] + long_options + short_commands + args

data/lib/shellopts/version.rb

@@ -1,3 +1,3 @@
 module ShellOpts
-  VERSION = "2.0.7"
+  VERSION = "2.0.10"
 end

data/lib/shellopts.rb

@@ -1,12 +1,6 @@
 
-$quiet = nil
-$verb = nil
-$debug = nil
-$shellopts = nil
-
 require 'indented_io'
 
-#$LOAD_PATH.unshift "../constrain/lib"
 require 'constrain'
 include Constrain
 
@@ -98,14 +92,22 @@ module ShellOpts
     # Array of remaining arguments. Initialized by #interpret
     attr_reader :args
 
-    # Compiler flags
-    attr_accessor :stdopts
-    attr_accessor :msgopts
+    # Automatically add a -h and a --help option if true
+    attr_reader :help
 
-    # Version of client program. This is only used if +stdopts+ is true
-    attr_reader :version
+    # Version of client program. If not nil a --version option is added to the program
+    def version
+      return @version if @version
+      exe = caller.find { |line| line =~ /`<top \(required\)>'$/ }&.sub(/:.*/, "")
+      file = Dir.glob(File.dirname(exe) + "/../lib/*/version.rb").first
+      @version = IO.read(file).sub(/^.*VERSION\s*=\s*"(.*?)".*$/m, '\1') or
+          raise ArgumentError, "ShellOpts needs an explicit version"
+    end
+
+    # Add message options (TODO)
+    attr_accessor :msgopts
 
-    # Interpreter flags
+    # Floating options
     attr_accessor :float
 
     # True if ShellOpts lets exceptions through instead of writing an error
@@ -117,11 +119,14 @@ module ShellOpts
 
     # Debug: Internal variables made public
     attr_reader :tokens
-    alias_method :ast, :grammar # Oops - defined earlier FIXME
+    alias_method :ast, :grammar
 
-    def initialize(name: nil, stdopts: true, version: nil, msgopts: false, float: true, exception: false)
+    def initialize(name: nil, help: true, version: true, msgopts: false, float: true, exception: false)
       @name = name || File.basename($PROGRAM_NAME)
-      @stdopts, @version, @msgopts, @float, @exception = stdopts, version, msgopts, float, exception
+      @help = help
+      @use_version = version ? true : false
+      @version = @use_version && @version != true ? @version : nil
+      @msgopts, @float, @exception = msgopts, float, exception
     end
 
     # Compile source and return grammar object. Also sets #spec and #grammar.
@@ -133,7 +138,8 @@ module ShellOpts
         @file = find_caller_file
         @tokens = Lexer.lex(name, @spec, @oneline)
         ast = Parser.parse(tokens)
-        ast.add_stdopts if stdopts
+        ast.add_version_option if @use_version
+        ast.add_help_options if @help
         @grammar = Analyzer.analyze(ast)
       }
       self
@@ -146,19 +152,16 @@ module ShellOpts
       handle_exceptions { 
         @argv = argv.dup
         @program, @args = Interpreter.interpret(grammar, argv, float: float, exception: exception)
-        if stdopts
-          if @program.version?
-            version or raise ArgumentError, "Version not specified"
-            puts version 
-            exit
-          elsif @program.help?
-            if @program[:help].name == "-h"
-              ShellOpts.brief
-            else
-              ShellOpts.help
-            end
-            exit
+        if @program.version?
+          puts version 
+          exit
+        elsif @program.help?
+          if @program[:help].name == "-h"
+            ShellOpts.brief
+          else
+            ShellOpts.help
           end
+          exit
         end
       }
       self
@@ -364,132 +367,3 @@ module ShellOpts
   end
 end
 
-
-
-
-
-
-
-
-__END__
-
-require "shellopts/version"
-
-require "ext/algorithm.rb"
-require "ext/ruby_env.rb"
-
-require "shellopts/constants.rb"
-require "shellopts/exceptions.rb"
-
-require "shellopts/grammar/analyzer.rb"
-require "shellopts/grammar/lexer.rb"
-require "shellopts/grammar/parser.rb"
-require "shellopts/grammar/command.rb"
-require "shellopts/grammar/option.rb"
-
-require "shellopts/ast/parser.rb"
-require "shellopts/ast/command.rb"
-require "shellopts/ast/option.rb"
-
-require "shellopts/args.rb"
-require "shellopts/formatter.rb"
-
-if RUBY_ENV == "development"
-  require "shellopts/grammar/dump.rb"
-  require "shellopts/ast/dump.rb"
-end
-
-$verb = nil
-$quiet = nil
-$shellopts = nil
-
-module ShellOpts
-  class ShellOpts
-    attr_reader :name # Name of program. Defaults to the name of the executable
-    attr_reader :spec
-    attr_reader :argv
-
-    attr_reader :grammar
-    attr_reader :program
-    attr_reader :arguments
-
-    def initialize(spec, argv, name: nil, exception: false)
-      @name = name || File.basename($PROGRAM_NAME)
-      @spec, @argv = spec, argv.dup
-      exprs = Grammar::Lexer.lex(@spec)
-      commands = Grammar::Parser.parse(@name, exprs)
-      @grammar = Grammar::Analyzer.analyze(commands)
-
-      begin
-        @program, @arguments = Ast::Parser.parse(@grammar, @argv)
-      rescue Error => ex
-        raise if exception
-        error(ex.subject, ex.message)
-      end
-    end
-
-    def error(subject = nil, message)
-      $stderr.puts "#{name}: #{message}"
-      usage(subject, device: $stderr)
-      exit 1
-    end
-
-    def fail(message)
-      $stderr.puts "#{name}: #{message}"
-      exit 1
-    end
-
-    def usage(subject = nil, device: $stdout, levels: 1, margin: "")
-      subject = find_subject(subject)
-      device.puts Formatter.usage_string(subject, levels: levels, margin: margin)
-    end
-
-    def help(subject = nil, device: $stdout, levels: 10, margin: "", tab: "  ")
-      subject = find_subject(subject)
-      device.puts Formatter.help_string(subject, levels: levels, margin: margin, tab: tab)
-    end
-
-  private
-    def lookup(name)
-      a = name.split(".")
-      cmd = grammar
-      while element = a.shift
-        cmd = cmd.commands[element]
-      end
-      cmd
-    end
-
-    def find_subject(obj)
-      case obj
-        when String; lookup(obj)
-        when Ast::Command; Command.grammar(obj)
-        when Grammar::Command; obj
-        when NilClass; grammar
-      else
-        raise Internal, "Illegal object: #{obj.class}"
-      end
-    end
-  end
-
-  def self.process(spec, argv, name: nil, exception: false)
-    $shellopts = ShellOpts.new(spec, argv, name: name, exception: exception)
-    [$shellopts.program, $shellopts.arguments]
-  end
-
-  def self.error(subject = nil, message)
-    $shellopts.error(subject, message)
-  end
-
-  def self.fail(message)
-    $shellopts.fail(message)
-  end
-
-  def self.help(subject = nil, device: $stdout, levels: 10, margin: "", tab: "  ")
-    $shellopts.help(subject, device: device, levels: levels, margin: margin, tab: tab)
-  end
-
-  def self.usage(subject = nil, device: $stdout, levels: 1, margin: "")
-    $shellopts.usage(subject, device: device, levels: levels, margin: margin)
-  end
-end
-

data/main

@@ -7,12 +7,15 @@ require 'shellopts'
 
 include ShellOpts
 
+p ShellOpts::ShellOpts.default_version
+exit
+
 VERSION = "1.2.3"
 
 SPEC = %(
   -a @ An option
 )
-opts, args = ShellOpts::process(SPEC, ARGV, version: VERSION)
+opts, args = ShellOpts.process(SPEC, ARGV, version: VERSION)
 #ShellOpts::ShellOpts.help
 
 

data/shellopts.gemspec

@@ -1,7 +1,5 @@
 
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "shellopts/version"
+require_relative "lib/shellopts/version"
 
 Gem::Specification.new do |spec|
   spec.name          = "shellopts"
@@ -15,15 +13,18 @@ Gem::Specification.new do |spec|
                           and has built-in help and error messages}
   spec.homepage      = "http://github.com/clrgit/shellopts"
 
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{^(test|spec|features)/})
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
   end
+
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
   spec.add_dependency "forward_to"
-  spec.add_dependency "constrain"
+  spec.add_dependency "constrain", "~> 0.5.1"
   spec.add_dependency "ruby-terminfo"
   spec.add_dependency "indented_io"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shellopts
 version: !ruby/object:Gem::Version
-  version: 2.0.7
+  version: 2.0.10
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-03 00:00:00.000000000 Z
+date: 2022-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: forward_to
@@ -28,16 +28,16 @@ dependencies:
   name: constrain
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.5.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.5.1
 - !ruby/object:Gem::Dependency
   name: ruby-terminfo
   requirement: !ruby/object:Gem::Requirement
@@ -132,10 +132,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
 - ".rspec"
 - ".ruby-version"
-- ".travis.yml"
 - Gemfile
 - README.md
 - Rakefile

data/.gitignore

@@ -1,30 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/rdoc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status
-
-# simplecov
-/coverage/
-
-# Ignore Gemfile.lock. See https://stackoverflow.com/questions/4151495/should-gemfile-lock-be-included-in-gitignore
-/Gemfile.lock
-
-# Ignore vim files
-.*.swp
-
-# Ignore t.* files
-t
-t.*
-tt
-tt.*
-s
-s.*
-
-# Ignore temporary directory
-/spec/tmpdir/

data/.travis.yml

@@ -1,5 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.5.1
-before_install: gem install bundler -v 1.16.1