Contents

module MonkeySupport
  module CProxy

    # Generates a proxy-to-C method.
    #
    # Parameters:
    #   - ruby_name -- the original name of the function to override
    #   - c_name    -- the name of the C function in MonkeySupport::C to use
    #   - args      -- list of arguments to funtion, by type.
    #
    # args example: [:string, :fixnum, [:string, '-'], [:bool true]]
    #   - takes a string, a fixnum, a string with default value '-', then a boolean
    #     with default value true.
    # 
    # EXAMPLE:
    # 
    # alias_method :__unproxy_demodulize, :demodulize
    # MS_C = MonkeySupport::C unless defined? MS_C
    # def demodulize(arg0)
    #   begin
    #     MS_C.activesupport_inflector_demodulize(arg0)
    #   rescue TypeError
    #     __unproxy_demodulize(arg0)
    #   end
    # end
    def monkey_c_proxy(ruby_name, c_name, args)
      arglist_with_defaults    = Util::arglist(args, true)
      arglist_without_defaults = Util::arglist(args, false)

      # Note: About MS_C: That little extra lookup to MonkeySupport::C
      # can be a near-15% performance hit on some functions. Brutal.
      function = <<-EOS
        alias_method :__unproxy_#{ruby_name}, :#{ruby_name}
        MS_C = MonkeySupport::C unless defined? MS_C
        def #{ruby_name}(#{arglist_with_defaults})
          begin
            MS_C.#{c_name}(#{arglist_without_defaults})
          rescue TypeError
            __unproxy_#{ruby_name}(#{arglist_without_defaults})
          end
        end
      EOS

      class_eval(function)
    end

    module Util
      def self.arglist(args, include_defaults)
        arglist = []
        args.each_with_index do |arg, i|
          if (arg.class == Array && include_defaults)
            arglist << "arg#{i} = #{arg[1].inspect}"
          else
            arglist << "arg#{i}"
          end
        end 
        return arglist.join(", ")
      end
    end
  end
end 

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
monkeysupport-1.0.0	lib/monkeysupport/c_proxy.rb
monkeysupport-0.2.0	lib/monkeysupport/c_proxy.rb
monkeysupport-0.1.2	lib/monkeysupport/c_proxy.rb