esearch 0.2.0

data/lib/esearch/cluster.rb

@@ -0,0 +1,85 @@
+module Esearch
+  # Handle for an elasticsearch cluster
+  class Cluster
+
+    include Adamantium::Flat, Concord.new(:connection)
+
+    # Return connection
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    attr_reader :connection
+
+    # Return handler for index
+    #
+    # @param [String] name
+    #
+    # @return [Index]
+    #
+    # @api private
+    #
+    def index(name)
+      Index.new(connection, name)
+    end
+
+    # Return handler for indices
+    #
+    # @param [Enumerable<String>] names
+    #
+    # @return [Indices]
+    #
+    # @api private
+    #
+    def indices(names)
+      Indices.new(connection, names)
+    end
+
+    # Return cluster health
+    #
+    # @param [Hash] options
+    #
+    # @return [Presenter::Health]
+    #
+    # @api private
+    #
+    def health(options = {})
+      Command::Cluster::Health.run(self, options)
+    end
+
+    # Return path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def path
+      self.class::PATH
+    end
+
+    PATH = Pathname.new('/')
+
+    # Return handler for all indices 
+    #
+    # @return [Indices::All]
+    #
+    # @api private
+    #
+    def all_indices
+      Indices::All.new(connection)
+    end
+    memoize :all_indices
+
+    # Build connection
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    def self.connect(*args)
+      new(Connection.build(*args))
+    end
+
+  end
+end

data/lib/esearch/command.rb

@@ -0,0 +1,158 @@
+module Esearch
+  # Abstract base class for elasticsearch commands
+  class Command 
+    include Adamantium::Flat, AbstractType, Concord.new(:context)
+
+    EXPECTED_STATI    = [ 200 ].freeze
+    JSON_CONTENT_TYPE = 'application/json; charset=UTF-8'.freeze
+
+    # Run command
+    #
+    # @return [Object]
+    #
+    # @api private
+    #
+    def self.run(*args)
+      new(*args).result
+    end
+
+    # Return result of request
+    #
+    # @return [Presenter]
+    #
+    # @api private
+    #
+    def result
+      assert_success
+      presenter.new(parsed_json)
+    end
+
+  private
+
+    # Test for json content type
+    #
+    # @return [true]
+    #   if content type is json
+    #
+    # @return [false]
+    #   otherwise
+    #
+    # @api private
+    #
+    def json_content_type?
+      content_type.eql?(JSON_CONTENT_TYPE)
+    end
+
+    # Return presenter
+    #
+    # @return [Class:Presenter]
+    #
+    # @api private
+    #
+    def presenter
+      self.class::PRESENTER
+    end
+
+    # Return connection
+    #
+    # @return [Faraday::Connection]
+    #
+    # @api private
+    #
+    def connection
+      context.connection
+    end
+
+    # Return context path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def context_path
+      context.path
+    end
+
+    # Return response content type
+    #
+    # @return [String]
+    #
+    # @api private
+    #
+    def content_type
+      response.headers['content-type']
+    end
+
+    # Return expected response stati
+    #
+    # @return [Enumerable<Fixnum>]
+    # 
+    # @api private
+    #
+    def expected_response_stati
+      self.class::EXPECTED_STATI
+    end
+
+    # Test for success
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def assert_success
+      unless expected_response_stati.include?(response.status)
+        raise_status_error
+      end
+    end
+
+    # Raise remote status error
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def raise_status_error
+      raise ProtocolError, "expected response stati: #{expected_response_stati.inspect} but got: #{response.status}, remote message: #{remote_message.inspect}"
+    end
+
+    # Return remote message
+    #
+    # @return [String]
+    #
+    # @api private
+    #
+    def remote_message
+      if json_content_type?
+        parsed_json
+      else
+        response.body
+      end
+    end
+
+    # Return parsed json
+    #
+    # @return [Hash]
+    #
+    # @api private
+    #
+    def parsed_json
+      unless json_content_type?
+        raise ProtocolError, "Expected json content type, but got: #{content_type.inspect}"
+      end
+      MultiJson.load(response.body)
+    end
+    memoize :parsed_json
+
+    # Return response
+    #
+    # @return [Faraday::Response]
+    #
+    # @api private
+    #
+    def response
+      connection.run(request)
+    end
+    memoize :response
+
+  end
+end

data/lib/esearch/command/cluster.rb

@@ -0,0 +1,28 @@
+module Esearch
+  class Command
+    # Base class for cluster commands
+    class Cluster < self
+
+      # Command for accessing health
+      class Health < self
+        include Concord.new(:context, :options)
+
+        PRESENTER = Presenter::Cluster::Health
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.get('/_cluster/health', {}, options)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/esearch/command/document.rb

@@ -0,0 +1,111 @@
+module Esearch
+  class Command
+
+    # Base class for commands on documents
+    class Document < self
+
+      # Document index command
+      class Index < self
+        include Concord.new(:context, :document, :options)
+
+        EXPECTED_STATI = [ 200, 201 ].freeze
+        PRESENTER = Presenter::Document::Operation::Index
+
+        FORCE_OPTIONS = {}
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.post(context_path, document, effective_options)
+        end
+
+        # Return effective options
+        #
+        # @return [Hash]
+        #
+        # @api private
+        #
+        def effective_options
+          options.merge(self.class::FORCE_OPTIONS)
+        end
+
+        # Document index update command
+        class Update < self
+          EXPECTED_STATI = [ 200 ].freeze
+          FORCE_OPTIONS = { :op_type => :index }.freeze
+        end
+
+        # Document index create command
+        class Create < self
+          EXPECTED_STATI = [ 201 ].freeze
+          FORCE_OPTIONS = { :op_type => :create }.freeze
+        end
+      end
+
+      # Present get document command result
+      class Get < self
+        
+        EXPECTED_STATI = [ 200, 404 ].freeze
+        PRESENTER = Presenter::Document::Get
+
+        # Return result
+        #
+        # @return [true]
+        #   if object exists
+        #
+        # @return [false]
+        #   otherwise
+        #
+        # @api private
+        #
+        def result
+          assert_success
+          if response.status == 200
+            presenter.new(parsed_json)
+          else
+            nil
+          end
+        end
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.get(context_path)
+        end
+
+      end
+
+      # Present delete document command result
+      class Delete < self
+
+        PRESENTER = Presenter::Document::Operation::Delete
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.delete(context_path)
+        end
+
+      end
+
+    end
+  end
+end

data/lib/esearch/command/exist.rb

@@ -0,0 +1,37 @@
+module Esearch
+  class Command
+    # Command to check existance of objects
+    class Exist < self
+
+      EXPECTED_STATI = [ 200, 404 ].freeze
+
+      # Return result
+      #
+      # @return [true]
+      #   if object exists
+      #
+      # @return [false]
+      #   otherwise
+      #
+      # @api private
+      #
+      def result
+        assert_success
+        response.status == 200
+      end
+
+    private
+
+      # Return request
+      #
+      # @return [Request]
+      #
+      # @api private
+      #
+      def request
+        Request.head(context_path)
+      end
+
+    end
+  end
+end

data/lib/esearch/command/index.rb

@@ -0,0 +1,66 @@
+module Esearch
+  class Command
+    # Base class for commands on index
+    class Index < self
+
+      # Create index comand
+      class Create < self
+        include Concord.new(:context, :settings)
+
+        EXPECT_STATUS = [ 201 ].freeze
+        PRESENTER = Presenter::Index::Create
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.put(context_path, settings)
+        end
+
+      end
+
+      # Delete index comand
+      class Delete < self
+
+        PRESENTER = Presenter::Index::Delete
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.delete(context_path)
+        end
+
+      end
+
+      # Refresh index command
+      class Refresh < self
+
+        PRESENTER = Presenter::Index::Refresh
+
+      private
+
+        # Return request
+        #
+        # @return [Request]
+        #
+        # @api private
+        #
+        def request
+          Request.post(context_path.join('_refresh'))
+        end
+
+      end
+    end
+  end
+end