clint 0.1.5 → 0.2.1

data/lib/clint.rb

@@ -2,7 +2,7 @@ class Clint
 
   def initialize(options={})
     reset
-    @strict = !options[:strict].nil?
+    @strict = !!options[:strict]
   end
 
   def usage
@@ -118,6 +118,28 @@ class Clint
     @args = args
   end
 
+  # Pass options and arguments however possible to the given callable, which
+  # could be a Proc or just an object that responds to the method call.
+  def dispatch(callable)
+    arity = begin
+      callable.arity
+    rescue NoMethodError
+      callable.method(:call).arity
+    end
+    if @args.length == arity
+      callable.call(*@args)
+    elsif -@args.length - 1 == arity
+      callable.call(*(@args + [@options]))
+    else
+      dispatch callable.new
+      exit 0
+    end
+  rescue Exception => e
+    raise e if SystemExit == e.class
+    usage
+    exit 1
+  end
+
   # Treat the first non-option argument as a subcommand in the given class.
   # If a suitable class method is found, it is called with all remaining
   # arguments, including @options if we can get away with it.  Otherwise,

metadata

@@ -1,12 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: clint
 version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 1
-  - 5
-  version: 0.1.5
+  version: 0.2.1
 platform: ruby
 authors: 
 - Richard Crowley
@@ -14,58 +9,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-09 00:00:00 +00:00
+date: 2010-03-30 00:00:00 +00:00
 default_executable: 
 dependencies: []
 
-description: |
-  clint(7) -- Ruby command line argument parser
-  =============================================
-  
-  ## SYNOPSIS
-  
-  	require 'clint'
-  	c = Clint.new
-  	c.usage do
-  	  $stderr.puts "Usage: #{File.basename(__FILE__)} [-h|--help]"
-  	end
-  	c.help do
-  	  $stderr.puts "  -h, --help\tshow this help message"
-  	end
-  	c.options :help => false, :h => :help
-  	c.parse ARGV
-  	if c.options[:help]
-  	  c.help
-  	  exit 1
-  	end
-  	c.subcommand Klass
-  
-  ## DESCRIPTION
-  
-  Clint is an alternative Ruby command line argument parser that's very good for programs using the subcommand pattern familiar from `git`(1), `svn`(1), `apt-get`(8), and many others.  In addition, it separates option declarations from usage and help messages becuase the author feels like that's a better idea.
-  
-  Clint options are declared by passing hash arguments to `Clint#options`.  The hash keys should be `Symbol`s.  If the value is also a `Symbol`, an alias is defined from the key to the value.  If the value is a `Class`, Clint attempts to find a default value for that class.  Otherwise, the value is treated as the default and the value's class will be used to construct type-accurate values from command line arguments.
-  
-  `Clint#options` may be called repeatedly to declare extra options and aliases.  `Clint#reset` can be used at any time to clear all declared options and aliases.
-  
-  `Clint#parse` may likewise be called repeatedly.  At the end of each invocation, it stores the remaining non-option arguments, meaning that arguments (for example, `ARGV`) must only be passed as a parameter to the first invocation.
-  
-  `Clint#subcommand` may be called after `Clint#parse` to automatically handle the subcommand pattern as follows.  The first non-option argument is taken to be the subcommand, which must exist as a singleton or instance method of the class object passed to `Clint#subcommand`.  If a suitable class method is found, it is called with all remaining arguments, including a hash of the parsed options if we can get away with it.  Otherwise, an instance is constructed with the next non-option argument and the instance method is called with all remaining arguments, again including a hash of the parsed options if we can get away with it.
-  
-  Due to limitations in the Ruby 1.8 grammar, all methods that could act as subcommands must not declare default argument values except `options={}` if desired.
-  
-  ## THEME SONG
-  
-  Leo Arnaud and John Williams - "Bugler's Dream"
-  
-  ## AUTHOR
-  
-  Richard Crowley <r@rcrowley.org>
-  
-  ## SEE ALSO
-  
-  The standard Ruby `OptionParser` class <http://ruby-doc.org/stdlib/libdoc/optparse/rdoc/classes/OptionParser.html>.
-
+description: command line argument parser
 email: r@rcrowley.org
 executables: []
 
@@ -89,20 +37,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
+  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
+  version: 
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: command line argument parser