clive 0.4.0 → 0.4.1

data/README.md

@@ -120,6 +120,21 @@ Anything that isn't a command, switch or flag is taken as an argument. These are
     my_file --size big /usr/bin
     #=> ["/usr/bin"]
 
+
+### Error Handling
+
+You are able to intercept errors when an option does not exist in a similar way to `method_missing`.
+
+    c = Clive.new do
+      option_missing do |name|
+        puts "#{name} was used but not defined"
+      end
+    end
+    c.parse("--hey")
+    #=> hey was used but not defined
+
+I was hoping to provide a similar way of intercepting commands as well but these could also be arguments which means it could result in unexpected results. For this reason I will not be implementing `command_missing`.
+
 ### Putting It All Together
 
     require 'clive'

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/clive.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{clive}
-  s.version = "0.4.0"
+  s.version = "0.4.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Joshua Hawxwell"]
-  s.date = %q{2010-09-19}
+  s.date = %q{2010-10-25}
   s.description = %q{Clive is a DSL for creating a command line interface. It is for people who, like me, love OptionParser's syntax and love GLI's commands.}
   s.email = %q{m@hawx.me}
   s.extra_rdoc_files = [

data/lib/clive/command.rb

@@ -29,6 +29,8 @@ class Clive
       @base     = false
       @commands = Clive::Array.new
       @options  = Clive::Array.new
+      
+      @option_missing = Proc.new {|e| raise NoOptionError.new(e)}
     
       if args.length == 1 && args[0] == true
         @base = true
@@ -183,15 +185,20 @@ class Clive
               r << [:argument, v]
             end
           else
-            raise InvalidOption.new(v)
+            @option_missing.call(v)
           end
         end
       end
       r
     end
+    
+  # @group Missing Helpers
+  
+    def option_missing(&block)
+      @option_missing = block
+    end      
       
-      
-  #### CREATION HELPERS #### 
+  # @group Creators
   
     # Add a new command to +@commands+
     #
@@ -230,7 +237,7 @@ class Clive
     end
     alias_method :boolean, :bool
     
-  #### HELP STUFF ####
+  # @group Help
     
     # This actually creates a switch with "-h" and "--help" that controls
     # the help on this command.

data/lib/clive/exceptions.rb

@@ -31,6 +31,11 @@ class Clive
     def reason; "parse error"; end
   end
   
+  # Long name is missing for bool
+  class MissingLongName < CliveError
+    def reason; "missing long name"; end
+  end
+  
   # A flag has a missing argument
   class MissingArgument < ParseError
     def reason; "missing argument"; end
@@ -42,13 +47,8 @@ class Clive
   end
   
   # An option that wasn't defined has been found
-  class InvalidOption < ParseError
+  class NoOptionError < ParseError
     def reason; "invalid option"; end
   end
   
-  # Long name is missing for bool
-  class MissingLongName < CliveError
-    def reason; "missing long name"; end
-  end
-  
 end

data/test/bin_test

@@ -5,46 +5,51 @@ require 'clive'
 options = {}
 c = Clive.new do
 
-  switch(:v, :verbose, "Run verbosely") {
+  switch :v, :verbose, "Run verbosely" do
     options[:verbose] = true
-  }
+  end
   
-  flag(:t, :type, "TYPE", "Change type to TYPE") do |i|
+  flag :t, :type, "TYPE", "Change type to TYPE" do |i|
     options[:type] = i
   end
   
   flag(:long_only, "A flag with only a long") {}
   
-  flag(:p, :print, "[TEXT]", "Print TEXT, defaults to 'hey'") do |i|
+  flag :p, :print, "[TEXT]", "Print TEXT, defaults to 'hey'" do |i|
     i ||= 'hey'
     p i
   end
   
   flag(:z, :apple, "More applez") {}
   
-  command(:add, "Add something") {
+  command :add, "Add something" do
     
     header "Usage: bin_test add [options]\n" +
            "Use add to add things to add, which in turn can be added."
     
-    switch(:f, :full, "Use full") {
+    switch :f, :full, "Use full" do
       options[:full] = true
-    }  
+    end
     
     # Use with app-name add -e
-    switch(:e, :empty, "Use empty") {
+    switch :e, :empty, "Use empty" do
       options[:full] = false
-    }
+    end
     
     footer "If the header was a little confusing, don't worry the footer thought so too."
   
-  }
+  end
   
-  command(:remove, :delete, "Get rid of something") {
-    switch(:f, :force, "Force") {
+  command :remove, :delete, "Get rid of something" do
+    switch :f, :force, "Force" do
       p "deleting! now"
-    }   
-  }
+    end
+  end
+  
+  
+  option_missing do |name|
+    puts "hi, #{name}"
+  end
 
 end
 

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: clive
 version: !ruby/object:Gem::Version 
-  hash: 15
   prerelease: false
   segments: 
   - 0
   - 4
-  - 0
-  version: 0.4.0
+  - 1
+  version: 0.4.1
 platform: ruby
 authors: 
 - Joshua Hawxwell
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-19 00:00:00 +01:00
+date: 2010-10-25 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,7 +25,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
         segments: 
         - 0
         version: "0"
@@ -40,7 +38,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 3
         segments: 
         - 0
         version: "0"
@@ -95,7 +92,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -104,7 +100,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"