chewy 8.0.0 → 8.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b5ed854e820d95af1d41232ffab69a142b8cb45591ba01f8b316349120ec49b5
-  data.tar.gz: b2ea3e975b6fcc5af8e3a993e731e1bb5a1e64ffab9edb1b26687e91e4c05763
+  metadata.gz: 36ec23aabab2b6b62d9425ad6505f5589958400f21411c90d9808113336aac35
+  data.tar.gz: 0b082e6327fa4092477c7888714662f791a940b9a1045047ce7a183d41656f2c
 SHA512:
-  metadata.gz: 92b482a9606d2e0e2dfcf8560d70679a1542f6e89012c012f7d46f4844dd568c04feca8a949b9c100444de73819d821edcb07cf9bbbb997a10f8cbcf93b033eb
-  data.tar.gz: c0595cbc913c89c295f653b124c545153f2775cdb64050bee435067020700093a69b137e132ec743feb4a5f477efd8c4a278eb3dce569c86f67cce1188c4e9da
+  metadata.gz: ad839b902eeb12a5f94547e21f0ed9b2d078be1869b0070be7698fd357edde8d6d759502301dd823eb53d8a3fa42bd6d5584cee53dd482df6c05d1b46e2d110a
+  data.tar.gz: 3fdef90ea2c73f41274556d5f001e7931bcbbb9b2bdd02df6204fbd75c5b8139ed2cbff00cd448922e8215d2f35f6f3695bd52505db2f30cd20968b54732c401

data/CHANGELOG.md

@@ -1,10 +1,21 @@
 # Changelog
 
+## 8.0.1 (2026-03-12)
+
+### New Features
+
+### Changes
+
+* [#1003](https://github.com/toptal/chewy/pull/1003): Ruby 4.0 support added [@mjankowski](https://github.com/mjankowski)
+
+### Bugs Fixed
+
 ## 8.0.0 (2026-02-25)
 
 ### New Features
 
 ### Changes
+* [#977](https://github.com/toptal/chewy/pull/977): Fewer files on gem installation [@ericproulx](https://github.com/ericproulx).
 
 * **(Breaking)** Drop support for Ruby < 3.2 and Rails < 7.2. Chewy now requires Ruby ~> 3.2 and ActiveSupport >= 7.2. ([@bbatsov][])
 

data/README.md

@@ -53,7 +53,7 @@ Chewy is compatible with MRI 3.2-3.4.
 
 | Chewy version | Elasticsearch version              |
 | ------------- | ---------------------------------- |
-| 8.0.0         | 8.x                                |
+| 8.0.x         | 8.x                                |
 | 7.2.x         | 7.x                                |
 | 7.1.x         | 7.x                                |
 | 7.0.x         | 6.8, 7.x                           |
@@ -236,6 +236,7 @@ end
 
 ## Documentation
 
+- [Getting Started](docs/getting_started.md) — end-to-end tutorial building search for a media library
 - [Configuration](docs/configuration.md) — client settings, update strategies, notifications, integrations
 - [Indexing](docs/indexing.md) — index definition, field types, crutches, witchcraft, index manipulation
 - [Import](docs/import.md) — import options, raw import, journaling
@@ -243,6 +244,33 @@ end
 - [Rake Tasks](docs/rake_tasks.md) — all rake tasks and parallelization
 - [Testing](docs/testing.md) — RSpec, Minitest, DatabaseCleaner
 - [Troubleshooting](docs/troubleshooting.md) — pre-request filter
+- [Non-Rails Usage](docs/non_rails.md) — using Chewy without Rails
+
+## FAQ
+
+**Can I use Chewy without Rails?**
+
+Yes. ActiveSupport and the elasticsearch gem are the only hard dependencies; the Rails railtie loads conditionally. See the [Non-Rails Usage](docs/non_rails.md) guide.
+
+**Does Chewy follow SemVer?**
+
+No. The major version tracks the newest supported Elasticsearch version and minor version bumps may include breaking changes. Always check the [release notes](https://github.com/toptal/chewy/releases) before upgrading.
+
+**Which versions of Ruby, Rails and Elasticsearch are supported?**
+
+See the [Compatibility](#compatibility) section above. When a Ruby or Rails version reaches end-of-life we may drop support in a future release.
+
+**What's the `UndefinedUpdateStrategy` error?**
+
+Chewy raises this when you save a model with an `update_index` callback and no strategy is active. Wrap your code in `Chewy.strategy(:atomic) { ... }` or set `Chewy.root_strategy = :bypass`. See [Troubleshooting](docs/troubleshooting.md#undefinedupdatestrategy-error) for details.
+
+**Can I use Chewy with OpenSearch?**
+
+OpenSearch is not officially supported or tested. Chewy depends on the official `elasticsearch` Ruby client and targets Elasticsearch.
+
+**How do I connect to Elastic Cloud?**
+
+Use the standard client settings with your Cloud credentials (API key or user/password). See [Configuration](docs/configuration.md#client-settings) for examples.
 
 ## Contributing
 

data/lib/chewy/index/witchcraft.rb

@@ -1,6 +1,10 @@
 begin
   require 'method_source'
-  require 'parser/current'
+  begin
+    require 'prism'
+  rescue LoadError
+    require 'parser/current'
+  end
   require 'unparser'
 rescue LoadError
   nil
@@ -24,7 +28,11 @@ module Chewy
         def check_requirements!
           messages = []
           messages << "MethodSource gem is required for the Witchcraft, please add `gem 'method_source'` to your Gemfile" unless Proc.method_defined?(:source)
-          messages << "Parser gem is required for the Witchcraft, please add `gem 'parser'` to your Gemfile" unless '::Parser'.safe_constantize
+          if RUBY_VERSION >= '3.3'
+            messages << "Prism gem is required for the Witchcraft, please add `gem 'prism'` to your Gemfile" unless '::Prism'.safe_constantize
+          else
+            messages << "Parser gem is required for the Witchcraft, please add `gem 'parser'` to your Gemfile" unless '::Parser'.safe_constantize
+          end
           messages << "Unparser gem is required for the Witchcraft, please add `gem 'unparser'` to your Gemfile" unless '::Unparser'.safe_constantize
           messages = messages.join("\n")
 
@@ -164,8 +172,7 @@ module Chewy
         end
 
         def source_for(proc, nesting)
-          ast = Parser::CurrentRuby.parse(proc.source)
-          lambdas = exctract_lambdas(ast)
+          lambdas = exctract_lambdas(ast_from_proc(proc))
 
           raise "No lambdas found, try to reformat your code:\n`#{proc.source}`" unless lambdas
 
@@ -192,6 +199,14 @@ module Chewy
           Unparser.unparse(source)
         end
 
+        def ast_from_proc(proc)
+          if defined?(Prism)
+            Prism::Translation::ParserCurrent.parse(proc.source)
+          else
+            Parser::CurrentRuby.parse(proc.source)
+          end
+        end
+
         def exctract_lambdas(node)
           return unless node.is_a?(Parser::AST::Node)
 

data/lib/chewy/version.rb

@@ -1,3 +1,3 @@
 module Chewy
-  VERSION = '8.0.0'.freeze
+  VERSION = '8.0.1'.freeze
 end

metadata

@@ -1,14 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: chewy
 version: !ruby/object:Gem::Version
-  version: 8.0.0
+  version: 8.0.1
 platform: ruby
 authors:
 - Toptal, LLC
 - pyromaniac
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -67,39 +68,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/CODEOWNERS"
-- ".github/ISSUE_TEMPLATE/bug_report.md"
-- ".github/ISSUE_TEMPLATE/feature_request.md"
-- ".github/PULL_REQUEST_TEMPLATE.md"
-- ".github/dependabot.yml"
-- ".github/workflows/ruby.yml"
-- ".gitignore"
-- ".rspec"
-- ".rubocop.yml"
-- ".rubocop_todo.yml"
-- ".yardopts"
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- Gemfile
-- Guardfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- chewy.gemspec
-- docker-compose.yml
-- docs/README.md
-- docs/configuration.md
-- docs/import.md
-- docs/indexing.md
-- docs/querying.md
-- docs/rake_tasks.md
-- docs/testing.md
-- docs/troubleshooting.md
-- filters
-- gemfiles/base.gemfile
-- gemfiles/rails.7.2.activerecord.gemfile
-- gemfiles/rails.8.0.activerecord.gemfile
 - lib/chewy.rb
 - lib/chewy/config.rb
 - lib/chewy/elastic_client.rb
@@ -210,114 +181,18 @@ files:
 - lib/generators/chewy/install_generator.rb
 - lib/generators/templates/chewy.yml
 - lib/tasks/chewy.rake
-- migration_guide.md
-- spec/chewy/config_spec.rb
-- spec/chewy/elastic_client_spec.rb
-- spec/chewy/fields/base_spec.rb
-- spec/chewy/fields/root_spec.rb
-- spec/chewy/fields/time_fields_spec.rb
-- spec/chewy/index/actions_spec.rb
-- spec/chewy/index/adapter/active_record_spec.rb
-- spec/chewy/index/adapter/object_spec.rb
-- spec/chewy/index/aliases_spec.rb
-- spec/chewy/index/import/bulk_builder_spec.rb
-- spec/chewy/index/import/bulk_request_spec.rb
-- spec/chewy/index/import/journal_builder_spec.rb
-- spec/chewy/index/import/routine_spec.rb
-- spec/chewy/index/import_spec.rb
-- spec/chewy/index/mapping_spec.rb
-- spec/chewy/index/observe/active_record_methods_spec.rb
-- spec/chewy/index/observe/callback_spec.rb
-- spec/chewy/index/observe_spec.rb
-- spec/chewy/index/settings_spec.rb
-- spec/chewy/index/specification_spec.rb
-- spec/chewy/index/syncer_spec.rb
-- spec/chewy/index/witchcraft_spec.rb
-- spec/chewy/index/wrapper_spec.rb
-- spec/chewy/index_spec.rb
-- spec/chewy/journal_spec.rb
-- spec/chewy/minitest/helpers_spec.rb
-- spec/chewy/minitest/search_index_receiver_spec.rb
-- spec/chewy/multi_search_spec.rb
-- spec/chewy/rake_helper_spec.rb
-- spec/chewy/repository_spec.rb
-- spec/chewy/rspec/build_query_spec.rb
-- spec/chewy/rspec/helpers_spec.rb
-- spec/chewy/rspec/update_index_spec.rb
-- spec/chewy/runtime/version_spec.rb
-- spec/chewy/runtime_spec.rb
-- spec/chewy/search/loader_spec.rb
-- spec/chewy/search/pagination/kaminari_examples.rb
-- spec/chewy/search/pagination/kaminari_spec.rb
-- spec/chewy/search/parameters/aggs_spec.rb
-- spec/chewy/search/parameters/bool_storage_examples.rb
-- spec/chewy/search/parameters/collapse_spec.rb
-- spec/chewy/search/parameters/docvalue_fields_spec.rb
-- spec/chewy/search/parameters/explain_spec.rb
-- spec/chewy/search/parameters/filter_spec.rb
-- spec/chewy/search/parameters/hash_storage_examples.rb
-- spec/chewy/search/parameters/highlight_spec.rb
-- spec/chewy/search/parameters/ignore_unavailable_spec.rb
-- spec/chewy/search/parameters/indices_spec.rb
-- spec/chewy/search/parameters/integer_storage_examples.rb
-- spec/chewy/search/parameters/knn_spec.rb
-- spec/chewy/search/parameters/limit_spec.rb
-- spec/chewy/search/parameters/load_spec.rb
-- spec/chewy/search/parameters/min_score_spec.rb
-- spec/chewy/search/parameters/none_spec.rb
-- spec/chewy/search/parameters/offset_spec.rb
-- spec/chewy/search/parameters/order_spec.rb
-- spec/chewy/search/parameters/post_filter_spec.rb
-- spec/chewy/search/parameters/preference_spec.rb
-- spec/chewy/search/parameters/profile_spec.rb
-- spec/chewy/search/parameters/query_spec.rb
-- spec/chewy/search/parameters/query_storage_examples.rb
-- spec/chewy/search/parameters/request_cache_spec.rb
-- spec/chewy/search/parameters/rescore_spec.rb
-- spec/chewy/search/parameters/script_fields_spec.rb
-- spec/chewy/search/parameters/search_after_spec.rb
-- spec/chewy/search/parameters/search_type_spec.rb
-- spec/chewy/search/parameters/source_spec.rb
-- spec/chewy/search/parameters/storage_spec.rb
-- spec/chewy/search/parameters/stored_fields_spec.rb
-- spec/chewy/search/parameters/string_array_storage_examples.rb
-- spec/chewy/search/parameters/string_storage_examples.rb
-- spec/chewy/search/parameters/suggest_spec.rb
-- spec/chewy/search/parameters/terminate_after_spec.rb
-- spec/chewy/search/parameters/timeout_spec.rb
-- spec/chewy/search/parameters/track_scores_spec.rb
-- spec/chewy/search/parameters/track_total_hits_spec.rb
-- spec/chewy/search/parameters/version_spec.rb
-- spec/chewy/search/parameters_spec.rb
-- spec/chewy/search/query_proxy_spec.rb
-- spec/chewy/search/request_spec.rb
-- spec/chewy/search/response_spec.rb
-- spec/chewy/search/scrolling_spec.rb
-- spec/chewy/search_spec.rb
-- spec/chewy/stash_spec.rb
-- spec/chewy/strategy/active_job_spec.rb
-- spec/chewy/strategy/atomic_no_refresh_spec.rb
-- spec/chewy/strategy/atomic_spec.rb
-- spec/chewy/strategy/delayed_sidekiq_spec.rb
-- spec/chewy/strategy/lazy_sidekiq_spec.rb
-- spec/chewy/strategy/sidekiq_spec.rb
-- spec/chewy/strategy_spec.rb
-- spec/chewy_spec.rb
-- spec/spec_helper.rb
-- spec/support/active_record.rb
-- spec/support/class_helpers.rb
-- spec/support/fail_helpers.rb
 homepage: https://github.com/toptal/chewy
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -326,7 +201,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Elasticsearch ODM client wrapper
 test_files: []

data/.github/CODEOWNERS

@@ -1 +0,0 @@
-* @toptal/platform-foundation

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,39 +0,0 @@
----
-name: Bug Report
-about: Report an issue with Chewy you've discovered.
----
-
-*Be clear, concise and precise in your description of the problem.
-Open an issue with a descriptive title and a summary in grammatically correct,
-complete sentences.*
-
-*Use the template below when reporting bugs. Please, make sure that
-you're running the latest stable Chewy and that the problem you're reporting
-hasn't been reported (and potentially fixed) already.*
-
-*Before filing the ticket you should replace all text above the horizontal
-rule with your own words.*
-
---------
-
-## Expected behavior
-
-Describe here how you expected Chewy to behave in this particular situation.
-
-## Actual behavior
-
-Describe here what actually happened.
-
-## Steps to reproduce the problem
-
-This is extremely important! Providing us with a reliable way to reproduce
-a problem will expedite its solution.
-
-## Version Information
-
-Share here essential version information such as:
-
-* Chewy version
-* Elasticsearch version
-* Ruby version
-* Rails version

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +0,0 @@
----
-name: Feature Request
-about: Suggest new Chewy features or improvements to existing features.
----
-
-## Is your feature request related to a problem? Please describe.
-
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
-
-## Describe the solution you'd like
-
-A clear and concise description of what you want to happen.
-
-## Describe alternatives you've considered
-
-A clear and concise description of any alternative solutions or features you've considered.
-
-## Additional context
-
-Add any other context or screenshots about the feature request here.

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,16 +0,0 @@
-**Replace this text with a summary of the changes in your PR.
-The more detailed you are, the better.**
-
------------------
-
-Before submitting the PR make sure the following are checked:
-
-* [ ] The PR relates to *only* one subject with a clear title and description in grammatically correct, complete sentences.
-* [ ] Wrote [good commit messages][1].
-* [ ] Commit message starts with `[Fix #issue-number]` (if the related issue exists).
-* [ ] Feature branch is up-to-date with `master` (if not - rebase it).
-* [ ] Squashed related commits together.
-* [ ] Added tests.
-* [ ] Added an entry to the changelog if the new code introduces user-observable changes. See [changelog entry format](https://github.com/toptal/chewy/blob/master/CONTRIBUTING.md#changelog-entry-format) for details.
-
-[1]: https://chris.beams.io/posts/git-commit/

data/.github/dependabot.yml

@@ -1,42 +0,0 @@
-version: 2
-registries:
-  toptal-github:
-    type: "git"
-    url: "https://github.com"
-    username: "x-access-token"
-    password: "${{secrets.DEPENDABOT_GITHUB_TOKEN}}"
-
-updates:
-  - package-ecosystem: bundler
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "wednesday"
-      time: "07:00"
-    pull-request-branch-name:
-      separator: "-"
-    labels:
-      - "no-jira"
-      - "ruby"
-      - "dependencies"
-    reviewers:
-      - "toptal/sre"
-    registries:
-      - toptal-github
-    insecure-external-code-execution: allow
-    open-pull-requests-limit: 3
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "weekly"
-      day: "wednesday"
-      time: "07:00"
-    pull-request-branch-name:
-      separator: "-"
-    labels:
-      - "no-jira"
-      - "dependencies"
-      - "gha"
-    reviewers:
-      - "toptal/sre"
-    open-pull-requests-limit: 3

data/.github/workflows/ruby.yml

@@ -1,61 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [master]
-  workflow_dispatch:
-  pull_request:
-    types: [
-      synchronize, # PR was updated
-      opened, # PR was open
-      reopened # PR was reopened
-    ]
-
-jobs:
-  ruby-3:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: [ '3.2', '3.3', '3.4' ]
-        gemfile: [rails.7.2.activerecord, rails.8.0.activerecord]
-    name: ${{ matrix.ruby }}-${{ matrix.gemfile }}
-
-    env:
-      BUNDLE_GEMFILE: gemfiles/${{ matrix.gemfile }}.gemfile
-
-    services:
-      redis:
-        # Docker Hub image
-        image: redis
-        ports:
-          - '6379:6379'
-        # Set health checks to wait until redis has started
-        options: >-
-          --health-cmd "redis-cli ping"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-    steps:
-      - uses: actions/checkout@v6
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-      - name: Start containers
-        run: |
-          docker compose up elasticsearch_test -d
-          sleep 15
-
-      - name: Tests
-        run: bundle exec rspec
-
-  rubocop:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: 3.4
-          bundler-cache: true
-      - run: bundle exec rubocop --format simple

data/.gitignore

@@ -1,22 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-gemfiles/*.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-.rvmrc
-_site
-.sass-cache
-file::memory:?cache=shared

data/.rspec

@@ -1,2 +0,0 @@
---color
---backtrace

data/.rubocop.yml

@@ -1,64 +0,0 @@
-inherit_from: .rubocop_todo.yml
-
-AllCops:
-  NewCops: enable
-  TargetRubyVersion: 3.2
-
-Layout/AccessModifierIndentation:
-  EnforcedStyle: outdent
-
-Layout/HashAlignment:
-  EnforcedLastArgumentHashStyle: always_ignore
-
-Layout/ParameterAlignment:
-  EnforcedStyle: with_fixed_indentation
-
-Layout/CaseIndentation:
-  EnforcedStyle: end
-
-Layout/EndAlignment:
-  EnforcedStyleAlignWith: variable
-
-Layout/FirstArrayElementIndentation:
-  EnforcedStyle: consistent
-
-Layout/FirstHashElementIndentation:
-  EnforcedStyle: consistent
-
-Layout/HeredocIndentation:
-  Enabled: false
-
-Layout/MultilineMethodCallIndentation:
-  EnforcedStyle: indented
-
-Layout/MultilineOperationIndentation:
-  EnforcedStyle: indented
-
-Layout/SpaceInsideHashLiteralBraces:
-  EnforcedStyle: no_space
-
-Lint/AmbiguousBlockAssociation:
-  Enabled: false
-
-Style/Alias:
-  EnforcedStyle: prefer_alias_method
-
-Style/AndOr:
-  EnforcedStyle: conditionals
-
-Style/DoubleNegation:
-  Enabled: false
-
-Metrics/BlockLength:
-  Exclude:
-    - '**/*_spec.rb'
-    - '**/*_examples.rb'
-    - '**/*.rake'
-
-Metrics/ModuleLength:
-  Exclude:
-    - 'lib/chewy/rake_helper.rb'
-    - '**/*_spec.rb'
-
-Style/ArgumentsForwarding:
-  Enabled: false