rsearch 0.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.2"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,28 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.6.2)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.9.2)
+    rcov (0.9.9)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.2)
+  rcov
+  rspec (~> 2.3.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Serguei Filimonov
+
+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/README.rdoc

@@ -0,0 +1,19 @@
+= rsearch
+
+Description goes here.
+
+== Contributing to rsearch
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Serguei Filimonov. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "rsearch"
+  gem.homepage = "http://github.com/sergueif/rsearch"
+  gem.license = "MIT"
+  gem.summary = %Q{one-line summary of your gem}
+  gem.description = %Q{longer description of your gem}
+  gem.email = "serguei.filimonov@gmail.com"
+  gem.authors = ["Serguei Filimonov"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "rsearch #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/lib/rsearch/bfs.rb

@@ -0,0 +1,27 @@
+require 'set'
+require File.dirname(__FILE__) + '/search'
+
+class BFS
+  def initialize(options)
+    queue = []
+    marked = Set.new
+    marked << options[:start]
+    scheduler = Proc.new do |states|
+      states.each do |state|
+        if !marked.include?(state)
+          queue << state
+          marked << state
+        end
+      end
+      queue.shift
+    end
+
+    @search = Search.new(start: options[:start],
+                         generator: options[:generator],
+                         scheduler: scheduler)
+  end
+
+  def method_missing(meth, *args, &block)
+    @search.send(meth, *args, &block)
+  end
+end

data/lib/rsearch/dfs.rb

@@ -0,0 +1,27 @@
+require 'set'
+require File.dirname(__FILE__) + '/search'
+
+class DFS
+  def initialize(options)
+
+    stack = []
+    marked = Set.new
+    marked << options[:start]
+
+    scheduler = Proc.new do |states|
+      states.reverse.each do |state|
+        stack << state if !marked.include?(state)
+        marked << state
+      end
+      stack.pop
+    end
+
+    @search = Search.new(start: options[:start],
+                         generator: options[:generator],
+                         scheduler: scheduler)
+  end
+
+  def method_missing(meth, *args, &block)
+    @search.send(meth, *args, &block)
+  end
+end

data/lib/rsearch/search.rb

@@ -0,0 +1,57 @@
+require 'set'
+
+class Search
+  attr_reader :iterations, :current_state
+
+  #Search object is initialized with a start node, a generator function that expands
+  #neighbours of the node, and scheduler that chooses which neighbour to expand next
+  def initialize(options)
+    @start = options[:start]
+    @generator = options[:generator]
+    @scheduler = options[:scheduler]
+    @iterations = 0                   #keep track of iterations executed
+    @current_state = @start           #set start as current state of the search
+    @child_to_parent = {}             #parent tree to find paths
+    @parents = Set.new                #keep track of parents to prevent back-edges in the parent tree
+  end
+
+
+  #performs an iteration of a search, expanding the current node in the search tree
+  #and scheduling neighbours, as well as keep track of paths and iterations
+  def run
+    raise "dead end" if @current_state.nil?
+    @iterations += 1
+
+    new_states = @generator.call(@current_state)
+    @parents << @current_state if new_states.any?
+    new_states.each do |new_state|
+      if !@parents.include?(new_state) && #prevent back-edges
+        !@child_to_parent[new_state] #respect expansion order in the path
+        @child_to_parent[new_state] = @current_state
+      end
+    end
+    next_state = @scheduler.call(new_states)
+    @current_state = next_state
+  end
+
+  #returns the path to the current node from the start
+  def path
+    path_to(@current_state)
+  end
+
+  #how far is the search right now from the start
+  def distance
+    path.size - 1
+  end
+
+  private
+
+  def path_to(node)
+    anc = [node]
+    while @child_to_parent[node]
+      anc << @child_to_parent[node]
+      node = @child_to_parent[node]
+    end
+    anc.reverse
+  end
+end

data/lib/rsearch/tabu.rb

@@ -0,0 +1,23 @@
+#this class maintains a tabu list and kicks elements out if they are too old
+class Tabu
+
+  def initialize(size)
+    @hash = {}
+    @max = size
+  end
+
+  #decrease longevity of all keys and insert new one
+  def insert(elem)
+    @hash.each_key do |key|
+      @hash[key] -= 1
+      if @hash[key] <= 0
+        @hash.delete(key)
+      end
+    end
+    @hash[elem] = @max
+  end
+
+  def include?(elem)
+    !@hash[elem].nil?
+  end
+end

data/lib/rsearch.rb

@@ -0,0 +1,2 @@
+Dir[File.dirname(__FILE__) + "/**/*.rb"].each { |file| require file }
+

data/rsearch.gemspec

@@ -0,0 +1,69 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rsearch}
+  s.version = "0.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Serguei Filimonov"]
+  s.date = %q{2011-06-12}
+  s.description = %q{longer description of your gem}
+  s.email = %q{serguei.filimonov@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/rsearch.rb",
+    "lib/rsearch/bfs.rb",
+    "lib/rsearch/dfs.rb",
+    "lib/rsearch/search.rb",
+    "lib/rsearch/tabu.rb",
+    "rsearch.gemspec",
+    "spec/bfs_spec.rb",
+    "spec/dfs_spec.rb",
+    "spec/rsearch_spec.rb",
+    "spec/search_spec.rb",
+    "spec/searcher_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/tabu_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/sergueif/rsearch}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{one-line summary of your gem}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+  end
+end
+

data/spec/bfs_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe BFS do
+  it "works" do
+    start = 1
+    generator = Proc.new do |state|
+      new_states = if state.abs < 5
+                     [state+2,state-1]
+                   else
+                     []
+                   end
+      new_states
+    end
+    @search = BFS.new(:start => start, :generator => generator)
+    @search.run
+    @search.path.should == [1,3]
+    @search.run
+    @search.path.should == [1,0]
+    @search.run
+    @search.path.should == [1,3,5]
+    @search.run
+    @search.path.should == [1,3,2]
+    @search.run
+    @search.path.should == [1,0,-1]
+    @search.run
+    @search.path.should == [1,3,2,4]
+    @search.run
+    @search.path.should == [1,0,-1,-2]
+    @search.run
+    @search.path.should == [1,3,2,4,6]
+    @search.run
+    @search.path.should == [1,0,-1,-2,-3]
+  end
+end

data/spec/dfs_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+describe DFS do
+  it "works" do
+    start = 1
+    generator = Proc.new do |state|
+      new_states = if state.abs < 5
+                     [state+2,state-1]
+                   else
+                     []
+                   end
+      new_states
+    end
+    @search = DFS.new(:start => start, :generator => generator)
+    @search.run
+    @search.path.should == [1,3]
+    @search.run
+    @search.path.should == [1,3,5]
+    @search.run
+    @search.path.should == [1,3,2]
+    @search.run
+    @search.path.should == [1,3,2,4]
+    @search.run
+    @search.path.should == [1,3,2,4,6]
+    @search.run
+    @search.path.should == [1,0]
+    @search.run
+    @search.path.should == [1,0,-1]
+    @search.run
+    @search.path.should == [1,0,-1,-2]
+  end
+end

data/spec/rsearch_spec.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')

data/spec/search_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe Search do
+  before do
+    @search = Search.new(start: nil, generator: nil, scheduler: nil)
+  end
+
+  it "is an object" do
+    @search.should be
+  end
+
+  describe "run" do
+    it "executes the callback with start node on first iteration" do
+      generator = Proc.new do |state|
+        [state+1]
+      end
+      scheduler = Proc.new{|states| states.first}
+      generator.should_receive(:call).with(0).and_return([1])
+      @search = Search.new(start: 0, generator: generator, scheduler: scheduler)
+      @search.iterations.should == 0
+      @search.run
+      @search.iterations.should == 1
+    end
+    it "maintains a current state" do
+      generator = Proc.new do |state|
+        [state+1]
+      end
+      scheduler = Proc.new{|states| states.first}
+      @search = Search.new(start: 0, generator: generator, scheduler: scheduler)
+      @search.current_state.should == 0
+      @search.run
+      @search.current_state.should == 1
+    end
+    it "maintains a parent tree state" do
+      generator = Proc.new do |state|
+        [state+1]
+      end
+      scheduler = Proc.new{|states| states.first}
+      @search = Search.new(start: 0, generator: generator, scheduler: scheduler)
+      @search.run
+      @search.path.should == [0,1]
+      @search.distance.should == 1
+      @search.run
+      @search.path.should == [0,1,2]
+      @search.distance.should == 2
+    end
+  end
+end

data/spec/searcher_spec.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'rsearch'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  
+end

data/spec/tabu_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe Tabu do
+  it "works" do
+    t = Tabu.new(2)
+    t.insert(1)
+    t.include?(1).should be_true
+    t.insert(2)
+    t.include?(2).should be_true
+    t.insert(3)
+    t.include?(3).should be_true
+    t.include?(1).should be_false
+    t.insert(2)
+    t.include?(2).should be_true
+    t.include?(3).should be_true
+  end
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: rsearch
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Serguei Filimonov
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-12 00:00:00.000000000 -04:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &71325450 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
+  prerelease: false
+  version_requirements: *71325450
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &71324900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *71324900
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &71324440 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+  type: :development
+  prerelease: false
+  version_requirements: *71324440
+- !ruby/object:Gem::Dependency
+  name: rcov
+  requirement: &71324030 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *71324030
+description: longer description of your gem
+email: serguei.filimonov@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/rsearch.rb
+- lib/rsearch/bfs.rb
+- lib/rsearch/dfs.rb
+- lib/rsearch/search.rb
+- lib/rsearch/tabu.rb
+- rsearch.gemspec
+- spec/bfs_spec.rb
+- spec/dfs_spec.rb
+- spec/rsearch_spec.rb
+- spec/search_spec.rb
+- spec/searcher_spec.rb
+- spec/spec_helper.rb
+- spec/tabu_spec.rb
+has_rdoc: true
+homepage: http://github.com/sergueif/rsearch
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -63201453
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: one-line summary of your gem
+test_files: []