stretcher 1.6.0 → 1.7.0

data/README.md

@@ -93,11 +93,12 @@ Specs may be run with `rake spec`
 
 ## Contributors
 
-* @andrewvc
-* @psynix
-* @fmardini
-* @chatgris
-* @alpinegizmo
+* [@andrewvc](https://github.com/andrewvc)
+* [@psynix](https://github.com/psynix)
+* [@fmardini](https://github.com/fmardini)
+* [@chatgris](https://github.com/chatgris)
+* [@alpinegizmo](https://github.com/alpinegizmo)
+* [@mcolyer](https://github.com/mcolyer)
 
 ## Contributing
 

data/lib/stretcher/index_type.rb

@@ -19,6 +19,13 @@ module Stretcher
       raw ? res : res["_source"]
     end
 
+    # Explains a query for a specific document
+    def explain(id, query)
+      request(:get, "#{id}/_explain") do |req|
+        req.body = query
+      end
+    end
+
     # Index an item with a specific ID
     def put(id, source)
       request(:put, id, source)

data/lib/stretcher/version.rb

@@ -1,3 +1,3 @@
 module Stretcher
-  VERSION = "1.6.0"
+  VERSION = "1.7.0"
 end

data/spec/lib/stretcher_index_type_spec.rb

@@ -53,7 +53,7 @@ describe Stretcher::IndexType do
     end
   end
 
-  describe "put/get/delete" do
+  describe "put/get/delete/explain" do
     before do
       @doc = {:message => "hello!"}
       @put_res = type.put(987, @doc)
@@ -83,6 +83,13 @@ describe Stretcher::IndexType do
       res["_source"].message.should == @doc[:message]
     end
 
+    it "should explain a query" do
+      type.exists?(987).should be_true
+      index.refresh
+      res = type.explain(987, {:query => {:match_all => {}}})
+      res.should have_key('explanation')
+    end
+
     it "should update individual docs correctly" do
       type.update(987, :script => "ctx._source.message = 'Updated!'")
       type.get(987).message.should == 'Updated!'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stretcher
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-03-12 00:00:00.000000000 Z
+date: 2013-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday