method-args 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+pkg
+.bundle

data/Gemfile

@@ -0,0 +1,4 @@
+source :gemcutter
+
+# Specify your gem's dependencies in optitron.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    method_args (0.0.1)
+      ruby2ruby (~> 1.2.4)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0.4)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    callsite (0.0.4)
+    minitest (2.0.2)
+    phocus (1.1)
+    rake (0.8.7)
+    ruby2ruby (1.2.5)
+      ruby_parser (~> 2.0)
+      sexp_processor (~> 3.0)
+    ruby_parser (2.0.5)
+      sexp_processor (~> 3.0)
+    sexp_processor (3.0.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  callsite (~> 0.0.4)
+  method_args!
+  minitest
+  phocus
+  rake
+  ruby2ruby (~> 1.2.4)
+  ruby_parser (~> 2.0)
+  sexp_processor (~> 3.0.4)

data/README.markdown

@@ -0,0 +1,40 @@
+# MethodArgs
+
+## Purpose
+
+You've got a method, but want to know more about the arguments? `#arity` and `#parameters` (if available) are useful,
+but not nearly enough. You need something better. Like, the default arguments. *MethodArgs* makes this simple. It operates
+on a source file to supply the more details argument information by parsing the code itself.
+
+## Usage
+
+Pretend you have a file `your_ruby_file.rb`:
+
+    class MyClass
+      def initialize
+        @default_value = 'hello'
+      end
+
+      def something(one, two = 'two', three = @default_value)
+      end
+    end
+
+To look at the arguments to something, do the following.
+    
+    MethodArgs.load('your_ruby_file') # <-- this also requires the file
+    MyClass.arg_list(:something)
+    
+This will return an `ArgList` object. You can then look at the names & types.
+
+    MyClass.arg_list(:something).names
+    # => [:one, :two, :three]
+
+    MyClass.arg_list(:something).types
+    # => [:required, :optional, :splat]
+    
+If you want to get the value of a default argument, you'll need a context in which to evaluate it, namely,
+an instance of the class from which the method derives.
+
+    obj = MyClass.new
+    MyClass.arg_list(:something).last.default_value(obj)
+    # => 'hello'

data/Rakefile

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'bundler'
+
+desc "Run tests"
+task :test do
+  $: << 'lib'
+  require 'method_args'
+  require 'test/helper'
+  Dir['test/**/test_*.rb'].each { |test| require test }
+end
+
+require 'rake/rdoctask'
+desc "Generate documentation"
+Rake::RDocTask.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+  rd.rdoc_dir = 'rdoc'
+end
+
+Bundler::GemHelper.install_tasks

data/lib/method_args.rb

@@ -0,0 +1,170 @@
+require 'ruby2ruby'
+require 'ruby_parser'
+require 'sexp_processor'
+
+module MethodArgs
+
+  class ArgList < Array
+    class Arg
+      
+      attr_reader :name, :type
+      
+      def initialize(cls, arg)
+        @cls = cls
+        @name = arg[0]
+        @type = arg[1]
+        @default = arg[2]
+      end
+
+      def required?
+        @type == :required
+      end
+
+      def optional?
+        @type == :optional
+      end
+
+      def splat?
+        @type == :splat
+      end
+
+      def default_value(inst)
+        return nil if @default.nil?
+        raise "You must evaluate defaults in the context of a matching class. #{inst.class.name} is not a #{@cls.name}." unless inst.is_a?(@cls)
+        inst.instance_eval(@default)
+      end
+    end
+    
+    def required_size
+      inject(0) {|count, arg| count += arg.required? ? 1 : 0}
+    end
+    alias_method :required_count, :required_size
+
+    def names
+      map(&:name)
+    end
+
+    def types
+      map(&:type)
+    end
+
+    def initialize(cls, method)
+      @cls, @method = cls, method
+    end
+
+    def to_method
+      @cls.instance_method(@method)
+    end
+  end
+
+
+  def self.load(file)
+    file = File.expand_path(file)
+    require file
+    parser = RubyParser.new
+    sexp = parser.process(File.read(File.exist?(file) ? file : "#{file}.rb"))
+    method_args = Processor.new
+    method_args.process(sexp)
+  end
+
+  class Processor < SexpProcessor
+
+    attr_reader :method_maps
+
+    def initialize
+      @method_maps = Hash.new{|h,k| h[k] = {}}
+      @current_class = []
+      super()
+    end
+
+    def process_module(exp)
+      exp.shift
+      @current_class << exp.first.to_sym
+      process(exp)
+      @current_class.pop
+      exp.clear
+      exp
+    end
+
+    def process_class(exp)
+      exp.shift
+      current_class_size = @current_class.size
+      case exp.first
+      when Symbol
+        @current_class << exp.first.to_sym
+        process(exp)
+      else
+        if exp.first.first == :colon2
+          exp.first.shift
+          class_exp = exp.shift
+          class_exp[0, class_exp.size - 1].each do |const|
+            @current_class << const.last
+          end
+          @current_class << class_exp.last
+        else
+          raise
+        end
+        exp.shift
+        process(exp.first)
+      end
+      @current_class.slice!(current_class_size, @current_class.size)
+      exp.clear
+      exp
+    end
+
+    def process_defn(exp)
+      exp.shift
+      @current_method = exp.shift
+      @ruby2ruby = Ruby2Ruby.new
+      process_args(exp.shift)
+      scope = exp.shift
+      exp
+    end
+
+    def process_args(exp)
+      exp.shift
+      arg_list = ArgList.new(current_class, @current_method)
+      while !exp.empty?
+        t = exp.shift
+        case t
+        when Symbol
+          arg_list << if t.to_s[0] == ?*
+            ArgList::Arg.new(current_class, [t.to_s[1, t.to_s.size].to_sym, :splat])
+          else
+            ArgList::Arg.new(current_class, [t, :required])
+          end
+        when Sexp
+          case t.shift
+          when :block
+            lasgn = t.shift
+            lasgn.shift
+            name = lasgn.shift
+            new_arg = ArgList::Arg.new(current_class, [name, :optional, @ruby2ruby.process(lasgn.last)])
+            arg_list.each_with_index{|arg, idx| arg_list[idx] = new_arg if arg.name == name}
+          end
+        end
+      end
+      @method_maps[current_classname][@current_method] = arg_list
+      add_methods
+    end
+
+    def add_methods
+      unless current_class.const_defined?(:ArgList)
+        current_class.send(:const_set, :ArgList, @method_maps[current_classname])
+        current_class.module_eval "
+          def self.arg_list(method_name)
+            ArgList[method_name]
+          end
+        "
+      end
+    end
+
+    def current_classname
+      @current_class.map{|c| c.to_s}.join('::')
+    end
+
+    def current_class
+      @current_class.inject(Module) {|c, m| c.const_get(m)}
+    end
+  end
+end

data/lib/method_args/version.rb

@@ -0,0 +1,3 @@
+module MethodArgs
+  VERSION = '0.0.1'
+end

data/method_args.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "method_args/version"
+
+Gem::Specification.new do |s|
+  s.name        = "method-args"
+  s.version     = MethodArgs::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Joshua Hull"]
+  s.email       = ["joshbuddy@gmail.com"]
+  s.homepage    = "https://github.com/joshbuddy/method_args"
+  s.summary     = "Get back more detailed information about the arguments for a method"
+  s.description = "Get back more detailed information about the arguments for a method"
+
+  s.rubyforge_project = "method_args2"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "ruby_parser", "~> 2.0"
+  s.add_dependency "ruby2ruby", "~> 1.2.4"
+  s.add_dependency "sexp_processor", "~> 3.0.4"
+  s.add_development_dependency "callsite", "~> 0.0.4"
+  s.add_development_dependency "bundler", "~> 1.0.0"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "phocus"
+  s.add_development_dependency "minitest"
+end

data/test/fixtures/1.rb

@@ -0,0 +1,21 @@
+class One
+  attr_accessor :two_method
+
+  def no_args
+  end
+
+  def one_args(one)
+  end
+  
+  def two_args(one, two)
+  end
+
+  def splat_args(one, two, *three)
+  end
+
+  def default_args(one, two = 'two')
+  end
+
+  def default_args_with_dependant_value(one, two = two_method)
+  end
+end

data/test/helper.rb

@@ -0,0 +1,4 @@
+require 'minitest/autorun'
+require 'phocus'
+require 'callsite'
+Callsite.activate_string_methods

data/test/test_method_args.rb

@@ -0,0 +1,37 @@
+class TestMethodArgs < MiniTest::Unit::TestCase
+  def setup
+    MethodArgs.load(~'fixtures/1')
+  end
+
+  def test_arg_counts
+    assert_equal 0, One.arg_list(:no_args).count
+    assert_equal 1, One.arg_list(:one_args).count
+    assert_equal 2, One.arg_list(:two_args).count
+    assert_equal 3, One.arg_list(:splat_args).count
+    assert_equal 2, One.arg_list(:splat_args).required_count
+    assert_equal 2, One.arg_list(:default_args).count
+    assert_equal 1, One.arg_list(:default_args).required_count
+    assert_equal 2, One.arg_list(:default_args_with_dependant_value).count
+    assert_equal 1, One.arg_list(:default_args_with_dependant_value).required_count
+  end
+
+  def test_arg_types
+    assert_equal [],                              One.arg_list(:no_args).types
+    assert_equal [:required],                     One.arg_list(:one_args).types
+    assert_equal [:required, :required],          One.arg_list(:two_args).types
+    assert_equal [:required, :required, :splat], One.arg_list(:splat_args).types
+    assert_equal [:required, :optional],          One.arg_list(:default_args).types
+    assert_equal [:required, :optional],          One.arg_list(:default_args_with_dependant_value).types
+  end
+
+  def test_arg_method
+    assert_equal One.instance_method(:no_args), One.arg_list(:no_args).to_method
+  end
+
+  def test_default_args
+    one = One.new
+    one.two_method = 'happy times'
+    assert_equal 'happy times', One.arg_list(:default_args_with_dependant_value).last.default_value(one)
+  end
+
+end

metadata

@@ -0,0 +1,200 @@
+--- !ruby/object:Gem::Specification 
+name: method-args
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Joshua Hull
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-02 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ruby_parser
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: ruby2ruby
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 2
+        - 4
+        version: 1.2.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: sexp_processor
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 3
+        - 0
+        - 4
+        version: 3.0.4
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: callsite
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 0
+        - 0
+        - 4
+        version: 0.0.4
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: phocus
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id008
+description: Get back more detailed information about the arguments for a method
+email: 
+- joshbuddy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.markdown
+- Rakefile
+- lib/method_args.rb
+- lib/method_args/version.rb
+- method_args.gemspec
+- test/fixtures/1.rb
+- test/helper.rb
+- test/test_method_args.rb
+has_rdoc: true
+homepage: https://github.com/joshbuddy/method_args
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: method_args2
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Get back more detailed information about the arguments for a method
+test_files: 
+- test/fixtures/1.rb
+- test/helper.rb
+- test/test_method_args.rb