active_mappers 1.5.2 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a95ea925512e3657ad168bc4cc6afaeab5689bc9ec80102dbf49d696e414957f
-  data.tar.gz: 5b4a775f480aa38b2ef0a83d16096c157467d1e59e5a76b004114a3c589fbe51
+  metadata.gz: 43a75d246a1c97b9e8c31781bedf8e7893c58868b6dab6dce13aebf508d6b6a8
+  data.tar.gz: 569ee97b2c0db9f631012c7572e338df69795e86e0e7a5868b7867f7112ac38e
 SHA512:
-  metadata.gz: bf6455490ce818e13fe29d088c05e277223a44fbc84bc3e60496300f17acb5be7d03a321783235f5b14ce1e5d71aa817132e2f40f4b389e52a2330ceee8f0079
-  data.tar.gz: 4635133599db4ac2d6da88da02c6bdd2de64cd521a45f0c270a6e943630a6ce7cf13a3bbf9cf2c8337d199e7d96de3e006c9c4a09a493a97729d0a514fdb6692
+  metadata.gz: 22132e79ffeb517b0e163148972248bb4524e79d5e4a6827e0d91057410f7a463856613aff6a2932196a3ef09276c27aed963af6f0dcf428d4a2fb49560dc0da
+  data.tar.gz: eda34e0f9ec6a58a473abbfcfc9c4fcdc22f58b7b371327d56eabff76dd9c198600cc6e386b9b776f073a6358b621f68a71cc1cc77d62be218409580dd610a6d

data/Gemfile.lock

@@ -1,12 +1,12 @@
 PATH
   remote: .
   specs:
-    active_mappers (1.5.0)
+    active_mappers (1.5.3)
       activesupport (>= 4.2)
-      method_source (~> 0.9.2)
+      method_source (>= 0.9.2)
       mocha (>= 1.8.0)
       ruby2ruby (> 2.4.0)
-      ruby_parser (~> 3.1)
+      ruby_parser (>= 3.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -316,6 +316,34 @@ end
 RewardMapper.with(reward, context: user)
 ```
 
+The context is **propagated to nested mappers**, both through `relation` and through
+`polymorphic`. A child mapper rendered as a relation therefore sees the same context as
+its parent, without having to walk back up the association:
+
+```ruby
+class TicketMapper < ActiveMappers::Base
+  relation :pictures, PictureMapper
+end
+
+class PictureMapper < ActiveMappers::Base
+  each do |picture, context|
+    { uri: picture.uri_for(context[:app]) }   # => 'scan_reduc'
+  end
+end
+
+TicketMapper.with(ticket, context: { app: 'scan_reduc' })
+```
+
+A context declared on the relation itself wins over the parent's — the parent's is only a
+default:
+
+```ruby
+relation :pictures, PictureMapper, context: { app: 'always_this_one' }
+```
+
+> Before 1.6.0, `relation` did not forward the context (`polymorphic` already did), so a
+> nested mapper always received `nil`.
+
 ### Scope
 
 ActiveMappers does not yet support inheritance. However we provide an even better alternative named `scope`.

data/active_mappers.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name        = 'active_mappers'
-  s.version     = '1.5.2'
-  s.date        = '2024-01-26'
+  s.version     = '1.6.0'
+  s.date        = '2026-09-25'
   s.summary     = 'Slick, fast view layer for you Rails API.'
   s.description = 'Fast, simple, declarative way to design your API\'s view layer'
   s.authors     = ['Michaël Villeneuve', 'Loïc SENCE']
@@ -13,8 +13,8 @@ Gem::Specification.new do |s|
 
   s.license = 'MIT'
   s.add_runtime_dependency('activesupport', ['>= 4.2'])
-  s.add_runtime_dependency('method_source', ['~> 0.9.2'])
+  s.add_runtime_dependency('method_source', ['>= 0.9.2'])
   s.add_runtime_dependency('mocha', ['>= 1.8.0'])
   s.add_runtime_dependency('ruby2ruby', ['> 2.4.0'])
-  s.add_runtime_dependency('ruby_parser', ['~> 3.1'])
+  s.add_runtime_dependency('ruby_parser', ['>= 3.1'])
 end

data/lib/active_mappers.rb

@@ -3,6 +3,11 @@ require 'ruby2ruby'
 require 'ruby_parser'
 
 require 'active_support'
+# ⚠️ `blank?` / `present?` sont utilisés par `with` : dans une application Rails ils
+# arrivent par le require complet d'ActiveSupport, mais en test ISOLÉ la gem ne charge que
+# ce qu'elle déclare — sans cette ligne, toute la suite tombait en
+# `NoMethodError: undefined method 'present?'`.
+require 'active_support/core_ext/object/blank'
 require 'active_support/core_ext/object/try'
 require 'active_support/core_ext/hash/except'
 require 'active_support/core_ext/string/inflections'
@@ -46,9 +51,21 @@ module ActiveMappers
       end
     end
 
+    # ⚠️ Le bloc capture `context` et le passe au mapper enfant. Sans ça, un mapper rendu
+    # comme relation recevait toujours `nil` — alors que `polymorphic` le propageait déjà :
+    # l'enfant ne pouvait donc pas savoir pour qui on rendait (app appelante, scope…), et
+    # la seule parade était de remonter au parent par l'association.
+    #
+    # ⚠️ Le contexte est ajouté SOUS `options`, pas par-dessus : un `context:` passé
+    # explicitement à la déclaration (`relation :x, Mapper, context: {...}`) reste
+    # prioritaire, et celui du parent ne sert que de défaut.
+    #
+    # ⚠️ On MERGE au lieu d'écrire `options[:context] = context` : `options` est capturé par
+    # la closure et partagé par TOUS les rendus de ce mapper. Le muter ferait fuiter le
+    # contexte d'un rendu à l'autre entre threads.
     def self.relation(key, mapper = nil, **options)
       path = options[:optional_path] || key
-      each do |resource|
+      each do |resource, context|
         mapper_to_use = if mapper
           mapper
         else
@@ -59,16 +76,17 @@ module ActiveMappers
 
         raise "'#{mapper_to_use.name}' should be a mapper" unless mapper_to_use.ancestors.map(&:to_s).include?("ActiveMappers::Base")
 
-        { key => mapper_to_use.with(path.to_s.split('.').inject(resource, :try), default_options.merge(options)) }
+        { key => mapper_to_use.with(path.to_s.split('.').inject(resource, :try), { context: context }.merge(default_options.merge(options))) }
       end
     end
 
     def self.polymorphic(key, **options)
       each do |resource, context|
-        options[:context] = context
+        # Même merge non mutant que `relation` : `options[:context] = context` mutait le
+        # hash capturé par la closure, partagé par tous les rendus de ce mapper.
         if polymorphic_resource = resource.send("#{key}_type")
           resource_mapper = "#{KeyTransformer.base_namespace(self)}::#{polymorphic_resource}Mapper".constantize
-          { key => resource_mapper.with(resource.send(key), default_options.merge(options)) }
+          { key => resource_mapper.with(resource.send(key), { context: context }.merge(default_options.merge(options))) }
         else
           {}
         end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_mappers
 version: !ruby/object:Gem::Version
-  version: 1.5.2
+  version: 1.6.0
 platform: ruby
 authors:
 - Michaël Villeneuve
 - Loïc SENCE
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2026-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -29,14 +28,14 @@ dependencies:
   name: method_source
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.9.2
 - !ruby/object:Gem::Dependency
@@ -71,14 +70,14 @@ dependencies:
   name: ruby_parser
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.1'
 description: Fast, simple, declarative way to design your API's view layer
@@ -102,7 +101,6 @@ homepage: https://github.com/fidme/active_mappers
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -117,8 +115,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.4
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Slick, fast view layer for you Rails API.
 test_files: []