search_for 0.0.1

data/README.rdoc

@@ -0,0 +1,37 @@
+=Introduction
+
+A simple gem for adding a chainable search method to ActiveRecord::Base (rails 3) 
+
+=Installation
+
+To install, add this to your bundler Gemfile 
+
+  gem 'search_for'
+
+Next, go to the root of your project in a shell and run this command (you may need to use "sudo" depending on your environment): 
+
+  λ bundle install 
+  
+=Usage
+
+Suppose you'd like to create a simple quicksearch form for searching your Book database. 
+We'll assume your books have the following attributes: "title, author, description, genre"
+
+If someone searches for "romance", we'd like to it to return any books where the title, author, description, or genre matches "romance"
+
+If someone searches for "space odyssey", we want it to narrow results: now a column attribute matches only if that attributes contains both "Space" and "Odyssey".
+
+How does it work? Assuming our form posts a 'query' param, then we could do something like this in our controller:
+
+  Book.search_for params[:query], :on => [:title, :author, :description, :genre] 
+
+The sql generated would look something like this (assuming params[:query] = "space odyseey"):
+
+  Book.search_for(params[:query], :on => [:title, :author, :description, :genre]).to_sql
+  # ==> 
+  #    SELECT * FROM "books" WHERE (
+  #         (title LIKE '%space%' AND title LIKE '%odyssey%')
+  #      OR (author LIKE '%space%' AND author LIKE '%odyssey%')
+  #      OR (description LIKE '%space%' AND description LIKE '%odyssey%')
+  #      OR (genre LIKE '%space%' AND genre LIKE '%odyssey%')
+  #    )

data/lib/search_for.rb

@@ -0,0 +1,3 @@
+require 'active_record'
+require 'search_for/search_for'
+require 'search_for/activerecord'

data/lib/search_for/activerecord.rb

@@ -0,0 +1,3 @@
+class ActiveRecord::Base
+  extend SearchFor
+end

data/lib/search_for/search_for.rb

@@ -0,0 +1,10 @@
+module SearchFor
+  def search_for(query, on_fields)
+    raise ArgumentError, "You must provide an :on => [..fields..] argument to #search_for." unless on_fields[:on] 
+    on_fields   = on_fields[:on].kind_of?(Array) ? on_fields[:on] : [on_fields[:on]]
+    query_terms = query.split(/\s+/)
+    fields      = on_fields.map {|f| "(" + (["#{f} LIKE ?"] * query_terms.size).join(" AND ") + ")"}.join(" OR ")
+    query_terms = (query_terms.map {|qt| "%#{qt}%"}) * on_fields.size
+    where(*([fields] + query_terms))
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: search_for
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Parker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-21 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 299253627
+        segments: 
+        - 3
+        - 0
+        - 0
+        - beta3
+        version: 3.0.0.beta3
+  type: :runtime
+  version_requirements: *id001
+description: This gem will add a chainable "search_for" method to your ActiveResource classes, allowingallowing you to pass in a search query and fields to search on.
+email: moonmaster9000@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- lib/search_for.rb
+- lib/search_for/activerecord.rb
+- lib/search_for/search_for.rb
+has_rdoc: true
+homepage: http://github.com/moonmaster9000/search_for
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A simple search generator for ActiveRecord in Rails 3
+test_files: []
+