oj_serializers 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8fd87262444d89cfbbe11a1b6ae6201de6d71ed996edcd8a4a9ae224320ad7c
-  data.tar.gz: bfe507b6e02c01087d99381ab8ef971547e0062085eb4bfb9c9551ceb2796c18
+  metadata.gz: f1a6edc7a526ccc3e6edd655070c28a9c54f2fd38646aaf36bf4db0b58363f36
+  data.tar.gz: 5a2541b9005c35d1f4c68a0dc142691b35199c78e0e134f6cc44ad0cd6a3a8bc
 SHA512:
-  metadata.gz: 060b791a7d8c2f204adab9313873b950b89eb1a80400b26355b1382ab6e08d0efa3e48efeef1ececc96cb8f42729f8f4cea50b37d579ab1acc333b393b060c0d
-  data.tar.gz: a7ea8370d3155f8bfd99f9d1cffe67fe05f896930277a0e69a81b3e4eda2b0088a8901730ec2fb910e564dcf3f29ea3200f5cc70d8321dd1892b72c9f9b75bf4
+  metadata.gz: 4ee1d2c5e850cd14548dbf1219056f61b25be85a55a83107bc6cf695b991cb52bb54605c45c88aed18e3573e53c72f22bbedbfa7a2bd066e10a17d71a1e25bd1
+  data.tar.gz: f8454069164b46838efecc9652e5a56fa816a07e47e7ad1983be49147c469f2c58bcdb67ab54ebb59bbcdd381abe0ee7ff7240ca282f310e581fc8dc0a275a0f

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## Oj Serializers 2.0.2 (2023-04-02)
+
+### Features ✨
+
+- [Automatically remove `?` when using `transform_keys :camelize`](https://github.com/ElMassimo/oj_serializers/commit/79758a0)
+
+### Fixes 🐞
+
+- [Error when defining attributes with options](https://github.com/ElMassimo/oj_serializers/commit/680ab47)
+
 ## Oj Serializers 2.0.1 (2023-04-02)
 
 ### Features ✨

data/README.md

@@ -22,6 +22,8 @@ Faster JSON serializers for Ruby, built on top of the powerful [`oj`][oj] librar
 [sugar]: https://github.com/ElMassimo/oj_serializers/blob/main/lib/oj_serializers/sugar.rb#L14
 [migration guide]: https://github.com/ElMassimo/oj_serializers/blob/main/MIGRATION_GUIDE.md
 [design]: https://github.com/ElMassimo/oj_serializers#design-
+[associations]: https://github.com/ElMassimo/oj_serializers#associations-
+[compose]: https://github.com/ElMassimo/oj_serializers#composing-serializers-
 [raw_json]: https://github.com/ohler55/oj/issues/542
 [trailing_commas]: https://maximomussini.com/posts/trailing-commas/
 [render dsl]: https://github.com/ElMassimo/oj_serializers#render-dsl-
@@ -41,12 +43,12 @@ Learn more about [how this library achieves its performance][design].
 
 ## Features ⚡️
 
-- Declaration syntax [similar to Active Model Serializers][migration guide]
+- Intuitive declaration syntax, supporting mixins and inheritance
 - Reduced [memory allocation][benchmarks] and [improved performance][benchmarks]
-- Support for `has_one` and `has_many`, compose with `flat_one`
+- Generate [TypeScript interfaces automatically][types_from_serializers]
+- Support for [`has_one`][associations] and [`has_many`][associations], compose with [`flat_one`][compose]
 - Useful development checks to avoid typos and mistakes
-- Integrates nicely with Rails controllers
-- [Generate TypeScript interfaces automatically][types_from_serializers]
+- [Migrate easily from Active Model Serializers][migration guide]
 
 ## Installation 💿
 
@@ -155,6 +157,24 @@ class AlbumsController < ApplicationController
 end
 ```
 
+<details>
+  <summary>Active Model Serializers style</summary>
+
+```ruby
+require "oj_serializers/sugar" # In an initializer
+
+class AlbumsController < ApplicationController
+  def show
+    render json: album, serializer: AlbumSerializer
+  end
+  
+  def index
+    render json: albums, root: :albums, each_serializer: AlbumSerializer
+  end
+end
+```
+</details>
+
 ## Rendering 🖨
 
 Use `one` to serialize objects, and `many` to serialize enumerables:
@@ -170,7 +190,7 @@ Serializers can be rendered arrays, hashes, or even inside `ActiveModel::Seriali
 by using a method in the serializer, making it very easy to combine with other
 libraries and migrate incrementally.
 
-You can use `render` as a shortcut for `one` and `many`, but it might be less readable:
+`render` is a shortcut for `one` and `many`:
 
 ```ruby
 render json: {
@@ -378,6 +398,41 @@ It's easy for the backend and the frontend to become out of sync. Traditionally,
 
 As a result, it's posible to easily detect mismatches between the backend and the frontend, as well as make the fields more discoverable and provide great autocompletion in the frontend, without having to manually write the types.
 
+### Composing serializers 🧱
+
+There are three options to compose serializers: inheritance, mixins, and `flat_one`.
+
+Use `flat_one` to include all attributes from a different serializer:
+
+```ruby
+class AttachmentSerializer < BaseSerializer
+  identifier
+
+  class BlobSerializer < BaseSerializer
+    attributes :filename, :byte_size, :content_type, :created_at
+  end
+
+  flat_one :blob, serializer: BlobSerializer
+end
+```
+
+<details>
+  <summary>Example Output</summary>
+
+```ruby
+{
+  id: 5,
+  filename: "image.jpg,
+  byte_size: 256074,
+  content_type: "image/jpeg",
+  created_at: "2022-08-04T17:25:12.637-07:00",
+}
+```
+</details>
+
+This is especially convenient when using [`types_from_serializers`][types_from_serializers],
+as it enables automatic type inference for the included attributes.
+
 ### Memoization & local state
 
 Serializers are designed to be stateless so that an instanced can be reused, but
@@ -480,10 +535,8 @@ end
 This will change the default shortcuts (`render`, `one`, `one_if`, and `many`),
 so that the serializer writes directly to JSON instead of returning a Hash.
 
-> **Note**
->
-> This was the default behavior in `oj_serializers` v1, but was replaced with
-`default_format :hash` in v2.
+Even when using this mode, you can still use rendered values inside arrays,
+hashes, and other serializers, thanks to [the `raw_json` extensions][raw_json].
 
 <details>
   <summary>Example Output</summary>
@@ -569,9 +622,6 @@ so that the serializer writes directly to JSON instead of returning a Hash.
 ```
 </details>
 
-Even when using this mode, you can still use rendered values inside arrays,
-hashes, and other serializers, thanks to [the `raw_json` extensions][raw_json].
-
 ## Design 📐
 
 Unlike `ActiveModel::Serializer`, which builds a Hash that then gets encoded to

data/lib/oj_serializers/serializer.rb

@@ -126,7 +126,7 @@ protected
     # This setting is inherited from parent classes.
     def transform_keys(strategy = nil, &block)
       transformer = case (strategy ||= block)
-      when :camelize, :camel_case then ->(key) { key.camelize(:lower) }
+      when :camelize, :camel_case then ->(key) { key.camelize(:lower).chomp('?') }
       when :none then nil
       when Symbol then strategy.to_proc
       when Proc then strategy
@@ -376,7 +376,7 @@ protected
     #
     # See ./benchmarks/document_benchmark.rb
     def mongo_attributes(*attr_names, **options)
-      identifier(:_id, as: :id, attribute: :mongoid, **options) if attr_names.delete(:id)
+      identifier(:_id, as: :id, attribute: :mongoid, **options.slice(:if)) if attr_names.delete(:id)
       attributes(*attr_names, **options, attribute: :mongoid)
     end
 
@@ -392,6 +392,7 @@ protected
 
       methods_with_options.each do |attr_name, options|
         options = { as: options } if options.is_a?(Symbol)
+        options[:attribute] ||= attr_options[:attribute]
         add_attribute(attr_name, **options)
       end
     end

data/lib/oj_serializers/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: oj_serializers
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Maximo Mussini
@@ -68,7 +68,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.32
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: A lighter JSON serializer for Ruby Objects in Rails. Easily migrate away