chewy 0.8.4 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 99f0c4b83cadcf35bdf475f7f68e16120ed4674d
-  data.tar.gz: b9653b8e9bfb3e2e8f8b98662495f13a6b2d56e8
+  metadata.gz: de7c5c4e672dfb909540467bf37a13aaa21933c1
+  data.tar.gz: 1e6a424a74805c9e19495f9c2d33a1e16cd0a843
 SHA512:
-  metadata.gz: 7c28d1f97d185c70c986c4d7250e566bb196adc2f7230a7ff76939e3cbc589fabcb0a4ac6b26fe80ec267ec6c7d6a80cea766f4ea5fb6d67dd6cc76b47038cf1
-  data.tar.gz: b1418935e1d6bff9e2fc93676ac8d93ee4f4c6a3ee30e1a5371781e1004adf1cddd24fd326f8a368fc692823a5a96464a555c14de82c8e1117a1dbaf0cc3a6da
+  metadata.gz: 9a7b5152aa2def448318b81b1fbac395ad652620c079c8013332e5e44ffebcfb27932688d81b7116f95447e37ebe715630307bf45e010f6964ff12a618a97d97
+  data.tar.gz: 370c365d9d690e29e5ab7de4ba06f0dff07aa360edbb7f18c982bf2c6f288b1bdd7554bb8bc569993d82553c696e44c3c726ab5c11db278b1d6fcc4c472b4998

data/.rubocop.yml

@@ -0,0 +1,34 @@
+inherit_from: .rubocop_todo.yml
+
+Lint/EndAlignment:
+  AlignWith: variable
+
+Style/AccessModifierIndentation:
+  EnforcedStyle: outdent
+
+Style/Alias:
+  EnforcedStyle: prefer_alias_method
+
+Style/AlignHash:
+  EnforcedLastArgumentHashStyle: always_ignore
+
+Style/AlignParameters:
+  EnforcedStyle: with_fixed_indentation
+
+Style/AndOr:
+  EnforcedStyle: conditionals
+
+Style/CaseIndentation:
+  IndentWhenRelativeTo: end
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/IndentArray:
+  EnforcedStyle: consistent
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+Style/MultilineOperationIndentation:
+  EnforcedStyle: indented

data/.rubocop_todo.yml

@@ -0,0 +1,44 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2016-09-09 17:05:47 +0700 using RuboCop version 0.42.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 42
+Metrics/AbcSize:
+  Max: 48
+
+# Offense count: 4
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 280
+
+# Offense count: 14
+Metrics/CyclomaticComplexity:
+  Max: 13
+
+# Offense count: 1450
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes.
+# URISchemes: http, https
+Metrics/LineLength:
+  Max: 198
+
+# Offense count: 38
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 33
+
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/ModuleLength:
+  Max: 172
+
+# Offense count: 14
+Metrics/PerceivedComplexity:
+  Max: 15
+
+# Offense count: 93
+Style/Documentation:
+  Enabled: false

data/.travis.yml

@@ -3,74 +3,34 @@ sudo: false
 services:
   - mongodb
 rvm:
-  - 2.0
-  - 2.1
-  - 2.2.3
-  - 2.3.0
-  # - rbx
+  - 2.2.5
+  - 2.3.1
 gemfile:
-  - gemfiles/rails.3.2.activerecord.gemfile
-  - gemfiles/rails.3.2.activerecord.kaminari.gemfile
-  - gemfiles/rails.3.2.activerecord.will_paginate.gemfile
-  - gemfiles/rails.4.0.activerecord.gemfile
-  - gemfiles/rails.4.0.activerecord.kaminari.gemfile
-  - gemfiles/rails.4.0.activerecord.will_paginate.gemfile
-  - gemfiles/rails.4.1.activerecord.gemfile
-  - gemfiles/rails.4.1.activerecord.kaminari.gemfile
-  - gemfiles/rails.4.1.activerecord.will_paginate.gemfile
   - gemfiles/rails.4.2.activerecord.gemfile
   - gemfiles/rails.4.2.activerecord.kaminari.gemfile
   - gemfiles/rails.4.2.activerecord.will_paginate.gemfile
-  - gemfiles/rails.5.0.0.beta3.activerecord.gemfile
-  - gemfiles/rails.5.0.0.beta3.activerecord.kaminari.gemfile
-  - gemfiles/rails.5.0.0.beta3.activerecord.will_paginate.gemfile
-  - gemfiles/rails.4.0.mongoid.4.0.0.gemfile
-  - gemfiles/rails.4.0.mongoid.4.0.0.kaminari.gemfile
-  - gemfiles/rails.4.0.mongoid.4.0.0.will_paginate.gemfile
-  - gemfiles/rails.4.0.mongoid.5.1.0.gemfile
-  - gemfiles/rails.4.0.mongoid.5.1.0.kaminari.gemfile
-  - gemfiles/rails.4.0.mongoid.5.1.0.will_paginate.gemfile
-  - gemfiles/rails.4.1.mongoid.4.0.0.gemfile
-  - gemfiles/rails.4.1.mongoid.4.0.0.kaminari.gemfile
-  - gemfiles/rails.4.1.mongoid.4.0.0.will_paginate.gemfile
-  - gemfiles/rails.4.1.mongoid.5.1.0.gemfile
-  - gemfiles/rails.4.1.mongoid.5.1.0.kaminari.gemfile
-  - gemfiles/rails.4.1.mongoid.5.1.0.will_paginate.gemfile
-  - gemfiles/rails.4.2.mongoid.4.0.0.gemfile
-  - gemfiles/rails.4.2.mongoid.4.0.0.kaminari.gemfile
-  - gemfiles/rails.4.2.mongoid.4.0.0.will_paginate.gemfile
-  - gemfiles/rails.4.2.mongoid.5.1.0.gemfile
-  - gemfiles/rails.4.2.mongoid.5.1.0.kaminari.gemfile
-  - gemfiles/rails.4.2.mongoid.5.1.0.will_paginate.gemfile
-  - gemfiles/sequel.4.31.gemfile
-
+  - gemfiles/rails.5.0.activerecord.gemfile
+  - gemfiles/rails.5.0.activerecord.kaminari.gemfile
+  - gemfiles/rails.5.0.activerecord.will_paginate.gemfile
+  - gemfiles/rails.4.2.mongoid.4.0.gemfile
+  - gemfiles/rails.4.2.mongoid.4.0.kaminari.gemfile
+  - gemfiles/rails.4.2.mongoid.4.0.will_paginate.gemfile
+  - gemfiles/rails.4.2.mongoid.5.1.gemfile
+  - gemfiles/rails.4.2.mongoid.5.1.kaminari.gemfile
+  - gemfiles/rails.4.2.mongoid.5.1.will_paginate.gemfile
+  - gemfiles/sequel.4.38.gemfile
 matrix:
-  exclude:
-    - rvm: 2.0
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.gemfile
-    - rvm: 2.0
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.kaminari.gemfile
-    - rvm: 2.0
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.will_paginate.gemfile
+  include:
     - rvm: 2.1
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.gemfile
-    - rvm: 2.1
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.kaminari.gemfile
-    - rvm: 2.1
-      gemfile: gemfiles/rails.5.0.0.beta3.activerecord.will_paginate.gemfile
-    - rvm: 2.2
       gemfile: gemfiles/rails.3.2.activerecord.gemfile
-    - rvm: 2.2
-      gemfile: gemfiles/rails.3.2.activerecord.kaminari.gemfile
-    - rvm: 2.2
-      gemfile: gemfiles/rails.3.2.activerecord.will_paginate.gemfile
-    - rvm: 2.3
-      gemfile: gemfiles/rails.3.2.activerecord.gemfile
-    - rvm: 2.3
+    - rvm: 2.1
       gemfile: gemfiles/rails.3.2.activerecord.kaminari.gemfile
-    - rvm: 2.3
+    - rvm: 2.1
       gemfile: gemfiles/rails.3.2.activerecord.will_paginate.gemfile
 before_install:
-  - curl -# https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.7.2.tar.gz | tar xz -C /tmp
+  - curl -s https://download.elastic.co/elasticsearch/elasticsearch/elasticsearch-1.7.5.tar.gz | tar xz -C /tmp
 before_script:
-  - TEST_CLUSTER_COMMAND="/tmp/elasticsearch-1.7.2/bin/elasticsearch" rake elasticsearch:start
+  - TEST_CLUSTER_COMMAND="/tmp/elasticsearch-1.7.5/bin/elasticsearch" rake es:start
+script:
+  - bundle exec rspec
+  - bundle exec rubocop

data/Appraisals

@@ -1,4 +1,4 @@
-%w(3.2 4.0 4.1 4.2).each do |version|
+%w(3.2 4.2 5.0).each do |version|
   appraise "rails.#{version}.activerecord" do
     gem 'activerecord', "~> #{version}.0"
     gem 'activesupport', "~> #{version}.0"
@@ -22,55 +22,30 @@
   end
 end
 
-'5.0.0.beta3'.tap do |version|
-  appraise "rails.#{version}.activerecord" do
-    gem 'activerecord', "~> #{version}"
-    gem 'activesupport', "~> #{version}"
-    gem 'activejob', "~> #{version}"
+{ '4.0' => '4.2', '5.1' => '4.2' }.each do |(mongoid, activesupport)|
+  appraise "rails.#{activesupport}.mongoid.#{mongoid}" do
+    gem 'mongoid', "~> #{mongoid}.0"
+    gem 'activesupport', "~> #{activesupport}.0"
     gem 'resque', require: false
     gem 'sidekiq', require: false
   end
 
-  appraise "rails.#{version}.activerecord.kaminari" do
-    gem 'activerecord', "~> #{version}"
-    gem 'activesupport', "~> #{version}"
-    gem 'activejob', "~> #{version}"
-    gem 'actionpack', "~> #{version}"
+  appraise "rails.#{activesupport}.mongoid.#{mongoid}.kaminari" do
+    gem 'mongoid', "~> #{mongoid}.0"
+    gem 'activesupport', "~> #{activesupport}.0"
     gem 'kaminari', '0.16.3', require: false
   end
 
-  appraise "rails.#{version}.activerecord.will_paginate" do
-    gem 'activerecord', "~> #{version}"
-    gem 'activesupport', "~> #{version}"
-    gem 'activejob', "~> #{version}" if version >= '4.2'
+  appraise "rails.#{activesupport}.mongoid.#{mongoid}.will_paginate" do
+    gem 'mongoid', "~> #{mongoid}.0"
+    gem 'activesupport', "~> #{activesupport}.0"
     gem 'will_paginate', require: false
   end
 end
 
-%w(4.0 4.1 4.2).each do |activesupport|
-  %w(4.0.0 5.1.0).each do |mongoid|
-    appraise "rails.#{activesupport}.mongoid.#{mongoid}" do
-      gem 'mongoid', "> #{mongoid}"
-      gem 'activesupport', "~> #{activesupport}.0"
-      gem 'resque', require: false
-      gem 'sidekiq', require: false
-    end
-
-    appraise "rails.#{activesupport}.mongoid.#{mongoid}.kaminari" do
-      gem 'mongoid', "> #{mongoid}"
-      gem 'activesupport', "~> #{activesupport}.0"
-      gem 'kaminari', '0.16.3', require: false
-    end
-
-    appraise "rails.#{activesupport}.mongoid.#{mongoid}.will_paginate" do
-      gem 'mongoid', "> #{mongoid}"
-      gem 'activesupport', "~> #{activesupport}.0"
-      gem 'will_paginate', require: false
-    end
+%w(4.38).each do |sequel|
+  appraise "sequel.#{sequel}" do
+    gem 'sequel', "~> #{sequel}.0"
+    gem 'activesupport', '~> 5.0.0'
   end
 end
-
-appraise "sequel.4.31" do
-  gem 'sequel', "~> 4.31.0"
-  gem 'activesupport', '~> 4.2.0'
-end

data/CHANGELOG.md

@@ -1,5 +1,47 @@
 # master
 
+# Version 0.9.0
+
+## Changes
+
+  * Add `preference` param to Query (@menglewis, #443)
+
+  * Add the `track_scores` option to the query; `_score` to be computed and tracked even when there are no `_score` in sort. (@dmitry, #417)
+
+  * Confugurable `Chewy.indices_path` (@robacarp, #414, #433, #439)
+
+  * [Journaling](https://github.com/toptal/chewy/#journaling) implementation (@sergey-kintsel, #409, #425, #428, #432, #434, #463)
+
+  * Minitest helpers (@robacarp, #396)
+
+  * `Chewy::Query#unlimited` to fetch all the records (@sergey-kintsel, #393)
+
+  * `Chewy::Query#exists?` (@sergey-kintsel, #386)
+
+  * Import otimizations (#381, #376)
+
+  * Additional import optimization technique - [raw import](https://github.com/toptal/chewy/#raw-import) (@DNNX, #375)
+
+  * `weight` scoring dunction was added to the search DSL (@sevab, #380)
+
+  * Rake tasks support multiple indexes and exceptions: `rake chewy:reset[users,projects]`, `rake chewy:update[-projects]`
+
+  * Witchcraft™ supports dynamically generated procs with variables from closure.
+
+  * Added `Query#preference` for specifying shard replicas to query against. (@menglewis)
+
+## Bugfixes
+
+  * `.script_fields` method in the Index class (@dmitry, #415)
+
+  * Fix routing_missing_exception on delete with parent missing (@guigs, #398)
+
+  * Sequesl custom primary keys handling fix (@okliv, #385)
+
+  * Bulk import fixes (@0x0badc0de, #374)
+
+# Version 0.8.4
+
 ## Changes
 
   * Brand new import `:bulk_size` option, set desired ElasticSearch bulk size in bytes

data/Gemfile

@@ -16,4 +16,5 @@ gem 'activerecord'
 group :test do
   gem 'guard'
   gem 'guard-rspec'
+  gem 'listen', '~> 3.0.0'
 end

data/Guardfile

@@ -4,20 +4,20 @@
 guard :rspec, cmd: 'rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
-  watch('spec/spec_helper.rb')  { "spec" }
+  watch('spec/spec_helper.rb')  { 'spec' }
 
   # Rails example
   watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
   watch(%r{^app/(.*)(\.erb|\.haml|\.slim)$})          { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
   watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
-  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
-  watch('config/routes.rb')                           { "spec/routing" }
-  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  watch(%r{^spec/support/(.+)\.rb$})                  { 'spec' }
+  watch('config/routes.rb')                           { 'spec/routing' }
+  watch('app/controllers/application_controller.rb')  { 'spec/controllers' }
 
   # Capybara features specs
   watch(%r{^app/views/(.+)/.*\.(erb|haml|slim)$})     { |m| "spec/features/#{m[1]}_spec.rb" }
 
   # Turnip features and steps
   watch(%r{^spec/acceptance/(.+)\.feature$})
-  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$})   { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance' }
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance' }
 end

data/README.md

@@ -4,11 +4,47 @@
 [![Inline docs](http://inch-ci.org/github/toptal/chewy.svg?branch=master)](http://inch-ci.org/github/toptal/chewy)
 
 <p align="right">Sponsored by</p>
-<p align="right"><a href="http://www.toptal.com/"><img src="http://www.toptal.com/assets/public/blocks/logo/big.png" alt="Toptal" width="105" height="34"></a></p>
+<p align="right"><a href="https://www.toptal.com/"><img src="https://www.toptal.com/assets/public/blocks/logo/big.png" alt="Toptal" width="105" height="34"></a></p>
 
 # Chewy
 
-Chewy is an ODM and wrapper for [the official Elasticsearch client](https://github.com/elasticsearch/elasticsearch-ruby).
+Chewy is an ODM and wrapper for [the official Elasticsearch client](https://github.com/elastic/elasticsearch-ruby).
+
+## Table of Contents
+
+* [Why Chewy?] (#why-chewy)
+* [Usage] (#usage)
+  * [Client settings] (#client-settings)
+  * [Index definition] (#index-definition)
+  * [Type default import options] (#type-default-import-options)
+  * [Multi (nested) and object field types] (#multi-nested-and-object-field-types)
+  * [Geo Point fields] (#geo-point-fields)
+  * [Crutches™ technology] (#crutches-technology)
+  * [Witchcraft™ technology] (#witchcraft-technology)
+  * [Raw Import] (#raw-import)
+  * [Journaling] (#journaling)
+  * [Types access] (#types-access)
+  * [Index manipulation] (#index-manipulation)
+  * [Index update strategies] (#index-update-strategies)
+    * [Nesting] (#nesting)
+    * [Non-block notation] (#non-block-notation)
+    * [Designing your own strategies] (#designing-your-own-strategies)
+  * [Rails application strategies integration] (#rails-application-strategies-integration)
+  * [Index querying] (#index-querying)
+  * [Additional query action.] (#additional-query-action)
+  * [Filters query DSL] (#filters-query-dsl)
+  * [Faceting] (#faceting)
+  * [Aggregations] (#aggregations)
+  * [Script fields] (#script-fields)
+  * [Script scoring] (#script-scoring)
+  * [Boost Factor] (#boost-factor)
+  * [Objects loading] (#objects-loading)
+    * [NewRelic integration] (#newrelic-integration)
+  * [Rake tasks] (#rake-tasks)
+  * [Rspec integration] (#rspec-integration)
+  * [Minitest integration] (#minitest-integration)
+* [TODO a.k.a coming soon:] (#todo-aka-coming-soon)
+* [Contributing] (#contributing)
 
 ## Why Chewy?
 
@@ -125,7 +161,7 @@ See [config.rb](lib/chewy/config.rb) for more details.
   end
   ```
 
-  [See here for mapping definitions](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/mapping.html).
+  [See here for mapping definitions](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping.html).
 
 4. Add some index- and type-related settings. Analyzer repositories might be used as well. See `Chewy::Index.settings` docs for details:
 
@@ -161,8 +197,8 @@ See [config.rb](lib/chewy/config.rb) for more details.
   end
   ```
 
-  [See index settings here](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html).
-  [See root object settings here](http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/mapping-root-object-type.html).
+  [See index settings here](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-update-settings.html).
+  [See root object settings here](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-root-object-type.html).
 
   See [mapping.rb](lib/chewy/type/mapping.rb) for more details.
 
@@ -395,7 +431,107 @@ end
 ```
 
 And don't even ask how is it possible, it is a witchcraft.
-Obviously not every type of definition might be compiled, so use reasonable formatting to make `method_source` be able to extract field value proc sources. Also value procs with splat arguments are not supported right now. However, it is quite possible that your type definition will be supported by Witchcraft™ technology out of the box in the most of the cases.
+Obviously not every type of definition might be compiled. There are some restrictions:
+
+1. Use reasonable formatting to make `method_source` be able to extract field value proc sources.
+2. Value procs with splat arguments are not supported right now.
+3. If you are generating fields dynamically use value proc with arguments, argumentless value procs are not supported yet:
+
+  ```ruby
+  [:first_name, :last_name].each do |name|
+    field name, value: -> (o) { o.send(name) }
+  end
+  ```
+
+However, it is quite possible that your type definition will be supported by Witchcraft™ technology out of the box in the most of the cases.
+
+### Raw Import
+
+Another way to speed up import time is Raw Imports. This technology is only available in ActiveRecord adapter. Very often, ActiveRecord model instantiation is what consumes most of the CPU and RAM resources. Precious time is wasted on converting, say, timestamps from strings and then serializing them back to strings. Chewy can operate on raw hashes of data directly obtained from the database. All you need is to provide a way to convert that hash to a lightweight object that mimics the behaviour of the normal ActiveRecord object.
+
+```ruby
+class LightweightProduct
+  def initialize(attributes)
+    @attributes = attributes
+  end
+
+  # Depending on the database, `created_at` might
+  # be in different formats. In PostgreSQL, for example,
+  # you might see the following format:
+  #   "2016-03-22 16:23:22"
+  #
+  # Taking into account that Elastic expects something different,
+  # one might do something like the following, just to avoid
+  # unnecessary String -> DateTime -> String conversion.
+  #
+  #   "2016-03-22 16:23:22" -> "2016-03-22T16:23:22Z"
+  def created_at
+    @attributes['created_at'].tr(' ', 'T') << 'Z'
+  end
+end
+
+define_type Product do
+  default_import_options raw_import: ->(hash) {
+    LightweightProduct.new(hash)
+  }
+
+  field :created_at, 'datetime'
+end
+```
+
+Also, you can pass `:raw_import` option to the `import` method explicitly.
+
+
+### Journaling
+
+You can record all actions that were made to the separate journal index in ElasticSearch.
+When you create/update/destroy your records, it will be saved in this special index.
+If you make something with a batch of records (e.g. during index reset) it will be saved as a one record, including primary keys of each document that was affected.
+Common journal record looks like this:
+
+```json
+{
+  "action": "index",
+  "object_id": [1, 2, 3],
+  "index_name": "...",
+  "type_name": "...",
+  "created_at": "<timestamp>"
+}
+```
+
+This feature is turned off by default.
+But you can turn it on by setting `journal` setting to `true` in `config/chewy.yml`.
+Also, you can specify journal index name. For example:
+
+```yaml
+# config/chewy.yml
+production:
+  journal: true,
+  journal_name: my_super_journal
+```
+
+Also, you can provide this option while you're importing some index:
+
+```ruby
+CityIndex.import journal: true
+```
+
+Or as a default import option for an index:
+
+```ruby
+class CityIndex
+  define_type City do
+    default_import_options journal: true
+  end
+end
+```
+
+You may be wondering why do you need it? The answer is simple: Not to lose the data.
+Imagine that:
+You reset your index in Zero Downtime manner (to separate index), and meantime somebody keeps updating the data frequently (to old index). So all these actions will be written to the journal index and you'll be able to apply them after index reset with `Chewy::Journal::Apply.since(1.hour.ago.to_i)`.
+
+For index reset journaling is turned off even if you set `journal: true` in `config/chewy.yml` or in `default_import_options`.
+You can change it only if you pass `journal: true` parameter explicitly to `#import`.
 
 ### Types access
 
@@ -404,6 +540,8 @@ You can access index-defined types with the following API:
 ```ruby
 UsersIndex::User # => UsersIndex::User
 UsersIndex.type_hash['user'] # => UsersIndex::User
+UsersIndex.type('user') # => UsersIndex::User
+UsersIndex.type('foo') # => raises error UndefinedType("Unknown type in UsersIndex: foo")
 UsersIndex.types # => [UsersIndex::User]
 UsersIndex.type_names # => ['user']
 ```
@@ -1129,9 +1267,14 @@ Inside the Rails application, some index-maintaining rake tasks are defined.
 ```bash
 rake chewy:reset # resets all the existing indices, declared in app/chewy
 rake chewy:reset[users] # resets UsersIndex only
+rake chewy:reset[users,projects] # resets UsersIndex and ProjectsIndex
+rake chewy:reset[-users,projects] # resets every index in application except specified ones
 
 rake chewy:update # updates all the existing indices, declared in app/chewy
 rake chewy:update[users] # updates UsersIndex only
+rake chewy:update[users,projects] # updates UsersIndex and ProjectsIndex
+rake chewy:update[-users,projects] # updates every index in application except specified ones
+
 ```
 
 `rake chewy:reset` performs zero-downtime reindexing as described [here](https://www.elastic.co/blog/changing-mapping-with-zero-downtime). So basically rake task creates a new index with uniq suffix and then simply aliases it to the common index name. The previous index is deleted afterwards (see `Chewy::Index.reset!` for more details).
@@ -1141,6 +1284,12 @@ rake chewy:update[users] # updates UsersIndex only
 
 Just add `require 'chewy/rspec'` to your spec_helper.rb and you will get additional features: See [update_index.rb](lib/chewy/rspec/update_index.rb) for more details.
 
+### Minitest integration
+
+Add `require 'chewy/minitest'` to your test_helper.rb, and then for tests which you'd like indexing test hooks, `include Chewy::Minitest::Helpers`.
+
+### DatabaseCleaner
+
 If you use `DatabaseCleaner` in your tests with [the `transaction` strategy](https://github.com/DatabaseCleaner/database_cleaner#how-to-use), you may run into the problem that `ActiveRecord`'s models are not indexed automatically on save despite the fact that you set the callbacks to do this with the `update_index` method. The issue arises because `chewy` indexes data on `after_commit` run as default, but all `after_commit` callbacks are not run with the `DatabaseCleaner`'s' `transaction` strategy. You can solve this issue by changing the `Chewy.use_after_commit_callbacks` option. Just add the following initializer in your Rails application:
 
 ```ruby