methadone 0.3.3 → 0.3.4

data/README.rdoc

@@ -91,6 +91,12 @@ Methadone gives you a simple,lightweight DSL to help.  It's important to note th
     arg :name
     arg :password, :optional
 
+    # If you want to avoid automatic exception catching/logging do:
+    #
+    # leak_exceptions true
+    #
+    # Note that Methadone::Error exceptions are always caught and logged
+
     go!
 
 +go!+ runs the block you gave to +main+, passing it the unparsed +ARGV+ as parameters to the block.  It will

data/lib/methadone/main.rb

@@ -87,6 +87,16 @@ module Methadone
       @option_parser = OptionParserProxy.new(OptionParser.new,@options)
     end
 
+    # Configure the auto-handling of StandardError exceptions caught
+    # from calling go!.
+    #
+    # leak - if true, go! will *not* catch StandardError exceptions, but instead
+    #        allow them to bubble up.  If false, they will be caught and handled as normal.
+    #        This does *not* affect Methadone::Error exceptions; those will NOT leak through.
+    def leak_exceptions(leak)
+      @leak_exceptions = leak
+    end
+
 
     # Start your command-line app, exiting appropriately when
     # complete.
@@ -196,6 +206,7 @@ module Methadone
       error ex.message unless no_message? ex
       ex.exit_code
     rescue => ex
+      raise ex if @leak_exceptions
       error ex.message unless no_message? ex
       70 # Linux sysexit code for internal software error
     end

data/lib/methadone/version.rb

@@ -1,3 +1,3 @@
 module Methadone
-  VERSION = "0.3.3"
+  VERSION = "0.3.4"
 end

data/test/test_main.rb

@@ -93,8 +93,6 @@ class TestMain < BaseTest
     end
   end
 
-  def run_go!; proc { go! }; end
-
   test_that "go exits with the numeric value that main evaluated to" do
     [0,1,2,3].each do |exit_status|
       Given main_that_exits exit_status
@@ -120,6 +118,35 @@ class TestMain < BaseTest
     }
   end
 
+  test_that "An exception that's not a StandardError causes the excepteion to break through and raise" do
+    Given {
+      main do
+        raise Exception,"oh noes"
+      end
+    }
+    Then {
+      ex = assert_raises Exception do
+        When run_go!
+      end
+      assert_equal "oh noes",ex.message
+    }
+  end
+
+  test_that "Non-methadone exceptions leak through if we configure it that way" do
+    Given {
+      main do
+        raise StandardError,"oh noes"
+      end
+      leak_exceptions true
+    }
+    Then {
+      ex = assert_raises StandardError do
+        When run_go!
+      end
+      assert_equal "oh noes",ex.message
+    }
+  end
+
   test_that "go exits with the exit status included in the special-purpose excepiton" do
     Given {
       main do
@@ -368,6 +395,8 @@ class TestMain < BaseTest
   rescue SystemExit
   end
 
+  def run_go!; proc { go! }; end
+
   def assert_logged_at_error(expected_message)
     @logged.should include expected_message
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: methadone
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-04 00:00:00.000000000Z
+date: 2011-11-10 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70155090787300 !ruby/object:Gem::Requirement
+  requirement: &70257700838920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70155090787300
+  version_requirements: *70257700838920
 - !ruby/object:Gem::Dependency
   name: rspec-expectations
-  requirement: &70155090786800 !ruby/object:Gem::Requirement
+  requirement: &70257700838400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '2.6'
   type: :development
   prerelease: false
-  version_requirements: *70155090786800
+  version_requirements: *70257700838400
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70155090786380 !ruby/object:Gem::Requirement
+  requirement: &70257700837880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70155090786380
+  version_requirements: *70257700837880
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &70155090785840 !ruby/object:Gem::Requirement
+  requirement: &70257700837200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: '3.9'
   type: :development
   prerelease: false
-  version_requirements: *70155090785840
+  version_requirements: *70257700837200
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &70155090785340 !ruby/object:Gem::Requirement
+  requirement: &70257700836640 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 1.1.1
   type: :development
   prerelease: false
-  version_requirements: *70155090785340
+  version_requirements: *70257700836640
 - !ruby/object:Gem::Dependency
   name: aruba
-  requirement: &70155090784960 !ruby/object:Gem::Requirement
+  requirement: &70257700836160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70155090784960
+  version_requirements: *70257700836160
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &70155090784420 !ruby/object:Gem::Requirement
+  requirement: &70257700835560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,10 +87,10 @@ dependencies:
         version: '0.5'
   type: :development
   prerelease: false
-  version_requirements: *70155090784420
+  version_requirements: *70257700835560
 - !ruby/object:Gem::Dependency
   name: test_unit-given
-  requirement: &70155090783920 !ruby/object:Gem::Requirement
+  requirement: &70257700834960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,7 +98,7 @@ dependencies:
         version: 0.1.1
   type: :development
   prerelease: false
-  version_requirements: *70155090783920
+  version_requirements: *70257700834960
 description: Methadone provides a lot of small but useful features for developing
   a command-line app, including an opinionated bootstrapping process, some helpful
   cucumber steps, and some classes to bridge logging and output into a simple, unified,