Add renderer option to render relationship only.

Author: beauby

lib/jsonapi/renderer/document.rb

@@ -12,6 +12,7 @@ def initialize(params = {})
         @fields  = _symbolize_fields(params[:fields] || {})
         @jsonapi = params[:jsonapi]
         @include = JSONAPI::IncludeDirective.new(params[:include] || {})
+        @relationship = params[:relationship]
       end
 
       def to_hash
@@ -23,14 +24,18 @@ def to_hash
 
       def document_hash
         {}.tap do |hash|
-          if @data != :no_data
-            hash.merge!(data_hash)
-          elsif @errors.any?
-            hash.merge!(errors_hash)
+          if @relationship
+            hash.merge!(relationship_hash)
+          else
+            if @data != :no_data
+              hash.merge!(data_hash)
+            elsif @errors.any?
+              hash.merge!(errors_hash)
+            end
+            hash[:links] = @links if @links.any?
+            hash[:meta]  = @meta  unless @meta.nil?
           end
-          hash[:links]   = @links    if @links.any?
-          hash[:meta]    = @meta     unless @meta.nil?
-          hash[:jsonapi] = @jsonapi  unless @jsonapi.nil?
+          hash[:jsonapi] = @jsonapi unless @jsonapi.nil?
         end
       end
 
@@ -43,6 +48,31 @@ def data_hash
         end
       end
 
+      def relationship_hash
+        rel_name = @relationship.to_sym
+        data = @data.jsonapi_related([rel_name])[rel_name]
+        included =
+          if @include.key?(rel_name)
+            ResourcesProcessor.new(data, @include[rel_name], @fields)
+                              .process
+                              .flatten!
+          else
+            []
+          end
+
+        res = @data.as_jsonapi(fields: [rel_name], include: [rel_name])
+        rel = res[:relationships][rel_name]
+        links = (rel[:links] || {}).merge(@links)
+        meta  = (rel[:meta] || {}).merge(@meta || {})
+
+        {}.tap do |hash|
+          hash[:data]     = rel[:data]
+          hash[:included] = included if included.any?
+          hash[:links]    = links    if links.any?
+          hash[:meta]     = meta     unless meta.nil?
+        end
+      end
+
       def errors_hash
         {}.tap do |hash|
           hash[:errors] = @errors.flat_map(&:as_jsonapi)

spec/renderer_spec.rb

@@ -455,4 +455,104 @@ def as_jsonapi
 
     expect(actual).to eq(expected)
   end
+
+  context 'when rendering a relationship' do
+    it 'renders the linkage data only' do
+      actual = subject.render(data: @users[0], relationship: :posts)
+      expected = {
+        data: [{ type: 'posts', id: '2' }],
+        links: {
+          self: 'http://api.example.com/users/1/relationships/posts',
+          related: {
+            href: 'http://api.example.com/users/1/posts',
+            meta: {
+              do_not_use: true
+            }
+          }
+        },
+        meta: {
+          deleted_posts: 5
+        }
+      }
+
+      expect(actual).to eq(expected)
+    end
+
+    it 'renders supports include parameter' do
+      actual = subject.render(data: @users[0], relationship: :posts,
+                              include: 'posts.author')
+      actual_included = actual.delete(:included)
+
+      expected = {
+        data: [{ type: 'posts', id: '2' }],
+        links: {
+          self: 'http://api.example.com/users/1/relationships/posts',
+          related: {
+            href: 'http://api.example.com/users/1/posts',
+            meta: {
+              do_not_use: true
+            }
+          }
+        },
+        meta: {
+          deleted_posts: 5
+        }
+      }
+      expected_included = [
+        {
+          type: 'users',
+          id: '1',
+          attributes: {
+            name: 'User 1',
+            address: '123 Example st.'
+          },
+          relationships: {
+            posts: {
+              links: {
+                self: 'http://api.example.com/users/1/relationships/posts',
+                related: {
+                  href: 'http://api.example.com/users/1/posts',
+                  meta: {
+                    do_not_use: true
+                  }
+                }
+              },
+              meta: {
+                deleted_posts: 5
+              }
+            }
+          },
+          links: {
+            self: 'http://api.example.com/users/1'
+          },
+          meta: {
+            user_meta: 'is_meta'
+          }
+        },
+        {
+          type: 'posts',
+          id: '2',
+          attributes: {
+            title: 'Post 2',
+            date: 'today'
+          },
+          relationships: {
+            author: {
+              data: { type: 'users', id: '1' },
+              links: {
+                self: 'http://api.example.com/posts/2/relationships/author',
+                related: 'http://api.example.com/posts/2/author'
+              },
+              meta: {
+                author_active: true
+              }
+            }
+          }
+        }
+      ]
+
+      expect(actual).to eq(expected)
+      expect(actual_included).to match_array(expected_included)
+    end
+  end
 end