grape-active_model_serializers 1.2.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a7165b88d80b5bc264604cd516f0a02e8634a052
-  data.tar.gz: 4f2890224636b6e9afb95403cfe2a99dcc0ed5d7
+  metadata.gz: 5e9d5adc2e060c4ff6cb0ff20b716af5ac60b65f
+  data.tar.gz: 1175bcd15b520733dca73731304eb07c1ef41ff1
 SHA512:
-  metadata.gz: 71d51d264cd2b51ab7c301145d4ee7cc5a282bbb356dbe07dfb0355f3f50feb663c5a183bf45bfc55d8dfdd343f083965b539f0dc28a31f9fcf6469d2bf02e14
-  data.tar.gz: 4752dbab654717c0c5960d2aec3fbf4da4d65a7dbba2ef014027e8bf8ea75330f92dbd6f66d25e0e37707f620f573c0b324666984a98b120f60bbda1ed9227fc
+  metadata.gz: 2253fc66827baafc811df441f44e6d44119a19a6c5b3c926d3a643259a6cafe3059eb9cf2c9523a973900884093dd30ba374de6c178d333477462e67efc501d3
+  data.tar.gz: e5e75c33e502cd1b41d1e94ad2b9489cd26cc47f3dfff68e1692445d7366f61d1eb4bb91bd681bf5391b78dce23c315f1a93166790a9f99e77408a1b061a93f3

data/README.md

@@ -99,6 +99,16 @@ namespace 'foo', :serializer => :bar do
 end
 ```
 
+### Custom metadata along with the resources
+
+```ruby
+# Control any additional metadata using meta and meta_key
+get "/homes"
+  collection = Home.all
+  render collection, { meta: { page: 5, current_page: 3 }, meta_key: :pagination_info }
+end
+```
+
 ### current_user
 
 One of the nice features of ActiveModel::Serializers is that it

data/grape-active_model_serializers.gemspec

@@ -17,7 +17,7 @@ Gem::Specification.new do |gem|
   gem.licenses      = ['MIT']
 
   gem.add_dependency "grape", "~> 0.3"
-  gem.add_dependency "active_model_serializers", ">= 0.8.1"
+  gem.add_dependency "active_model_serializers", ">= 0.9.0.alpha1"
 
   gem.add_development_dependency "rspec"
   gem.add_development_dependency "rack-test"

data/lib/grape-active_model_serializers/endpoint_extension.rb

@@ -27,9 +27,26 @@ module Grape
       end
     end
 
+    def render(resources, meta={})
+      set_meta_and_meta_key(meta)
+      resources
+    end
+
     def default_serializer_options; end
+
     def url_options; end
-  end
 
+    private
+
+    def set_meta_and_meta_key(meta)
+      if meta.has_key?(:meta)
+        Formatter::ActiveModelSerializers.meta = meta[:meta]
+        if meta.has_key?(:meta_key)
+          Formatter::ActiveModelSerializers.meta_key = meta[:meta_key]
+        end
+      end
+    end
+
+  end
   Endpoint.send(:include, EndpointExtension)
 end

data/lib/grape-active_model_serializers/formatter.rb

@@ -16,11 +16,43 @@ module Grape
           endpoint = env['api.endpoint']
           options = build_options_from_endpoint(endpoint)
 
-          if resource.respond_to?(:to_ary) && !resource.empty?
+          if serializer = options.fetch(:serializer, ActiveModel::Serializer.serializer_for(resource))
+            options[:scope] = serialization_scope unless options.has_key?(:scope)
             # ensure we have an root to fallback on
-            endpoint.controller_name = default_root(endpoint)
+            options[:resource_name] = default_root(endpoint) if resource.respond_to?(:to_ary)
+            serializer.new(resource, options.merge(other_options))
           end
-          ::ActiveModel::Serializer.build_json(endpoint, resource, options)
+        end
+
+        def other_options
+          options = {}
+          if @meta_content_items
+            if @meta_key
+             key_option = @meta_key[:meta_key]
+              @meta_key.delete(:meta_key)
+              options[:meta_key] = key_option if key_option
+            end
+            meta_option = @meta_content_items[:meta]
+            @meta_content_items.delete(:meta)
+            options[key_option || :meta] = meta_option if meta_option
+          end
+          options
+        end
+
+        def meta
+          @meta_content_items || {}
+        end
+
+        def meta=(meta_content)
+          @meta_content_items = { meta: meta_content } if meta_content
+        end
+
+        def meta_key
+          @meta_key || {}
+        end
+
+        def meta_key=(key)
+          @meta_key = { meta_key: key } if key
         end
 
         def build_options_from_endpoint(endpoint)
@@ -38,6 +70,10 @@ module Grape
             endpoint.options[:path][0].to_s.split('/')[-1]
           end
         end
+
+        def serialization_scope
+          :current_user
+        end
       end
     end
   end

data/lib/grape-active_model_serializers/version.rb

@@ -1,5 +1,5 @@
 module Grape
   module ActiveModelSerializers
-    VERSION = '1.2.0'
+    VERSION = '1.2.1'
   end
 end

data/spec/features/grape-active_model_serializers/render_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+require 'support/models/user'
+require 'support/serializers/user_serializer'
+require 'grape-active_model_serializers'
+require 'securerandom'
+
+describe '#render' do
+  let(:app) { Class.new(Grape::API) }
+
+  before do
+    app.format :json
+    app.formatter :json, Grape::Formatter::ActiveModelSerializers
+  end
+
+  def get_resource_with(meta)
+    url = "/#{SecureRandom.hex}"
+    app.get(url) do
+      render User.new(first_name: 'Jeff'), meta
+    end
+    get url
+    JSON.parse last_response.body
+  end
+
+  context 'with meta key' do
+    it 'includes meta key and content' do
+      result = get_resource_with({ meta: { total: 2 }})
+      expect(result).to have_key('meta')
+      expect(result.fetch('meta')).to eq({ 'total' => 2 })
+    end
+  end
+
+  context 'with a custom meta_key' do
+
+    it 'includes the custom meta key name' do
+      result = get_resource_with({ meta: { total: 2 }, meta_key: :custom_key_name })
+      expect(result).to have_key('custom_key_name')
+      expect(result.fetch('custom_key_name')).to eq({ 'total' => 2 })
+    end
+
+    it 'ignores a lonely meta_key' do
+      result = get_resource_with({ meta_key: :custom_key_name })
+      expect(result).not_to have_key('meta')
+      expect(result).not_to have_key('custom_key_name')
+    end
+  end
+
+  context 'junk keys' do
+
+    it 'ignores junk keys' do
+      result = get_resource_with({ junk_key: { total: 2 } })
+      expect(result).not_to have_key('junk_key')
+    end
+
+    it 'ignores empty meta_key' do
+      result = get_resource_with({ meta: { total: 2 }, meta_key: nil })
+      expect(result).to have_key('meta')
+    end
+
+    it 'ignores empty meta' do
+      result = get_resource_with({ meta: nil })
+      expect(result).not_to have_key('meta')
+    end
+
+  end
+end

data/spec/grape-active_model_serializers/endpoint_extension_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe 'Grape::EndpointExtension' do
+
+  subject { Grape::Endpoint.new(nil, {path: '/', method: 'foo'}) }
+
+  let(:serializer) { Grape::Formatter::ActiveModelSerializers }
+
+  let(:user) do
+               Object.new do
+                 def name
+                   'sven'
+                 end
+               end
+             end
+
+  let(:users) { [user, user] }
+
+  describe "#render" do
+    it { should respond_to(:render) }
+    let (:meta_content) { { total: 2 } }
+    let (:meta_full) { { meta: meta_content } }
+    context 'supplying meta' do
+      it 'passes through the Resource and uses given meta settings' do
+        expect(serializer).to receive(:meta=).with(meta_content)
+        expect(subject.render(users, meta_full)).to eq(users)
+      end
+    end
+    context 'supplying meta and key' do
+      let (:meta_key) { { meta_key: :custom_key_name } }
+      it 'passes through the Resource and uses given meta settings' do
+        expect(serializer).to receive(:meta=).with(meta_content)
+        expect(serializer).to receive(:meta_key=).with(meta_key[:meta_key])
+        expect(subject.render(users, meta_full.merge(meta_key))).to eq(users)
+      end
+    end
+  end
+
+end

data/spec/grape-active_model_serializers/formatter_spec.rb

@@ -2,5 +2,33 @@ require 'spec_helper'
 require 'grape-active_model_serializers/formatter'
 
 describe Grape::Formatter::ActiveModelSerializers do
+  subject { Grape::Formatter::ActiveModelSerializers }
+  it { should respond_to(:meta) }
+  it { should respond_to(:meta=) }
+  it { should respond_to(:meta_key) }
+  it { should respond_to(:meta_key=) }
 
+  context '#meta' do
+    it 'will silently accept falsy input but return empty Hash' do
+      subject.meta = nil
+      expect(subject.meta).to eq({})
+    end
+
+    it 'will wrap valid input in the meta: {} wrapper' do
+      subject.meta = { total: 2 }
+      expect(subject.meta).to eq({ meta: { total: 2 } })
+    end
+  end
+
+  context '#meta_key' do
+    it 'will silently accept falsy input but return empty Hash' do
+      subject.meta_key = nil
+      expect(subject.meta_key).to eq({})
+    end
+
+    it 'will wrap valid input in the meta_key: {} wrapper' do
+      subject.meta_key = :custom_key_name
+      expect(subject.meta_key).to eq({ meta_key: :custom_key_name })
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: grape-active_model_serializers
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Jonathan Richard Henry Evans
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-05 00:00:00.000000000 Z
+date: 2014-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grape
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.9.0.alpha1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: 0.9.0.alpha1
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -129,6 +129,8 @@ files:
 - lib/grape-active_model_serializers/endpoint_extension.rb
 - lib/grape-active_model_serializers/formatter.rb
 - lib/grape-active_model_serializers/version.rb
+- spec/features/grape-active_model_serializers/render_spec.rb
+- spec/grape-active_model_serializers/endpoint_extension_spec.rb
 - spec/grape-active_model_serializers/formatter_spec.rb
 - spec/grape-active_model_serializers_spec.rb
 - spec/old_grape_ams_spec.rb
@@ -162,6 +164,8 @@ signing_key:
 specification_version: 4
 summary: Use active_model_serializer in grape
 test_files:
+- spec/features/grape-active_model_serializers/render_spec.rb
+- spec/grape-active_model_serializers/endpoint_extension_spec.rb
 - spec/grape-active_model_serializers/formatter_spec.rb
 - spec/grape-active_model_serializers_spec.rb
 - spec/old_grape_ams_spec.rb