esearch 0.2.0

data/lib/esearch/command/search.rb

@@ -0,0 +1,24 @@
+module Esearch
+  class Command
+    # Search command
+    class Search < self
+      include Concord.new(:context, :query)
+
+      PRESENTER = Presenter::Search
+
+    private
+
+      # Return request
+      #
+      # @return [Request]
+      #
+      # @api private
+      #
+      def request
+        Request.get(context_path.join('_search'), query)
+      end
+
+    end
+  end
+end
+

data/lib/esearch/command/status.rb

@@ -0,0 +1,24 @@
+module Esearch
+  class Command
+
+    # Command to return cluster status
+    class Status < self
+      include Concord.new(:context)
+
+      PRESENTER = Presenter::Status
+
+    private
+
+      # Return request
+      #
+      # @return [Request]
+      #
+      # @api private
+      #
+      def request
+        Request.get(context_path.join('_status'))
+      end
+
+    end
+  end
+end

data/lib/esearch/connection.rb

@@ -0,0 +1,36 @@
+module Esearch
+  # Connection to an elasticsearch cluster
+  class Connection
+    include Adamantium::Flat, Concord.new(:raw_connection, :logger)
+
+    # Return connection
+    #
+    # @param [String] uri
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    def self.build(uri, logger = NullLogger.instance)
+      new(Faraday.new(uri), logger)
+    end
+
+
+    # Run request 
+    #
+    # @param [Command::Request] request
+    #
+    # @return [Faraday::Request]
+    #
+    # @api private
+    #
+    def run(request)
+      util = logger
+      util.debug { request.log_string }
+      response = request.run(raw_connection)
+      util.debug { response.status.to_s }
+      response
+    end
+
+  end
+end

data/lib/esearch/document.rb

@@ -0,0 +1,53 @@
+module Esearch
+  # Handler for document
+  class Document
+    include Adamantium::Flat, Concord.new(:type, :id)
+    include Mixin::Exist, Mixin::Document
+
+    # Delete document
+    #
+    # @return [Presenter::Command::Document::Delete]
+    #
+    # @api private
+    #
+    def delete
+      Command::Document::Delete.run(self)
+    end
+
+    # Return document
+    #
+    # @return [Presenter::Command::Document::Get]
+    #   if foundd
+    #
+    # @return [nil]
+    #   otherwise
+    #
+    # @api private
+    #
+    def get
+      Command::Document::Get.run(self)
+    end
+
+    # Return path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def path
+      type.path.join(id)
+    end
+    memoize :path
+
+    # Return connection
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    def connection
+      type.connection
+    end
+
+  end
+end

data/lib/esearch/index.rb

@@ -0,0 +1,61 @@
+module Esearch
+  # Driver for specific index
+  class Index
+    include Adamantium::Flat, Concord.new(:connection, :name)
+    include Mixin::Exist, Mixin::Search, Mixin::Index
+
+    # Return connection
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    attr_reader :connection
+
+    # Cretate remote index
+    #
+    # @param [Hash] settings
+    #
+    # @return [Presenter::Index::Create]
+    #
+    # @api private
+    #
+    def create(settings)
+      Command::Index::Create.run(self, settings)
+    end
+
+    # Delete remote index
+    #
+    # @return [Presenter::Index::Delete]
+    #
+    # @api private
+    #
+    def delete
+      Command::Index::Delete.run(self)
+    end
+
+    # Return type for index
+    #
+    # @param [String] name
+    #
+    # @return [Type]
+    #
+    # @api private
+    #
+    def type(name)
+      Type.new(self, name)
+    end
+
+    # Return path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def path
+      Pathname.new("/#{name}")
+    end
+    memoize :path
+
+  end
+end

data/lib/esearch/indices.rb

@@ -0,0 +1,52 @@
+module Esearch
+  # Handler for set of indices
+  class Indices
+    include Adamantium::Flat, Concord.new(:connection, :names)
+    include Mixin::Exist, Mixin::Index, Mixin::Search
+
+    # Return connection
+    #
+    # @return [Connection]
+    #
+    # @api private
+    #
+    attr_reader :connection
+
+    # Return path
+    #
+    # @return [Pathname]
+    #
+    # @api private
+    #
+    def path
+      Pathname.new("/#{names.join(',')}")
+    end
+    memoize :path
+
+    # Control all indices of a cluster
+    class All < self
+      include Concord.new(:connection)
+
+      # Return connection
+      #
+      # @return [Connection]
+      #
+      # @api private
+      #
+      attr_reader :connection
+
+      # Return path
+      #
+      # @return [Pathname]
+      #
+      # @api private
+      #
+      def path
+        self.class::PATH
+      end
+
+      PATH = Pathname.new('/_all').freeze
+
+    end
+  end
+end

data/lib/esearch/mixin.rb

@@ -0,0 +1,111 @@
+module Esearch
+  # Namespace for handler mixins
+  module Mixin
+
+    # Mixin for exist predicate
+    module Exist
+
+      # Test if index does exist
+      #
+      # @return [true]
+      #   if index exists
+      #
+      # @return [false]
+      #   otherwise
+      #
+      # @api private
+      #
+      def exist?
+        Command::Exist.run(self)
+      end
+
+    end
+
+    # Mixin that adds document operations
+    module Document
+
+      # Index document
+      #
+      # @param [Document] document
+      # @param [Hash] options
+      #
+      # @return [Presenter::Document::Operation::Index]
+      #
+      # @api private
+      #
+      def index(document, options = {})
+        Command::Document::Index.run(self, document, options)
+      end
+
+      # Create indexed document
+      #
+      # @param [Document] document
+      # @param [Hash] options
+      #
+      # @return [Presenter::Document::Operation::Index]
+      #
+      # @api private
+      #
+      def index_create(document, options = {})
+        Command::Document::Index::Create.run(self, document, options)
+      end
+
+      # Update indexed document
+      #
+      # @param [Document] document
+      # @param [Hash] options
+      #
+      # @return [Presenter::Document::Operation::Index]
+      #
+      # @api private
+      #
+      def index_update(document, options = {})
+        Command::Document::Index::Update.run(self, document, options)
+      end
+
+    end
+
+    # Mixin that adds index commands
+    module Index
+
+      # Refresh cluster
+      #
+      # @return [self]
+      #
+      # @api private
+      #
+      def refresh
+        Command::Index::Refresh.run(self)
+      end
+
+      # Return status of cluster
+      #
+      # @return [Status]
+      #
+      # @api private
+      #
+      def status
+        Command::Index::Status.run(self)
+      end
+
+    end
+
+    # Mixin for search command
+    module Search
+
+      # Return result
+      #
+      # @param [Hash] query
+      #
+      # @return [Presenter::Search]
+      #
+      # @api private
+      #
+      def search(query)
+        Command::Search.run(self, query)
+      end
+
+    end
+
+  end
+end

data/lib/esearch/presenter.rb

@@ -0,0 +1,43 @@
+module Esearch
+  # Abstract base class for json response presenters
+  class Presenter
+    include Adamantium::Flat, AbstractType, Concord.new(:raw)
+
+    # Define tagged collection exposer
+    #
+    # @param [Symbol] name
+    # @param [Class:Presenter] presenter
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def self.expose_tagged_collection(key, presenter)
+      key = key.to_s # caches string in closure ;)
+      define_method(key) do ||
+        raw.fetch(key).map do |name, element| 
+          presenter.new(element.merge('name' => name))
+        end
+      end
+    end
+    private_class_method :expose_tagged_collection
+
+    # Define primitive exposer
+    #
+    # @param [Symbol] key
+    # @param [Symbol] method_name
+    #
+    # @return [undefined]
+    #
+    # @api private
+    #
+    def self.expose_primitive(key, method_name = key)
+      key = key.to_s # caches string in closure ;)
+      define_method(method_name) do ||
+        raw.fetch(key)
+      end
+    end
+    private_class_method :expose_primitive
+
+  end
+end

data/lib/esearch/presenter/aspect.rb

@@ -0,0 +1,17 @@
+module Esearch
+  class Presenter
+
+    # Abstract base class of an aspect of a facet
+    class Aspect < self
+
+      # Return count of occurences of aspect in facet
+      #
+      # @return [Fixnum]
+      #
+      # @api private
+      #
+      expose_primitive(:count)
+
+    end
+  end
+end

data/lib/esearch/presenter/aspect/range.rb

@@ -0,0 +1,63 @@
+module Esearch
+  class Presenter
+    class Aspect
+
+      # Range aspect
+      class Range < self
+        
+        # Return range start 
+        #
+        # @return [Float]
+        #   if present
+        #
+        # @return [nil]
+        #   otherwise
+        #
+        # @api private
+        #
+        def from
+          raw['from']
+        end
+
+        # Return range end 
+        #
+        # @return [Float]
+        #   if present
+        #
+        # @return [nil]
+        #   otherwise
+        #
+        # @api private
+        #
+        def to
+          raw['to']
+        end
+
+        # Return total count
+        #
+        # @return [Fixnum]
+        #
+        # @api private
+        #
+        expose_primitive(:total_count)
+
+        # Return total 
+        #
+        # @return [Float]
+        #
+        # @api private
+        #
+        expose_primitive(:total)
+
+        # Return mean 
+        #
+        # @return [Float]
+        #
+        # @api private
+        #
+        expose_primitive(:mean)
+
+      end
+    end
+  end
+end