cmdparse 1.0.4 → 1.0.5

data/ChangeLog

@@ -1,4 +1,12 @@
 ------------------------------------------------------------------------
+r328 | thomas | 2005-07-05 16:10:02 +0200 (Tue, 05 Jul 2005) | 1 line
+Changed paths:
+   M /trunk/cmdparse/Rakefile
+   M /trunk/cmdparse/doc/src/index.page
+   M /trunk/cmdparse/lib/cmdparse.rb
+
+* added possibility to parse global options, command and local options separately
+------------------------------------------------------------------------
 r302 | thomas | 2005-06-16 12:02:37 +0200 (Thu, 16 Jun 2005) | 1 line
 Changed paths:
    M /trunk/cmdparse/doc/src/index.page

data/Rakefile

@@ -130,13 +130,13 @@ else
 
     s.has_rdoc = true
     s.extra_rdoc_files = rd.rdoc_files.reject do |fn| fn =~ /\.rb$/ end.to_a
-    s.rdoc_options = ['--line-numbers', '-m README']
+    s.rdoc_options = ['--line-numbers', '-m', 'README']
 
     #### Author and project details
 
     s.author = "Thomas Leitner"
     s.email = "t_leitner@gmx.at"
-    s.homepage = "cmdparse.rubyforge.org"
+    s.homepage = "http://cmdparse.rubyforge.org"
     s.rubyforge_project = "cmdparse"
   end
 

data/VERSION

@@ -1 +1 @@
-1.0.4
+1.0.5

data/doc/src/index.page

@@ -12,6 +12,13 @@ Have a look around the site!
 
 h2. News
 
+<b>2005-07-05 cmdparse 1.0.5 released!!!</b>
+
+Changes:
+
+* added possibility to parse global options, command and local options separately
+
+
 <b>2005-06-16 cmdparse 1.0.4 released!!!</b>
 
 Changes:

data/lib/cmdparse.rb

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: cmdparse.rb 297 2005-06-14 09:30:22Z thomas $
+# $Id: cmdparse.rb 328 2005-07-05 14:10:02Z thomas $
 #
 # cmdparse: an advanced command line parser using optparse which supports commands
 # Copyright (C) 2004 Thomas Leitner
@@ -107,7 +107,7 @@ end
 class CommandParser
 
   # The version of the command parser
-  VERSION = [1, 0, 4]
+  VERSION = [1, 0, 5]
 
   # This error is thrown when an invalid command is encountered.
   class InvalidCommandError < OptionParser::ParseError
@@ -313,6 +313,33 @@ class CommandParser
     command.init( self )
   end
 
+  # Parses the global options.
+  def parse_global_options!( args )
+    @options.order!( args )
+  end
+
+  # Parses the command.
+  def parse_command!( args )
+    @parsed[:command] = args.shift
+    if @parsed[:command].nil?
+      if @default.nil?
+        raise NoCommandGivenError
+      else
+        @parsed[:command] = @default
+      end
+    else
+      raise InvalidCommandError.new( @parsed[:command] ) unless commands.include?( @parsed[:command] )
+    end
+  end
+
+  # Parses the local options. Attention: The command has to be parsed (invoke method
+  # +parse_command!+) before this method can be invoked.
+  def parse_local_options!( args )
+    if @parsed[:command]
+      commands[@parsed[:command]].options.permute!( args ) unless commands[@parsed[:command]].options.nil?
+    end
+  end
+
   # Calls +parse+ - implemented to mimic OptionParser
   def permute( args ); parse( args ); end
   # Calls +parse!+ - implemented to mimic OptionParser
@@ -321,41 +348,29 @@ class CommandParser
   def order( args ); parse( args ); end
   # Calls +parse!+ - implemented to mimic OptionParser
   def order!( args ); parse!( args ); end
-
   # see CommandParser#parse!
   def parse( args ); parse!( args.dup ); end
 
   # Parses the given argument. First it tries to parse global arguments if given. After that the
-  # command name is analyzied and the options for the specific commands parsed. If +execCommand+
-  # is true, the command is executed immediately. If false, the +CommandParser#execute+ has to be
-  # called to execute the command.
-  def parse!( args, execCommand = true )
-    # parse global options
+  # command name is analyzied and the options for the specific commands parsed. If +execCommand+ is
+  # true, the command is executed immediately. If false, the <tt>CommandParser#execute</tt> has to
+  # be called to execute the command. The optional +parse+ parameter specifies what should be
+  # parsed. If <tt>:global</tt> is included in the +parse+ array, global options are parsed; if
+  # <tt>:command</tt> is included, the command is parsed and if <tt>:local</tt> is included, the
+  # local options are parsed.
+  def parse!( args, execCommand = true, parse = [:global, :command, :local] )
     begin
-      @options.order!( args )
-      @parsed[:command] = args.shift
-      if @parsed[:command].nil?
-        if @default.nil?
-          raise NoCommandGivenError
-        else
-          @parsed[:command] = @default
-        end
-      else
-        raise InvalidCommandError.new( @parsed[:command] ) unless commands.include?( @parsed[:command] )
-      end
-    rescue OptionParser::ParseError => e
-      handle_exception( e, :global )
-    end
+      context = :global
+      parse_global_options!( args ) if parse.include?( :global )
+      parse_command!( args ) if parse.include?( :command )
 
-    # parse local options
-    begin
-      commands[@parsed[:command]].options.permute!( args ) unless commands[@parsed[:command]].options.nil?
+      context = :local
+      parse_local_options!( args ) if parse.include?( :local )
     rescue OptionParser::ParseError => e
-      handle_exception( e, :local )
+      handle_exception( e, context )
     end
 
     @parsed[:args] = args
-
     execute if execCommand
   end
 

metadata

@@ -3,13 +3,13 @@ rubygems_version: 0.8.6
 specification_version: 1
 name: cmdparse
 version: !ruby/object:Gem::Version 
-  version: 1.0.4
-date: 2005-06-16
+  version: 1.0.5
+date: 2005-07-05
 summary: An advanced command line parser using optparse which supports commands
 require_paths: 
   - lib
 email: t_leitner@gmx.at
-homepage: cmdparse.rubyforge.org
+homepage: http://cmdparse.rubyforge.org
 rubyforge_project: cmdparse
 description: "cmdparse extends the default option parser 'optparse' by adding support for
   commands. Programs that use such command line interfaces are, for example,
@@ -53,7 +53,8 @@ files:
 test_files: []
 rdoc_options: 
   - "--line-numbers"
-  - "-m README"
+  - "-m"
+  - README
 extra_rdoc_files: 
   - README
 executables: []