elastics 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ca7add0bf62591b992bdcbb03cf08461cf208204
-  data.tar.gz: 5f2b845c2cf49a89e6f4414dfad2dd505ed56784
+  metadata.gz: 4414829781480b6aaf6c1fa14bf0450a0e164906
+  data.tar.gz: c63d19ed109fae4244b4c9427814c4ffa1f10de6
 SHA512:
-  metadata.gz: da3920ea1f157297b6c3e5fea2b7ead3620493fb887ee34bd6191b8428ab74763fb324246be193fbd5e2fc32268f7f61331680a02f087d6ce3c619d9d7da1820
-  data.tar.gz: 262e2e0efec270bed5eac991e706298220bf67f5024efd6ae99782d94efb86380c95bf40bcc9dc2779e423205d6c00441a9b72968921894d3bd5fb3869034cab
+  metadata.gz: 43f6b27708081b51906e6768edb32cd54243974582c0beae93a2030f3b605d62e8f5c4a245c9b5dc8fa6a7de0e0590756404bfb748961ad66e513dc99bcb7bda
+  data.tar.gz: c02fc34b15851945a8b5da43e93326062c903383dca4a7a8e21134c8d199f92a1918bebcb2f71e32f9c08046c3e8520e97765c5045b3d52682788be9dd97c321

data/README.md

@@ -171,7 +171,7 @@ creates index with settings for each file from `indices` folder.
 - `rake elastics:migrate` (`.migrate`)
 puts mappings from `mappings` folder.
 
-- `rake elastics:migrate full=true` (`.migrate!`)
+- `rake elastics:migrate!` (`.migrate!`)
 performs full migration.
 
 - `rake elastics:reindex` (`.reindex`)

data/lib/elastics/active_record/helper_methods.rb

@@ -10,26 +10,23 @@ module Elastics
       end
 
       module ClassMethods
+        # Performs `_search` request on type and instantiates result object.
+        # SearchResult is a default result class. It can be overriden with
+        # :result_class option.
         def search_elastics(data = {}, options = {})
-          request = {
-            id:   :_search,
-            body: data,
-          }
-          if routing = options[:routing]
-            request[:query] = {routing: routing}
-          end
-          SearchResult.new self, request_elastics(request), options
+          options[:result_class] ||= SearchResult
+          options[:model] = self
+          super
         end
 
+        # Finds items by ids and returns array in the order in which ids were given.
+        # Every missing record is replaced with `nil` in the result.
         def find_all_ordered(ids)
           items_by_id = where(id: ids).index_by(&:id)
           ids.map { |i| items_by_id[i] }
         end
 
-        def elastics_mapping
-          request_elastics(method: :get, id: :_mapping)
-        end
-
+        # Indexes all records in current scope.
         def index_all_elastics(*args)
           find_in_batches(*args) do |batch|
             index_batch_elastics(batch)

data/lib/elastics/active_record/search_result.rb

@@ -1,8 +1,8 @@
 module Elastics
   module ActiveRecord
     class SearchResult < Result::Search
-      def initialize(model, response, options = {})
-        @model = model
+      def initialize(response, options = {})
+        @model = options[:model]
         super response, options
       end
 

data/lib/elastics/model/helper_methods.rb

@@ -21,18 +21,37 @@ module Elastics
           }
         end
 
+        # Proxies #request method to elastics client with specified index & type.
         def request_elastics(params)
           elastics.request(elastics_params.merge!(params))
         end
 
+        # Proxies #bulk method to elastics client with specified index & type.
         def bulk_elastics(params = {}, &block)
           elastics.bulk(elastics_params.merge!(params), &block)
         end
 
+        # Performs `_search` request on type and instantiates result object.
+        # Result::Search is a default result class. It can be overriden with
+        # :result_class option.
+        def search_elastics(data = {}, options = {})
+          request = {
+            id:     :_search,
+            body:   data,
+          }
+          if routing = options[:routing]
+            request[:query] = {routing: routing}
+          end
+          result_class = options[:result_class] || Result::Search
+          result_class.new request_elastics(request), options
+        end
+
+        # Performs `_refresh` request on index.
         def refresh_elastics
           request_elastics(method: :post, type: nil, id: :_refresh)
         end
 
+        # Indexes given records using batch API.
         def index_batch_elastics(batch)
           bulk_elastics do |bulk|
             batch.each do |record|
@@ -41,8 +60,20 @@ module Elastics
           end
         end
 
+        # Reindexes all records. It requires #find_in_batches method to be defined.
         def reindex_elastics(options = {})
-          raise 'Not implemented'
+          find_in_batches(options) do |batch|
+            index_batch_elastics(batch)
+          end
+        end
+
+        # Deletes all records in type keeping its mapping using "Delete by query" API.
+        def clear_elastics
+          request_elastics method: :delete, id: :_query, body: {query: {match_all: {}}}
+        end
+
+        def elastics_mapping
+          request_elastics(id: :_mapping)
         end
       end
 

data/lib/elastics/query_helper.rb

@@ -1,11 +1,15 @@
 module Elastics
   module QueryHelper
+    # Combines multiple filters into `and` filter. Returns unmodified input
+    # unless it was an array.
     def normalize_filters(filters)
       return filters unless filters.is_a?(Array)
       return filters[0] if 2 > filters.size
       {and: {filters: filters}}
     end
 
+    # Wraps given query into `filtered` query if filter is present.
+    # Also replaces empty query with `match_all`.
     def normalize_query(query, filters)
       filter = normalize_filters filters
       query ||= {match_all: {}}
@@ -16,12 +20,20 @@ module Elastics
       }}
     end
 
+    # Returns `term`(for scalar value) or `terms` (for array) query node
+    # for specified field.
     def terms_query(field, val, options = {})
       if val.is_a?(Array)
         {terms: {field => val}.merge(options)}
       else
-        result = {term: {field => val}}
+        {term: {field => val}}
       end
     end
+
+    # Returns `nil` if falsy value or empty array is given. Other way
+    # it returns term(s) query for it.
+    def terms_array_query(field, val, options = {})
+      terms_query(field, val, options) if val && (!val.is_a?(Array) || val.any?)
+    end
   end
 end

data/lib/elastics/tasks/mappings.rb

@@ -26,10 +26,34 @@ module Elastics
           flatten.sort.
           each_with_object({}) do |file, hash|
             name = File.basename file, '.yml'
-            hash[name] = YAML.load_file(file)
+            hash[name] = fix_mapping(name, YAML.load_file(file))
           end
       end
 
+      # Adds missing type name in the top-level and updates properties definition.
+      # It allows to write
+      #
+      #     properties:
+      #       name: string
+      #       project_id: integer
+      #
+      # instead of
+      #
+      #     task:
+      #       properties:
+      #         name:
+      #           type: string
+      #         project_id:
+      #           type: integer
+      def fix_mapping(name, mapping)
+        mapping = {name => mapping} unless mapping.keys == [name]
+        properties = mapping[name]['properties']
+        properties && properties.each do |field, val|
+          properties[field] = {type: val} if val.is_a?(String)
+        end
+        mapping
+      end
+
       def types
         @types ||= mappings.keys
       end

data/lib/elastics/version.rb

@@ -1,5 +1,5 @@
 module Elastics
-  VERSION = '0.4.0'
+  VERSION = '0.5.0'
 
   def self.gem_version
     Gem::Version.new VERSION

data/lib/tasks/elastics.rake

@@ -29,11 +29,11 @@ namespace 'elastics' do
 
   desc 'Creates indices and applies mappings. Full migration when param is present'
   task migrate: :load_config do
-    if ENV['full']
-      Elastics::Tasks.migrate! @elastics_options
-    else
-      Elastics::Tasks.migrate @elastics_options
-    end
+    Elastics::Tasks.migrate @elastics_options
+  end
+
+  task migrate!: :load_config do
+    Elastics::Tasks.migrate! @elastics_options
   end
 
   desc 'Reindex'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elastics
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Max Melentiev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-31 00:00:00.000000000 Z
+date: 2015-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient