railsful 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 287dbb619eaa2542331bdfe1c4dc85b167fd5d278ccb29d9e8c6efc9f7018f25
-  data.tar.gz: 76d078511d927554643d36f55b1180c145150d0ad57e66531b657a3f9b066954
+  metadata.gz: 5cd2f4395f88962e11a4335a4bf967c227211ecf1cd0ebc8a08f6a874e776789
+  data.tar.gz: fa6dd976d49839ac1ba66059338511e9531cdf07cedbba0d984024145b9b5d11
 SHA512:
-  metadata.gz: f5dbe0c90a4f3104bcac9b2eb41c289b4c3a11adff09884f020d5eaf0f5321290e8970d71ea084cb7a4798cf6bfd7d6da429a2a5e61339e6bdd1c427fb50a174
-  data.tar.gz: aec33b3ee51fcd7338a0e83b6306bdf2e42e9fd7bbd35ec4cefa9e0dc584506f7aaafc61c1dba37d61474786af67e9e7caf5c10dc1468f95167e2a45c04a4344
+  metadata.gz: 5b497801b60386efe403923d63ca2e77f0df7c899bec213dda0a332df117342d0dd92a1ad8e353bab72a478725afdb0249d674b646152a7b39b6ed3dd8c3aa17
+  data.tar.gz: 0ce44ea6f1a17ed26b9b3d7a77b1ac5e062365d2f13aa70190e1e4816cf00012c7c8594206b8ceb2fd70f2565e2603d6fa3a4c29eb91cb5f42fb20d78b5bce54

data/README.md

@@ -77,6 +77,17 @@ GET /some_module/users
 }
 ```
 
+If you want to use another serializer you can do this by specifying a
+`serializer` key inside the options:
+
+``` ruby
+render json: User.first, serializer: 'author'
+
+# or
+
+render json: User.first, serializer: AuthorSerializer
+```
+
 ### Deserialization
 For deserialization of jsonapi compliant request all controllers that
 inherit from `ActionController` can use the `#deserialized_params` method.

data/lib/railsful/serializer.rb

@@ -39,7 +39,7 @@ module Railsful
       return options unless renderable
 
       # Try to fetch the right serializer for given renderable.
-      serializer = serializer_for(renderable)
+      serializer = serializer_for(renderable, options)
 
       # When no serializer is found just pass the original options hash.
       return options unless serializer
@@ -49,12 +49,37 @@ module Railsful
     end
 
     # Find the right serializer for given object.
+    # First we will look if the options hash includes a serializer. If not,
+    # we try to guess the right serializer from the model/class name.
     #
-    # @param [ApplicationRecord, ActiveRecord::Relation]
+    # @param renderable [ApplicationRecord, ActiveRecord::Relation]
+    # @param options [Hash]
     # @return [Class] The serializer class.
     #
     # :reek:UtilityFunction
-    def serializer_for(renderable)
+    def serializer_for(renderable, options = {})
+      serializer_by_options(options) || serializer_by_renderable(renderable)
+    end
+
+    # Check the options hash for a serializer key.
+    #
+    # @return [Class] The serializer class.
+    #
+    # :reek:UtilityFunction
+    def serializer_by_options(options)
+      serializer = options[:serializer]
+      return unless serializer
+
+      # If the given serializer is a class return it.
+      return serializer if serializer.is_a? Class
+
+      "#{serializer.to_s.classify}Serializer".safe_constantize
+    end
+
+    # @return [Class] The serializer class.
+    #
+    # :reek:UtilityFunction
+    def serializer_by_renderable(renderable)
       # Get the class in order to find the right serializer.
       klass = if renderable.is_a?(ActiveRecord::Relation)
                 renderable.model.name

data/lib/railsful/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Railsful
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.0'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: railsful
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Henning Vogt
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-05-27 00:00:00.000000000 Z
+date: 2019-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: deep_merge