transmutation 0.4.5 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39130469c67108ad173209647cc7462624e53c27a7d4e582c9a41d25cad18b22
-  data.tar.gz: dbbfaab64d02de0cd2614670b03abbd579e90845ec361f9e2bce7c1a579de788
+  metadata.gz: 5d1be90589a50f1187323dfcb572a25a5f50329a71da0550deb133c7529cc4cf
+  data.tar.gz: 7dd9f520d65308273d0207c70a7ebe6288417a8afd0b76f299b8e61da0621c45
 SHA512:
-  metadata.gz: 9501c5f696fed8cab886f52d4fdfa64a17e6bdd2166c0c6e86fbe2f045500baeb0128b2b72845b47efc2e99a86247196cb009e0e567686a5f67ab39dd16cf931
-  data.tar.gz: a2740709abf68970709355628e90b6ee7c37b0f590028001693b60aa066e763661cc887c3dc3961166af8dc5bdd53b162473b77c346dbd1c4895fafb2c7e2b69
+  metadata.gz: 1682f31fa475e292df1e01d1e2c1eba4d3fb91982aa28e7cecdbf41114f9099faf28ed5deefbc9bb331ba40bfbdec117e6970ff70861df0c9308850e46439a36
+  data.tar.gz: 370d427728ab870d602a43bb5dd809f5bc339e3513560259ad05c0aaf3617ea81c301221ec208d966d81312f824bf6b6ac6c0f402ff49bb4ccaec4dd1d6cfecc

data/Gemfile

@@ -17,3 +17,6 @@ gem "simplecov-lcov"
 gem "undercover"
 
 gem "pry"
+
+gem "gem-release", require: false
+gem "solargraph", require: false

data/lib/transmutation/serialization/lookup.rb

@@ -18,13 +18,13 @@ module Transmutation
       #   namespace: Api::V1::Admin::Detailed
       #   serializer: Chat::User
       #
-      #   This method will attempt to find a serializer defined in the following order:
+      #   # This method will attempt to find a serializer defined in the following order:
       #
-      #   - Api::V1::Admin::Detailed::Chat::UserSerializer
-      #   - Api::V1::Admin::Chat::UserSerializer
-      #   - Api::V1::Chat::UserSerializer
-      #   - Api::Chat::UserSerializer
-      #   - Chat::UserSerializer
+      #   # - Api::V1::Admin::Detailed::Chat::UserSerializer
+      #   # - Api::V1::Admin::Chat::UserSerializer
+      #   # - Api::V1::Chat::UserSerializer
+      #   # - Api::Chat::UserSerializer
+      #   # - Chat::UserSerializer
       def serializer_for(object, serializer: nil)
         serializer_name = serializer_name_for(object, serializer:)
 
@@ -65,14 +65,10 @@ module Transmutation
       end
 
       def serializer_namespace
-        return caller_namespace if @namespace.nil?
-        return @namespace       if @namespace.start_with?("::")
+        return @caller.namespace if @namespace.nil?
+        return @namespace        if @namespace.start_with?("::")
 
-        "#{caller_namespace}::#{@namespace}"
-      end
-
-      def caller_namespace
-        @caller_namespace ||= @caller.class.name.split("::")[...-1].join("::")
+        "#{@caller.namespace}::#{@namespace}"
       end
 
       def constantize_serializer!(namespace, name, object:)

data/lib/transmutation/serialization.rb

@@ -12,19 +12,18 @@ module Transmutation
     # @return [Transmutation::Serializer] The serialized object. This will respond to `#as_json` and `#to_json`.
     def serialize(object, namespace: nil, serializer: nil, depth: 0, max_depth: 1)
       if object.respond_to?(:map) && !object.respond_to?(:to_hash)
-        return object.map do |item|
-          serialize(item, namespace:, serializer:, depth:, max_depth:)
-        end
+        return object.map { |item| serialize(item, namespace:, serializer:, depth:, max_depth:) }
       end
 
-      lookup_serializer(object, namespace:, serializer:)
-        .new(object, depth:, max_depth:)
+      lookup_serializer(object, namespace:, serializer:).new(object, depth:, max_depth:)
     end
 
     # Lookup the serializer for the given object.
     #
     # This calls {Transmutation::Serialization::Lookup#serializer_for} to find the serializer for the given object.
     #
+    # This also caches the result for future lookups.
+    #
     # @param object [Object] The object to lookup the serializer for.
     # @param namespace [String, Symbol, Module] The namespace to lookup the serializer in.
     # @param serializer [String, Symbol, Class] The serializer to use.
@@ -32,7 +31,16 @@ module Transmutation
     # @return [Class<Transmutation::Serializer>] The serializer for the given object.
     #
     def lookup_serializer(object, namespace: nil, serializer: nil)
-      Lookup.new(self, namespace:).serializer_for(object, serializer:)
+      Serialization.cache[[self.namespace, object.class, namespace, serializer]] ||=
+        Lookup.new(self, namespace:).serializer_for(object, serializer:)
+    end
+
+    def self.cache
+      @cache ||= {}
+    end
+
+    def namespace
+      @namespace ||= self.class.name.split("::")[...-1].join("::")
     end
 
     private_class_method def self.included(base)

data/lib/transmutation/serializer.rb

@@ -44,7 +44,7 @@ module Transmutation
       # Define an attribute to be serialized
       #
       # @param attribute_name [Symbol] The name of the attribute to serialize
-      # @param block [Proc] The block to call to get the value of the attribute
+      # @yield [object] The block to call to get the value of the attribute
       #   - The block is called in the context of the serializer instance
       #
       # @example
@@ -66,30 +66,28 @@ module Transmutation
       # @param association_name [Symbol] The name of the association to serialize
       # @param namespace [String, Symbol, Module] The namespace to lookup the association's serializer in
       # @param serializer [String, Symbol, Class] The serializer to use for the association's serialization
+      # @yield [object] The block to call to get the value of the association
+      #   - The block is called in the context of the serializer instance
+      #   - The return value from the block is automatically serialized
       #
       # @example
       #   class UserSerializer < Transmutation::Serializer
       #     association :posts
       #     association :comments, namespace: "Nested", serializer: "User::CommentSerializer"
+      #     association :archived_posts do
+      #       object.posts.archived
+      #     end
       #   end
-      def association(association_name, namespace: nil, serializer: nil)
+      def association(association_name, namespace: nil, serializer: nil, &custom_block)
         block = lambda do
-          serialize(
-            object.send(association_name),
-            namespace:,
-            serializer:,
-            depth: @depth + 1,
-            max_depth: @max_depth
-          )
+          association_instance = custom_block ? instance_exec(&custom_block) : object.send(association_name)
+
+          serialize(association_instance, namespace:, serializer:, depth: @depth + 1, max_depth: @max_depth)
         end
 
         attributes_config[association_name] = { block:, association: true }
       end
 
-      alias belongs_to association
-      alias has_one association
-      alias has_many association
-
       # Shorthand for defining multiple attributes
       #
       # @param attribute_names [Array<Symbol>] The names of the attributes to serialize
@@ -98,9 +96,9 @@ module Transmutation
       #   class UserSerializer < Transmutation::Serializer
       #     attributes :first_name, :last_name
       #   end
-      def attributes(*attribute_names)
+      def attributes(*attribute_names, **, &)
         attribute_names.each do |attribute_name|
-          attribute(attribute_name)
+          attribute(attribute_name, **, &)
         end
       end
 
@@ -112,11 +110,15 @@ module Transmutation
       #   class UserSerializer < Transmutation::Serializer
       #     associations :posts, :comments
       #   end
-      def associations(*association_names)
+      def associations(*association_names, **, &)
         association_names.each do |association_name|
-          association(association_name)
+          association(association_name, **, &)
         end
       end
+
+      alias belongs_to associations
+      alias has_one associations
+      alias has_many associations
     end
 
     private

data/lib/transmutation/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Transmutation
-  VERSION = "0.4.5"
+  VERSION = "0.5.1"
 end

data/lib/transmutation.rb

@@ -42,8 +42,8 @@ module Transmutation
 end
 
 require "zeitwerk"
-loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
-loader.ignore("#{__dir__}/transmutation/core_ext")
+
+loader = Zeitwerk::Loader.for_gem
 loader.setup
 
 require "active_support"

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: transmutation
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.5.1
 platform: ruby
 authors:
 - nitemaeric
 - borrabeer
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-24 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -39,7 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-description:
 email:
 - daniel@spellbook.tech
 - worapath.pakkavesa@spellbook.tech
@@ -75,7 +73,6 @@ metadata:
   source_code_uri: https://github.com/spellbook-technology/transmutation
   changelog_uri: https://github.com/spellbook-technology/transmutation/CHANGELOG.md
   documentation_uri: https://rubydoc.info/gems/transmutation
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -90,8 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Ruby JSON serialization library
 test_files: []