wrest 3.0.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f91ae89613e80b46bbae1cab5167b0266c5e09c3
-  data.tar.gz: f0c445af93ea24acf525ef3daa33d172ee89321a
+SHA256:
+  metadata.gz: 07fc2ba6c267b466a0caa4366cb63e1657b5966a4140742ed386c6fd657df03f
+  data.tar.gz: f917474be39d0ab7d89a4ba5e652e76798bb51619339dff36ffb0e7453f9b118
 SHA512:
-  metadata.gz: 08a26da3142c49d6e2441aba1facad17ccf0f1a35d3ba35e67d24489b0542f1fe21930e58f4afae8b9a36e683bfd53fbc88514b04bce390aa280191c438d57f0
-  data.tar.gz: 2efeacaca5351a696185e93e21c8647dd4374e2b8e98984fb20000a1f9deaef6f6baf61098f433824dac10248c0f00958accdf0742d0c96219d46cf4d4c4e881
+  metadata.gz: 783b115e74659773e4a04de550d713c30a906ecd2e3de517d168d5535a588366164d440fd47782e975d3236aee8d0a66fe37e729f25440ee67592526ee4c89d7
+  data.tar.gz: 7b2ed5a8a9638cc5ead4ac39edbb27a54ac03e5a9da97ec627eaa0e322979ba4ffcf1e3e52bfc2ffe61055d6d2f788d445c242954969971a052989e3eeeecf1e

data/CHANGELOG

@@ -1,5 +1,8 @@
 Features under the section marked 'Current' are completed but pending release as a gem. If you need any of these, you'll need to use the latest source from the git repository.
 
+== Current
+ * Upgrade gems and fix build on Ruby 3.1.2
+
 Features under a numbered section are complete and available in the Wrest gem.
 
 == 2.2.0

data/LICENCE

@@ -1,4 +1,4 @@
-Copyright 2009 - 2010 Sidu Ponnappa
+Copyright 2009 - 2022 Sidu Ponnappa
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

data/README.md

@@ -1,24 +1,36 @@
-[![Build Status](https://travis-ci.org/c42/wrest.svg?branch=master)](https://travis-ci.org/c42/wrest)
-
-# Wrest 2.2.0
-
-(c) Copyright 2009-2016 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.
-
-Wrest is a ruby REST/HTTP client library. It is currently in use at substantial scale across all Ruby/JRuby systems at [GO-JEK](https://twitter.com/GojekTech).
-
-* Allows you to pick your Ruby: use CRuby or JRuby
+# Wrest 4.0.0.dev
+
+<p align="center"><img src="docs/wrest-logo-320x320.png" width="320"></p>
+<p align="center">
+  <a href="https://rubygems.org/gems/wrest">
+    <img src="https://badge.fury.io/rb/wrest.svg" alt="Gem Version" height="18">
+  </a>
+  <a href="https://github.com/kaiwren/wrest/actions/workflows/ruby.yml">
+    <img src="https://github.com/kaiwren/wrest/actions/workflows/ruby.yml/badge.svg" alt="Ruby" style="max-width: 100%;">    
+  </a>
+  <a href="https://github.com/kaiwren/wrest/actions/workflows/jruby.yml">
+    <img src="https://github.com/kaiwren/wrest/actions/workflows/jruby.yml/badge.svg" alt="JRuby" style="max-width: 100%;">
+  </a>
+  <a href="https://codeclimate.com/github/kaiwren/wrest/maintainability">
+    <img src="https://api.codeclimate.com/v1/badges/dc0366a60000561951ab/maintainability" />
+  </a>
+</p>
+
+
+Wrest is a ruby REST/HTTP client library. It is currently in use at 10x🦄 scale across all Ruby/JRuby systems at [Gojek](https://twitter.com/GojekTech). 
+
+* Quick tool to wrangle APIs to powerful library to build complex production grade systems, Wrest does it all
+* Clean, object-oriented API with URLs as first class entities
 * Supports RFC 2616 based [caching](https://github.com/kaiwren/wrest/blob/caching/Caching.markdown)
 * Async http calls using Threads (truly useful only on JRuby due to [GIL](https://en.wikipedia.org/wiki/Global_interpreter_lock) limitations on CRuby) or EventMachine
-* Allows you to quickly build object oriented wrappers around any web service
-* Is designed to be used as a library, not just a command line REST client (fewer class/static methods, more object oriented)
 * Is spec driven, strongly favours immutable objects and avoids class methods and setters making it better suited for use as a library, especially in multi-threaded environments
 * Provides convenient HTTP wrappers, redirect handling, serialisation, deserialisation and xpath based lookup
 
-To receive notifications whenever new features are added to Wrest, please subscribe to my [twitter feed](http://twitter.com/ponnappa).
+Wrest is currently undergoing a substantial clean-up of syntax and dendencies to bring it up to speed on Ruby 3.x and JRuby 9.3.x. This will be released shortly as version 4.0.0.
 
 ## Examples
 
-For Facebook, Twitter, Delicious, GitHub and other API examples, see http://github.com/c42/wrest/tree/master/examples
+For Facebook, Twitter, Delicious, GitHub and other API examples, see http://github.com/kaiwren/wrest/tree/master/examples
 
 ### Basic Http Calls
 
@@ -27,10 +39,10 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Basic API calls
 
     ```
-    # Works with json and xml out of the box
+    # Works with json and xml out of the box to give you a hash
     # See lib/wrest/components/translators to add other formats
     
-    'https://api.github.com/repos/c42/wrest/issues'.to_uri.get.deserialize
+    'https://api.github.com/repos/rails/rails/issues'.to_uri.get.deserialize
     ```
 
 * Timeout support
@@ -52,8 +64,6 @@ For Facebook, Twitter, Delicious, GitHub and other API examples, see http://gith
 * Deserialise with XPath filtering
 
     ```
-    ActiveSupport::XmlMini.backend = 'REXML'
-
     'http://twitter.com/statuses/public_timeline.xml'.to_uri.get.deserialise(
                                                   xpath: '//user/name/text()'
                                                 )
@@ -351,17 +361,6 @@ Detailed http debug logging can be turned on like so (DO NOT USE IN PRODUCTION!
     'https://api.github.com/repos/c42/wrest/issues'.to_uri(detailed_http_logging: $stdout).get.deserialize
     ```
 
-
-### Json Backend
-
-Wrest uses the multi_json gem to manage Json backends, allowing it to play nice with Rails 3.1. To change the backend used, you can do the following:
-
-```
-  MultiJson.engine = :json_gem
-```
-
-For more information, look up the [multi_json](http://github.com/intridea/multi_json) documentation.
-
 ### Build
 
 Standard options are available and can be listed using `rake -T`. Use rake:rcov for coverage and rake:rdoc to generate documentation. The link to the continuous integration build is over at the C42 Engineering [open source](http://c42.in/open_source) page.
@@ -433,3 +432,5 @@ Run the tests in a different terminal:
 * Jacques Crocker : [railsjedi](http://github.com/railsjedi)
 * Jasim A Basheer: [jasim](http://github.com/jasim)
 * Arvind Laxminarayan: [ardsrk](http://github.com/ardsrk)
+
+©️ Copyright 2009-2022 [Sidu Ponnappa](http://twitter.com/ponnappa). All Rights Reserved.

data/bin/wrest

@@ -1,3 +1,4 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
-load(File.dirname(__FILE__)+'/wrest_shell.rb')
+load(File.join(__dir__, 'wrest_shell.rb'))

data/bin/wrest_shell.rb

@@ -1,21 +1,23 @@
+# frozen_string_literal: true
+
 puts "Ruby #{RUBY_VERSION}, #{RUBY_RELEASE_DATE}, #{RUBY_PLATFORM}"
 
-entry_point = File.expand_path "#{File.dirname(__FILE__)}/../lib/wrest.rb"
-version = File.expand_path "#{File.dirname(__FILE__)}/../lib/wrest/version.rb"
+entry_point = File.join(__dir__, '..', 'lib', 'wrest.rb')
+version_file = File.expand_path(File.join(__dir__, '..', 'lib', 'wrest', 'version.rb'))
 
 irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
 
 require 'optparse'
-options = { :irb => irb }
+options = { irb: irb }
 OptionParser.new do |opt|
-  opt.banner = "Usage: console [options]"
+  opt.banner = 'Usage: console [options]'
   opt.on("--irb=[#{irb}]", 'Invoke a different irb.') { |v| options[:irb] = v }
   opt.parse!(ARGV)
 end
 
-libs =  " -r irb/completion"
-libs << " -r #{entry_point}"
+libs = ' -r irb/completion ' \
+       "-r #{entry_point}"
 
-require version
+require version_file
 puts "Loading Wrest #{Wrest::VERSION}"
-exec "#{options[:irb]} #{libs} --simple-prompt"
+exec "#{options[:irb]} #{libs} --simple-prompt"

data/lib/wrest/async_request/event_machine_backend.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -10,7 +12,7 @@
 begin
   gem 'eventmachine'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Eventmachine ~> 0.12.10 not found. Wrest uses Eventmachine to perform evented asynchronous requests"
+  Wrest.logger.debug 'Eventmachine ~> 0.12.10 not found. Wrest uses Eventmachine to perform evented asynchronous requests'
   raise e
 end
 

data/lib/wrest/async_request/thread_backend.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,14 +15,15 @@ module Wrest
     # Only recommended for production use on JRuby.
     class ThreadBackend
       attr_reader :thread_pool
+
       def initialize(number_of_threads = 5)
         @thread_pool = ThreadPool.new(number_of_threads)
       end
-      
+
       def execute(request)
         @thread_pool.execute_eventually(request)
       end
-      
+
       # Uses Thread#join to wait until all
       # background requests are completed.
       def wait_for_thread_pool!

data/lib/wrest/async_request/thread_pool.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009-2016 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,12 +15,12 @@ module Wrest
       def initialize(number_of_threads)
         @pool = Concurrent::FixedThreadPool.new(number_of_threads)
       end
-      
+
       def execute_eventually(request)
         @pool.post { request.invoke }
         nil
       end
-      
+
       def join_pool_threads!
         @pool.wait_for_termination
       end

data/lib/wrest/async_request.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -7,12 +9,11 @@
 # is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and limitations under the License.
 
-
 module Wrest
   module AsyncRequest
     # Loads Wrest eventmachine backend alongwith eventmachine gem
     def self.enable_em
-      require "wrest/async_request/event_machine_backend"
+      require 'wrest/async_request/event_machine_backend'
     end
 
     # Assign default backend to be used for asynchronous request. Default is to use threads
@@ -20,13 +21,13 @@ module Wrest
       @default_backend = backend
     end
 
-    # Assign default backend for asynchronous request to using eventmachine. 
+    # Assign default backend for asynchronous request to using eventmachine.
     def self.default_to_em!
-      self.enable_em
+      enable_em
       self.default_backend = Wrest::AsyncRequest::EventMachineBackend.new
     end
 
-    # Assign default backend for asynchronous request to using threads. 
+    # Assign default backend for asynchronous request to using threads.
     def self.default_to_threads!(number_of_threads = 5)
       self.default_backend = Wrest::AsyncRequest::ThreadBackend.new(number_of_threads)
     end
@@ -35,7 +36,7 @@ module Wrest
     def self.default_backend
       @default_backend || default_to_threads!
     end
-    
+
     # Uses Thread#join to wait until all background requests
     # are completed.
     #

data/lib/wrest/cache_proxy.rb

@@ -1,5 +1,6 @@
-module Wrest
+# frozen_string_literal: true
 
+module Wrest
   class CacheProxy
     class << self
       def new(get, cache_store)
@@ -15,20 +16,21 @@ module Wrest
       def initialize(get)
         @get = get
       end
+
       def get
         @get.invoke_without_cache_check
       end
     end
 
     class DefaultCacheProxy
-      HOP_BY_HOP_HEADERS = ["connection",
-                           "keep-alive",
-                           "proxy-authenticate",
-                           "proxy-authorization",
-                           "te",
-                           "trailers",
-                           "transfer-encoding",
-                           "upgrade"]
+      HOP_BY_HOP_HEADERS = %w[connection
+                              keep-alive
+                              proxy-authenticate
+                              proxy-authorization
+                              te
+                              trailers
+                              transfer-encoding
+                              upgrade].freeze
 
       def initialize(get, cache_store)
         @get         = get
@@ -36,19 +38,15 @@ module Wrest
       end
 
       def log_cached_response
-          Wrest.logger.debug "<*> (GET #{@get.hash}) #{@get.uri.protocol}://#{@get.uri.host}:#{@get.uri.port}#{@get.http_request.path}"
+        Wrest.logger.debug "<*> (GET #{@get.hash}) #{@get.uri.protocol}://#{@get.uri.host}:#{@get.uri.port}#{@get.http_request.path}"
       end
-      
+
       def get
         cached_response = @cache_store[@get.full_uri_string]
-        return get_fresh_response if cached_response.nil?
+        return fresh_get_response if cached_response.nil?
 
         if cached_response.expired?
-          if cached_response.can_be_validated?
-            get_validated_response_for(cached_response)
-          else
-            get_fresh_response
-          end
+          expired_cached_response(cached_response)
         else
           log_cached_response
           cached_response
@@ -57,15 +55,17 @@ module Wrest
 
       def update_cache_headers_for(cached_response, new_response)
         # RFC 2616 13.5.3 (Combining Headers)
-        cached_response.headers.merge!(new_response.headers.select {|key, value| not (HOP_BY_HOP_HEADERS.include? key.downcase)})
+        cached_response.headers.merge!(new_response.headers.reject do |key, _value|
+                                         (HOP_BY_HOP_HEADERS.include? key.downcase)
+                                       end)
       end
 
       def cache(response)
-        @cache_store[@get.full_uri_string] = response.clone if response && response.cacheable?
+        @cache_store[@get.full_uri_string] = response.clone if response&.cacheable?
       end
 
-      #:nodoc:
-      def get_fresh_response
+      # :nodoc:
+      def fresh_get_response
         @cache_store.delete @get.full_uri_string
 
         response = @get.invoke_without_cache_check
@@ -75,10 +75,10 @@ module Wrest
         response
       end
 
-      #:nodoc:
+      # :nodoc:
       def get_validated_response_for(cached_response)
         new_response = send_validation_request_for(cached_response)
-        if new_response.code == "304"
+        if new_response.code == '304'
           update_cache_headers_for(cached_response, new_response)
           log_cached_response
           cached_response
@@ -88,21 +88,32 @@ module Wrest
         end
       end
 
-      #:nodoc:
+      # :nodoc:
       # Send a cache-validation request to the server. This would be the actual Get request with extra cache-validation headers.
       # If a 304 (Not Modified) is received, Wrest would use the cached_response itself. Otherwise the new response is cached and used.
       def send_validation_request_for(cached_response)
         last_modified            = cached_response.last_modified
-        etag                     = cached_response.headers["etag"]
+        etag                     = cached_response.headers['etag']
 
         cache_validation_headers = {}
-        cache_validation_headers["if-modified-since"] = last_modified unless last_modified.nil?
-        cache_validation_headers["if-none-match"] = etag unless etag.nil?
+        cache_validation_headers['if-modified-since'] = last_modified unless last_modified.nil?
+        cache_validation_headers['if-none-match'] = etag unless etag.nil?
 
         new_request = @get.build_request_without_cache_store(cache_validation_headers)
 
         new_request.invoke
       end
+
+      private
+
+      # :nodoc:
+      def expired_cached_response(cached_response)
+        if cached_response.can_be_validated?
+          get_validated_response_for(cached_response)
+        else
+          fresh_get_response
+        end
+      end
     end
   end
-end
+end

data/lib/wrest/caching/memcached.rb

@@ -1,34 +1,37 @@
+# frozen_string_literal: true
+
 begin
   gem 'dalli', '~> 2'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Dalli ~> 2 not found. The Dalli gem is necessary to use the memcached caching back-end."
+  Wrest.logger.debug 'Dalli ~> 2 not found. The Dalli gem is necessary to use the memcached caching back-end.'
   raise e
 end
 
 require 'dalli'
 
-module Wrest::Caching
-  class Memcached
+module Wrest
+  module Caching
+    class Memcached
+      def initialize(server_urls = nil, options = {})
+        @memcached = Dalli::Client.new(server_urls, options)
+      end
 
-    def initialize(server_urls=nil, options={})
-      @memcached = Dalli::Client.new(server_urls, options)
-    end
+      def [](key)
+        @memcached.get(key)
+      end
 
-    def [](key)
-      @memcached.get(key)
-    end
+      def []=(key, value)
+        @memcached.set(key, value)
+      end
 
-    def []=(key, value)
-      @memcached.set(key, value)
-    end
+      # should be compatible with Hash - return value of the deleted element.
+      def delete(key)
+        value = self[key]
 
-    # should be compatible with Hash - return value of the deleted element.
-    def delete(key)
-      value = self[key]
-      
-      @memcached.delete key
+        @memcached.delete key
 
-      return value
+        value
+      end
     end
   end
 end

data/lib/wrest/caching/redis.rb

@@ -1,38 +1,38 @@
+# frozen_string_literal: true
+
 begin
   gem 'redis', '~> 3'
 rescue Gem::LoadError => e
-  Wrest.logger.debug "Redis ~> 3 not found. The Redis gem is necessary to use redis as a caching back-end."
+  Wrest.logger.debug 'Redis ~> 3 not found. The Redis gem is necessary to use redis as a caching back-end.'
   raise e
 end
 
 require 'redis'
 require 'yaml'
 
-module Wrest::Caching
-  class Redis
+module Wrest
+  module Caching
+    class Redis
+      def initialize(redis_options = {})
+        @redis = ::Redis.new(redis_options)
+      end
 
-    def initialize(redis_options = {})
-      @redis = ::Redis.new(redis_options)
-    end
+      def [](key)
+        value = @redis.get(key)
+        value.nil? ? nil : YAML.unsafe_load(value)
+      end
 
-    def [](key)
-      value = @redis.get(key)
-      unmarshalled_value = value.nil? ? nil : YAML::load(value)
-      unmarshalled_value
-    end
+      def []=(key, response)
+        marshalled_response = YAML.dump(response)
+        @redis.set(key, marshalled_response)
+        @redis.expire(key, response.freshness_lifetime) unless response.expired?
+      end
 
-    def []=(key, response)
-      marshalled_response = YAML::dump(response)
-      @redis.set(key, marshalled_response)
-      unless response.expired?
-        @redis.expire(key, response.freshness_lifetime)
+      def delete(key)
+        value = self[key]
+        @redis.del(key)
+        value
       end
     end
-    
-    def delete(key)
-      value = self[key]
-      @redis.del(key)
-      return value
-    end
   end
 end

data/lib/wrest/caching.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -9,42 +11,42 @@
 
 module Wrest
   module Caching
-    # Loads the Memcached caching back-end and the Dalli gem 
+    # Loads the Memcached caching back-end and the Dalli gem
     def self.enable_memcached
-      require "wrest/caching/memcached"
+      require 'wrest/caching/memcached'
     end
-    
-    # Loads the Redis caching back-end and the Redis gem 
+
+    # Loads the Redis caching back-end and the Redis gem
     def self.enable_redis
-      require "wrest/caching/redis"
+      require 'wrest/caching/redis'
     end
 
     # Configures Wrest to cache all requests. This will use a Ruby Hash.
-    # WARNING: This should NEVER be used in a real environment. The Hash will 
+    # WARNING: This should NEVER be used in a real environment. The Hash will
     # keep growing since Wrest does not limit the size of a cache store.
     #
     # Please switch to the memcached or redis back-end for production use.
     def self.default_to_hash!
-      self.default_store = Hash.new
+      self.default_store = ({})
     end
 
-    # Default Wrest to using memcached for caching requests. 
+    # Default Wrest to using memcached for caching requests.
     def self.default_to_memcached!
-      self.enable_memcached
-      self.default_store = Wrest::Caching::Memcached.new 
+      enable_memcached
+      self.default_store = Wrest::Caching::Memcached.new
     end
-    
+
     # Default Wrest to using redis for caching requests.
-    # 
+    #
     # Options to configuring the redis gem can be passed as arguments.
     def self.default_to_redis!(redis_options = {})
-      self.enable_redis
+      enable_redis
       self.default_store = Wrest::Caching::Redis.new(redis_options)
     end
 
     # Assign the default cache store to be used. Default is none.
     def self.default_store=(store)
-      @default_store = store 
+      @default_store = store
     end
 
     # Returns the default store for caching, if any is set.

data/lib/wrest/callback.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Copyright 2009 Sidu Ponnappa
 
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -12,12 +14,13 @@ module Wrest
     attr_reader :callback_hash
 
     def initialize(callable)
-      if callable.is_a?(Hash)
+      case callable
+      when Hash
         @callback_hash = Callback.ensure_values_are_collections(callable)
-      elsif callable.is_a?(Proc)
+      when Proc
         @callback_hash = {}
         callable.call(self)
-      elsif callable.is_a?(Callback)
+      when Callback
         @callback_hash = callable.callback_hash.dup
       end
     end
@@ -34,12 +37,12 @@ module Wrest
 
     def execute(response)
       callback_hash.each do |code, callback_list|
-        callback_list.each {|callback| callback.call(response)} if case code
-        when Range
-          code.include?(response.code.to_i)
-        when Fixnum
-          code == response.code.to_i
-        end
+        callback_list.each { |callback| callback.call(response) } if case code
+                                                                     when Range
+                                                                       code.include?(response.code.to_i)
+                                                                     when Integer
+                                                                       code == response.code.to_i
+                                                                     end
       end
     end
 
@@ -47,14 +50,14 @@ module Wrest
       @callback_hash[code] ? @callback_hash[code] << block : @callback_hash[code] = [block]
     end
 
-    {200 => "ok", 201 => "created", 202 => "accepted", 204 => "no_content", 301 => "moved_permanently", 302 => "found", 303 => "see_other", 304 => "not_modified",
-      307 => "temporary_redirect", 400 => "bad_request", 401 => "unauthorized", 403 => "forbidden", 404 => "not_found", 405 => "method_not_allowed",
-      406 => "not_acceptable", 422 => "unprocessable_entity", 500 => "internal_server_error"}.each do |code, method|
-        method_name = "on_#{method}".to_sym
-        define_method method_name do |&block|
-          (@callback_hash[code] ? @callback_hash[code] << block : @callback_hash[code] = [block]) if block
-        end
+    { 200 => 'ok', 201 => 'created', 202 => 'accepted', 204 => 'no_content', 301 => 'moved_permanently', 302 => 'found', 303 => 'see_other', 304 => 'not_modified',
+      307 => 'temporary_redirect', 400 => 'bad_request', 401 => 'unauthorized', 403 => 'forbidden', 404 => 'not_found', 405 => 'method_not_allowed',
+      406 => 'not_acceptable', 422 => 'unprocessable_entity', 500 => 'internal_server_error' }.each do |code, method|
+      method_name = "on_#{method}".to_sym
+      define_method method_name do |&block|
+        (@callback_hash[code] ? @callback_hash[code] << block : @callback_hash[code] = [block]) if block
       end
+    end
 
     def self.ensure_values_are_collections(hash)
       result = {}