Release version 0.2.0: Remove :grape_entity_preloader option functionality; update README for new usage methods and adjust CHANGELOG.

Author: OuYangJinTing

CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2025-10-14 UTC
+
+- ⚠️ [Broken] Remove `:grape_entity_preloader` option functionality, please use `Grape::Entity::Preloader.with_enable` or `Grape::Entity::Preloader.with_disable` instead.
+
 ## [0.1.0] - 2025-10-12 UTC
 
 - Initial release

README.md

@@ -33,21 +33,6 @@ Grape::Entity::Preloader.enabled!
 #### Local Activation and Deactivation
 
 You can control preloading for specific `represent` calls.
-
-##### 1. Using options
-
-Pass `grape_entity_preloader: :enabled` or `grape_entity_preloader: :disabled` to the options hash. This overrides the global setting.
-
-```ruby
-# Locally enable
-MyEntity.represent(users, grape_entity_preloader: :enabled)
-
-# Locally disable
-MyEntity.represent(users, grape_entity_preloader: :disabled)
-```
-
-##### 2. Using a block
-
 For a specific block of code, you can use `with_enable` or `with_disable`. This is useful in contexts like API endpoints or middlewares.
 
 ```ruby

lib/grape/entity/preloader/entity.rb

@@ -10,11 +10,8 @@ module ClassMethods # rubocop:disable Style/Documentation
           def represent(objects, options = {})
             options = Grape::Entity::Options.new(options) unless options.is_a?(Grape::Entity::Options)
 
-            options[:grape_entity_preloader] ||= Preloader.enabled? ? :enabled : :disabled
-            Preloader.new(root_exposures, objects, options).call if options[:grape_entity_preloader] == :enabled
-            options[:grape_entity_preloader] = :finished
-
-            super(objects, options)
+            Preloader.new(root_exposures, objects, options).call if Preloader.enabled?
+            Preloader.with_disable { super(objects, options) }
           end
         end
       end

lib/grape/entity/preloader/version.rb

@@ -3,7 +3,7 @@
 module Grape
   class Entity
     class Preloader
-      VERSION = '0.1.0'
+      VERSION = '0.2.0'
     end
   end
 end

spec/n_plus_one_op_spec.rb

@@ -121,15 +121,15 @@
         }
 
         expect do
-          User::Entity.represent(users, options.dup)
+          User::Entity.represent(users, options)
         end.to make_database_queries(count: 1)
           .and make_database_queries(count: 1, matching: /user_books_by_association/)
 
         users.map(&:reload)
 
         options[:only] << { books_by_association: [:tags_by_association] }
         expect do
-          User::Entity.represent(users, options.dup)
+          User::Entity.represent(users, options)
         end.to make_database_queries(count: 2)
           .and make_database_queries(count: 1, matching: /user_books_by_association/)
           .and make_database_queries(count: 1, matching: /book_tags_by_association/)