oj_serializers 3.0.1 → 3.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8bbb93696ca1b7eb5e3daac8a7a8eaaf2d66331733ae170a6d2d64f15520a0b7
-  data.tar.gz: 9356aad11f17a314aa66d7c99d6428b116ae0d7fcd8e36400b27175e428ab6f0
+  metadata.gz: a88e76c54a8ec84dbffa0f384167e6f33113160568263268f0db02ac6c1a9dcd
+  data.tar.gz: ce378f273475d3b4f26aaec1fc507f7fd0af291b19eec1598659572d7ac03120
 SHA512:
-  metadata.gz: 6dab9b921059a3ecc572f58ada7eca96e21c3cfed14ebd7ddc50ba5cd75631aa4621da1402e578b0239908c2268795b6cb449c8c4b41adf590426fc9e3c2b563
-  data.tar.gz: 4f68ba68ad0ee15585eff8150b87fc448931b3a2aab2aa55bc3aee7d6ca9800851fa46d94b6d20c27012e3f89829e19b979cbec8d993554039a7857f2e105468
+  metadata.gz: 05d212b7dd306c565146279cf86af2dbda1c756fc695e07a6d1dd415d9b7ba947e324cb1484bd70bf9c0a918e48fb616b0118df673af609868ef847888d5675d
+  data.tar.gz: 6aee49934b25a387d185ae24688b1929d1296b6f4985a82ecd224e7023f114e3ccd0b4b17458c4898f816491c245cddbff7f4507b2941180fac13d3753d4d0a9

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## Oj Serializers 3.0.2 (2026-08-28)
+
+### Features ✨
+
+- [feat: add `from` as the inverse of `as` for attribute definitions](https://github.com/ElMassimo/oj_serializers/pull/43)
+
 ## Oj Serializers 3.0.1 (2026-07-17)
 
 ### Fixes 🐞

data/README.md

@@ -283,6 +283,17 @@ class SongSerializer < Oj::Serializer
 end
 ```
 
+Alternatively, use `from` to write the mapping the other way around: the key on
+the left is the output name, and `from` names the source method or attribute.
+
+```ruby
+class SongSerializer < Oj::Serializer
+  # These two definitions are equivalent:
+  attributes name: {as: :label, type: :string}
+  attributes label: {from: :name, type: :string}
+end
+```
+
 ### Conditional attributes ❔
 
 You can render attributes and associations conditionally by using `:if`.

data/lib/oj_serializers/compat.rb

@@ -7,33 +7,33 @@ require 'active_model_serializers'
 class ActiveModel::Serializer
   # JsonStringEncoder: Used internally to write a single object to JSON.
   def self.one(object, options = nil)
-    new(object, options)
+    new(object, options || {})
   end
 
   # JsonStringEncoder: Used internally to write an array of objects to JSON.
   def self.many(array, options = nil)
-    array.map { |object| new(object, options) }
+    array.map { |object| new(object, options || {}) }
   end
 
   # OjSerializer: Used internally to write a single object association in :hash mode.
   #
   # Returns nothing.
   def self.one_as_hash(object, options = nil)
-    new(object)
+    new(object, options || {})
   end
 
   # OjSerializer: Used internally to write an association in :hash mode.
   #
   # Returns nothing.
   def self.many_as_hash(array, options = nil)
-    array.map { |object| new(object) }
+    array.map { |object| new(object, options || {}) }
   end
 
   # OjSerializer: Used internally to write a single object association in :json mode.
   #
   # Returns nothing.
   def self.write_one(writer, object, options = nil)
-    writer.push_value(new(object))
+    writer.push_value(new(object, options || {}))
   end
 
   # OjSerializer: Used internally to write an association in :json mode.
@@ -42,7 +42,7 @@ class ActiveModel::Serializer
   def self.write_many(writer, array, options = nil)
     writer.push_array
     array.each do |object|
-      write_one(writer, object)
+      write_one(writer, object, options)
     end
     writer.pop
   end

data/lib/oj_serializers/serializer.rb

@@ -444,7 +444,13 @@ protected
 
   private
 
-    def add_attribute(value_from, root: nil, as: nil, **options)
+    def add_attribute(value_from, root: nil, as: nil, from: nil, **options)
+      # `from` is the inverse of `as`: the definition key becomes the output name.
+      if from
+        as ||= value_from
+        value_from = from
+      end
+
       # Because it's so common, automatically mark id as an identifier.
       options[:identifier] = true if value_from == :id && !options.key?(:identifier)
 

data/lib/oj_serializers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OjSerializers
-  VERSION = '3.0.1'
+  VERSION = '3.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: oj_serializers
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.0.2
 platform: ruby
 authors:
 - Maximo Mussini