alba 3.11.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18b9be1d51ec5b7bed2d31fc59904a57c8dc7f4e24eb1a7cb6364a42ec8a27ec
-  data.tar.gz: 4112d0ace0fda10a9e6aee754e2b056b6488924fddbd5f12040652a2fcbbda75
+  metadata.gz: 0ec3b28fdf4ed9303e346f6dca7771480d8b9bba19dea65374b41a526e895c10
+  data.tar.gz: 1ca8398f44a505fbdfc7bc5df7b743de07e4dc6bcd7580bdff3dec0732278474
 SHA512:
-  metadata.gz: 7bee8581bad84469254b1282b3c81bdaf493be4f2c5ee1b31747b16f2908f4e2639d783ac9fa7e6f345b361117512f0ce4b208a81a2f000e05455d3bc875b08b
-  data.tar.gz: 6939052cd6b8ea09f23df209874c858aadc032193a0ab5729bd04d33bbf7d24e3223cc642494a0095ca4a8f7a4b182fdd4cbd4e9781c1d4689e205953c2ca2e7
+  metadata.gz: 0dd664193cc78874ac9e5e2630eaf201d172ce170137084041b65e8e683d95f435c4609df296b2f8b47b588219576e9e743473d83c0f7854a9e6ec6a25c0cce0
+  data.tar.gz: 3fc3dc98d059878f5f97e40c81999f0990ee96bb82848acc63cc5c0b49c4240bed2c1b17a077ac46d16754c1e603c6839617e1afa1e1185371885bdc9589955b

data/CHANGELOG.md

@@ -6,6 +6,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## 4.0.0 2026-08-28
+
+### Changed
+
+- Call #nil? on attribute values only when a nil handler is set [#546](https://github.com/okuramasafumi/alba/pull/546)
+
+### Removed
+
+- Remove the deprecated inference methods `Alba.enable_inference!`, `Alba.disable_inference!`, and `Alba.inferring`; use `Alba.inflector` and `Alba.inflector=` instead
+- Remove the deprecated `Alba.resource_with`; use `Alba.resource_for` instead
+- Remove deprecated support for overriding `Alba::Resource#attributes`; override `Alba::Resource#select` to filter attributes instead
+- Remove the deprecated `converter` and `collection_converter` serialization hooks
+- Remove the deprecated `select` keyword argument from `Alba::Resource#initialize`; the `Alba::Resource#select` filtering method remains available
+
 ## 3.11.0 2026-07-25
 
 ### Added

data/README.md

@@ -12,16 +12,6 @@
 
 Alba is a JSON serializer for Ruby, JRuby, and TruffleRuby.
 
-## IMPORTANT NOTICE
-
-Both version `3.0.0` and `2.4.2` contain important bug fix.
-~~However, version `3.0.0` has some bugs (see https://github.com/okuramasafumi/alba/issues/342).
-Until they get fixed, it's highly recommended to upgrade to version `2.4.2`.
-Dependabot and similar tools might create an automated Pull Request to upgrade to `3.0.0`, so it might be required to upgrade to `2.4.2` manually.~~
-Version `3.0.1` has been released so Ruby 3 users should upgrade to `3.0.1`.
-For Ruby 2 users, it's highly recommended to upgrade to `2.4.2`.
-Sorry for the inconvenience.
-
 ## TL;DR
 
 Alba allows you to do something like below.

data/lib/alba/resource.rb

@@ -51,13 +51,11 @@ module Alba
       # @param within [Alba::WITHIN_DEFAULT, Hash, Array, nil, false, true]
       #   determines what associations to be serialized. If not set, it serializes all associations.
       # @param with_traits [Symbol, Array<Symbol>, nil] specified traits
-      # @param select [Method] DEPRECATED noop
-      def initialize(object, params: EMPTY_HASH, within: WITHIN_DEFAULT, with_traits: nil, select: nil)
+      def initialize(object, params: EMPTY_HASH, within: WITHIN_DEFAULT, with_traits: nil)
         @object = object
         @params = params
         @within = within
         @with_traits = with_traits
-        warn '`select` keyword for Alba::Resource is deprecated', category: :deprecated, uplevel: 1 if select
         _setup
       end
 
@@ -127,10 +125,6 @@ module Alba
         end
       end
 
-      def deprecated_serializable_hash
-        Alba.collection?(@object) ? serializable_hash_for_collection : converter.call(@object)
-      end
-
       def serialize_with(hash)
         serialized_json = encode(hash)
         return serialized_json unless @_layout
@@ -167,18 +161,6 @@ module Alba
         end
       end
 
-      def deprecated_serializable_hash_for_collection
-        if @_collection_key
-          @object.to_h do |item|
-            k = item.public_send(@_collection_key)
-            key = Alba.regularize_key(k)
-            [key, converter.call(item)]
-          end
-        else
-          @object.each_with_object([], &collection_converter)
-        end
-      end
-
       # @return [String]
       def fetch_key
         k = Alba.collection?(@object) ? _key_for_collection : _key
@@ -210,23 +192,8 @@ module Alba
         @_transforming_root_key
       end
 
-      def converter
-        lambda do |obj|
-          attributes_to_hash(obj, {})
-        end
-      end
-
-      def collection_converter
-        lambda do |obj, a|
-          a << {}
-          h = a.last
-          attributes_to_hash(obj, h)
-          a
-        end
-      end
-
       def attributes_to_hash(obj, hash)
-        attributes.each do |key, attribute|
+        @_attributes.each do |key, attribute|
           set_key_and_attribute_body_from(obj, key, attribute, hash)
         rescue ::Alba::Error, FrozenError, TypeError
           raise
@@ -236,14 +203,6 @@ module Alba
         @with_traits.nil? ? hash : hash.merge!(hash_from_traits(obj))
       end
 
-      # This is default behavior for getting attributes for serialization
-      # Override this method to filter certain attributes
-      #
-      # @deprecated in favor of `select`
-      def attributes
-        @_attributes
-      end
-
       # Default implementation for selecting attributes
       # Override this method to filter attributes based on key and value
       def select(_key, _value, _attribute)
@@ -299,7 +258,7 @@ module Alba
                 else raise ::Alba::Error, "Unsupported type of attribute: #{attribute.class}"
                   # :nocov:
                 end
-        value.nil? && nil_handler ? instance_exec(obj, key, attribute, &nil_handler) : value
+        nil_handler && value.nil? ? instance_exec(obj, key, attribute, &nil_handler) : value
       end
 
       def fetch_attribute_from_object_and_resource(obj, attribute)
@@ -353,16 +312,8 @@ module Alba
       attr_reader(*INTERNAL_VARIABLES.keys)
 
       # This `method_added` is used for defining "resource methods"
-      def method_added(method_name) # rubocop:disable Metrics/MethodLength
+      def method_added(method_name)
         case method_name
-        when :collection_converter, :converter
-          warn "Defining ##{method_name} methods is deprecated", category: :deprecated, uplevel: 1
-          alias_method :serializable_hash_for_collection, :deprecated_serializable_hash_for_collection
-          private(:serializable_hash_for_collection)
-          alias_method :serializable_hash, :deprecated_serializable_hash
-          alias_method :to_h, :deprecated_serializable_hash
-        when :attributes
-          warn 'Overriding `attributes` is deprecated, use `select` instead.', category: :deprecated, uplevel: 1
         when :select
           @_select_arity = instance_method(:select).arity
         when :_setup # noop

data/lib/alba/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Alba
-  VERSION = '3.11.0'
+  VERSION = '4.0.0'
 end

data/lib/alba.rb

@@ -97,34 +97,6 @@ module Alba
       object.is_a?(Enumerable) && @non_collection_types.none? { |type| object.is_a?(type) }
     end
 
-    # Enable inference for key and resource name
-    #
-    # @param with [Symbol, Class, Module] inflector
-    #   When it's a Symbol, it sets inflector with given name
-    #   When it's a Class or a Module, it sets given object to inflector
-    # @deprecated Use {.inflector=} instead
-    def enable_inference!(with:)
-      Alba::Deprecation.warn('Alba.enable_inference! is deprecated. Use `Alba.inflector=` instead.')
-      @inflector = inflector_from(with)
-      @inferring = true
-    end
-
-    # Disable inference for key and resource name
-    #
-    # @deprecated Use {.inflector=} instead
-    def disable_inference!
-      Alba::Deprecation.warn('Alba.disable_inference! is deprecated. Use `Alba.inflector = nil` instead.')
-      @inferring = false
-      @inflector = nil
-    end
-
-    # @deprecated Use {.inflector} instead
-    # @return [Boolean] whether inference is enabled or not
-    def inferring
-      Alba::Deprecation.warn('Alba.inferring is deprecated. Use `Alba.inflector` instead.')
-      @inferring
-    end
-
     # Set an inflector
     #
     # @param inflector [Symbol, Class, Module] inflector
@@ -240,12 +212,6 @@ module Alba
       register_default_types
     end
 
-    # @deprecated Use resource_for instead
-    def resource_with(object, with: :inference, &block)
-      Kernel.warn('Alba.resource_with is deprecated. Use `Alba.resource_for` instead.')
-      _resource_for(object, with: with, &block)
-    end
-
     # Get a resource object from arguments
     # If block is given, it creates a resource class with the block
     # Otherwise, it behaves depending on `with` argument

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: alba
 version: !ruby/object:Gem::Version
-  version: 3.11.0
+  version: 4.0.0
 platform: ruby
 authors:
 - OKURA Masafumi