mongoid-fts 0.0.1

data/README.md

@@ -0,0 +1,53 @@
+NAME
+  mongoid-fts.rb
+
+DESCRIPTION
+  enable mongodb's new fulltext simply and quickly on your mongoid models, including pagination.
+
+SYNOPSIS
+
+````ruby
+
+  class A
+    include Mongoid::Document
+    include Mongoid::FTS
+
+    field(:title)
+    field(:body)
+
+    def to_search
+      {:title => title, :fulltext => body}
+    end
+  end
+
+
+  class B
+    include Mongoid::Document
+    include Mongoid::FTS
+
+    field(:title)
+    field(:body)
+
+    def to_search
+      {:title => title, :fulltext => body}
+    end
+  end
+
+
+  A.create!(:title => 'foo', :body => 'cats')
+  A.create!(:title => 'bar', :body => 'dogs')
+
+  B.create!(:title => 'foo', :body => 'cats')
+  B.create!(:title => 'bar', :body => 'dogs')
+
+  p FTS.search('cat', :models => [A, B])
+  p FTS.search('dog', :models => [A, B])
+
+  p A.search('cat')
+  p B.search('cat')
+  p A.search('dog')
+  p B.search('dog')
+
+  p A.search('cat dog').page(1).per(1)
+
+````

data/Rakefile

@@ -0,0 +1,446 @@
+This.name =
+  "Mongoid::FTS"
+
+This.synopsis =
+  "enable mongodb's new fulltext simply and quickly on your mongoid models, including pagination."
+
+This.rubyforge_project = 'codeforpeople'
+This.author            = "Ara T. Howard"
+This.email             = "ara.t.howard@gmail.com"
+This.homepage          = "https://github.com/ahoward/#{ This.lib }"
+
+This.setup!
+
+
+
+task :default do
+  puts((Rake::Task.tasks.map{|task| task.name.gsub(/::/,':')} - ['default']).sort)
+end
+
+task :test do
+  This.run_tests!
+end
+
+namespace :test do
+  task(:unit){ This.run_tests!(:unit) }
+  task(:functional){ This.run_tests!(:functional) }
+  task(:integration){ This.run_tests!(:integration) }
+end
+
+def This.run_tests!(which = nil)
+  which ||= '**'
+  test_dir = File.join(This.dir, "test")
+  test_glob ||= File.join(test_dir, "#{ which }/**_test.rb")
+  test_rbs = Dir.glob(test_glob).sort
+        
+  div = ('=' * 119)
+  line = ('-' * 119)
+
+  test_rbs.each_with_index do |test_rb, index|
+    testno = index + 1
+    command = "#{ File.basename(This.ruby) } -I ./lib -I ./test/lib #{ test_rb }"
+
+    puts
+    This.say(div, :color => :cyan, :bold => true)
+    This.say("@#{ testno } => ", :bold => true, :method => :print)
+    This.say(command, :color => :cyan, :bold => true)
+    This.say(line, :color => :cyan, :bold => true)
+
+    system(command)
+
+    This.say(line, :color => :cyan, :bold => true)
+
+    status = $?.exitstatus
+
+    if status.zero? 
+      This.say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      This.say("SUCCESS", :color => :green, :bold => true)
+    else
+      This.say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      This.say("FAILURE", :color => :red, :bold => true)
+    end
+    This.say(line, :color => :cyan, :bold => true)
+
+    exit(status) unless status.zero?
+  end
+end
+
+
+task :gemspec do
+  ignore_extensions = ['git', 'svn', 'tmp', /sw./, 'bak', 'gem']
+  ignore_directories = ['pkg', 'db']
+  ignore_files = ['test/log', 'test/db.yml', 'a.rb', 'b.rb'] + Dir['db/*'] + %w'db'
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+
+  lib         = This.lib
+  object      = This.object
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  #has_rdoc    = true #File.exist?('doc')
+  test_files  = test(?e, "test/#{ lib }.rb") ? "test/#{ lib }.rb" : nil
+  summary     = This.summary || This.synopsis || "#{ lib } kicks the ass"
+  description = This.description || summary
+
+  if This.extensions.nil?
+    This.extensions = []
+    extensions = This.extensions
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+# TODO
+  if This.dependencies.nil?
+    dependencies = []
+  else
+    case This.dependencies
+      when Hash
+        dependencies = This.dependencies.values
+      when Array
+        dependencies = This.dependencies
+    end
+  end
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      This.template_for{ IO.read('gemspec.erb') }
+    else
+      This.template_for {
+        <<-__
+          ## <%= lib %>.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = <%= lib.inspect %>
+            spec.version = <%= version.inspect %>
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = <%= lib.inspect %>
+            spec.description = <%= description.inspect %>
+
+            spec.files =\n<%= files.sort.pretty_inspect %>
+            spec.executables = <%= executables.inspect %>
+            
+            spec.require_path = "lib"
+
+            spec.test_files = <%= test_files.inspect %>
+
+            <% dependencies.each do |lib_version| %>
+              spec.add_dependency(*<%= Array(lib_version).flatten.inspect %>)
+            <% end %>
+
+            spec.extensions.push(*<%= extensions.inspect %>)
+
+            spec.rubyforge_project = <%= This.rubyforge_project.inspect %>
+            spec.author = <%= This.author.inspect %>
+            spec.email = <%= This.email.inspect %>
+            spec.homepage = <%= This.homepage.inspect %>
+          end
+        __
+      }
+    end
+
+  FileUtils.mkdir_p(This.pkgdir)
+  gemspec = "#{ lib }.gemspec"
+  open(gemspec, "w"){|fd| fd.puts(template)}
+  This.gemspec = gemspec
+end
+
+task :gem => [:clean, :gemspec] do
+  FileUtils.mkdir_p(This.pkgdir)
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  FileUtils.mv(gem, This.pkgdir)
+  This.gem = File.join(This.pkgdir, File.basename(gem))
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << This.util.indent(prompt + cmd, 2) << "\n\n"
+    samples << This.util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << This.util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -I ./lib #{ sample })'"
+    samples << This.util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      This.template_for{ IO.read('readme.erb') }
+    else
+      This.template_for {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| FileUtils.rm_rf(entry)}
+end
+
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+
+  cmd = "gem push #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+
+  #cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.gem }"
+  #puts cmd
+  #puts
+  #system(cmd)
+  #abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+end
+
+
+
+
+
+BEGIN {
+# support for this rakefile
+#
+  $VERBOSE = nil
+
+  require 'erb'
+  require 'fileutils'
+  require 'rbconfig'
+  require 'pp'
+
+# cache a bunch of stuff about this rakefile/environment
+#
+
+  This =
+    Class.new(Hash) do
+
+      def method_missing(method, *args, &block)
+        if method.to_s =~ /=/
+          key = method.to_s.chomp('=')
+          value = block ? block : args.shift
+          self[key] = value
+        else
+          key = method.to_s
+          if block
+            value = block
+            self[key] = value
+          else
+            value = self[key]
+
+            if value.respond_to?(:call)
+              self[key] = value.call()
+            else
+              value
+            end
+          end
+        end
+      end
+
+      def inspect
+        expand!
+        PP.pp(self, '')
+      end
+
+      def expand!
+        keys.each do |key|
+          value = self[key]
+          if value.respond_to?(:call)
+            self[key] = value.call()
+          end
+        end
+      end
+
+    end.new()
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+# defaults 
+#
+  This.lib do
+    File.basename(Dir.pwd)
+  end
+
+  def This.setup!
+    begin
+      require "./lib/#{ This.lib }"
+    rescue LoadError
+      abort("could not load #{ This.lib }")
+    end
+  end
+
+  This.name do
+    This.name = This.lib.capitalize
+  end
+
+  This.object do
+    begin
+      This.object = eval(This.name)
+    rescue Object
+      abort("could not determine object from #{ This.name }")
+    end
+  end
+
+  This.version do
+    This.object.send(:version)
+  end
+
+  This.dependencies do
+    if This.object.respond_to?(:dependencies)
+      This.object.dependencies
+    end
+  end
+
+  This.ruby do
+    c = Config::CONFIG
+    bindir = c["bindir"] || c['BINDIR']
+    ruby_install_name = c['ruby_install_name'] || c['RUBY_INSTALL_NAME'] || 'ruby'
+    ruby_ext = c['EXEEXT'] || ''
+    File.join(bindir, (ruby_install_name + ruby_ext))
+  end
+
+# some utils
+#
+  This.util = Module.new do
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each_line do |line|
+        next if line =~ %r/^\s*$/
+        indent = line[%r/^\s*/] and break
+      end
+      indent ? s.gsub(%r/^#{ indent }/, "") : s
+    end
+
+    extend self
+  end
+
+# template support
+#
+  This.template = Class.new do
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+
+    def expand(b=nil)
+      ERB.new(This.util.unindent(@template)).result((b||@block).binding)
+    end
+
+    alias_method 'to_s', 'expand'
+  end
+
+  def This.template_for(*args, &block)
+    This.template.new(*args, &block)
+  end
+
+# colored console output support
+#
+  This.ansi = {
+    :clear      => "\e[0m",
+    :reset      => "\e[0m",
+    :erase_line => "\e[K",
+    :erase_char => "\e[P",
+    :bold       => "\e[1m",
+    :dark       => "\e[2m",
+    :underline  => "\e[4m",
+    :underscore => "\e[4m",
+    :blink      => "\e[5m",
+    :reverse    => "\e[7m",
+    :concealed  => "\e[8m",
+    :black      => "\e[30m",
+    :red        => "\e[31m",
+    :green      => "\e[32m",
+    :yellow     => "\e[33m",
+    :blue       => "\e[34m",
+    :magenta    => "\e[35m",
+    :cyan       => "\e[36m",
+    :white      => "\e[37m",
+    :on_black   => "\e[40m",
+    :on_red     => "\e[41m",
+    :on_green   => "\e[42m",
+    :on_yellow  => "\e[43m",
+    :on_blue    => "\e[44m",
+    :on_magenta => "\e[45m",
+    :on_cyan    => "\e[46m",
+    :on_white   => "\e[47m"
+  }
+
+  def This.say(something, *args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options[:color] = args.shift.to_s.to_sym unless args.empty?
+    keys = options.keys
+    keys.each{|key| options[key.to_s.to_sym] = options.delete(key)}
+
+    color = options[:color]
+    bold = options.has_key?(:bold)
+
+    parts = [something]
+    parts.unshift(This.ansi[color]) if color
+    parts.unshift(This.ansi[:bold]) if bold
+    parts.push(This.ansi[:clear]) if parts.size > 1
+
+    method = options[:method] || :puts
+
+    Kernel.send(method, parts.join)
+  end
+
+# always run out of the project dir
+#
+  Dir.chdir(This.dir)
+}

data/lib/app/mongoid/fts/index.rb

@@ -0,0 +1 @@
+Mongoid::FTS::Index

data/lib/mongoid-fts.rb

@@ -0,0 +1,552 @@
+module Mongoid
+  module FTS
+  #
+    const_set(:Version, '0.0.1') unless const_defined?(:Version)
+
+    class << FTS
+      def version
+        const_get :Version
+      end
+
+      def dependencies
+        {
+          'mongoid'       => [ 'mongoid'       , '~> 3.1' ] ,
+          'map'           => [ 'map'           , '~> 6.5' ] ,
+          'coerce'        => [ 'coerce'        , '~> 0.0' ] ,
+        }
+      end
+
+      def libdir(*args, &block)
+        @libdir ||= File.expand_path(__FILE__).sub(/\.rb$/,'')
+        args.empty? ? @libdir : File.join(@libdir, *args)
+      ensure
+        if block
+          begin
+            $LOAD_PATH.unshift(@libdir)
+            block.call()
+          ensure
+            $LOAD_PATH.shift()
+          end
+        end
+      end
+
+      def load(*libs)
+        libs = libs.join(' ').scan(/[^\s+]+/)
+        libdir{ libs.each{|lib| Kernel.load(lib) } }
+      end
+    end
+
+    begin
+      require 'rubygems'
+    rescue LoadError
+      nil
+    end
+
+    if defined?(gem)
+      dependencies.each do |lib, dependency|
+        gem(*dependency)
+        require(lib)
+      end
+    end
+
+    begin
+      require 'pry'
+    rescue LoadError
+      nil
+    end
+
+
+  #
+    def FTS.search(*args)
+      options = args.extract_options!.to_options!
+
+      args.push(options)
+
+      _searches = FTS._search(*args)
+
+      Results.new(_searches)
+    end
+
+    def FTS._search(*args)
+      options = args.extract_options!.to_options!
+
+      search = args.join(' ')
+
+      text   = options.delete(:text) || Index.default_collection_name.to_s
+      limit  = [Integer(options.delete(:limit) || 128), 1].max
+      models = [options.delete(:models), options.delete(:model)].flatten.compact
+
+      models = FTS.models if models.blank?
+
+      _searches =
+        models.map do |model|
+          context_type = model.name.to_s
+          
+          cmd = Hash.new
+
+          cmd[:text] ||= text
+
+          cmd[:limit] ||= limit
+
+          (cmd[:search] ||= '') << search
+
+          cmd[:project] ||= {'_id' => 1, 'context_type' => 1, 'context_id' => 1}
+
+          cmd[:filter] ||= {'context_type' => context_type}
+
+          options.each do |key, value|
+            cmd[key] = value
+          end
+
+          Map.for(session.command(cmd)).tap do |_search|
+            _search[:_model] = model
+            _search[:_cmd] = cmd
+          end
+        end
+
+      Raw.new(_searches, :_search => search, :_text => text, :_limit => limit, :_models => models)
+    end
+
+  #
+    class Raw < ::Array
+      attr_accessor :_search
+      attr_accessor :_text
+      attr_accessor :_limit
+      attr_accessor :_models
+
+      def initialize(_searches, options = {})
+        replace(_searches)
+      ensure
+        options.each{|k, v| send("#{ k }=", v)}
+      end
+    end
+
+  #
+    class Results < ::Array
+      attr_accessor :_searches
+      attr_accessor :_models
+
+      def initialize(_searches)
+        @_searches = _searches
+        @_models = []
+        _denormalize!
+        @page = 1
+        @per = size
+      end
+
+      def paginate(*args)
+        options = args.extract_options!.to_options!
+
+        page = Integer(args.shift || options[:page] || @page)
+        per = Integer(args.shift || options[:per] || options[:size] || @per)
+
+        @page = [page.abs, 1].max
+        @per = [per.abs, 1].max
+
+        offset = (@page - 1) * @per
+        length = @per 
+
+        slice = Array(@_models[offset, length])
+
+        replace(slice)
+
+        self
+      end
+
+      def page(*args)
+        if args.empty?
+          return @page
+        else
+          options = args.extract_options!.to_options!
+          page = args.shift || options[:page]
+          options[:page] = page
+          paginate(options)
+        end
+      end
+
+      def per(*args)
+        if args.empty?
+          return @per
+        else
+          options = args.extract_options!.to_options!
+          per = args.shift || options[:per]
+          options[:per] = per
+          paginate(options)
+        end
+      end
+
+      def num_pages
+        (size.to_f / per).ceil
+      end
+
+      def total_pages
+        num_pages
+      end
+
+  # TODO - text sorting more...
+  #
+      def _denormalize!
+      #
+        collection = self
+
+        collection.clear
+        @_models = []
+
+        return self if @_searches.empty?
+
+      #
+        _models = @_searches._models
+
+        _position = proc do |model|
+          _models.index(model) or raise("no position for #{ model.inspect }!?")
+        end
+
+        results =
+          @_searches.map do |_search|
+            _search['results'] ||= []
+
+            _search['results'].each do |result|
+              result['_model'] = _search._model
+              result['_position'] = _position[_search._model]
+            end
+
+            _search['results']
+          end
+
+        results.flatten!
+        results.compact!
+
+        results.sort! do |a, b|
+          score = Float(b['score']) <=> Float(a['score'])
+
+          case score
+            when 0
+              a['_position'] <=> b['_position']
+            else
+              score
+          end
+        end
+
+      #
+        batches = Hash.new{|h,k| h[k] = []}
+
+        results.each do |entry|
+          obj = entry['obj']
+
+          context_type, context_id = obj['context_type'], obj['context_id']
+
+          batches[context_type].push(context_id)
+        end
+
+      #
+        models = FTS.find_in_batches(batches)
+
+      #
+        limit = @_searches._limit
+
+      #
+        replace(@_models = models[0 ... limit])
+
+        self
+      end
+    end
+
+  #
+    class Index
+      include Mongoid::Document
+
+      belongs_to(:context, :polymorphic => true)
+
+      field(:title, :type => String)
+      field(:keywords, :type => Array)
+      field(:fulltext, :type => String)
+
+      index(
+        {:context_type => 1, :title => 'text', :keywords => 'text', :fulltext => 'text'},
+        {:weights => { :title => 100, :keywords => 50, :fulltext => 1 }, :name => 'search_index'}
+      )
+
+      index(
+        {:context_type => 1, :context_id => 1},
+        {:unique => true, :sparse => true}
+      )
+
+      before_validation do |index|
+        index.normalize
+      end
+
+      before_upsert do |index|
+        index.normalize
+      end
+
+      validates_presence_of(:context_type)
+
+      def normalize
+        if !defined?(@normalized) or !@normalized
+          normalize!
+        end
+      end
+
+      def normalize!
+        index = self
+
+        unless index.keywords.blank?
+          index.keywords = FTS.list_of_strings(index.keywords)
+        end
+
+        unless index.title.blank?
+          index.title = index.title.to_s.strip
+        end
+
+        unless index.keywords.blank?
+          index.keywords = index.keywords.map{|keyword| keyword.strip}
+        end
+
+        unless index.fulltext.blank?
+          index.fulltext = index.fulltext.to_s.strip
+        end
+
+      ensure
+        @normalized = true
+      end
+
+      def Index.teardown!
+        Index.remove_indexes
+        Index.destroy_all
+      end
+
+      def Index.setup!
+        Index.create_indexes
+      end
+
+      def Index.reset!
+        teardown!
+        setup!
+      end
+
+      def Index.rebuild!
+        batches = Hash.new{|h,k| h[k] = []}
+
+        each do |index|
+          context_type, context_id = index.context_type, index.context_id
+          next unless context_type && context_id
+          (batches[context_type] ||= []).push(context_id)
+        end
+
+        models = FTS.find_in_batches(batches)
+
+        reset!
+
+        models.each{|model| add(model)}
+      end
+
+      def Index.add(model)
+        to_search = Index.to_search(model)
+
+        title    = to_search.has_key?(:title) ?  Coerce.string(to_search[:title]) : nil
+        keywords = to_search.has_key?(:keywords) ?  Coerce.list_of_strings(to_search[:keywords]) : nil
+        fulltext = to_search.has_key?(:fulltext) ?  Coerce.string(to_search[:fulltext]) : nil
+
+        context_type = model.class.name.to_s
+        context_id   = model.id
+
+        conditions = {
+          :context_type => context_type,
+          :context_id   => context_id
+        }
+
+        attributes = {
+          :title        => title,
+          :keywords     => keywords,
+          :fulltext     => fulltext
+        }
+
+        new(conditions).upsert
+
+        where(conditions).first.tap do |index|
+          if index
+            index.update_attributes(attributes)
+          end
+        end
+      end
+
+      def Index.remove(model)
+        context_type = model.class.name.to_s
+        context_id = model.id
+
+        conditions = {
+          :context_type => context_type,
+          :context_id   => context_id
+        }
+
+        where(conditions).first.tap do |index|
+          if index
+            index.destroy rescue nil
+          end
+        end
+      end
+
+      def Index.to_search(model)
+        to_search = nil
+
+        if model.respond_to?(:to_search)
+          to_search = Map.for(model.to_search)
+        else
+          to_search = Map.new
+
+          to_search[:title] =
+            %w( title ).map do |attr|
+              model.send(attr) if model.respond_to?(attr)
+            end.compact.join(' ')
+
+          to_search[:keywords] =
+            %w( keywords tags ).map do |attr|
+              model.send(attr) if model.respond_to?(attr)
+            end.compact
+
+          to_search[:fulltext] =
+            %w( fulltext text content body description ).map do |attr|
+              model.send(attr) if model.respond_to?(attr)
+            end.compact.join(' ')
+        end
+
+        unless %w( title keywords fulltext ).detect{|key| to_search.has_key?(key)}
+          raise ArgumentError, "you need to define #{ model }#to_search"
+        end
+
+        to_search
+      end
+    end
+
+    def FTS.index
+      Index
+    end
+
+  #
+    module Mixin
+      def Mixin.code
+        @code ||= proc do
+          class << self
+            def search(*args, &block)
+              args.push(options = args.extract_options!.to_options!)
+
+              options[:model] = self
+
+              FTS.search(*args, &block)
+            end
+
+            def _search(*args, &block)
+              args.push(options = args.extract_options!.to_options!)
+
+              options[:model] = self
+
+              FTS.search(*args, &block)
+            end
+          end
+
+          after_save do |model|
+            FTS::Index.add(model) rescue nil
+          end
+
+          after_destroy do |model|
+            FTS::Index.remove(model) rescue nil
+          end
+        end
+      end
+
+      def Mixin.included(other)
+        unless other.is_a?(Mixin)
+          begin
+            super
+          ensure
+            other.module_eval(&Mixin.code)
+            FTS.models.push(other)
+            FTS.models.uniq!
+          end
+        end
+      end
+    end
+
+    def FTS.included(other)
+      unless other.is_a?(FTS::Mixin)
+        other.send(:include, FTS::Mixin)
+      end
+    end
+
+  #
+    def FTS.models
+      @models ||= []
+    end
+
+    def FTS.list_of_strings(*args)
+      args.flatten.compact.map{|arg| arg.to_s}.select{|arg| !arg.empty?}.uniq
+    end
+
+    def FTS.session
+      @session ||= Mongoid::Sessions.default
+    end
+
+    def FTS.session=(session)
+      @session = session
+    end
+
+    def FTS.find_in_batches(queries = {})
+      models =
+        queries.map do |model_class, model_ids|
+          unless model_class.is_a?(Class)
+            model_class = eval(model_class.to_s)
+          end
+
+          model_ids = Array(model_ids)
+
+          begin
+            model_class.find(model_ids)
+          rescue Mongoid::Errors::DocumentNotFound
+            model_ids.map do |model_id|
+              begin
+                model_class.find(model_id)
+              rescue Mongoid::Errors::DocumentNotFound
+                nil
+              end
+            end
+          end
+        end
+
+      models.flatten!
+      models.compact!
+      models
+    end
+
+    def FTS.enable!
+      session = Mongoid::Sessions.default
+      session.with(database: :admin).command({ setParameter: 1, textFTSEnabled: true })
+    end
+
+    begin
+      FTS.enable!
+    rescue Object => e
+      warn "failed to enable search with #{ e.class }(#{ e.message })"
+    end
+  end
+
+  Fts = FTS
+
+  if defined?(Rails)
+    class FTS::Engine < ::Rails::Engine
+      paths['app/models'] = ::File.dirname(__FILE__)
+    end
+  end
+end
+
+
+=begin
+
+  Model.mongo_session.command(text: "collection_name", search: "my search string", filter: { ... }, project: { ... }, limit: 10, language: "english")
+
+  http://blog.serverdensity.com/full-text-search-in-mongodb/
+
+  http://blog.mongohq.com/mongodb-and-full-text-search-my-first-week-with-mongodb-2-4-development-release/
+
+  http://docs.mongodb.org/manual/single/index.html#document-tutorial/enable-text-search
+
+=end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: mongoid-fts
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Ara T. Howard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mongoid
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: map
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '6.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '6.5'
+- !ruby/object:Gem::Dependency
+  name: coerce
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.0'
+description: enable mongodb's new fulltext simply and quickly on your mongoid models,
+  including pagination.
+email: ara.t.howard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/app/mongoid/fts/index.rb
+- lib/mongoid-fts.rb
+homepage: https://github.com/ahoward/mongoid-fts
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: codeforpeople
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: mongoid-fts
+test_files: []