impl 1.0 → 1.1

data/README.md

@@ -2,14 +2,25 @@
 
 ## Usage
 
+### Impl normal usage
+
+    $ impl ~/git/ruby193 'Strimg#sum'
+    String#sum	string.c	/^rb_str_sum(int argc, VALUE *argv, VALUE str)$/;"	f	file:
+
+This may take long time in the first time you called, but it won't take time in the next time.
+
+## Impl plumbing usage (mostly for editor integration)
+
     $ cd ~/git/ruby193
     $ ctags -R
-    $ impl >> tags
+    $ impl --create . >> tags
 
 After moving into the latest Ruby source code directory of you, the first command builds `tags` by the Ruby C source codes, using your own `ctags` command. Then impl extracts Ruby methods both from the source codes and the `tags` file. The command outputs additional tags to STDOUT, so you may want to redirect to `tags` for appending them.
 
 Now you can go into the definition of a Ruby method by Ruby method format like `Random#rand`!
 
+## Legacy usage (not available right now)
+
 Higher level handy command is also available. The following command does almost equivalent to the three command previously I showed.
 
     $ impl --suite ~/git/ruby193

data/bin/impl

@@ -1,16 +1,22 @@
 #!/usr/bin/env ruby
+require 'pathname'
+$: << 'lib'
 require 'impl'
-case ARGV.shift
-when '-h'
+case ARGV[0]
+when '-h', '--help', '-v', '--version'
   puts Impl.help
-when '--suite'
-  Dir.chdir(File.expand_path(ARGV.shift)) do
-    additional = `#{__FILE__}`
-    File.open('tags', 'a') {|io| io.puts additional }
-  end
-else
+#when '--suite'
+#  Dir.chdir(File.expand_path(ARGV.shift)) do
+#    additional = `#{__FILE__}`
+#    File.open('tags', 'a') {|io| io.puts additional }
+#  end
+when '-c', '--create'
   ctags = File.read('tags')
   dir = File.expand_path '.'
   puts Impl.generate(ctags, dir)
+else
+  base = Pathname(ARGV.shift).expand_path
+  name = ARGV.shift
+  puts Impl.direct(base, name)
 end
 # vim: set ft=ruby :

data/lib/impl.rb

@@ -1,5 +1,16 @@
+module Enumerable
+  def take_until
+    memo = []
+    each do |x|
+      memo << x
+      break if yield x
+    end
+    memo
+  end
+end
+
 module Impl
-  VERSION = '1.0'
+  VERSION = '1.1'
 
   def generate(ctags, dir)
     memo = []
@@ -23,13 +34,49 @@ module Impl
     impl version #{VERSION}
 
     USAGE
-      impl -h: shows this message
-      impl:    shows additional information, assuming you already have |tags|
-               and Ruby codes in the current directory.
-      impl --suite {directory}:
-               generates new |tags| file in {directory} using files in
+      impl -h:
+               shows this message
+      impl {directory} {method name}
+               shows the file name and line number where {method name} like
+               'Strimg#sum' defined, assuming the Ruby source directory is
                {directory}.
+      impl -d {directory} {method name}
+      impl --description {directory} {method name}
+               shows the description of {method name} like 'Strimg#sum'
+               directly, assuming the Ruby source directory is {directory}.
+      impl -c {directory}:
+      impl --create {directory}:
+               shows additional information, assuming you already have
+               |tags| and Ruby codes in the current directory.
     EOH
   end
   module_function :help
+
+  def direct(base, name)
+    unless File.exists?(base + 'tags')
+      Dir.chdir base do
+        system 'ctags -R'
+      end
+    end
+    if /^String#sum/ !~ File.read(base + 'tags')
+      Dir.chdir base do
+        system 'impl -c .', out: ['tags', 'a']
+      end
+    end
+
+    x = File.read(base + 'tags').
+      each_line.
+      select {|l| /^#{name}\t/ =~ l }.
+      map {|l| l.split("\t") }.
+      first
+    r = Regexp.new(x[2][1..-4].gsub(/[\(\*\)]/) {|x| '\\' << x })
+    file = base + x[1]
+    content = File.read(file)
+    line, i = content.
+      each_line.
+      with_index.
+      detect {|line, _| r =~ line }
+    content.each_line.drop(i).take_until {|line| /^}/ =~ line }
+  end
+  module_function :direct
 end

metadata

@@ -4,8 +4,8 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 1
-  - 0
-  version: "1.0"
+  - 1
+  version: "1.1"
 platform: ruby
 authors: 
 - ujihisa
@@ -13,7 +13,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-01 00:00:00 -08:00
+date: 2011-03-11 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency