shellopts 2.0.9 → 2.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9d576d24bd0aec0dd43a2a3645ede04751d80ae22a4c88e8f66ed53bbe7e405
-  data.tar.gz: 9027ac55689a345099f6515e5280808528603dfafe385219e6cce77d1c166d96
+  metadata.gz: 812078e64c677a6aff78081e25a04b81be3b3a1fe9496709838e2abb80573b4a
+  data.tar.gz: 92c14741c409697f543820d656683b9552d4c6c7ce5c29b01a30677a174549c2
 SHA512:
-  metadata.gz: b44a4d95aa0585dd0ec31abccde4942c98ad712d9e3bdf9f0c0b6ead7333ff4c5b555ec5b45786a6f539388b2460c93d12f3755b2e80cbb81fd269c42a9b4955
-  data.tar.gz: 3c948a743d809df7d22bc142dcfa9aa4e943fed144004c4fbf5d1995c314f4aea3f91b032533222eed953e5344a45c55666339797e5ae2b1be262eea17071cd5
+  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,10 +20,6 @@ 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
@@ -54,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
@@ -76,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/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
             }
@@ -125,9 +136,9 @@ module ShellOpts
               section.delete(klass)
               section.delete(Paragraph)
               if klass <= OptionGroup
-                s = s + "S" if options.size > 1
+                s += "S" if options.size > 1
               elsif klass <= Command
-                s = s + "S" if commands.size > 1 || commands.first&.commands&.size != 0
+                s += "S" if commands.size > 1 || commands.size == 1 && commands.first.commands.size > 1
               end
               puts
               indent(-1).puts Ansi.bold s
@@ -139,7 +150,7 @@ module ShellOpts
             end
 
             if child.is_a?(Command)
-              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
@@ -150,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"
@@ -189,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
 

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,13 +124,15 @@ 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, 

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.9"
+  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
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shellopts
 version: !ruby/object:Gem::Version
-  version: 2.0.9
+  version: 2.0.10
 platform: ruby
 authors:
 - Claus Rasmussen
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-03-06 00:00:00.000000000 Z
+date: 2022-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: forward_to