elastics-client 1.1.11 → 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0c02f2ac3c2b9b6bb4e171602857f15e55a5c7e2
+  data.tar.gz: 3c896bc4ce82299716aead954fbb21d4ce8389e7
+SHA512:
+  metadata.gz: b2fbd808a7a9743aac6d5496a3b44ac6d394ec0cfdb492cf12f62f0a128ce19976f521534df3d26a1bb5929c27764777c47b6f60336f2888590cab6114bd9d2c
+  data.tar.gz: b650f110ca1e64876a538052ec3d8b93c815d2db62a8634a0fd9e82b22231b78243ccc6e7a2e263d141a35e20a426a92f47b2028ed303fd49a958372b05a7d05

data/VERSION

@@ -1 +1 @@
-1.1.11
+1.2.0

data/elastics-client.gemspec

@@ -1,6 +1,9 @@
 require 'date'
-version_path = %w[../VERSION ../../VERSION].detect{|v| File.exist?(File.expand_path(v, __FILE__))}
-version      = File.read(File.expand_path(version_path, __FILE__)).strip
+version_path = %w[VERSION ../VERSION].detect{|v| File.exist?(v)}
+version      = File.read(version_path).strip
+extra_files  = []
+extra_files << 'VERSION' if File.exist?('VERSION')
+extra_files << 'LICENSE' if File.exist?('LICENSE')
 
 Gem::Specification.new do |s|
   s.name                      = 'elastics-client'
@@ -11,7 +14,7 @@ Elasticsearch API Methods, Templating System, Cascading Variables Management, Re
   s.authors                   = ['Domizio Demichelis']
   s.email                     = 'dd.nexus@gmail.com'
   s.require_paths             = %w[lib]
-  s.files                     = `git ls-files -z`.split("\0") + %w[VERSION LICENSE]
+  s.files                     = `git ls-files -z`.split("\0") + extra_files
   s.version                   = version
   s.date                      = Date.today.to_s
   s.required_rubygems_version = '>= 1.3.6'

data/lib/elastics-client.rb

@@ -28,6 +28,7 @@ require 'elastics/template/common'
 require 'elastics/template/partial'
 require 'elastics/template/logger'
 require 'elastics/template'
+require 'elastics/template/api'
 require 'elastics/template/search'
 require 'elastics/template/slim_search'
 require 'elastics/template/tags'
@@ -60,20 +61,33 @@ module Elastics
   include ApiStubs
 
   include Templates
-  elastics.load_source File.expand_path('../elastics/api_templates/core_api.yml'   , __FILE__)
-  elastics.load_source File.expand_path('../elastics/api_templates/indices_api.yml', __FILE__)
-  elastics.load_source File.expand_path('../elastics/api_templates/cluster_api.yml', __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/document_api.yml'       , __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/search_api.yml'         , __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/indices_api.yml'        , __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/cat_api.yml'            , __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/cluster_api.yml'        , __FILE__)
+  elastics.load_api_source File.expand_path('../elastics/api_templates/elastics_additions.yml' , __FILE__)
 
   extend self
   extend UtilityMethods
 
-  elastics.wrap :post_bulk_string, :bulk do |*vars|
+  ### wrapped methods ###
+
+  elastics.wrap :cat do |*vars|
+    if vars.first.is_a?(String)
+      super :path => vars.first
+    else
+      super *vars
+    end
+  end
+
+  elastics.wrap :post_bulk_string do |*vars|
     vars = Vars.new(*vars)
     return if vars[:bulk_string].nil? || vars[:bulk_string].empty?
     super vars
   end
 
-  # get a document without using the get API (which doesn't support fields '*')
+  # get a document without using the get API and without raising any error if missing
   elastics.wrap :search_by_id do |*vars|
     vars   = Vars.new(*vars)
     result = super(vars)
@@ -85,7 +99,7 @@ module Elastics
   end
 
   # support for live-reindex
-  elastics.wrap :store, :put_store, :post_store do |*vars|
+  elastics.wrap :store, :post_store do |*vars|
     vars         = Vars.new(*vars)
     vars[:index] = LiveReindex.prefix_index(vars[:index]) if LiveReindex.should_prefix_index?
     result = super(vars)
@@ -97,7 +111,7 @@ module Elastics
   end
 
   # support for live-reindex
-  elastics.wrap :delete, :remove do |*vars|
+  elastics.wrap :delete do |*vars|
     vars         = Vars.new(*vars)
     vars[:index] = LiveReindex.prefix_index(vars[:index]) if LiveReindex.should_prefix_index?
     if LiveReindex.should_track_change?
@@ -107,4 +121,23 @@ module Elastics
     super(vars)
   end
 
+    ### alias methods ###
+
+  class << self
+    alias_method :put_store,          :store                 # for symmetry with post_store
+    alias_method :remove,             :delete
+    alias_method :multi_get,          :multi_get_ids         # deprecated (backward compatibility)
+    alias_method :bulk,               :post_bulk_string      # deprecated (backward compatibility)
+
+    alias_method :create_index,       :put_index
+    alias_method :index_exists,       :indices_exists
+    alias_method :exist?,             :indices_exists        # deprecated (backward compatibility)
+    alias_method :put_mapping,        :put_index_mapping
+    alias_method :type_exists,        :types_exists
+    alias_method :put_index_settings, :update_index_settings
+
+    alias_method :mlt,                :more_like_this
+  end
+
+
 end

data/lib/elastics/api_stubs.rb

@@ -2,1303 +2,1370 @@ module Elastics
   module ApiStubs
 
     # The following lines are autogenerated by Elastics.doc
-
-    ######################## Core API ########################
+    # Notice: :index and :type variables are always shown as nil (default), although they may be required by elasticsearch
 
     #  ########## Elastics.store ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  store:
     #  - PUT
-    #  - /<<index>>/<<type>>/<<id>>
+    #  - "/<<index>>/<<type>>/<<id>>"
     #
     #
     #  Usage:
-    #  Elastics.store :id    => id,    # required
+    #  Elastics.store :id    => id,   # required
     #                 :type  => nil,
-    #                 :index => "elastics_test_index"
+    #                 :index => nil
     #
-    def Elastics.store(*vars)
+    def self.store(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :put_store
 
-    #  ########## Elastics.put_store ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  put_store:
-    #  - PUT
-    #  - /<<index>>/<<type>>/<<id>>
-    #
-    #
-    #  Usage:
-    #  Elastics.put_store :id    => id,    # required
-    #                     :type  => nil,
-    #                     :index => "elastics_test_index"
-    #
-    def Elastics.put_store(*vars)
-      ## this is a stub, used for reference
-      super
-    end
 
     #  ########## Elastics.post_store ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  post_store:
     #  - POST
-    #  - /<<index>>/<<type>>
+    #  - "/<<index>>/<<type>>"
     #
     #
     #  Usage:
-    #  Elastics.post_store :index => "elastics_test_index",
+    #  Elastics.post_store :index => nil,
     #                      :type  => nil
     #
-    def Elastics.post_store(*vars)
-      ## this is a stub, used for reference
-      super
-    end
-
-    #  ########## Elastics.delete ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  delete:
-    #  - DELETE
-    #  - /<<index>>/<<type>>/<<id>>
-    #
-    #
-    #  Usage:
-    #  Elastics.delete :id    => id,    # required
-    #                  :type  => nil,
-    #                  :index => "elastics_test_index"
-    #
-    def Elastics.delete(*vars)
+    def self.post_store(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.remove ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  remove:
-    #  - DELETE
-    #  - /<<index>>/<<type>>/<<id>>
-    #
-    #
-    #  Usage:
-    #  Elastics.remove :id    => id,    # required
-    #                  :type  => nil,
-    #                  :index => "elastics_test_index"
-    #
-    def Elastics.remove(*vars)
-      ## this is a stub, used for reference
-      super
-    end
 
     #  ########## Elastics.get ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  get:
     #  - GET
-    #  - /<<index>>/<<type>>/<<id>>
+    #  - "/<<index>>/<<type>>/<<id>>"
     #
     #
     #  Usage:
-    #  Elastics.get :id    => id,    # required
+    #  Elastics.get :id    => id,   # required
     #               :type  => nil,
-    #               :index => "elastics_test_index"
+    #               :index => nil
     #
-    def Elastics.get(*vars)
+    def self.get(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.get_source ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  get_source:
     #  - GET
-    #  - /<<index>>/<<type>>/<<id>>/_source
+    #  - "/<<index>>/<<type>>/<<id>>/_source"
     #
     #
     #  Usage:
-    #  Elastics.get_source :id    => id,    # required
+    #  Elastics.get_source :id    => id,   # required
     #                      :type  => nil,
-    #                      :index => "elastics_test_index"
+    #                      :index => nil
     #
-    def Elastics.get_source(*vars)
+    def self.get_source(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.multi_get ##########
-    #  --------------
+
+    #  ########## Elastics.delete ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  multi_get:
-    #  - GET
-    #  - /<<index>>/<<type>>/_mget
-    #  - ids: << ids >>
+    #  delete:
+    #  - DELETE
+    #  - "/<<index>>/<<type>>/<<id>>"
     #
     #
     #  Usage:
-    #  Elastics.multi_get :ids   => ids,   # required
-    #                     :type  => nil,
-    #                     :index => "elastics_test_index"
+    #  Elastics.delete :id    => id,   # required
+    #                  :type  => nil,
+    #                  :index => nil
     #
-    def Elastics.multi_get(*vars)
+    def self.delete(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :remove
+
 
     #  ########## Elastics.update ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  update:
     #  - POST
-    #  - /<<index>>/<<type>>/<<id>>/_update
+    #  - "/<<index>>/<<type>>/<<id>>/_update"
     #
     #
     #  Usage:
-    #  Elastics.update :id    => id,    # required
+    #  Elastics.update :id    => id,   # required
     #                  :type  => nil,
-    #                  :index => "elastics_test_index"
+    #                  :index => nil
     #
-    def Elastics.update(*vars)
+    def self.update(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.suggest ##########
+
+    #  ########## Elastics.multi_get_ids ##########
     #  ------------------
     #  Elastics::Template
     #  ---
-    #  suggest:
-    #  - POST
-    #  - /<<index>>/<<type>>/_suggest
+    #  multi_get_ids:
+    #  - GET
+    #  - "/<<index>>/<<type>>/_mget"
+    #  - ids: "<< ids >>"
     #
     #
     #  Usage:
-    #  Elastics.suggest :index => "elastics_test_index",
-    #                   :type  => nil
+    #  Elastics.multi_get_ids :ids   => ids,  # required
+    #                         :type  => nil,
+    #                         :index => nil
     #
-    def Elastics.suggest(*vars)
+    def self.multi_get_ids(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :multi_get
 
-    #  ########## Elastics.percolate ##########
-    #  --------------
+
+    #  ########## Elastics.multi_get_docs ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  percolate:
+    #  multi_get_docs:
     #  - GET
-    #  - /<<index>>/<<type>>/_percolate
+    #  - "/<<index>>/<<type>>/_mget"
+    #  - docs: "<< docs >>"
     #
     #
     #  Usage:
-    #  Elastics.percolate :index => "elastics_test_index",
-    #                     :type  => nil
+    #  Elastics.multi_get_docs :docs  => docs,  # required
+    #                          :type  => nil,
+    #                          :index => nil
     #
-    def Elastics.percolate(*vars)
+    def self.multi_get_docs(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.put_percolator ##########
-    #  --------------
+
+    #  ########## Elastics.post_bulk_string ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_percolator:
-    #  - PUT
-    #  - /_percolator/<<index>>/<<percolator>>
+    #  post_bulk_string:
+    #  - POST
+    #  - "/_bulk"
+    #  - "<< bulk_string >>"
     #
     #
     #  Usage:
-    #  Elastics.put_percolator :percolator => percolator,  # required
-    #                          :index      => "elastics_test_index"
+    #  Elastics.post_bulk_string :bulk_string => bulk_string  # required
     #
-    def Elastics.put_percolator(*vars)
+    def self.post_bulk_string(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :bulk
 
-    #  ########## Elastics.delete_percolator ##########
-    #  --------------
+
+    #  ########## Elastics.termvector ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  delete_percolator:
-    #  - DELETE
-    #  - /_percolator/<<index>>/<<percolator>>
+    #  termvector:
+    #  - POST
+    #  - "/<<index>>/<<type>>/<<id>>/_termvector"
     #
     #
     #  Usage:
-    #  Elastics.delete_percolator :percolator => percolator,  # required
-    #                             :index      => "elastics_test_index"
+    #  Elastics.termvector :id    => id,   # required
+    #                      :type  => nil,
+    #                      :index => nil
     #
-    def Elastics.delete_percolator(*vars)
+    def self.termvector(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.post_bulk_string ##########
-    #  --------------
+
+    #  ########## Elastics.multi_termvectors ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  post_bulk_string:
+    #  multi_termvectors:
     #  - POST
-    #  - /_bulk
-    #  - << bulk_string >>
+    #  - "/<<index>>/<<type>>/_mtermvectors"
+    #  - docs: "<<docs= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.bulk :bulk_string => bulk_string  # required
+    #  Elastics.multi_termvectors :index => nil,
+    #                             :type  => nil,
+    #                             :docs  => nil
     #
-    def Elastics.post_bulk_string(*vars)
+    def self.multi_termvectors(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.count ##########
-    #  --------------
+
+    #  ########## Elastics.search_shards ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  count:
+    #  search_shards:
     #  - GET
-    #  - /<<index>>/<<type>>/_count
+    #  - "/<<index>>/<<type>>/_search_shards"
     #
     #
     #  Usage:
-    #  Elastics.count :index => "elastics_test_index",
-    #                 :type  => nil
+    #  Elastics.search_shards :index => nil,
+    #                         :type  => nil
     #
-    def Elastics.count(*vars)
+    def self.search_shards(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.delete_by_query ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  delete_by_query:
-    #  - DELETE
-    #  - /<<index>>/<<type>>/_query
-    #
-    #
-    #  Usage:
-    #  Elastics.delete_by_query :index => "elastics_test_index",
-     #                          :type  => nil
-    #
-    def Elastics.delete_by_query(*vars)
-      ## this is a stub, used for reference
-      super
-    end
 
-    #  ########## Elastics.more_like_this ##########
-    #  --------------
+    #  ########## Elastics.count ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  more_like_this:
+    #  count:
     #  - GET
-    #  - /<<index>>/<<type>>/<<id>>/_mlt
+    #  - "/<<index>>/<<type>>/_count"
     #
     #
     #  Usage:
-    #  Elastics.more_like_this :id    => id,    # required
-    #                          :type  => nil,
-    #                          :index => "elastics_test_index"
+    #  Elastics.count :index => nil,
+    #                 :type  => nil
     #
-    def Elastics.more_like_this(*vars)
+    def self.count(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.mlt ##########
-    #  --------------
+
+    #  ########## Elastics.search_exists ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  mlt:
+    #  search_exists:
     #  - GET
-    #  - /<<index>>/<<type>>/<<id>>/_mlt
+    #  - "/<<index>>/<<type>>/<<id= ~ >>/_search/exists"
     #
     #
     #  Usage:
-    #  Elastics.mlt :id    => id,    # required
-    #               :type  => nil,
-    #               :index => "elastics_test_index"
+    #  Elastics.search_exists :index => nil,
+    #                         :type  => nil,
+    #                         :id    => nil
     #
-    def Elastics.mlt(*vars)
+    def self.search_exists(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.validate ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  validate:
     #  - GET
-    #  - /<<index>>/<<type>>/_validate/query
+    #  - "/<<index>>/<<type>>/<<id= ~ >>/_validate/query"
     #
     #
     #  Usage:
-    #  Elastics.validate :index => "elastics_test_index",
-    #                    :type  => nil
+    #  Elastics.validate :index => nil,
+    #                    :type  => nil,
+    #                    :id    => nil
     #
-    def Elastics.validate(*vars)
+    def self.validate(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.explain ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  explain:
     #  - GET
-    #  - /<<index>>/<<type>>/<<id>>/_explain
+    #  - "/<<index>>/<<type>>/<<id= ~ >>/_explain"
     #
     #
     #  Usage:
-    #  Elastics.explain :id    => id,    # required
+    #  Elastics.explain :index => nil,
     #                   :type  => nil,
-    #                   :index => "elastics_test_index"
+    #                   :id    => nil
     #
-    def Elastics.explain(*vars)
+    def self.explain(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.match_all ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  match_all:
-    #  - GET
-    #  - /<<index>>/<<type>>/_search
-    #  - query:
-    #      match_all: {}
-    #
-    #
-    #  Usage:
-    #  Elastics.match_all :index => "elastics_test_index",
-    #                     :type  => nil
-    #
-    def Elastics.match_all(*vars)
-      ## this is a stub, used for reference
-      super
-    end
 
-    #  ########## Elastics.search_by_id ##########
-    #  --------------
+    #  ########## Elastics.percolate ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  search_by_id:
+    #  percolate:
     #  - GET
-    #  - /<<index>>/<<type>>/_search
-    #  - query:
-    #      term:
-    #        _id: <<id>>
+    #  - "/<<index>>/<<type>>/_percolate"
     #
     #
     #  Usage:
-    #  Elastics.search_by_id :id      => id,    # required
-    #                        :type    => nil,
-    #                        :index   => "elastics_test_index",
+    #  Elastics.percolate :index => nil,
+    #                     :type  => nil
     #
-    def Elastics.search_by_id(*vars)
+    def self.percolate(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    ######################## Indices API ########################
-
-    #  ########## Elastics.post_index_aliases ##########
-    #  --------------
-    #  Elastics::Template
-    #  ---
-    #  post_index_aliases:
-    #  - POST
-    #  - /_aliases
-    #  - actions: <<actions>>
-    #
-    #
-    #  Usage:
-    #  Elastics.post_index_aliases :actions => actions
-    #
-    def Elastics.post_index_aliases(*vars)
-      ## this is a stub, used for reference
-      super
-    end
 
-    #  ########## Elastics.get_index_aliases ##########
-    #  --------------
+    #  ########## Elastics.percolate_count ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_index_aliases:
+    #  percolate_count:
     #  - GET
-    #  - /<<index>>/_aliases
+    #  - "/<<index>>/<<type>>/_percolate/count"
     #
     #
     #  Usage:
-    #  Elastics.get_index_aliases :index => "elastics_test_index"
+    #  Elastics.percolate_count :index => nil,
+    #                           :type  => nil
     #
-    def Elastics.get_index_aliases(*vars)
+    def self.percolate_count(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.add_index_alias ##########
-    #  --------------
+
+    #  ########## Elastics.put_percolator ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  add_index_alias:
+    #  put_percolator:
     #  - PUT
-    #  - /<<index>>/_alias/<<alias>>
+    #  - "/<<index>>/.percolator/<<id>>"
     #
     #
     #  Usage:
-    #  Elastics.add_index_alias :alias => alias,  # required
-    #                           :index => "elastics_test_index"
+    #  Elastics.put_percolator :id    => id,  # required
+    #                          :index => nil
     #
-    def Elastics.add_index_alias(*vars)
+    def self.put_percolator(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.delete_index_alias ##########
-    #  --------------
+
+    #  ########## Elastics.delete_percolator ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  delete_index_alias:
+    #  delete_percolator:
     #  - DELETE
-    #  - /<<index>>/_alias/<<alias>>
+    #  - "/<<index>>/.percolator/<<id>>"
     #
     #
     #  Usage:
-    #  Elastics.delete_index_alias :alias => alias,  # required
-    #                              :index => "elastics_test_index"
+    #  Elastics.delete_percolator :id    => id,  # required
+    #                             :index => nil
     #
-    def Elastics.delete_index_alias(*vars)
+    def self.delete_percolator(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.get_index_alias ##########
-    #  --------------
+
+    #  ########## Elastics.more_like_this ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_index_alias:
+    #  more_like_this:
     #  - GET
-    #  - /<<index>>/_alias/<<alias= '*' >>
+    #  - "/<<index>>/<<type>>/<<id>>/_mlt"
     #
     #
     #  Usage:
-    #  Elastics.get_index_alias :index => "elastics_test_index",
-    #                           :alias => "*"
+    #  Elastics.more_like_this :id    => id,   # required
+    #                          :type  => nil,
+    #                          :index => nil
     #
-    def Elastics.get_index_alias(*vars)
+    def self.more_like_this(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :mlt
 
-    #  ########## Elastics.analyze_index ##########
-    #  --------------
+
+    #  ########## Elastics.put_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  analyze_index:
-    #  - GET
-    #  - /<<index>>/_analyze
+    #  put_index:
+    #  - PUT
+    #  - "/<<index>>"
+    #  - settings:
+    #      number_of_shards: "<<number_of_shards= 5 >>"
+    #      number_of_replicas: "<<number_of_replicas= 1 >>"
     #
     #
     #  Usage:
-    #  Elastics.analyze_index :index => "elastics_test_index"
+    #  Elastics.put_index :index              => nil,
+    #                     :number_of_shards   => 5,
+    #                     :number_of_replicas => 1
     #
-    def Elastics.analyze_index(*vars)
+    def self.put_index(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :create_index
 
-    #  ########## Elastics.put_index ##########
-    #  --------------
+
+    #  ########## Elastics.post_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_index:
-    #  - PUT
-    #  - /<<index>>
+    #  post_index:
+    #  - POST
+    #  - "/<<index>>"
     #  - settings:
-    #      number_of_shards: <<number_of_shards= 5 >>
-    #      number_of_replicas: <<number_of_replicas= 1 >>
+    #      number_of_shards: "<<number_of_shards= 5 >>"
+    #      number_of_replicas: "<<number_of_replicas= 1 >>"
     #
     #
     #  Usage:
-    #  Elastics.put_index :index              => "elastics_test_index",
-    #                     :number_of_shards   => 5,
-    #                     :number_of_replicas => 1
+    #  Elastics.post_index :index              => nil,
+    #                      :number_of_shards   => 5,
+    #                      :number_of_replicas => 1
     #
-    def Elastics.put_index(*vars)
+    def self.post_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.create_index ##########
-    #  --------------
+
+    #  ########## Elastics.delete_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  create_index:
-    #  - PUT
-    #  - /<<index>>
-    #  - settings:
-    #      number_of_shards: <<number_of_shards= 5 >>
-    #      number_of_replicas: <<number_of_replicas= 1 >>
+    #  delete_index:
+    #  - DELETE
+    #  - "/<<index>>"
     #
     #
     #  Usage:
-    #  Elastics.create_index :index              => "elastics_test_index",
-    #                        :number_of_shards   => 5,
-    #                        :number_of_replicas => 1
+    #  Elastics.delete_index :index => nil
     #
-    def Elastics.create_index(*vars)
+    def self.delete_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.post_index ##########
-    #  --------------
+
+    #  ########## Elastics.get_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  post_index:
-    #  - POST
-    #  - /<<index>>
-    #  - settings:
-    #      number_of_shards: <<number_of_shards= 5 >>
-    #      number_of_replicas: <<number_of_replicas= 1 >>
+    #  get_index:
+    #  - GET
+    #  - "/<<index>>/<<features= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.post_index :index              => "elastics_test_index",
-    #                      :number_of_shards   => 5,
-    #                      :number_of_replicas => 1
+    #  Elastics.get_index :index    => nil,
+    #                     :features => nil
     #
-    def Elastics.post_index(*vars)
+    def self.get_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.delete_index ##########
-    #  --------------
+
+    #  ########## Elastics.indices_exists ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  delete_index:
-    #  - DELETE
-    #  - /<<index>>
+    #  indices_exists:
+    #  - HEAD
+    #  - "/<<index>>"
     #
     #
     #  Usage:
-    #  Elastics.delete_index :index => "elastics_test_index"
+    #  Elastics.indices_exists :index => nil
     #
-    def Elastics.delete_index(*vars)
+    def self.indices_exists(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :index_exists, :exist?
+
 
     #  ########## Elastics.close_index ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  close_index:
     #  - POST
-    #  - /<<index>>/_close
+    #  - "/<<index>>/_close"
     #
     #
     #  Usage:
-    #  Elastics.close_index :index => "elastics_test_index"
+    #  Elastics.close_index :index => nil
     #
-    def Elastics.close_index(*vars)
+    def self.close_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.open_index ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  open_index:
     #  - POST
-    #  - /<<index>>/_close
+    #  - "/<<index>>/_open"
     #
     #
     #  Usage:
-    #  Elastics.open_index :index => "elastics_test_index"
+    #  Elastics.open_index :index => nil
     #
-    def Elastics.open_index(*vars)
+    def self.open_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.get_index_settings ##########
-    #  --------------
+
+    #  ########## Elastics.put_index_mapping ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_index_settings:
-    #  - GET
-    #  - /<<index>>/_settings
+    #  put_index_mapping:
+    #  - PUT
+    #  - "/<<index>>/_mapping/<<type>>"
+    #  - "<<type>>":
+    #      properties: "<<properties>>"
     #
     #
     #  Usage:
-    #  Elastics.get_index_settings :index => "elastics_test_index"
+    #  Elastics.put_index_mapping :properties => properties,  # required
+    #                             :type       => nil,
+    #                             :index      => nil
     #
-    def Elastics.get_index_settings(*vars)
+    def self.put_index_mapping(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :put_mapping
 
-    #  ########## Elastics.get_settings ##########
-    #  --------------
+
+    #  ########## Elastics.get_index_mapping ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_settings:
+    #  get_index_mapping:
     #  - GET
-    #  - /<<index>>/_settings
+    #  - "/<<index>>/_mapping/<<type>>"
     #
     #
     #  Usage:
-    #  Elastics.get_settings :index => "elastics_test_index"
+    #  Elastics.get_index_mapping :index => nil,
+    #                             :type  => nil
     #
-    def Elastics.get_settings(*vars)
+    def self.get_index_mapping(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.put_index_settings ##########
+
+    #  ########## Elastics.get_field_mapping ##########
     #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_index_settings:
-    #  - PUT
-    #  - /<<index>>/_settings
+    #  get_field_mapping:
+    #  - GET
+    #  - "/<<index>>/_mapping/<<type>>/field/<<field>>"
     #
     #
     #  Usage:
-    #  Elastics.put_index_settings :index => "elastics_test_index"
+    #  Elastics.get_field_mapping :field => field,  # required
+    #                             :type  => nil,
+    #                             :index => nil
     #
-    def Elastics.put_index_settings(*vars)
+    def self.get_field_mapping(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.get_index_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.types_exists ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_index_mapping:
-    #  - GET
-    #  - /<<index>>/<<type>>/_mapping
+    #  types_exists:
+    #  - HEAD
+    #  - "/<<index>>/<<type>>"
     #
     #
     #  Usage:
-    #  Elastics.get_index_mapping :index => "elastics_test_index",
-    #                             :type  => nil
+    #  Elastics.types_exists :index => nil,
+    #                        :type  => nil
     #
-    def Elastics.get_index_mapping(*vars)
+    def self.types_exists(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :type_exists
 
-    #  ########## Elastics.get_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.delete_index_mapping ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_mapping:
-    #  - GET
-    #  - /<<index>>/<<type>>/_mapping
+    #  delete_index_mapping:
+    #  - DELETE
+    #  - "/<<index>>/<<type>>"
     #
     #
     #  Usage:
-    #  Elastics.get_mapping :index => "elastics_test_index",
-    #                       :type  => nil
+    #  Elastics.delete_index_mapping :index => nil,
+    #                                :type  => nil
     #
-    def Elastics.get_mapping(*vars)
+    def self.delete_index_mapping(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.put_index_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.post_index_aliases ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_index_mapping:
-    #  - PUT
-    #  - /<<index>>/<<type>>/_mapping
-    #  - <<type>>:
-    #      properties: <<properties>>
+    #  post_index_aliases:
+    #  - POST
+    #  - "/_aliases"
+    #  - actions: "<<actions>>"
     #
     #
     #  Usage:
-    #  Elastics.put_index_mapping :properties => properties,  # required
-    #                             :type       => nil,
-    #                             :index      => "elastics_test_index"
+    #  Elastics.post_index_aliases :actions => actions  # required
     #
-    def Elastics.put_index_mapping(*vars)
+    def self.post_index_aliases(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.put_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.get_index_aliases ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_mapping:
-    #  - PUT
-    #  - /<<index>>/<<type>>/_mapping
-    #  - <<type>>:
-    #      properties: <<properties>>
+    #  get_index_aliases:
+    #  - GET
+    #  - "/<<index>>/_aliases"
     #
     #
     #  Usage:
-    #  Elastics.put_mapping :properties => properties,  # required
-    #                       :type       => nil,
-    #                       :index      => "elastics_test_index"
+    #  Elastics.get_index_aliases :index => nil
     #
-    def Elastics.put_mapping(*vars)
+    def self.get_index_aliases(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.delete_index_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.put_index_alias ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  delete_index_mapping:
-    #  - DELETE
-    #  - /<<index>>/<<type>>
+    #  put_index_alias:
+    #  - PUT
+    #  - "/<<index>>/_alias/<<alias>>"
     #
     #
     #  Usage:
-    #  Elastics.delete_index_mapping :index => "elastics_test_index",
-    #                                :type  => nil
+    #  Elastics.put_index_alias :alias => alias,  # required
+    #                           :index => nil
     #
-    def Elastics.delete_index_mapping(*vars)
+    def self.put_index_alias(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.delete_mapping ##########
-    #  --------------
+
+    #  ########## Elastics.delete_index_alias ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  delete_mapping:
+    #  delete_index_alias:
     #  - DELETE
-    #  - /<<index>>/<<type>>
+    #  - "/<<index>>/_alias/<<alias>>"
     #
     #
     #  Usage:
-    #  Elastics.delete_mapping :index => "elastics_test_index",
-    #                          :type  => nil
+    #  Elastics.delete_index_alias :alias => alias,  # required
+    #                              :index => nil
     #
-    def Elastics.delete_mapping(*vars)
+    def self.delete_index_alias(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.refresh_index ##########
-    #  --------------
+
+    #  ########## Elastics.get_index_alias ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  refresh_index:
-    #  - POST
-    #  - /<<index>>/_refresh
+    #  get_index_alias:
+    #  - GET
+    #  - "/<<index>>/_alias/<<alias= '*' >>"
     #
     #
     #  Usage:
-    #  Elastics.refresh_index :index => "elastics_test_index"
+    #  Elastics.get_index_alias :index => nil,
+    #                           :alias => "*"
     #
-    def Elastics.refresh_index(*vars)
+    def self.get_index_alias(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.optimize_index ##########
-    #  --------------
+
+    #  ########## Elastics.update_index_settings ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  optimize_index:
-    #  - POST
-    #  - /<<index>>/_optimize
+    #  update_index_settings:
+    #  - PUT
+    #  - "/<<index>>/_settings"
     #
     #
     #  Usage:
-    #  Elastics.optimize_index :index => "elastics_test_index"
+    #  Elastics.update_index_settings :index => nil
     #
-    def Elastics.optimize_index(*vars)
+    def self.update_index_settings(*vars)
       ## this is a stub, used for reference
       super
     end
+    # also aliased by: :put_index_settings
 
-    #  ########## Elastics.flush_index ##########
-    #  --------------
+
+    #  ########## Elastics.get_index_settings ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  flush_index:
-    #  - POST
-    #  - /<<index>>/_flush
+    #  get_index_settings:
+    #  - GET
+    #  - "/<<index>>/_settings"
     #
     #
     #  Usage:
-    #  Elastics.flush_index :index => "elastics_test_index"
+    #  Elastics.get_index_settings :index => nil
     #
-    def Elastics.flush_index(*vars)
+    def self.get_index_settings(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.gateway_snapshot ##########
-    #  --------------
+
+    #  ########## Elastics.get_settings ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  gateway_snapshot:
-    #  - POST
-    #  - /<<index>>/_gateway/snapshot
+    #  get_settings:
+    #  - GET
+    #  - "/<<index>>/_settings"
     #
     #
     #  Usage:
-    #  Elastics.gateway_snapshot :index => "elastics_test_index"
+    #  Elastics.get_settings :index => nil
     #
-    def Elastics.gateway_snapshot(*vars)
+    def self.get_settings(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.update_index_settings ##########
-    #  --------------
+
+    #  ########## Elastics.analyze_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  update_index_settings:
-    #  - PUT
-    #  - /<<index>>/_settings
+    #  analyze_index:
+    #  - GET
+    #  - "/<<index>>/_analyze"
     #
     #
     #  Usage:
-    #  Elastics.update_index_settings :index => "elastics_test_index"
+    #  Elastics.analyze_index :index => nil
     #
-    def Elastics.update_index_settings(*vars)
+    def self.analyze_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.put_index_template ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  put_index_template:
     #  - PUT
-    #  - /_template/<<template>>
+    #  - "/_template/<<template>>"
     #
     #
     #  Usage:
     #  Elastics.put_index_template :template => template  # required
     #
-    def Elastics.put_index_template(*vars)
+    def self.put_index_template(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.delete_index_template ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  delete_index_template:
     #  - DELETE
-    #  - /_template/<<template>>
+    #  - "/_template/<<template>>"
     #
     #
     #  Usage:
     #  Elastics.delete_index_template :template => template  # required
     #
-    def Elastics.delete_index_template(*vars)
+    def self.delete_index_template(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.get_index_template ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  get_index_template:
     #  - GET
-    #  - /_template/<<template>>
+    #  - "/_template/<<template= ~ >>"
+    #
+    #
+    #  Usage:
+    #  Elastics.get_index_template :template => nil
+    #
+    def self.get_index_template(*vars)
+      ## this is a stub, used for reference
+      super
+    end
+
+
+    #  ########## Elastics.index_template_exists ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  index_template_exists:
+    #  - HEAD
+    #  - "/_template/<<template>>"
     #
     #
     #  Usage:
-    #  Elastics.get_index_template :template => template  # required
+    #  Elastics.index_template_exists :template => template  # required
     #
-    def Elastics.get_index_template(*vars)
+    def self.index_template_exists(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.put_index_warmer ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  put_index_warmer:
     #  - PUT
-    #  - /<<index>>/<<type>>/_warmer/<<warmer>>
+    #  - "/<<index>>/<<type>>/_warmer/<<warmer>>"
     #
     #
     #  Usage:
     #  Elastics.put_index_warmer :warmer => warmer,  # required
     #                            :type   => nil,
-    #                            :index  => "elastics_test_index"
+    #                            :index  => nil
     #
-    def Elastics.put_index_warmer(*vars)
+    def self.put_index_warmer(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.delete_index_warmer ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  delete_index_warmer:
     #  - DELETE
-    #  - /<<index>>/_warmer/<<warmer= ~ >>
+    #  - "/<<index>>/_warmer/<<warmer>>"
     #
     #
     #  Usage:
-    #  Elastics.delete_index_warmer :index  => "elastics_test_index",
-    #                               :warmer => nil
+    #  Elastics.delete_index_warmer :warmer => warmer,  # required
+    #                               :index  => nil
     #
-    def Elastics.delete_index_warmer(*vars)
+    def self.delete_index_warmer(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.get_index_warmer ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  get_index_warmer:
     #  - GET
-    #  - /<<index>>/_warmer/<<warmer= ~ >>
+    #  - "/<<index>>/_warmer/<<warmer= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.get_index_warmer :index  => "elastics_test_index",
+    #  Elastics.get_index_warmer :index  => nil,
     #                            :warmer => nil
     #
-    def Elastics.get_index_warmer(*vars)
+    def self.get_index_warmer(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.index_stats ##########
-    #  --------------
+
+    #  ########## Elastics.index_status ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  index_stats:
+    #  index_status:
     #  - GET
-    #  - /<<index>>/_stats/<<endpoint= ~ >>/<<names= ~ >>
+    #  - "/<<index>>/_status"
     #
     #
     #  Usage:
-    #  Elastics.index_stats :index    => "elastics_test_index",
-    #                       :endpoint => nil,
-    #                       :names    => nil
+    #  Elastics.index_status :index => nil
     #
-    def Elastics.index_stats(*vars)
+    def self.index_status(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.stats ##########
-    #  --------------
+
+    #  ########## Elastics.index_stats ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  stats:
+    #  index_stats:
     #  - GET
-    #  - /<<index>>/_stats/<<endpoint= ~ >>/<<names= ~ >>
+    #  - "/<<index>>/_stats/<<stats= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.stats :index    => "elastics_test_index",
-    #                 :endpoint => nil,
-    #                 :names    => nil
+    #  Elastics.index_stats :index => nil,
+    #                       :stats => nil
     #
-    def Elastics.stats(*vars)
+    def self.index_stats(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.index_status ##########
-    #  --------------
+
+    #  ########## Elastics.index_segments ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  index_status:
+    #  index_segments:
     #  - GET
-    #  - /<<index>>/_status
+    #  - "/<<index>>/_segments"
     #
     #
     #  Usage:
-    #  Elastics.index_status :index => "elastics_test_index"
+    #  Elastics.index_segments :index => nil
     #
-    def Elastics.index_status(*vars)
+    def self.index_segments(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.index_segments ##########
-    #  --------------
+
+    #  ########## Elastics.index_recovery ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  index_segments:
+    #  index_recovery:
     #  - GET
-    #  - /<<index>>/_segments
+    #  - "/<<index>>/_recovery"
     #
     #
     #  Usage:
-    #  Elastics.index_segments :index => "elastics_test_index"
+    #  Elastics.index_recovery :index => nil
     #
-    def Elastics.index_segments(*vars)
+    def self.index_recovery(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.index_clearcache ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  index_clearcache:
     #  - POST
-    #  - /<<index>>/_cache/clear
+    #  - "/<<index>>/_cache/clear"
     #
     #
     #  Usage:
-    #  Elastics.index_clearcache :index => "elastics_test_index"
+    #  Elastics.index_clearcache :index => nil
     #
-    def Elastics.index_clearcache(*vars)
+    def self.index_clearcache(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.indices_exists ##########
-    #  --------------
+
+    #  ########## Elastics.flush_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  indices_exists:
-    #  - HEAD
-    #  - /<<index>>
+    #  flush_index:
+    #  - POST
+    #  - "/<<index>>/_flush"
     #
     #
     #  Usage:
-    #  Elastics.indices_exists :index => "elastics_test_index"
+    #  Elastics.flush_index :index => nil
     #
-    def Elastics.indices_exists(*vars)
+    def self.flush_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.exist? ##########
-    #  --------------
+
+    #  ########## Elastics.synced_flush_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  exist?:
-    #  - HEAD
-    #  - /<<index>>
+    #  synced_flush_index:
+    #  - POST
+    #  - "/<<index>>/_flush/synced"
     #
     #
     #  Usage:
-    #  Elastics.exist? :index => "elastics_test_index"
+    #  Elastics.synced_flush_index :index => nil
     #
-    def Elastics.exist?(*vars)
+    def self.synced_flush_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.types_exists ##########
-    #  --------------
+
+    #  ########## Elastics.refresh_index ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  types_exists:
-    #  - HEAD
-    #  - /<<index>>/<<type>>
+    #  refresh_index:
+    #  - POST
+    #  - "/<<index>>/_refresh"
     #
     #
     #  Usage:
-    #  Elastics.types_exists :index => "elastics_test_index",
-    #                        :type  => nil
+    #  Elastics.refresh_index :index => nil
     #
-    def Elastics.types_exists(*vars)
+    def self.refresh_index(*vars)
       ## this is a stub, used for reference
       super
     end
 
 
-    ######################## Cluster API ########################
+    #  ########## Elastics.optimize_index ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  optimize_index:
+    #  - POST
+    #  - "/<<index>>/_optimize"
+    #
+    #
+    #  Usage:
+    #  Elastics.optimize_index :index => nil
+    #
+    def self.optimize_index(*vars)
+      ## this is a stub, used for reference
+      super
+    end
+
+
+    #  ########## Elastics.upgrade_index ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  upgrade_index:
+    #  - POST
+    #  - "/<<index>>/_upgrade"
+    #
+    #
+    #  Usage:
+    #  Elastics.upgrade_index :index => nil
+    #
+    def self.upgrade_index(*vars)
+      ## this is a stub, used for reference
+      super
+    end
+
 
     #  ########## Elastics.cluster_health ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  cluster_health:
     #  - GET
-    #  - /_cluster/health/<<index>>
+    #  - "/_cluster/health/<<index>>"
     #
     #
     #  Usage:
-    #  Elastics.cluster_health :index => "elastics_test_index"
+    #  Elastics.cluster_health :index => nil
     #
-    def Elastics.cluster_health(*vars)
+    def self.cluster_health(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.cluster_state ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  cluster_state:
     #  - GET
-    #  - /_cluster/state
+    #  - "/_cluster/state/<<metrics= _all >>/<<index>>"
     #
     #
     #  Usage:
-    #  Elastics.cluster_state
+    #  Elastics.cluster_state :metrics => "_all",
+    #                         :index   => nil
     #
-    def Elastics.cluster_state(*vars)
+    def self.cluster_state(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.put_cluster_settings ##########
-    #  --------------
+
+    #  ########## Elastics.cluster_stats ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  put_cluster_settings:
-    #  - PUT
-    #  - /_cluster/settings
+    #  cluster_stats:
+    #  - GET
+    #  - "/_cluster/stats"
     #
     #
     #  Usage:
-    #  Elastics.put_cluster_settings
+    #  Elastics.cluster_stats
     #
-    def Elastics.put_cluster_settings(*vars)
+    def self.cluster_stats(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.get_cluster_settings ##########
-    #  --------------
+
+    #  ########## Elastics.cluster_pending_tasks ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  get_cluster_settings:
+    #  cluster_pending_tasks:
     #  - GET
-    #  - /_cluster/settings
+    #  - "/_cluster/pending_tasks"
     #
     #
     #  Usage:
-    #  Elastics.get_cluster_settings
+    #  Elastics.cluster_pending_tasks
     #
-    def Elastics.get_cluster_settings(*vars)
+    def self.cluster_pending_tasks(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.cluster_nodes_info ##########
-    #  --------------
+
+    #  ########## Elastics.cluster_reroute ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  cluster_nodes_info:
+    #  cluster_reroute:
+    #  - POST
+    #  - "/_cluster/reroute"
+    #
+    #
+    #  Usage:
+    #  Elastics.cluster_reroute
+    #
+    def self.cluster_reroute(*vars)
+      ## this is a stub, used for reference
+      super
+    end
+
+
+    #  ########## Elastics.put_cluster_settings ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  put_cluster_settings:
+    #  - PUT
+    #  - "/_cluster/settings"
+    #
+    #
+    #  Usage:
+    #  Elastics.put_cluster_settings
+    #
+    def self.put_cluster_settings(*vars)
+      ## this is a stub, used for reference
+      super
+    end
+
+
+    #  ########## Elastics.get_cluster_settings ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  get_cluster_settings:
     #  - GET
-    #  - /_nodes/<<nodes= ~ >>/<<endpoint= ~ >>
+    #  - "/_cluster/settings"
     #
     #
     #  Usage:
-    #  Elastics.cluster_nodes_info :nodes    => nil,
-    #                              :endpoint => nil
+    #  Elastics.get_cluster_settings
     #
-    def Elastics.cluster_nodes_info(*vars)
+    def self.get_cluster_settings(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.cluster_nodes_stats ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  cluster_nodes_stats:
     #  - GET
-    #  - /_nodes/<<nodes= ~ >>/stats/<<endpoint= ~ >>
+    #  - "/_nodes/<<nodes= ~ >>/stats/<<stats= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.cluster_nodes_stats :nodes    => nil,
-    #                               :endpoint => nil
+    #  Elastics.cluster_nodes_stats :nodes => nil,
+    #                               :stats => nil
     #
-    def Elastics.cluster_nodes_stats(*vars)
+    def self.cluster_nodes_stats(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.cluster_nodes_shutdown ##########
-    #  --------------
+
+    #  ########## Elastics.cluster_nodes_info ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  cluster_nodes_shutdown:
-    #  - POST
-    #  - /_cluster/nodes/<<nodes= ~ >>/_shutdown
+    #  cluster_nodes_info:
+    #  - GET
+    #  - "/_nodes/<<nodes= ~ >>/<<info= ~ >>"
     #
     #
     #  Usage:
-    #  Elastics.cluster_nodes_shutdown :nodes => nil
+    #  Elastics.cluster_nodes_info :nodes => nil,
+    #                              :info  => nil
     #
-    def Elastics.cluster_nodes_shutdown(*vars)
+    def self.cluster_nodes_info(*vars)
       ## this is a stub, used for reference
       super
     end
 
+
     #  ########## Elastics.cluster_nodes_hot_threads ##########
-    #  --------------
+    #  ------------------
     #  Elastics::Template
     #  ---
     #  cluster_nodes_hot_threads:
     #  - GET
-    #  - /_nodes/<<nodes= ~ >>/hot_threads
+    #  - "/_nodes/<<nodes= ~ >>/hot_threads"
     #
     #
     #  Usage:
     #  Elastics.cluster_nodes_hot_threads :nodes => nil
     #
-    def Elastics.cluster_nodes_hot_threads(*vars)
+    def self.cluster_nodes_hot_threads(*vars)
       ## this is a stub, used for reference
       super
     end
 
-    #  ########## Elastics.cluster_reroute ##########
-    #  --------------
+
+    #  ########## Elastics.match_all ##########
+    #  ------------------
     #  Elastics::Template
     #  ---
-    #  cluster_reroute:
-    #  - POST
-    #  - /_cluster/reroute
+    #  match_all:
+    #  - GET
+    #  - "/<<index>>/<<type>>/_search"
+    #  - query:
+    #      match_all: {}
     #
     #
     #  Usage:
-    #  Elastics.cluster_reroute
+    #  Elastics.match_all :index => nil,
+    #                     :type  => nil
     #
-    def Elastics.cluster_reroute(*vars)
+    def self.match_all(*vars)
       ## this is a stub, used for reference
       super
     end
 
 
+    #  ########## Elastics.search_by_id ##########
+    #  ------------------
+    #  Elastics::Template
+    #  ---
+    #  search_by_id:
+    #  - GET
+    #  - "/<<index>>/<<type>>/_search"
+    #  - query:
+    #      term:
+    #        _id: "<<id>>"
+    #
+    #
+    #  Usage:
+    #  Elastics.search_by_id :id    => id,   # required
+    #                        :type  => nil,
+    #                        :index => nil
+    #
+    def self.search_by_id(*vars)
+      ## this is a stub, used for reference
+      super
+    end
   end
 end