override_kernel 0.0.1

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+gem 'app_mode', '~> 1.0.0'
+
+group :rake do
+  gem 'rake_tasks', '~> 0.0.1'
+end

data/Gemfile.lock

@@ -0,0 +1,14 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    app_mode (1.0.1)
+    rake (0.8.7)
+    rake_tasks (0.0.4)
+      rake (~> 0.8.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  app_mode (~> 1.0.0)
+  rake_tasks (~> 0.0.1)

data/README

@@ -0,0 +1,48 @@
+== Welcome to OverrideKernel
+
+OverrideKernel changes Kernel functions
+from nasty wildebeasts into fluffy, harmless bunnies.
+Currently, only the exit function is dealt with in such a manner.
+
+== Getting Started
+
+1. Install OverrideKernel at the command prompt if you haven't yet:
+
+    gem install override_kernel
+
+2. Require the gem in your Gemfile:
+
+    gem 'override_kernel', '~> 0.0.1'
+
+3. Require the gem wherever you need to use it:
+
+    require 'override_kernel'
+
+== Usage
+
+Simply use the following call to start brushing the exit function off like it's
+a harmless pest:
+
+ start_override_exit
+
+This line will gladly put it back in your way:
+
+ stop_override_exit
+
+You can check the state of the application by
+checking OverrideKernel.override_exit.
+
+== Notes
+
+* Please note that it is up to you to 'reset' the application's state should
+  it be found to be 'dead'. The following line will do the deed:
+
+   OverrideKernel::AppState.state = :alive
+
+== Additional Documentation
+
+ rake rdoc:app
+
+== License
+
+OverrideKernel is released under the GPLv3 license.

data/lib/override_kernel/exit.rb

@@ -0,0 +1,45 @@
+# This file contains a monkey patch of Kernel functions for use during testing.
+
+#--
+################################################################################
+#                      Copyright (C) 2011 Travis Herrick                       #
+################################################################################
+#                                                                              #
+#                                 \v^V,^!v\^/                                  #
+#                                 ~%       %~                                  #
+#                                 {  _   _  }                                  #
+#                                 (  *   -  )                                  #
+#                                 |    /    |                                  #
+#                                  \   _,  /                                   #
+#                                   \__.__/                                    #
+#                                                                              #
+################################################################################
+# This program is free software: you can redistribute it                       #
+# and/or modify it under the terms of the GNU General Public License           #
+# as published by the Free Software Foundation,                                #
+# either version 3 of the License, or (at your option) any later version.      #
+#                                                                              #
+# Commercial licensing may be available for a fee under a different license.   #
+################################################################################
+# This program is distributed in the hope that it will be useful,              #
+# but WITHOUT ANY WARRANTY;                                                    #
+# without even the implied warranty of MERCHANTABILITY                         #
+# or FITNESS FOR A PARTICULAR PURPOSE.                                         #
+# See the GNU General Public License for more details.                         #
+#                                                                              #
+# You should have received a copy of the GNU General Public License            #
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
+################################################################################
+#++
+
+# Monkey patch Kernel functions for testing.
+module Kernel
+  # Patch exit so that it sets a flag rather than ends the application.
+  # (A call to exit will cause testing to stop otherwise).
+  alias :old_exit :exit
+  def exit(status = true)
+    old_exit(status) unless OverrideKernel.override_exit
+    OverrideKernel::AppState.state = :dead
+    return status
+  end
+end

data/lib/override_kernel/override_kernel.rb

@@ -0,0 +1,79 @@
+# This file contains constants that are used
+# to support overriding Kernel functionality.
+
+#--
+################################################################################
+#                      Copyright (C) 2011 Travis Herrick                       #
+################################################################################
+#                                                                              #
+#                                 \v^V,^!v\^/                                  #
+#                                 ~%       %~                                  #
+#                                 {  _   _  }                                  #
+#                                 (  *   -  )                                  #
+#                                 |    /    |                                  #
+#                                  \   _,  /                                   #
+#                                   \__.__/                                    #
+#                                                                              #
+################################################################################
+# This program is free software: you can redistribute it                       #
+# and/or modify it under the terms of the GNU General Public License           #
+# as published by the Free Software Foundation,                                #
+# either version 3 of the License, or (at your option) any later version.      #
+#                                                                              #
+# Commercial licensing may be available for a fee under a different license.   #
+################################################################################
+# This program is distributed in the hope that it will be useful,              #
+# but WITHOUT ANY WARRANTY;                                                    #
+# without even the implied warranty of MERCHANTABILITY                         #
+# or FITNESS FOR A PARTICULAR PURPOSE.                                         #
+# See the GNU General Public License for more details.                         #
+#                                                                              #
+# You should have received a copy of the GNU General Public License            #
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
+################################################################################
+#++
+
+module OverrideKernel
+
+  # Contains a list of methods that will be dynamically handled by the module.
+  # The following methods will be created:
+  #
+  #  :start_#{method_name} #=> @method_name = true
+  #  :stop_#{method_name}  #=> @method_name = false
+  #  :#{method_name}       #=> Returns the value of @method_name
+  METHOD_LIST = [
+    'override_exit',
+  ]
+
+  # This constant is used to indicate whether the application would have
+  # been halted by Kernel functions.
+  AppState = StateManager.new(:alive, [:alive, :dead])
+
+  ############################################################################
+  module_function
+  ############################################################################
+
+  def method_missing(method, *args, &block)
+    if METHOD_LIST.include?(method.to_s.sub(/^(start|stop)_/, ''))
+      var = '@' + method.to_s.sub(/^(start|stop)_/, '')
+      case method.to_s
+        when /^start/
+          send :instance_variable_set, var.to_sym, true
+        when /^stop/
+          send :instance_variable_set, var.to_sym, false
+        when var[1..-1]
+          send :instance_variable_get, var.to_sym
+      end
+    else
+      super
+    end
+  end
+
+  def respond_to_missing?(method, include_private)
+    if METHOD_LIST.include?(method.to_s.sub(/^(start|stop)_/, ''))
+      return true
+    else
+      super
+    end
+  end
+end

data/lib/override_kernel.rb

@@ -0,0 +1,6 @@
+gem_name = File.basename(__FILE__, '.rb')
+
+require 'app_mode'
+
+require_relative File.join(gem_name, gem_name)
+require_relative File.join(gem_name, 'exit')

data/override_kernel.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |s|
+  s.name = 'override_kernel'
+  s.version = '0.0.1'
+
+  s.summary = 'Overrides specific Kernel functions.'
+  s.description = %Q{
+OverrideKernel changes Kernel functions
+from nasty wildebeasts into fluffy, harmless bunnies.
+Currently, only the exit function is dealt with in such a manner.
+}.strip
+
+  s.author   = 'Travis Herrick'
+  s.email    = 'tthetoad@gmail.com'
+  s.homepage = 'http://www.bitbucket.org/ToadJamb/gems_override_kernel'
+
+  s.license = 'GPLv3'
+
+  s.extra_rdoc_files << 'README'
+
+  s.require_paths = ['lib']
+  s.files = Dir['lib/**/*.rb', '*']
+  s.test_files = Dir['test/**/*.rb']
+
+  s.add_dependency 'app_mode', '~> 1.0.0'
+
+  s.add_development_dependency 'rake_tasks', '~> 0.0.1'
+
+  s.has_rdoc = true
+end

data/rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler.require :rake

data/test/exit_test.rb

@@ -0,0 +1,108 @@
+#--
+################################################################################
+#                      Copyright (C) 2011 Travis Herrick                       #
+################################################################################
+#                                                                              #
+#                                 \v^V,^!v\^/                                  #
+#                                 ~%       %~                                  #
+#                                 {  _   _  }                                  #
+#                                 (  *   -  )                                  #
+#                                 |    /    |                                  #
+#                                  \   _,  /                                   #
+#                                   \__.__/                                    #
+#                                                                              #
+################################################################################
+# This program is free software: you can redistribute it                       #
+# and/or modify it under the terms of the GNU General Public License           #
+# as published by the Free Software Foundation,                                #
+# either version 3 of the License, or (at your option) any later version.      #
+#                                                                              #
+# Commercial licensing may be available for a fee under a different license.   #
+################################################################################
+# This program is distributed in the hope that it will be useful,              #
+# but WITHOUT ANY WARRANTY;                                                    #
+# without even the implied warranty of MERCHANTABILITY                         #
+# or FITNESS FOR A PARTICULAR PURPOSE.                                         #
+# See the GNU General Public License for more details.                         #
+#                                                                              #
+# You should have received a copy of the GNU General Public License            #
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
+################################################################################
+#++
+
+require_relative 'require'
+
+class ExitTest < Test::Unit::TestCase
+
+  def setup
+    override_exit(true)
+    reset_app_state
+  end
+
+  def teardown
+    override_exit(false)
+  end
+
+  def test_without_override
+    override_exit(false)
+    assert_raise(SystemExit) { exit }
+  end
+
+  def test_basic_exit_call
+    assert_alive
+    assert_nothing_raised { exit }
+    assert_dead
+  end
+
+  def test_exit_parameter
+    assert_alive
+    assert_nothing_raised { exit(-1) }
+    assert_dead
+  end
+
+  def test_exit_return_value
+    out = nil
+    assert_alive
+    assert_nothing_raised { out = exit }
+    assert_dead
+    assert_equal true, out
+
+    assert_alive
+    assert_nothing_raised { out = exit(-1) }
+    assert_dead
+    assert_equal(-1, out)
+
+    assert_alive
+    assert_nothing_raised { out = exit('blah') }
+    assert_dead
+    assert_equal 'blah', out
+  end
+
+  ############################################################################
+  private
+  ############################################################################
+
+  def override_exit(value)
+    if value
+      OverrideKernel.start_override_exit
+    else
+      OverrideKernel.stop_override_exit
+    end
+  end
+
+  def reset_app_state
+    OverrideKernel::AppState.state = :alive
+  end
+
+  def assert_alive
+    alive = OverrideKernel::AppState.alive
+    reset_app_state unless alive
+    assert alive, 'The application is not running when it was expected to be.'
+  end
+
+  def assert_dead
+    dead = OverrideKernel::AppState.dead
+    reset_app_state if dead
+    assert dead, 'The application is running when it was not expected to be.'
+  end
+end

data/test/override_kernel_test.rb

@@ -0,0 +1,53 @@
+#--
+################################################################################
+#                      Copyright (C) 2011 Travis Herrick                       #
+################################################################################
+#                                                                              #
+#                                 \v^V,^!v\^/                                  #
+#                                 ~%       %~                                  #
+#                                 {  _   _  }                                  #
+#                                 (  *   -  )                                  #
+#                                 |    /    |                                  #
+#                                  \   _,  /                                   #
+#                                   \__.__/                                    #
+#                                                                              #
+################################################################################
+# This program is free software: you can redistribute it                       #
+# and/or modify it under the terms of the GNU General Public License           #
+# as published by the Free Software Foundation,                                #
+# either version 3 of the License, or (at your option) any later version.      #
+#                                                                              #
+# Commercial licensing may be available for a fee under a different license.   #
+################################################################################
+# This program is distributed in the hope that it will be useful,              #
+# but WITHOUT ANY WARRANTY;                                                    #
+# without even the implied warranty of MERCHANTABILITY                         #
+# or FITNESS FOR A PARTICULAR PURPOSE.                                         #
+# See the GNU General Public License for more details.                         #
+#                                                                              #
+# You should have received a copy of the GNU General Public License            #
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.        #
+################################################################################
+#++
+
+require_relative 'require'
+
+class OverrideKernelTest < Test::Unit::TestCase
+  METHOD_LIST = [
+    :override_exit,
+  ]
+
+  def test_all_methods
+    METHOD_LIST.each do |method|
+      {
+        "start_#{method}".to_sym => true,
+        "stop_#{method}".to_sym => false,
+      }.each do |method_name, value|
+        assert_respond_to OverrideKernel, method_name
+        assert_nothing_raised { OverrideKernel.send method_name }
+        assert_respond_to OverrideKernel, method
+        assert_equal value, OverrideKernel.send(method)
+      end
+    end
+  end
+end

data/test/require.rb

@@ -0,0 +1,5 @@
+Bundler.require :test
+
+require 'test/unit'
+
+require_relative '../lib/override_kernel'

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: override_kernel
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Travis Herrick
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-10 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: app_mode
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake_tasks
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 0
+        - 1
+        version: 0.0.1
+  type: :development
+  prerelease: false
+  version_requirements: *id002
+description: |-
+  OverrideKernel changes Kernel functions
+  from nasty wildebeasts into fluffy, harmless bunnies.
+  Currently, only the exit function is dealt with in such a manner.
+email: tthetoad@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- lib/override_kernel/override_kernel.rb
+- lib/override_kernel/exit.rb
+- lib/override_kernel.rb
+- Gemfile.lock
+- override_kernel.gemspec
+- Gemfile
+- rakefile
+- README
+- test/override_kernel_test.rb
+- test/require.rb
+- test/exit_test.rb
+has_rdoc: true
+homepage: http://www.bitbucket.org/ToadJamb/gems_override_kernel
+licenses: 
+- GPLv3
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: -3169159202290470423
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Overrides specific Kernel functions.
+test_files: 
+- test/override_kernel_test.rb
+- test/require.rb
+- test/exit_test.rb