nkpart-accidently 0.0.1

data/History.txt

@@ -0,0 +1,6 @@
+1770 Captain Cook landed on the East coast of Australia.
+
+== 0.0.1 2008-11-12
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,21 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+TODO
+accidently.gemspec
+etc/examples.rb
+etc/textmate_command.rb
+lib/accidently.rb
+lib/accidently/mad_hax.rb
+lib/accidently/method_invoker.rb
+lib/accidently/patches/kernel.rb
+lib/accidently/patches/thread.rb
+script/console
+script/destroy
+script/generate
+spec/accidently_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/rspec.rake

data/PostInstall.txt

@@ -0,0 +1,7 @@
+
+For more information on how_does, see http://how_does.rubyforge.org
+
+NOTE: Change this information in PostInstall.txt 
+You can also delete it if you don't want it.
+
+

data/README.rdoc

@@ -0,0 +1,65 @@
+= Accidently!
+
+* http://github.com/nkpart/accidently
+
+== What?
+
+Accidently helps you out when you know what you want to do something, but you can't remember the function name
+
+== How
+
+$ sudo gem install nkpart-accidently
+$ irb
+
+>> require 'accidently'
+>> 1.accidently == '1'
+=> ["to_s", "inspect"]
+
+== Examples:
+
+> [1,2,3].accidently == 3
+ => ["last", "pop", "length", "size", "nitems", "max"]
+
+> [1,nil,3,5].accidently == [1,3,5]
+ => ["select", "compact", "compact!", "find_all"]
+
+> [:a, :b, :c].accidently(:b) == 1
+ => ["index", "rindex"]
+
+> [:a, :b, :c, :d].accidently(2,3) == [:c, :d]
+ => ["slice", "indexes", "values_at", "indices", "slice!", "[]"]
+
+> "abc".accidently(/\w/) == ["a","b","c"]
+ => ["scan"]
+
+> [1,2,3,4,5].accidently{|a,b| a + b} == 15
+ => ["inject"]
+
+== Requirements
+
+* prohax - http://github.com/nkpart/prohax
+
+== License
+
+(The MIT License)
+
+Copyright (c) 2008 nkpart
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,28 @@
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/accidently'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('accidently', Accidently::VERSION) do |p|
+  p.developer('nkpart', 'nkpart@gmail.com')
+  p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.post_install_message = 'PostInstall.txt' # TODO remove if post-install message not required
+  p.rubyforge_name       = p.name # TODO this is default value
+  p.extra_deps         = [
+    ['nkpart-prohax','>= 1.0.1']
+  ]
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks'
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+task "build" => ["spec", "verify_rcov"]
+task :default => [:build]

data/TODO

@@ -0,0 +1,4 @@
+* Do a fuzzy search. Methods that return things of the same type as the expected thing should be found.
+* Create a type to wrap the returned methods.
+* Find a method which expects parameters even when we haven't supplied the arguments.
+  * Would need to knock up our own arguments in the MethodInvoker...

data/accidently.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{accidently}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["nkpart"]
+  s.date = %q{2008-11-18}
+  s.description = %q{}
+  s.email = ["nkpart@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc"]
+  s.files = ["History.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "TODO", "accidently.gemspec", "etc/examples.rb", "etc/textmate_command.rb", "lib/accidently.rb", "lib/accidently/mad_hax.rb", "lib/accidently/method_invoker.rb", "lib/accidently/patches/kernel.rb", "lib/accidently/patches/thread.rb", "script/console", "script/destroy", "script/generate", "spec/accidently_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/rspec.rake"]
+  s.has_rdoc = true
+  s.homepage = %q{http://github.com/nkpart/accidently}
+  s.post_install_message = %q{PostInstall.txt}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{accidently}
+  s.rubygems_version = %q{1.3.1}
+  s.summary = %q{}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nkpart-prohax>, [">= 1.0.1"])
+      s.add_development_dependency(%q<newgem>, [">= 1.1.0"])
+      s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
+    else
+      s.add_dependency(%q<nkpart-prohax>, [">= 1.0.1"])
+      s.add_dependency(%q<newgem>, [">= 1.1.0"])
+      s.add_dependency(%q<hoe>, [">= 1.8.0"])
+    end
+  else
+    s.add_dependency(%q<nkpart-prohax>, [">= 1.0.1"])
+    s.add_dependency(%q<newgem>, [">= 1.1.0"])
+    s.add_dependency(%q<hoe>, [">= 1.8.0"])
+  end
+end

data/etc/examples.rb

@@ -0,0 +1,21 @@
+require '../lib/accidently'
+
+examples = <<EXAMPLES
+[1,2,3].accidently == 3
+[1,nil,3,5].accidently == [1,3,5]
+[:a, :b, :c].accidently(:b) == 1
+[:a, :b, :c, :d].accidently(2,3) == [:c, :d]
+"abc".accidently(/\\w/) == ["a","b","c"]
+[1,2,3,4,5].accidently{|a,b| a + b} == 15
+EXAMPLES
+
+examples.split("\n").each do |example|
+  next if example.empty?
+  puts "> #{example}\n => #{eval(example).inspect}"
+  puts ""
+end
+
+1.accidently == '1'
+
+[1,2,3].accidently(2) == [1,2]
+

data/etc/textmate_command.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+gem 'accidently'
+require 'accidently'
+input = STDIN.read
+answers = eval(input)
+if !answers.empty?
+  puts "# #{input}"
+  puts answers.map { |a|
+    input.gsub(/accidently/, a)
+  }.join("\n")
+else
+  puts $TM_SELECTED_TEXT + " # No match"
+end
+

data/lib/accidently.rb

@@ -0,0 +1,34 @@
+$: << File.expand_path(File.dirname(__FILE__))
+
+require 'rubygems'
+gem 'nkpart-prohax'
+require 'prohax'
+require 'accidently/mad_hax'
+
+class Object
+  def accidently *args, &block
+    Accidently::Proxy.new(self).with(*args, &block)
+  end
+end
+
+module Accidently
+  VERSION = '0.0.1'
+
+  class Proxy
+    def initialize object
+      @object = object
+      @args = []
+      @block = nil
+    end
+
+    def == result
+      MadHax.find_how @object, result, @args, &@block
+    end
+
+    def with *args, &block
+      @args.concat args
+      @block = block
+      self
+    end
+  end
+end

data/lib/accidently/mad_hax.rb

@@ -0,0 +1,24 @@
+require 'accidently/method_invoker'
+
+module Accidently
+  module MadHax
+
+    @@blacklist = %w(daemonize display exec exit! fork sleep system syscall what? what ri accidently)
+
+    module_function
+            
+    def select_candidates methods
+      methods.select { |m| m !~ /(should)|(assert)|(methods)/ && !@@blacklist.include?(m)}
+    end
+  
+    def find_how original, target, args = [], &blk
+      let(
+        :f => proc { |m| MethodInvoker.invoke(original, m, args, &blk) },
+        :candidates => proc { select_candidates(original.methods) }
+      ).in {
+        candidates.select { |m| f(m) == target }
+      } 
+    end
+  
+  end
+end

data/lib/accidently/method_invoker.rb

@@ -0,0 +1,54 @@
+require 'accidently/patches/kernel'
+require 'accidently/patches/thread'
+
+class InvocationResult < Strucked.build(:result, :block_used); end
+  
+module Accidently  
+  class MethodInvoker
+    def self.invoke v, meth, args, &blk
+      self.new(v).invoke(meth, args, &blk)
+    end
+      
+    def initialize v
+      @v = v
+    end
+    
+    def invoke meth, args, &blk
+      v, warns = yield_and_collect_stderr {
+        invocation_result, fail = either { do_send(meth, args, &blk) }
+        if should_do_block_execute(invocation_result, fail) then
+          either { invoke_and_infer_block(meth, args) }.compact.first
+        else
+          invocation_result
+        end
+      }
+      # TODO handle the warns            
+      v
+    end
+    
+    private
+    
+    def should_do_block_execute(invocation_result, fail)
+      let(
+        :is_a_187_block_result => proc { |x| defined?(Enumerable::Enumerator) && x.is_a?(Enumerable::Enumerator) },
+        :failed_because_no_block => proc { |fail| (fail && fail.is_a?(LocalJumpError)) }
+      ).in {
+        failed_because_no_block(fail) || is_a_187_block_result(invocation_result)
+      }
+    end
+
+    def do_send meth, args, &blk
+      # Executing with timeout in case of endless methods, like Array#cycle in 1.8.7
+      Thread.execute_with_timeout { dup(@v).send(meth, *args, &blk) } 
+    end
+    
+    def dup value
+      (value.is_a? Fixnum) ? value : value.dup
+    end
+    
+    def invoke_and_infer_block m, args
+      blk = proc { |x| x }
+      do_send(m, args, &blk)
+    end
+  end
+end

data/lib/accidently/patches/kernel.rb

@@ -0,0 +1,12 @@
+module Kernel
+  def yield_and_collect_stderr
+    # so many lol effects
+    old_err = $stderr
+    $stderr = StringIO.new
+    r = yield
+    warns = $stderr.string
+    [r, warns]
+  ensure
+    $stderr = old_err
+  end
+end

data/lib/accidently/patches/thread.rb

@@ -0,0 +1,11 @@
+class Thread
+  
+  def self.execute_with_timeout(timeout = 0.5)
+    r = nil
+    t = Thread.new {
+      r = yield 
+    }
+    t.join(timeout)
+    r
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/how_does.rb'}"
+puts "Loading how_does gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/spec/accidently_spec.rb

@@ -0,0 +1,85 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+include Accidently
+
+describe Accidently do
+  it "should figure out length of an array" do
+    methods = "dog".accidently == 3
+    assert methods.include?("length")
+  end
+
+  it "should figure out array reversal" do
+    methods = [1, 2].accidently == [2, 1]
+    assert methods.include?("reverse")
+  end
+  
+  it "should figure out select" do
+    methods = [1, false, 2].accidently == [1, 2]
+    assert methods.include?("select { |x| x }")
+  end
+  
+  it "should figure out index" do
+    methods = [:a, :b, :c].accidently == :a
+    assert methods.include?("first")
+  end
+  
+  it "should be able to be guided by a parameter" do
+    methods = [:a, :b, :c].accidently(:b) == 1
+    assert methods.include?("index")
+  end
+  
+  it "should be able to be guided by more than one parameter" do
+    methods = [:a, :b, :c, :d, :e].accidently(1, 2) == [:b, :c]
+    assert methods.include?("slice")
+  end
+
+  it "should be able to take a block suggestion" do
+    m = [1, 2, 3].accidently{ |a, b| a + b } == 6
+    assert m.include?("inject")
+  end
+  
+  it "should not fail for fixnums" do
+    m = 1.accidently == "1"
+    assert m.include?("to_s")
+  end
+end
+
+describe Accidently::MethodInvoker do
+  it "should invoke a simple no args method" do
+    r = MethodInvoker.invoke [], :size, []
+    assert_equal 0, r
+  end
+  
+  it "should invoke a no args method that takes a block" do
+    r = MethodInvoker.invoke [1], :select, []
+    assert_equal [1], r    
+  end
+end
+
+describe "Kernel patches" do
+  it "should collect warns" do
+    a, warns = yield_and_collect_stderr {
+      warn "fail"
+      warn "2"
+      5
+    }
+    
+    a.should == 5
+    warns.should == "fail\n2\n"
+  end
+end
+
+describe "Thread patches" do
+  it "should execute with a timeout" do
+    Thread.execute_with_timeout(0.1) do
+      5
+    end.should == 5
+  end
+  
+  it "should terminate early if longer than timeout" do
+    Thread.execute_with_timeout(0.1) do sleep(0.2); 1 end.should == nil
+  end
+end
+
+
+

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  gem 'rspec'
+  require 'spec'
+end
+
+require 'test/unit/assertions'
+
+include Test::Unit::Assertions
+
+$:.unshift(File.dirname(__FILE__) + '/../lib')
+require 'accidently'
+require 'accidently/method_invoker'
+require 'accidently/patches/kernel'

data/tasks/rspec.rake

@@ -0,0 +1,29 @@
+begin
+  require 'spec'
+rescue LoadError
+  require 'rubygems'
+  require 'spec'
+end
+begin
+  require 'spec/rake/spectask'
+  require 'spec/rake/verify_rcov'
+rescue LoadError
+  puts <<-EOS
+To use rspec for testing you must install rspec gem:
+    gem install rspec
+EOS
+  exit(0)
+end
+
+desc "coverage"
+RCov::VerifyTask.new do |t|
+  t.threshold = 100
+end
+
+desc "Run the specs under spec/models"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov_opts = ['--exclude', 'spec,rcov.rb']
+  t.rcov = true
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification 
+name: nkpart-accidently
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- nkpart
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-18 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: nkpart-prohax
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: ""
+email: 
+- nkpart@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+files: 
+- History.txt
+- Manifest.txt
+- PostInstall.txt
+- README.rdoc
+- Rakefile
+- TODO
+- accidently.gemspec
+- etc/examples.rb
+- etc/textmate_command.rb
+- lib/accidently.rb
+- lib/accidently/mad_hax.rb
+- lib/accidently/method_invoker.rb
+- lib/accidently/patches/kernel.rb
+- lib/accidently/patches/thread.rb
+- script/console
+- script/destroy
+- script/generate
+- spec/accidently_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rspec.rake
+has_rdoc: true
+homepage: http://github.com/nkpart/accidently
+post_install_message: PostInstall.txt
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: accidently
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: ""
+test_files: []
+