devel-which 0.3.0

data/LICENSE/license_en.txt

@@ -0,0 +1,58 @@
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+	  with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+

data/LICENSE/license_ja.txt

@@ -0,0 +1,53 @@
+$BK\%W%m%0%i%`$O%U%j!<%=%U%H%&%'%"$G$9!%(BGPL(the GNU General
+Public License)$B$^$?$O0J2<$K<($9>r7o$GK\%W%m%0%i%`$r:FG[I[$G(B
+$B$-$^$9!%(BGPL$B$K$D$$$F$O(BCOPYING.txt$B%U%!%$%k$r;2>H$7$F2<$5$$!%(B
+
+  1. $BJ#@=$O@)8B$J$/<+M3$G$9!%(B
+
+  2. $B0J2<$N>r7o$N$$$:$l$+$rK~$?$9;~$KK\%W%m%0%i%`$N%=!<%9$r(B
+     $B<+M3$KJQ99$G$-$^$9!%(B
+
+     (a) $B%M%C%H%K%e!<%:$K%]%9%H$7$?$j!$:n<T$KJQ99$rAwIU$9$k(B
+         $B$J$I$NJ}K!$G!$JQ99$r8x3+$9$k!%(B
+
+     (b) $BJQ99$7$?K\%W%m%0%i%`$r<+J,$N=jB0$9$kAH?%FbIt$@$1$G(B
+         $B;H$&!%(B
+
+     (c) $BJQ99E@$rL@<($7$?$&$(!$%=%U%H%&%'%"$NL>A0$rJQ99$9$k!%(B
+         $B$=$N%=%U%H%&%'%"$rG[I[$9$k;~$K$OJQ99A0$NK\%W%m%0%i(B
+         $B%`$bF1;~$KG[I[$9$k!%$^$?$OJQ99A0$NK\%W%m%0%i%`$N%=!<(B
+         $B%9$NF~<jK!$rL@<($9$k!%(B
+
+     (d) $B$=$NB>$NJQ99>r7o$r:n<T$H9g0U$9$k!%(B
+
+  3. $B0J2<$N>r7o$N$$$:$l$+$rK~$?$9;~$KK\%W%m%0%i%`$r%3%s%Q%$(B
+     $B%k$7$?%*%V%8%'%/%H%3!<%I$d<B9T7A<0$G$bG[I[$G$-$^$9!%(B
+
+     (a) $B%P%$%J%j$r<u$1<h$C$??M$,%=!<%9$rF~<j$G$-$k$h$&$K!$(B
+         $B%=!<%9$NF~<jK!$rL@<($9$k!%(B
+
+     (b) $B5!3#2DFI$J%=!<%9%3!<%I$rE:IU$9$k!%(B
+
+     (c) $BJQ99$r9T$C$?%P%$%J%j$OL>A0$rJQ99$7$?$&$(!$%*%j%8%J(B
+         $B%k$N%=!<%9%3!<%I$NF~<jK!$rL@<($9$k!%(B
+
+     (d) $B$=$NB>$NG[I[>r7o$r:n<T$H9g0U$9$k!%(B
+
+  4. $BB>$N%W%m%0%i%`$X$N0zMQ$O$$$+$J$kL\E*$G$"$l<+M3$G$9!%$?(B
+     $B$@$7!$K\%W%m%0%i%`$K4^$^$l$kB>$N:n<T$K$h$k%3!<%I$O!$$=(B
+     $B$l$>$l$N:n<T$N0U8~$K$h$k@)8B$,2C$($i$k>l9g$,$"$j$^$9!%(B
+
+     $B6qBNE*$K$O(Bgc.c($B0lIt(B)$B!$(Butil.c($B0lIt(B)$B!$(Bst.[ch]$B!$(Bregex.[ch] 
+     $B$*$h$S(B ./missing$B%G%#%l%/%H%j2<$N%U%!%$%k72$,3:Ev$7$^$9!%(B
+     $B$=$l$>$l$NG[I[>r7o$J$I$KIU$$$F$O3F%U%!%$%k$r;2>H$7$F$/(B
+     $B$@$5$$!%(B
+
+  5. $BK\%W%m%0%i%`$X$NF~NO$H$J$k%9%/%j%W%H$*$h$S!$K\%W%m%0%i(B
+     $B%`$+$i$N=PNO$N8"Mx$OK\%W%m%0%i%`$N:n<T$G$O$J$/!$$=$l$>(B
+     $B$l$NF~=PNO$r@8@.$7$??M$KB0$7$^$9!%$^$?!$K\%W%m%0%i%`$K(B
+     $BAH$_9~$^$l$k$?$a$N3HD%%i%$%V%i%j$K$D$$$F$bF1MM$G$9!%(B
+
+  6. $BK\%W%m%0%i%`$OL5J]>Z$G$9!%:n<T$OK\%W%m%0%i%`$r%5%]!<%H(B
+     $B$9$k0U;V$O$"$j$^$9$,!$%W%m%0%i%`<+?H$N%P%0$"$k$$$OK\%W(B
+     $B%m%0%i%`$N<B9T$J$I$+$iH/@8$9$k$$$+$J$kB;32$KBP$7$F$b@U(B
+     $BG$$r;}$A$^$;$s!%(B

data/README.md

@@ -0,0 +1,99 @@
+
+# module Devel::Which
+
+**Devel::Which - locate a symbol/library in the user's namespace/path**
+
+Forked from http://raa.ruby-lang.org/project/devel-which/
+
+## SYNOPSIS
+
+    require 'devel/which'
+
+    File.which_constant("TRUNC")    #=> File::Constants
+    Fixnum.which_method("nonzero?") #=> Numeric
+    which_library("net/http")       #=> (the path where the net/http exists)
+    whereis_library("forwardable")  #=> [(path, ... )]
+
+
+## DESCRIPTION
+
+Devel::Which provides an effective definition finder, for example,
+Fixnum#nonzero? is defined at Numeric and
+Fixnum.which_method("nonzero?") returns Numeric.
+
+## Constants
+
+Devel::Which::VERSION
+
+Stands for the version of Devel::Which.
+
+## Methods
+
+Module::which_constant(name)
+
+Returns Devel::Which::ForModule::which_constant(self, name). This
+method is defined in devel/which.
+
+Module::which_method(name)
+
+Returns Devel::Which::ForClass::which_method(self, name). This method
+is defined in devel/which.
+
+Object::which_library(name)
+
+Returns Devel::Which::ForObject::which_library(name). This method is
+defined in devel/which.
+
+Returns Devel::Which::ForObject::whereis_library(name). This method is
+defined in devel/which.
+
+Devel::Which::ForModule::which_constant(mod, name)
+
+Returns a Module where the constant name is defined. This method is
+defined in devel/which/formodule.
+
+Devel::Which::ForModule::which_method(mod, name)
+
+Returns a Class where the method name is defined. This method is
+defined in devel/which/formodule.
+
+Devel::Which::ForObject::which_library(name)
+
+Returns a file name where the library name exists. This method is
+defined in devel/which/forobject.
+
+Devel::Which::ForObject::whereis_library(name)
+
+Returns an Array consists of file names where the library name exists.
+This method is defined in devel/which/forobject.
+
+## AUTHORS
+
+### FORK
+
+mori_dev <mori.dev.asdf at gmail dot com>
+
+### ORIGINAL
+
+GOTO Kentaro aka Gotoken <gotoken at notwork dot org>
+
+## HISTORY
+
+### FORK
+
+2012-02-25: VERSION 0.3.0 - added gem, gemspec, Rakefile.
+
+### ORIGINAL
+
+2002-02-02: VERSION 0.2.0 - which_method moved to
+Devel::Which::ForModule.
+
+2002-01-15: VERSION 0.1.1 - added whereis_library (inspired by eban).
+
+2002-01-13: VERSION 0.1.0
+
+
+## LICENSE
+
+Ruby's License
+See LICENSE/* for details.

data/Rakefile

@@ -0,0 +1,33 @@
+require "rake"
+require "rake/clean"
+require "pathname"
+
+
+task :default do
+  sh "rake -T"
+end
+
+CLEAN.include "devel-which-*.gem"
+
+
+namespace :gem do
+
+  desc "build devel-which gem"
+  task :build do
+    sh "rake clean && gem build devel-which.gemspec"
+  end
+
+  desc "run gem install on the built gem"
+  task :install => :build do
+    sh "gem install devel-which*.gem"
+  end
+
+  desc "push devel-which.gem to RubyGems"
+  task :release do
+    if Pathname.new("~/.gem/credentials").expand_path.exist?
+      sh "gem push devel-which*.gem"
+    else
+      raise "Your rubygems.org credentials aren't set. Run `gem push` to set them."
+    end
+  end
+end

data/devel-which.gemspec

@@ -0,0 +1,32 @@
+$:.push File.expand_path("../lib", __FILE__)
+require "devel/which"
+
+Gem::Specification.new do |s|
+  s.name        = "devel-which"
+  s.version     = Devel::Which::VERSION
+  s.authors     = ["GOTO Kentaro aka Gotoken, mori_dev"]
+  s.email       = ["mori.dev.asdf@gmail.com"]
+  s.homepage    = "https://github.com/wakaran/devel-which"
+  s.summary     = %q{Devel::Which - locate a symbol/library in the users namespace/path}
+  s.description = <<-EOS
+    Devel::Which provides an effective definition finder, for example,
+    Fixnum#nonzero? is defined at Numeric and
+    Fixnum.which_method("nonzero?") returns Numeric.
+  EOS
+  s.files = [
+    "devel-which.gemspec",
+    "lib/devel/which",
+    "lib/devel/which/forclass.rb",
+    "lib/devel/which/forobject.rb",
+    "lib/devel/which/libwhich.rb",
+    "lib/devel/which/formodule.rb",
+    "lib/devel/which.rb",
+    "LICENSE/license_ja.txt",
+    "LICENSE/license_en.txt",
+    "README.md",
+    "Rakefile"
+  ]
+
+  s.require_paths = ["lib"]
+
+end

data/lib/devel/which.rb

@@ -0,0 +1,97 @@
+#! /usr/local/bin/ruby
+# $kNotwork: which.rb,v 1.3 2002/02/08 19:52:57 gotoken Exp $
+
+require "devel/which/forobject"
+require "devel/which/formodule"
+
+module Devel
+  module Which
+    VERSION = "0.3.0"
+  end
+end
+
+class Object
+  def which_library(name)
+    Devel::Which::ForObject::which_library(name)
+  end
+
+  def whereis_library(name)
+    Devel::Which::ForObject::whereis_library(name)
+  end
+end
+
+class Module
+  def which_constant(name)
+    Devel::Which::ForModule::which_constant(self, name)
+  end
+
+  def which_method(name)
+    Devel::Which::ForModule::which_method(self, name)
+  end
+end
+
+if __FILE__ == $0
+  def show(str = nil, hidden = nil)
+    if str
+      print("#{str.ljust(25)}")
+      val = eval(str)
+      puts(hidden ? "" : " #=> #{val.inspect}" )
+    else
+      puts("")
+    end
+  end
+
+  show %{Fixnum.which_method :nonzero?}  #=> Numeric
+  show %{Fixnum.which_method :integer?}  #=> Integer
+  show %{Fixnum.which_method :zero?}     #=> Fixnum
+  show %{Array.which_method :sort}       #=> Array
+  show %{Array.which_method :find}       #=> Enumerable
+  show
+  show %{File::Constants.which_constant("IO")} #=> Object
+  show %{File::Constants.which_constant("Constants")} #=> File
+  show %{File::Constants.which_constant("TRUNC")} #=> File::Constants
+  show %{
+    module M0
+      X = 0
+      Z = 0
+    end
+
+    module M1
+      X = 1
+      Y = "1"
+
+      module C
+        Y = "1"
+      end
+    end
+
+    module M2
+      include M0
+      Z = 0
+    end
+
+    module A
+      X = nil
+
+      module B
+        include M1
+
+        module C
+          include M2
+        end
+      end
+    end}, true
+  show
+  show %{A::B::C.which_constant("X")} #=> A
+  show %{A::B::C.which_constant("Y")} #=> nil
+  show %{A::B::C.which_constant("Z")} #=> M0
+  show
+  show %{which_library "xmp"}
+  show %{which_library "irb"}
+  show %{which_library "irb/xmp"}
+  show %{which_library "nkf"}
+  show %{which_library "which.rb"}
+  show
+  show %{whereis_library "uri"}
+  show %{whereis_library "tk"}
+end

data/lib/devel/which/forclass.rb

@@ -0,0 +1,9 @@
+require "devel/which/formodule"
+require "devel/which/libwhich"
+
+module Devel
+  module Which
+    module ForClass
+    end
+  end
+end

data/lib/devel/which/formodule.rb

@@ -0,0 +1,47 @@
+require "devel/which/libwhich"
+
+module Devel
+  module Which
+    module ForModule
+
+      def which_constant(mod, name)
+
+        name  = Devel::Which::name2string(name)
+        nest  = []
+        pos   = 0
+        space = mod.name
+
+        begin
+          pos -= 1
+          space = space[0..pos]
+          nest.push(space)
+        end while pos = space.rindex(/::/)
+
+        nest.map!{|i| eval "::#{i}"}
+        mod.ancestors.each{|i| nest.push i}
+        a = (class << self; self; end).ancestors.each{|i| nest.push i}
+        cand = nest.find_all{|m| m.const_defined? name}
+        last = cand.shift
+        return nil if not last
+        value = last.const_get(name)
+
+        while car = cand.shift
+          break if value != car.const_get(name)
+          last = car
+        end
+
+        last
+      end
+      module_function :which_constant
+
+      def which_method(mod, name)
+        name = Devel::Which::name2string(name)
+        mod.ancestors.find{|a|
+          a.instance_methods.include?(name)
+        }
+      end
+      module_function :which_method
+
+    end
+  end
+end

data/lib/devel/which/forobject.rb

@@ -0,0 +1,72 @@
+require "rbconfig"
+
+module Devel
+  module Which
+    module ForObject
+      def which_library(lib)
+        unless lib.is_a? String
+          raise TypeError,
+            "wrong argument type #{lib.type} (expected String)"
+        end
+        ext = ["rb", Config::CONFIG["DLEXT"], Config::CONFIG["DLEXT2"]]
+        ext.map!{|i| i.length > 0 ? ".#{i}" : nil}
+        ext.compact!
+        ext.push("")
+
+        at = with = nil
+        at = $:.find{|path|
+          file = "#{File::expand_path(path)}/#{lib}"
+
+          begin
+            with = ext.find{|i|
+              test(?f, file+i) && test(?r, file+i)
+            }
+          rescue
+            next
+          end
+        }
+
+        "#{at}/#{lib}#{with}" if at
+      end
+      module_function :which_library
+
+      def whereis_library(lib, opt = {})
+        unless lib.is_a? String
+          raise TypeError,
+            "wrong argument type #{lib.type} (expected String)"
+        end
+        unless opt.is_a? Hash
+          raise TypeError,
+            "wrong argument type #{lib.type} (expected Hash)"
+        end
+        optpath = opt[:path] || opt[:p] || []
+        optext = opt[:ext] || opt[:e] || ""
+        ext = ["rb", Config::CONFIG["DLEXT"], Config::CONFIG["DLEXT2"], optext]
+        ext.map!{|i| i.length > 0 ? ".#{i}" : nil}
+        ext.compact!
+        ext.push("")
+
+        at = []
+
+        ($: + optpath).each{|path|
+          with = nil
+          file = "#{File::expand_path(path)}/#{lib}"
+
+          begin
+            ext.each{|with|
+              if (test(?f, file+with) && test(?r, file+with) rescue false)
+                at << "#{path}/#{lib}#{with}"
+              end
+            }
+          rescue
+            next
+          end
+        }
+
+        at
+      end
+      module_function :whereis_library
+
+    end
+  end
+end

data/lib/devel/which/libwhich.rb

@@ -0,0 +1,14 @@
+module Devel
+  module Which
+    def name2string(name)
+      name = name.id2name if name.is_a? Symbol
+      unless name.is_a? String
+        raise TypeError,
+        "wrong argument type #{name.type} (expected String or Symbol)"
+      else
+        name
+      end
+    end
+    module_function :name2string
+  end
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: devel-which
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+  prerelease: 
+platform: ruby
+authors:
+- GOTO Kentaro aka Gotoken, mori_dev
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-10 00:00:00.000000000Z
+dependencies: []
+description: ! "    Devel::Which provides an effective definition finder, for example,\n
+  \   Fixnum#nonzero? is defined at Numeric and\n    Fixnum.which_method(\"nonzero?\")
+  returns Numeric.\n"
+email:
+- mori.dev.asdf@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- devel-which.gemspec
+- lib/devel/which/forclass.rb
+- lib/devel/which/forobject.rb
+- lib/devel/which/libwhich.rb
+- lib/devel/which/formodule.rb
+- lib/devel/which.rb
+- LICENSE/license_ja.txt
+- LICENSE/license_en.txt
+- README.md
+- Rakefile
+homepage: https://github.com/wakaran/devel-which
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.13
+signing_key: 
+specification_version: 3
+summary: Devel::Which - locate a symbol/library in the users namespace/path
+test_files: []