shanna-dm-sphinx-adapter 0.4

data/History.txt

@@ -0,0 +1,17 @@
+=== 0.4 / 2008-11-21
+
+  * Fixed broken dm-is-searchable support.
+  * Bumped version because the read_one/read_many result structure had to change to support dm-is-searchable.
+
+=== 0.3 / 2008-11-18
+
+  * Removed calls to indexer on create/update. See README.txt
+  * Made the client object available from the adapter.
+
+=== 0.2 / 2008-11-09
+
+  * Addributes.
+  * Self managed searchd daemon if you want it.
+
+=== 0.1 / 2008-10-24
+

data/LICENCE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Shane Hanna
+
+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/Manifest.txt

@@ -0,0 +1,31 @@
+History.txt
+LICENCE.txt
+Manifest.txt
+README.txt
+Rakefile
+dm-sphinx-adapter.gemspec
+lib/dm-sphinx-adapter.rb
+lib/dm-sphinx-adapter/adapter.rb
+lib/dm-sphinx-adapter/attribute.rb
+lib/dm-sphinx-adapter/client.rb
+lib/dm-sphinx-adapter/config.rb
+lib/dm-sphinx-adapter/config_parser.rb
+lib/dm-sphinx-adapter/index.rb
+lib/dm-sphinx-adapter/resource.rb
+test/files/dm_sphinx_adapter_test.sql
+test/files/resource_explicit.rb
+test/files/resource_resource.rb
+test/files/resource_searchable.rb
+test/files/resource_storage_name.rb
+test/files/resource_vanilla.rb
+test/files/sphinx.conf
+test/test_adapter.rb
+test/test_adapter_explicit.rb
+test/test_adapter_resource.rb
+test/test_adapter_searchable.rb
+test/test_adapter_vanilla.rb
+test/test_client.rb
+test/test_config.rb
+test/test_config_parser.rb
+test/test_type_attribute.rb
+test/test_type_index.rb

data/README.txt

@@ -0,0 +1,195 @@
+= DataMapper Sphinx Adapter
+
+* http://rubyforge.org/projects/dm-sphinx/
+* http://github.com/shanna/dm-sphinx-adapter/tree/master
+
+== Description
+
+A DataMapper Sphinx adapter.
+
+== Dependencies
+
+* dm-core           ~> 0.9.7
+* riddle            ~> 0.9
+* daemon_controller ~> 0.2   (optional)
+* dm-is-searchable  ~> 0.9.7 (optional)
+
+I'd recommend using the dm-more plugin dm-is-searchable instead of fetching the document id's yourself.
+
+== Install
+
+* Via git: git clone git://github.com/shanna/iso-country-codes.git
+* Via gem: gem install shanna-dm-sphinx-adapter -s http://gems.github.com
+
+== Synopsis
+
+DataMapper uses URIs or a connection has to connect to your data-stores. In this case the sphinx search daemon
+<tt>searchd</tt>.
+
+On its own this adapter will only return an array of document hashes when queried. The DataMapper library dm-more
+however provides dm-is-searchable, a common interface to search one adapter and load documents from another. My
+preference is to use this adapter in tandem with dm-is-searchable.
+
+Like all DataMapper adapters you can connect with a Hash or URI.
+
+A URI:
+  DataMapper.setup(:search, 'sphinx://localhost')
+
+The breakdown is:
+  "#{adapter}://#{host}:#{port}/#{config}"
+  - adapter Must be :sphinx
+  - host    Hostname (default: localhost)
+  - port    Optional port number (default: 3312)
+  - config  Optional but strongly recommended path to sphinx config file.
+
+Alternatively supply a Hash:
+  DataMapper.setup(:search, {
+    :adapter  => 'sphinx',       # required
+    :config   => './sphinx.conf' # optional. Recommended though.
+    :host     => 'localhost',    # optional. Default: localhost
+    :port     => 3312            # optional. Default: 3312
+    :managed  => true            # optional. Self managed searchd server using daemon_controller.
+  }
+
+=== DataMapper
+
+  require 'rubygems'
+  require 'dm-sphinx-adapter'
+
+  DataMapper.setup(:default, 'sqlite3::memory:')
+  DataMapper.setup(:search, 'sphinx://localhost:3312')
+
+  class Item
+    include DataMapper::Resource
+    property :id, Serial
+    property :name, String
+  end
+
+  # Fire up your sphinx search daemon and start searching.
+  docs  = repository(:search){ Item.all(:name => 'barney') } # Search 'items' index for '@name barney'
+  ids   = docs.map{|doc| doc[:id]}
+  items = Item.all(:id => ids) # Search :default for all the document id's returned by sphinx.
+
+=== DataMapper and Is Searchable
+
+  require 'rubygems'
+  require 'dm-core'
+  require 'dm-is-searchable'
+  require 'dm-sphinx-adapter'
+
+  # Connections.
+  DataMapper.setup(:default, 'sqlite3::memory:')
+  DataMapper.setup(:search, 'sphinx://localhost:3312')
+
+  class Item
+    include DataMapper::Resource
+    property :id, Serial
+    property :name, String
+
+    is :searchable # defaults to :search repository though you can be explicit:
+    # is :searchable, :repository => :sphinx
+  end
+
+  # Fire up your sphinx search daemon and start searching.
+  items = Item.search(:name => 'barney') # Search 'items' index for '@name barney'
+
+=== Merb, DataMapper and Is Searchable
+
+  # config/init.rb
+  dependency 'dm-is-searchable'
+  dependency 'dm-sphinx-adapter'
+
+  # config/database.yml
+  ---
+  development: &defaults
+    repositories:
+      search:
+        adapter:  sphinx
+        host:     localhost
+        port:     3312
+
+  # app/models/item.rb
+  class Item
+    include DataMapper::Resource
+    property :id, Serial
+    property :name, String
+
+    is :searchable # defaults to :search repository though you can be explicit:
+    # is :searchable, :repository => :sphinx
+  end # Item
+
+  # Fire up your sphinx search daemon and start searching.
+  Item.search(:name => 'barney') # Search 'items' index for '@name barney'
+
+=== DataMapper::SphinxResource
+
+For finer grained control you can include DataMapper::SphinxResource. For instance you can search one or more indexes
+and sort, include or exclude by attributes defined in your sphinx configuration:
+
+  class Item
+    include DataMapper::Resource # Optional, included by SphinxResource if you leave it out yourself.
+    include DataMapper::SphinxResource
+    property :id, Serial
+    property :name, String
+
+    is :searchable
+    repository(:search) do
+      index :items
+      index :items_delta, :delta => true
+
+      # Sphinx attributes to sort include/exclude by.
+      attribute :updated_on, DateTime
+    end
+
+  end # Item
+
+  # Search 'items, items_delta' index for '@name barney' updated in the last 30 minutes.
+  Item.search(:name => 'barney', :updated => (Time.now - 1800 .. Time.now))
+
+== Sphinx Configuration
+
+Though you don't have to supply the sphinx configuration file to dm-sphinx-adapter I'd recommend doing it anyway.
+It's more DRY since all searchd/indexer options can be read straight from the configuration.
+
+  DataMapper.setup(:search, :adapter => 'sphinx', :config => '/path/to/sphinx.conf')
+  DataMapper.setup(:search, 'sphinx://localhost/path/to/sphinx.conf')
+
+If your sphinx.conf lives in either of the default locations /usr/local/etc/sphinx.conf or ./sphinx.conf then you
+only need to supply:
+
+  DataMapper.setup(:search, :adapter => 'sphinx')
+
+== Searchd
+
+As of 0.2 I've added a managed searchd option using daemon_controller. It may come in handy if you only use God, Monit
+or whatever in production. Use the Hash form of DataMapper#setup and supply the option :managed with a true value and
+daemon_controller will start searchd on demand.
+
+It is already strongly encouraged but you will need to specify the path to your sphinx configuration file in order for
+searchd to run. See Sphinx Configuration, DataMapper::Adapters::Sphinx::ManagedClient.
+
+The daemon_controller library can be found only on github, not rubyforge.
+See http://github.com/FooBarWidget/daemon_controller/tree/master
+
+== Indexer and Live(ish) updates.
+
+As of 0.3 the indexer will no longer be fired on create/update even if you have delta indexes defined. Sphinx indexing
+is blazing fast but unless your resource sees very little activity you will run the risk of lock errors on
+the temporary delta index files (.tmpl.sp1) and your delta index won't be updated. Given this functionality is
+unreliable at best I've chosen to remove it.
+
+For reliable live(ish) updates in a main + delta scheme it's probably best you schedule them outside of your ORM.
+Andrew (Shodan) Aksyonoff of Sphinx suggests a cronjob or alternatively if you need even less lag to "run indexer in
+an endless loop, with a few seconds of sleep in between to allow searchd some headroom to pick up the changes".
+
+== Todo
+
+* Loads of documentation. Most of it is unchecked YARD at the moment.
+* Add DataMapper::Adapters::Sphinx::Client#attribute_set to allow attribute modification on one or more indexes. It's
+  the only thing missing if you understand the pitfalls and still want to add thinking-sphinx like delta indexing to
+  your resource.
+
+== Contributing
+
+Go nuts. Just send me a pull request (github or otherwise) when you are happy with your code.
+

data/Rakefile

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.new('dm-sphinx-adapter', '0.4') do |p|
+  p.developer('Shane Hanna', 'shane.hanna@gmail.com')
+  p.extra_deps = [
+    ['dm-core', '~> 0.9.7'],
+    ['riddle',  '~> 0.9']
+  ]
+end
+
+# http://blog.behindlogic.com/2008/10/auto-generate-your-manifest-and-gemspec.html
+desc 'Rebuild manifest and gemspec.'
+task :cultivate do
+  Dir.chdir(File.dirname(__FILE__)) do #TODO: Is this required?
+    system %q{git ls-files | grep -v "\.gitignore" > Manifest.txt}
+    system %q{rake debug_gem | grep -v "(in " > `basename \`pwd\``.gemspec}
+  end
+end
+
+# vim: syntax=Ruby

data/dm-sphinx-adapter.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{dm-sphinx-adapter}
+  s.version = "0.4"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Shane Hanna"]
+  s.date = %q{2008-11-24}
+  s.description = %q{A DataMapper Sphinx adapter.}
+  s.email = ["shane.hanna@gmail.com"]
+  s.extra_rdoc_files = ["History.txt", "LICENCE.txt", "Manifest.txt", "README.txt"]
+  s.files = ["History.txt", "LICENCE.txt", "Manifest.txt", "README.txt", "Rakefile", "dm-sphinx-adapter.gemspec", "lib/dm-sphinx-adapter.rb", "lib/dm-sphinx-adapter/adapter.rb", "lib/dm-sphinx-adapter/attribute.rb", "lib/dm-sphinx-adapter/client.rb", "lib/dm-sphinx-adapter/config.rb", "lib/dm-sphinx-adapter/config_parser.rb", "lib/dm-sphinx-adapter/index.rb", "lib/dm-sphinx-adapter/resource.rb", "test/files/dm_sphinx_adapter_test.sql", "test/files/resource_explicit.rb", "test/files/resource_resource.rb", "test/files/resource_searchable.rb", "test/files/resource_storage_name.rb", "test/files/resource_vanilla.rb", "test/files/sphinx.conf", "test/test_adapter.rb", "test/test_adapter_explicit.rb", "test/test_adapter_resource.rb", "test/test_adapter_searchable.rb", "test/test_adapter_vanilla.rb", "test/test_client.rb", "test/test_config.rb", "test/test_config_parser.rb", "test/test_type_attribute.rb", "test/test_type_index.rb"]
+  s.has_rdoc = true
+  s.homepage = %q{http://rubyforge.org/projects/dm-sphinx/}
+  s.rdoc_options = ["--main", "README.txt"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{dm-sphinx-adapter}
+  s.rubygems_version = %q{1.3.0}
+  s.summary = %q{A DataMapper Sphinx adapter.}
+  s.test_files = ["test/test_adapter.rb", "test/test_adapter_explicit.rb", "test/test_adapter_resource.rb", "test/test_adapter_searchable.rb", "test/test_adapter_vanilla.rb", "test/test_client.rb", "test/test_config.rb", "test/test_config_parser.rb", "test/test_type_attribute.rb", "test/test_type_index.rb"]
+
+  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<dm-core>, ["~> 0.9.7"])
+      s.add_runtime_dependency(%q<riddle>, ["~> 0.9"])
+      s.add_development_dependency(%q<hoe>, [">= 1.8.2"])
+    else
+      s.add_dependency(%q<dm-core>, ["~> 0.9.7"])
+      s.add_dependency(%q<riddle>, ["~> 0.9"])
+      s.add_dependency(%q<hoe>, [">= 1.8.2"])
+    end
+  else
+    s.add_dependency(%q<dm-core>, ["~> 0.9.7"])
+    s.add_dependency(%q<riddle>, ["~> 0.9"])
+    s.add_dependency(%q<hoe>, [">= 1.8.2"])
+  end
+end

data/lib/dm-sphinx-adapter/adapter.rb

@@ -0,0 +1,218 @@
+require 'benchmark'
+
+# TODO: I think perhaps I should move all the query building code to a lib of its own.
+
+module DataMapper
+  module Adapters
+    module Sphinx
+      # == Synopsis
+      #
+      # DataMapper uses URIs or a connection has to connect to your data-stores. In this case the sphinx search daemon
+      # <tt>searchd</tt>.
+      #
+      # On its own this adapter will only return an array of document hashes when queried. The DataMapper library dm-more
+      # however provides dm-is-searchable, a common interface to search one adapter and load documents from another. My
+      # preference is to use this adapter in tandem with dm-is-searchable.
+      #
+      # Like all DataMapper adapters you can connect with a Hash or URI.
+      #
+      # A URI:
+      #   DataMapper.setup(:search, 'sphinx://localhost')
+      #
+      # The breakdown is:
+      #   "#{adapter}://#{host}:#{port}/#{config}"
+      #   - adapter Must be :sphinx
+      #   - host    Hostname (default: localhost)
+      #   - port    Optional port number (default: 3312)
+      #   - config  Optional but recommended path to sphinx config file.
+      #
+      # Alternatively supply a Hash:
+      #   DataMapper.setup(:search, {
+      #     :adapter  => 'sphinx',       # required
+      #     :config   => './sphinx.conf' # optional. Recommended though.
+      #     :host     => 'localhost',    # optional. Default: localhost
+      #     :port     => 3312            # optional. Default: 3312
+      #     :managed  => true            # optional. Self managed searchd server using daemon_controller.
+      #   })
+      class Adapter < AbstractAdapter
+        ##
+        # Initialize the sphinx adapter.
+        #
+        # @param [URI, DataObject::URI, Addressable::URI, String, Hash, Pathname] uri_or_options
+        # @see   DataMapper::Adapters::Sphinx::Config
+        # @see   DataMapper::Adapters::Sphinx::Client
+        def initialize(name, uri_or_options)
+          super
+
+          managed = !!(uri_or_options.kind_of?(Hash) && uri_or_options[:managed])
+          @client  = managed ? ManagedClient.new(uri_or_options) : Client.new(uri_or_options)
+        end
+
+        ##
+        # Interaction with searchd and indexer.
+        #
+        # @see DataMapper::Adapters::Sphinx::Client
+        # @see DataMapper::Adapters::Sphinx::ManagedClient
+        attr_reader :client
+
+        def create(resources) #:nodoc:
+          true
+        end
+
+        def delete(query) #:nodoc:
+          true
+        end
+
+        def read_many(query)
+          read(query)
+        end
+
+        def read_one(query)
+          read(query).first
+        end
+
+        protected
+          ##
+          # List sphinx indexes to search.
+          # If no indexes are explicitly declared using DataMapper::Adapters::Sphinx::Resource then the default storage
+          # name is used.
+          #
+          # @see DataMapper::Adapters::Sphinx::Resource#sphinx_indexes
+          def indexes(model)
+            indexes = model.sphinx_indexes(repository(self.name).name) if model.respond_to?(:sphinx_indexes)
+            if indexes.nil? or indexes.empty?
+              indexes = [Index.new(model, model.storage_name)]
+            end
+            indexes
+          end
+
+          ##
+          # List sphinx delta indexes to search.
+          #
+          # @see DataMapper::Adapters::Sphinx::Resource#sphinx_indexes
+          def delta_indexes(model)
+            indexes(model).find_all{|i| i.delta?}
+          end
+
+          ##
+          # Query sphinx for a list of document IDs.
+          #
+          # @param [DataMapper::Query]
+          def read(query)
+            from    = indexes(query.model).map{|index| index.name}.join(', ')
+            search  = search_query(query)
+            options = {
+              :match_mode => :extended, # TODO: Modes!
+              :filters    => search_filters(query) # By attribute.
+            }
+            options[:limit]  = query.limit.to_i  if query.limit
+            options[:offset] = query.offset.to_i if query.offset
+
+            if order = search_order(query)
+              options.update(
+                :sort_mode => :extended,
+                :sort_by   => order
+              )
+            end
+
+            res = @client.search(search, from, options)
+            raise res[:error] unless res[:error].nil?
+
+            DataMapper.logger.info(
+              %q{Sphinx (%.3f): search '%s' in '%s' found %d documents} % [res[:time], search, from, res[:total]]
+            )
+            res[:matches].map{|doc| {:id => doc[:doc]}}
+          end
+
+          ##
+          # Sphinx search query string from properties (fields).
+          #
+          # If the query has no conditions an '' empty string will be generated possibly triggering Sphinx's full scan
+          # mode.
+          #
+          # @see    http://www.sphinxsearch.com/doc.html#searching
+          # @see    http://www.sphinxsearch.com/doc.html#conf-docinfo
+          # @param  [DataMapper::Query]
+          # @return [String]
+          def search_query(query)
+            match  = []
+
+            if query.conditions.empty?
+              match << ''
+            else
+              # TODO: This needs to be altered by match mode since not everything is supported in different match modes.
+              query.conditions.each do |operator, property, value|
+                next if property.kind_of? Sphinx::Attribute # Filters are added elsewhere.
+                # TODO: Why does my gem riddle differ from the vendor riddle that comes with ts?
+                # escaped_value = Riddle.escape(value)
+                escaped_value = value.to_s.gsub(/[\(\)\|\-!@~"&\/]/){|char| "\\#{char}"}
+                match << case operator
+                  when :eql, :like then "@#{property.field} #{escaped_value}"
+                  when :not        then "@#{property.field} -#{escaped_value}"
+                  when :lt, :gt, :lte, :gte
+                    DataMapper.logger.warn('Sphinx: Query properties with lt, gt, lte, gte are treated as .eql')
+                    "@#{name} #{escaped_value}"
+                  when :raw
+                    "#{property}"
+                end
+              end
+            end
+            match.join(' ')
+          end
+
+          ##
+          # Sphinx search query filters from attributes.
+          # @param  [DataMapper::Query]
+          # @return [Array]
+          def search_filters(query)
+            filters = []
+            query.conditions.each do |operator, attribute, value|
+              next unless attribute.kind_of? Sphinx::Attribute
+              # TODO: Value cast to uint, bool, str2ordinal, float
+              filters << case operator
+                when :eql, :like then Riddle::Client::Filter.new(attribute.name.to_s, filter_value(value))
+                when :not        then Riddle::Client::Filter.new(attribute.name.to_s, filter_value(value), true)
+                else
+                  error = "Sphinx: Query attributes do not support the #{operator} operator"
+                  DataMapper.logger.error(error)
+                  raise error # TODO: RuntimeError subclass and more information about the actual query.
+              end
+            end
+            filters
+          end
+
+          ##
+          # Order by attributes.
+          #
+          # @return [String or Symbol]
+          def search_order(query)
+            by = []
+            # TODO: How do you tell the difference between the default query order and someone explicitly asking for
+            # sorting by the primary key?
+            query.order.each do |order|
+              next unless order.property.kind_of? Sphinx::Attribute
+              by << [order.property.field, order.direction].join(' ')
+            end
+            by.empty? ? nil : by.join(', ')
+          end
+
+          # TODO: Move this to Attribute#dump.
+          # This is ninja'd straight from TS just to get things going.
+          def filter_value(value)
+            case value
+              when Range
+                value.first.is_a?(Time) ? value.first.to_i..value.last.to_i : value
+              when Array
+                value.collect { |val| val.is_a?(Time) ? val.to_i : val }
+              else
+                Array(value)
+            end
+          end
+      end # Adapter
+    end # Sphinx
+
+    # Keep magic in DataMapper#setup happy.
+    SphinxAdapter = Sphinx::Adapter
+  end # Adapters
+end # DataMapper
+

data/lib/dm-sphinx-adapter/attribute.rb

@@ -0,0 +1,39 @@
+module DataMapper
+  module Adapters
+    module Sphinx
+
+      ##
+      # Define a Sphinx attribute.
+      #
+      # Supports only a subset of DataMapper::Property types that can be used as Sphinx attributes.
+      #
+      # * TrueClass                 # sql_attr_bool
+      # * String                    # sql_attr_str2ordinal
+      # * Float,                    # sql_attr_float
+      # * Integer,                  # sql_attr_uint
+      # * DateTime,                 # sql_attr_timestamp
+      # * Date,                     # sql_attr_timestamp
+      # * DataMapper::Types::Serial # sql_attr_uint
+      class Attribute < Property
+
+        # DataMapper types supported as Sphinx attributes.
+        TYPES = [
+          TrueClass,                # sql_attr_bool
+          String,                   # sql_attr_str2ordinal
+          # DataMapper::Types::Text,
+          Float,                    # sql_attr_float
+          Integer,                  # sql_attr_uint
+          # BigDecimal,             # sql_attr_float?
+          DateTime,                 # sql_attr_timestamp
+          Date,                     # sql_attr_timestamp
+          Time,                     # sql_attr_timestamp
+          # Object,
+          # Class,
+          # DataMapper::Types::Discriminator,
+          DataMapper::Types::Serial # sql_attr_uint
+        ]
+
+      end # Attribute
+    end # Sphinx
+  end # Adapters
+end # DataMapper

data/lib/dm-sphinx-adapter/client.rb

@@ -0,0 +1,86 @@
+require 'rubygems'
+
+gem 'riddle', '~> 0.9'
+require 'riddle'
+
+module DataMapper
+  module Adapters
+    module Sphinx
+      class Client
+        include Extlib::Assertions
+
+        def initialize(uri_or_options = {})
+          @config = Sphinx::Config.new(uri_or_options)
+        end
+
+        ##
+        # Search one or more indexes.
+        #
+        # @param [String] query The sphinx query string.
+        # @param [Array, String] indexes A string or array of indexes to search. Default is '*' (all).
+        # @param [Hash] options Any options you'd like to pass through to Riddle::Client.
+        # @see   Riddle::Client
+        def search(query, indexes = '*', options = {})
+          indexes = indexes.join(' ') if indexes.kind_of?(Array)
+
+          client = Riddle::Client.new(@config.address, @config.port)
+          options.each{|k, v| client.method("#{k}=".to_sym).call(v) if client.respond_to?("#{k}=".to_sym)}
+          client.query(query, indexes.to_s)
+        end
+
+        ##
+        # Index one or more indexes.
+        #
+        # @param [Array, String] indexes Defaults to --all if indexes is nil or '*'.
+        def index(indexes = nil, options = {})
+          indexes = indexes.join(' ') if indexes.kind_of?(Array)
+
+          command = @config.indexer_bin
+          command << " --rotate" if running?
+          command << ((indexes.nil? || indexes == '*') ? ' --all' : " #{indexes.to_s}")
+          warn "Sphinx: Indexer #{$1}" if `#{command}` =~ /(?:error|fatal|warning):?\s*([^\n]+)/i
+        end
+
+        protected
+
+          ##
+          # Is the client running.
+          #
+          # Tests the address and port set in the configuration file.
+          def running?
+            !!TCPSocket.new(@config.address, @config.port) rescue nil
+          end
+      end # Client
+
+      ##
+      # Managed searchd if you don't already have god/monit doing the job for you.
+      #
+      # Requires you have daemon_controller installed.
+      # @see http://github.com/FooBarWidget/daemon_controller/tree/master
+      class ManagedClient < Client
+        def initialize(url_or_options = {})
+          super
+
+          # Fire up searchd.
+          require 'daemon_controller'
+          @client = DaemonController.new(
+            :identifier    => 'Sphinx searchd',
+            :start_command => @config.searchd_bin,
+            :stop_command  => "#{@config.searchd_bin} --stop",
+            :ping_command  => method(:running?),
+            :pid_file      => @config.pid_file,
+            :log_file      => @config.log
+          )
+        end
+
+        def search(*args)
+          @client.connect{super}
+        end
+
+        def stop
+          @client.stop if @client.running?
+        end
+      end # ManagedClient
+    end # Sphinx
+  end # Adapters
+end # DataMapper