simple_column_search 1.0.0

data/CHANGELOG

@@ -0,0 +1,13 @@
+v1.0.0. PostgreSQL support, Rit Li [rit]
+
+v0.1.2. Fixed initialization when used as a plugin.
+
+v0.1.1. Version bump to trigger a GitHub rebuild.
+
+v0.1.0. Support for specifying match type and specifying name.
+
+v0.0.3. Plenty of doc cleanups.
+
+v0.0.2. Added a simpler interface to enable the plugin.
+
+v0.0.1. Initial release.

data/Manifest

@@ -0,0 +1,8 @@
+CHANGELOG
+init.rb
+lib/simple_column_search.rb
+Manifest
+Rakefile
+README.rdoc
+spec/models.rb
+spec/spec_helper.rb

data/README.rdoc

@@ -0,0 +1,40 @@
+= Simple Column Search
+
+Quick and dirty multi column LIKE searches. Great for prototyping auto-completers as it handles partial matches and adding search terms refines the results.
+
+Running lots of queries or have a large data set? You should probably upgrade to a real search back-end already!
+
+== Examples
+
+Add a search method to your model by calling simple_column_search with the fields you want to search.
+
+  class User
+    simple_column_search :first_name, :last_name
+  end
+ 
+Search for a single value across all searched columns.
+
+  User.search('eli')             # => anyone with first or last name starting with eli
+  User.search('miller')          # => anyone with first or last name starting with miller
+  
+Refine the search by adding another search term.
+
+  User.search('eli miller')
+    # => anyone with first or last name starting with eli AND
+    #    anyone with first or last name starting with miller
+
+== Install
+
+As a Rails plugin.
+
+  ./script/plugin install git://github.com/jqr/simple_column_search.git
+
+Prefer gems? Add this to your environment.rb and run the following command.
+
+  config.gem 'simple_column_search', :source => 'http://gemcutter.org'
+
+  $ rake gems:install
+
+
+Homepage:: http://github.com/jqr/simple_column_search/tree/master  
+License:: Copyright (c) 2008 Elijah Miller <mailto:elijah.miller@gmail.com>, released under the MIT license.

data/Rakefile

@@ -0,0 +1,18 @@
+require 'spec/rake/spectask'
+
+require 'echoe'
+Echoe.new 'simple_column_search' do |p|
+  p.description     = "Quick and dirty multi column LIKE searches."
+  p.url             = "http://github.com/jqr/simple_column_search"
+  p.author          = "Elijah Miller"
+  p.email           = "elijah.miller@gmail.com"
+  p.retain_gemspec  = true
+  p.need_tar_gz     = false
+  p.extra_deps      = [
+  ]
+  p.ignore_pattern  = ['spec/test.sqlite3']
+end
+
+desc 'Default: run specs'
+task :default => :spec
+task :test => :spec

data/init.rb

@@ -0,0 +1,3 @@
+require 'simple_column_search'
+
+ActiveRecord::Base.extend(SimpleColumnSearch)

data/lib/simple_column_search.rb

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'activerecord'
+
+module SimpleColumnSearch
+  # Adds a Model.search('term1 term2') method that searches across SEARCH_COLUMNS
+  # for ANDed TERMS ORed across columns.
+  #   
+  #  class User
+  #    simple_column_search :first_name, :last_name
+  #  end
+  #  
+  #  User.search('elijah')          # => anyone with first or last name elijah
+  #  User.search('miller')          # => anyone with first or last name miller
+  #  User.search('elijah miller')
+  #    # => anyone with first or last name elijah AND
+  #    #    anyone with first or last name miller
+  def simple_column_search(*args)
+    options = args.extract_options!
+    columns = args
+
+    options[:match] ||= :start
+    options[:name] ||= 'search'
+
+    # PostgreSQL LIKE is case-sensitive, use ILIKE for case-insensitive
+    like = connection.adapter_name == "PostgreSQL" ? "ILIKE" : "LIKE"
+    
+    named_scope options[:name], lambda { |terms|
+      conditions = terms.split.inject(nil) do |acc, term|
+        pattern = 
+          case(options[:match])
+          when :exact
+            term
+          when :start
+            term + '%'
+          when :middle
+            '%' + term + '%'
+          when :end
+            '%' + term
+          else
+            raise "Unexpected match type: #{options[:match]}"
+          end
+        merge_conditions  acc, [columns.collect { |column| "#{table_name}.#{column} #{like} :pattern" }.join(' OR '), { :pattern => pattern }]
+      end
+    
+      { :conditions => conditions }
+    }
+  end
+  
+end

data/simple_column_search.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{simple_column_search}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Elijah Miller"]
+  s.date = %q{2009-12-03}
+  s.description = %q{Quick and dirty multi column LIKE searches.}
+  s.email = %q{elijah.miller@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "lib/simple_column_search.rb", "README.rdoc"]
+  s.files = ["CHANGELOG", "init.rb", "lib/simple_column_search.rb", "Manifest", "Rakefile", "README.rdoc", "spec/models.rb", "spec/spec_helper.rb", "simple_column_search.gemspec"]
+  s.homepage = %q{http://github.com/jqr/simple_column_search}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Simple_column_search", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{simple_column_search}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Quick and dirty multi column LIKE searches.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/models.rb

@@ -0,0 +1,10 @@
+class Person < ActiveRecord::Base
+  simple_column_search :first_name, :last_name, :alias
+
+  simple_column_search :first_name, :name => :search_first_name_default_match
+
+  simple_column_search :first_name, :name => :search_first_name_exact, :match => :exact
+  simple_column_search :first_name, :name => :search_first_name_start, :match => :start
+  simple_column_search :first_name, :name => :search_first_name_middle, :match => :middle
+  simple_column_search :first_name, :name => :search_first_name_end, :match => :end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+require 'spec'
+require 'fileutils'
+
+
+$: << File.join(File.dirname(__FILE__), '..', 'lib')
+
+require File.join(File.dirname(__FILE__), '..', 'init')
+
+TEST_DATABASE_FILE = File.join(File.dirname(__FILE__), 'test.sqlite3')
+
+Spec::Runner.configure do |config|
+  
+end
+
+def setup_database
+  File.unlink(TEST_DATABASE_FILE) if File.exist?(TEST_DATABASE_FILE)
+  ActiveRecord::Base.establish_connection(
+    "adapter" => "sqlite3", "timeout" => 5000, "database" => TEST_DATABASE_FILE
+  )
+  create_tables
+end
+
+def create_tables
+  c = ActiveRecord::Base.connection
+  
+  c.create_table :people, :force => true do |t|
+    t.string :first_name
+    t.string :last_name
+    t.string :alias
+    t.timestamps
+  end
+end
+
+setup_database
+
+require File.join(File.dirname(__FILE__), 'models')

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: simple_column_search
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Elijah Miller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-03 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Quick and dirty multi column LIKE searches.
+email: elijah.miller@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/simple_column_search.rb
+- README.rdoc
+files: 
+- CHANGELOG
+- init.rb
+- lib/simple_column_search.rb
+- Manifest
+- Rakefile
+- README.rdoc
+- spec/models.rb
+- spec/spec_helper.rb
+- simple_column_search.gemspec
+has_rdoc: true
+homepage: http://github.com/jqr/simple_column_search
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Simple_column_search
+- --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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: simple_column_search
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Quick and dirty multi column LIKE searches.
+test_files: []
+