roar-contrib 0.0.1.alpha1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 21d28d530f3cc0618a39fd6a54a465371e3f0f07
+  data.tar.gz: a551b007d5df3fcf78fdd7dde7ab53b07237a1ac
+SHA512:
+  metadata.gz: 3e7315a588ab63d249f67022b3e7ed86cab7b55b894eb581e851b81078bcb8f84e2752bebb861e7711ded5ddaf29f19833564e1bdcdc0acbb0f20f546f995491
+  data.tar.gz: 16f7746c50492dabf6fc4781290717b917182c4401e14d7c2c8f0618b52efa652cfafe2aca3fea5804907fc40cac0f02fa8716a0a2f72bd4c09060dcb73b4599

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.3

data/CHANGES.md

@@ -0,0 +1,2 @@
+# 0.0.1.alpha1
+Initial alpha release of `roar-contrib`. Includes `CollectionRepresenter` and `PageRepresenter` for Decorators.

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ari Summer
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,228 @@
+# roar-contrib [![Build Status](https://travis-ci.org/summera/roar-contrib.svg?branch=master)](https://travis-ci.org/summera/roar-contrib)
+Collection of useful [Roar](https://github.com/apotonick/roar) contributions and extensions.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'roar-contrib'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install roar-contrib
+
+## Representers
+
+### Collections with Decorators
+When using Decorators, include `Roar::Contrib::Decorator::CollectionRepresenter` to create a Representer for a collection of resources.
+
+```ruby
+class SongRepresenter < Roar::Decorator
+  include Roar::JSON
+
+  property :name
+end
+
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+  include Roar::Contrib::Decorator::CollectionRepresenter
+end
+```
+
+This will create a collection (`songs` in this case) based on the name of the Representer, using the singular representer (SongRepresenter) to serialize each individual resource in the collection. Therefore, a **GET** request to `/songs` would give you:
+
+```json
+{
+  "songs": [
+    {
+      "name": "Thriller"
+    },
+    {
+      "name": "One More Time"
+    },
+    {
+      "name": "Good Vibrations"
+    }
+  ]
+}
+```
+
+If you need more custom behavior and want to define your own collection, you can do it like so:
+```ruby
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+
+  collection :top_songs,
+    :exec_context => :decorator,
+    :decorator => TopSong
+
+  def top_songs
+    represented
+  end
+end
+```
+
+### Pagination with Decorators
+Roar-contrib pagination works with either [will_paginate](https://github.com/mislav/will_paginate) or [Kaminari](https://github.com/amatsuda/kaminari). It is based on Nick Sutterer's [blog post](http://nicksda.apotomo.de/2012/05/ruby-on-rest-6-pagination-with-roar/). You must install one of these for roar-contrib pagination to work. In your Gemfile, include either
+
+```ruby
+gem 'will_paginate'
+```
+or
+```ruby
+gem 'kaminari'
+```
+
+To paginate, include `Roar::Contrib::Decorator::PageRepresenter` and define `page_url` in the paginated Representer like so:
+
+```ruby
+class SongRepresenter < Roar::Decorator
+  include Roar::JSON
+
+  property :name
+end
+
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+  include Roar::Contrib::Decorator::PageRepresenter
+
+  collection :songs,
+    :exec_context => :decorator,
+    :decorator => SongRepresenter
+
+  def songs
+    represented
+  end
+
+  # If using roar-rails, url helpers are also available here
+  def page_url(args)
+    "http://www.roar-contrib.com/songs?#{args.to_query}"
+  end
+end
+```
+
+
+As you may have guessed, you can combine the `CollectionRepresenter` and `PageRepresenter` to DRY up the example above. **Woot Woot!** :stuck_out_tongue_closed_eyes: :boom:
+
+```ruby
+class SongRepresenter < Roar::Decorator
+  include Roar::JSON
+
+  property :name
+end
+
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+  include Roar::Contrib::Decorator::PageRepresenter
+  include Roar::Contrib::Decorator::CollectionRepresenter
+
+  def page_url(args)
+    "http://www.roar-contrib.com/songs?#{args.to_query}"
+  end
+end
+```
+
+If you are using Rails, your controller(s) may look like the following...
+
+```ruby
+# Using will_paginate
+class SongsController < ActionController::Base
+  include Roar::Rails::ControllerAdditions
+  represents :json, Song
+
+  def index
+    @songs = Song.paginate :page => params[:page], :per_page => params[:per_page]
+
+    respond_with @songs
+  end
+end
+
+# Using Kaminari
+class SongsController < ActionController::Base
+  include Roar::Rails::ControllerAdditions
+  represents :json, Song
+
+  def index
+    @songs = Song.page(params[:page]).per params[:per_page]
+
+    respond_with @songs
+  end
+end
+```
+
+Now, a **GET** request to `/songs?page=3&per_page=1` would give you:
+
+```json
+{
+  "total_entries": 3,
+  "links": [
+    {
+      "rel": "self",
+      "href": "http://www.roar-contrib.com/songs?page=3&per_page=1"
+    },
+    {
+      "rel": "previous",
+      "href": "http://www.roar-contrib.com/songs?page=2&per_page=1"
+    }
+  ],
+  "songs": [
+    {
+      "name": "Good Vibrations"
+    }
+  ]
+}
+```
+
+You can define additional pagination properties in your response such as `per_page` provided by [will_paginate](https://github.com/mislav/will_paginate), or `limit_value` provided by [Kaminari](https://github.com/amatsuda/kaminari), by defining the property in your paginated representer.
+
+```ruby
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+  include Roar::Contrib::Decorator::PageRepresenter
+  include Roar::Contrib::Decorator::CollectionRepresenter
+
+  property :per_page # Only works with will_paginate
+
+  def page_url(args)
+    songs_url args
+  end
+end
+```
+
+Roar-contrib provides you with the following methods defined on the Decorator instance that work with either `will_paginate` or `Kaminari`:
+- `#current_page`
+- `#next_page`
+- `#previous_page`
+- `#per_page`
+- `#total_entries`
+
+You can use them as properties by telling Roar to execute the methods in the context of the Decorator.
+
+```ruby
+class SongsRepresenter < Roar::Decorator
+  include Roar::JSON
+  include Roar::Contrib::Decorator::PageRepresenter
+  include Roar::Contrib::Decorator::CollectionRepresenter
+
+  property :per_page, :exec_context => :decorator # Works with either will_paginate or Kaminari
+
+  def page_url(args)
+    songs_url args
+  end
+end
+```
+
+## Contributing
+Contributions welcome!! :smile:
+
+1. Fork it ( https://github.com/sweatshirtio/roar-contrib/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+task :default => [:test]
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.test_files = FileList['test/**/*_test.rb']
+  test.verbose = true
+end

data/lib/roar/contrib/decorator/collection_representer.rb

@@ -0,0 +1,32 @@
+require 'active_support/concern'
+require 'active_support/inflector'
+
+module Roar
+  module Contrib
+    module Decorator
+      module CollectionRepresenter
+        extend ActiveSupport::Concern
+
+        module ClassMethods
+          def resource_representer
+            (name.chomp('Representer').singularize << 'Representer').constantize
+          end
+
+          def represented_collection_name
+            name.demodulize.chomp('Representer').underscore.pluralize
+          end
+        end
+
+        included do
+          define_method represented_collection_name do
+            represented
+          end
+
+          collection represented_collection_name,
+            :exec_context => :decorator,
+            :decorator => resource_representer
+        end
+      end
+    end
+  end
+end

data/lib/roar/contrib/decorator/page_representer.rb

@@ -0,0 +1,74 @@
+require 'active_support/concern'
+require 'active_support/inflections'
+
+module Roar
+  module Contrib
+    module Decorator
+      module PageRepresenter
+        extend ActiveSupport::Concern
+
+        def page_url(args)
+          raise NotImplementedError
+        end
+
+        included do
+          # REVIEW: Should we include Hypermedia automatically or raise
+          #   an error if not included already?
+          include Roar::Hypermedia
+
+          def current_page
+            represented.current_page
+          end
+
+          def next_page
+            represented.next_page
+          end
+
+          # WillPaginate uses #per_page while Kaminari uses #limit_value
+          def per_page
+            per_page_method = represented.respond_to?(:per_page) ?
+              :per_page : :limit_value
+
+            represented.send per_page_method
+          end
+
+          # WillPaginate uses #previous_page while Kaminari uses #prev_page
+          def previous_page
+            previous_page_method = represented.respond_to?(:previous_page) ?
+              :previous_page : :prev_page
+
+            represented.send previous_page_method
+          end
+
+          # WillPaginate uses #total_entries while Kaminari uses #total_count
+          def total_entries
+            total_entries_method = represented.respond_to?(:total_entries) ?
+              :total_entries : :total_count
+
+            represented.send total_entries_method
+          end
+
+          property :total_entries, exec_context: :decorator
+
+          link :self do |opts|
+            page_url :page => current_page, :per_page => per_page
+          end
+
+          link :next do |opts|
+            page_url(
+              :page => next_page,
+              :per_page => per_page
+            ) if next_page
+          end
+
+          link :previous do |opts|
+            page_url(
+              :page => previous_page,
+              :per_page => per_page
+            ) if previous_page
+          end
+        end
+      end
+    end
+  end
+end

data/lib/roar/contrib/version.rb

@@ -0,0 +1,5 @@
+module Roar
+  module Contrib
+    VERSION = '0.0.1.alpha1'
+  end
+end

data/lib/roar-contrib.rb

@@ -0,0 +1,9 @@
+require 'roar/contrib/version'
+
+module Roar
+  module Contrib
+  end
+end
+
+require 'roar/contrib/decorator/collection_representer'
+require 'roar/contrib/decorator/page_representer'

data/roar-contrib.gemspec

@@ -0,0 +1,28 @@
+$:.push File.expand_path('../lib', __FILE__)
+require 'roar/contrib/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'roar-contrib'
+  spec.version       = Roar::Contrib::VERSION
+  spec.authors       = ['Ari Summer']
+  spec.email         = ['aribsummer@gmail.com']
+  spec.summary       = %q{Collection of useful Roar extensions.}
+  spec.description   = %q{Roar provides object-oriented representers to define nested REST API documents which can be rendered and parsed. Roar-contrib adds some useful extensions.}
+  spec.homepage      = 'https://github.com/summera/roar-contrib'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  spec.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'roar', '~> 1.0'
+  spec.add_runtime_dependency 'activesupport', '>= 3.0.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'minitest', '~> 5.4'
+  spec.add_development_dependency 'minitest-reporters', '~> 1.0'
+  spec.add_development_dependency 'will_paginate', '~> 3.0'
+  spec.add_development_dependency 'kaminari', '~> 0.16'
+end

data/test/decorator/collection_representer_test.rb

@@ -0,0 +1,30 @@
+require 'test_helper'
+require 'roar/decorator'
+
+class CollectionRepresenterTest < MiniTest::Spec
+  class SongRepresenter < Roar::Decorator
+    include Roar::JSON
+
+    property :name
+  end
+
+  class SongsRepresenter < Roar::Decorator
+    include Roar::JSON
+    include Roar::Contrib::Decorator::CollectionRepresenter
+  end
+
+  let(:songs) do
+    [
+      OpenStruct.new(:name => 'Thriller'),
+      OpenStruct.new(:name => 'One More Time'),
+      OpenStruct.new(:name => 'Good Vibrations')
+    ]
+  end
+
+  it 'renders a valid collection' do
+    SongsRepresenter
+      .prepare(songs)
+      .to_json
+      .must_equal '{"songs":[{"name":"Thriller"},{"name":"One More Time"},{"name":"Good Vibrations"}]}'
+  end
+end

data/test/decorator/page_representer_test.rb

@@ -0,0 +1,182 @@
+require 'test_helper'
+require 'roar/decorator'
+require 'active_support/core_ext/object/to_query'
+
+class PageRepresenterTest < MiniTest::Spec
+  let(:songs) do
+    [
+      OpenStruct.new(:name => 'Thriller'),
+      OpenStruct.new(:name => 'One More Time'),
+      OpenStruct.new(:name => 'Good Vibrations')
+    ]
+  end
+
+  class SongRepresenter < Roar::Decorator
+    include Roar::JSON
+
+    property :name
+  end
+
+  class SongsRepresenter < Roar::Decorator
+    include Roar::JSON
+    include Roar::Contrib::Decorator::PageRepresenter
+
+    collection :songs,
+      :exec_context => :decorator,
+      :decorator => SongRepresenter
+
+    def songs
+      represented
+    end
+
+    def page_url(args)
+      "http://www.roar-contrib.com/songs?#{args.to_query}"
+    end
+  end
+
+  describe 'without #page_url defined' do
+    class NotImplementedSongsRepresenter < Roar::Decorator
+      include Roar::JSON
+      include Roar::Contrib::Decorator::PageRepresenter
+
+      collection :songs,
+        :exec_context => :decorator,
+        :decorator => SongRepresenter
+
+      def songs
+        represented
+      end
+    end
+
+    it 'raises NotImplementedError' do
+      proc {
+        NotImplementedSongsRepresenter.prepare(songs.paginate()).to_json
+      }.must_raise NotImplementedError
+    end
+  end
+
+  describe 'without CollectionRepresenter' do
+    describe 'using WillPaginate' do
+      require "will_paginate/array"
+
+      it 'renders a paginated response with no previous or next page' do
+        SongsRepresenter
+          .prepare(songs.paginate())
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=1&per_page=30"}],"songs":[{"name":"Thriller"},{"name":"One More Time"},{"name":"Good Vibrations"}]}'
+      end
+
+      it 'renders a paginated response with a previous and next page' do
+        SongsRepresenter
+          .prepare(songs.paginate(:page => 2, :per_page => 1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"},{"rel":"next","href":"http://www.roar-contrib.com/songs?page=3&per_page=1"},{"rel":"previous","href":"http://www.roar-contrib.com/songs?page=1&per_page=1"}],"songs":[{"name":"One More Time"}]}'
+      end
+
+      it 'renders a paginated response with a previous and no next page' do
+        SongsRepresenter
+          .prepare(songs.paginate(:page => 3, :per_page => 1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=3&per_page=1"},{"rel":"previous","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"}],"songs":[{"name":"Good Vibrations"}]}'
+      end
+
+      it 'renders a paginated response with a next page and no previous page' do
+        SongsRepresenter
+          .prepare(songs.paginate(:page => 1, :per_page => 1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=1&per_page=1"},{"rel":"next","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"}],"songs":[{"name":"Thriller"}]}'
+      end
+    end
+
+    describe 'using Kaminari' do
+      require 'kaminari/config'
+      require 'kaminari/helpers/paginator'
+      require 'kaminari/models/page_scope_methods'
+      require 'kaminari/models/configuration_methods'
+      require 'kaminari/models/array_extension'
+
+      it 'renders a paginated response with no previous or next page' do
+        SongsRepresenter
+          .prepare(Kaminari.paginate_array(songs).page)
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=1&per_page=25"}],"songs":[{"name":"Thriller"},{"name":"One More Time"},{"name":"Good Vibrations"}]}'
+      end
+
+      it 'renders a paginated response with a previous and next page' do
+        SongsRepresenter
+          .prepare(Kaminari.paginate_array(songs).page(2).per(1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"},{"rel":"next","href":"http://www.roar-contrib.com/songs?page=3&per_page=1"},{"rel":"previous","href":"http://www.roar-contrib.com/songs?page=1&per_page=1"}],"songs":[{"name":"One More Time"}]}'
+      end
+
+      it 'renders a paginated response with a previous and no next page' do
+        SongsRepresenter
+          .prepare(Kaminari.paginate_array(songs).page(3).per(1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=3&per_page=1"},{"rel":"previous","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"}],"songs":[{"name":"Good Vibrations"}]}'
+      end
+
+      it 'renders a paginated response with a next page and no previous page' do
+        SongsRepresenter
+          .prepare(Kaminari.paginate_array(songs).page(1).per(1))
+          .to_json
+          .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=1&per_page=1"},{"rel":"next","href":"http://www.roar-contrib.com/songs?page=2&per_page=1"}],"songs":[{"name":"Thriller"}]}'
+      end
+    end
+  end
+
+  describe 'HAL' do
+    require "will_paginate/array"
+
+    class HalSongsRepresenter < Roar::Decorator
+      include Roar::JSON::HAL
+      include Roar::Contrib::Decorator::PageRepresenter
+
+      collection :songs,
+        :exec_context => :decorator,
+        :decorator => SongRepresenter
+
+      def songs
+        represented
+      end
+
+      def page_url(args)
+        "http://www.roar-contrib.com/songs?#{args.to_query}"
+      end
+    end
+
+    it 'renders a paginated response with no previous or next page' do
+      HalSongsRepresenter
+        .prepare(songs.paginate())
+        .to_json
+        .must_equal '{"total_entries":3,"_links":{"self":{"href":"http://www.roar-contrib.com/songs?page=1&per_page=30"}},"songs":[{"name":"Thriller"},{"name":"One More Time"},{"name":"Good Vibrations"}]}'
+    end
+  end
+
+  describe 'with CollectionRepresenter' do
+    require "will_paginate/array"
+
+    class TopSongRepresenter < Roar::Decorator
+      include Roar::JSON
+
+      property :name
+    end
+
+    class TopSongsRepresenter < Roar::Decorator
+      include Roar::JSON
+      include Roar::Contrib::Decorator::PageRepresenter
+      include Roar::Contrib::Decorator::CollectionRepresenter
+
+      def page_url(args)
+        "http://www.roar-contrib.com/songs?#{args.to_query}"
+      end
+    end
+
+    it 'renders a paginated response with no previous or next page' do
+      TopSongsRepresenter
+        .prepare(songs.paginate())
+        .to_json
+        .must_equal '{"total_entries":3,"links":[{"rel":"self","href":"http://www.roar-contrib.com/songs?page=1&per_page=30"}],"top_songs":[{"name":"Thriller"},{"name":"One More Time"},{"name":"Good Vibrations"}]}'
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,9 @@
+require 'minitest/autorun'
+require 'minitest/reporters'
+Minitest::Reporters.use!
+
+require 'ostruct'
+
+require 'roar/json'
+require 'roar/json/hal'
+require 'roar-contrib'

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: roar-contrib
+version: !ruby/object:Gem::Version
+  version: 0.0.1.alpha1
+platform: ruby
+authors:
+- Ari Summer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: roar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.4'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: will_paginate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: kaminari
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+description: Roar provides object-oriented representers to define nested REST API
+  documents which can be rendered and parsed. Roar-contrib adds some useful extensions.
+email:
+- aribsummer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGES.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/roar-contrib.rb
+- lib/roar/contrib/decorator/collection_representer.rb
+- lib/roar/contrib/decorator/page_representer.rb
+- lib/roar/contrib/version.rb
+- roar-contrib.gemspec
+- test/decorator/collection_representer_test.rb
+- test/decorator/page_representer_test.rb
+- test/test_helper.rb
+homepage: https://github.com/summera/roar-contrib
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Collection of useful Roar extensions.
+test_files:
+- test/decorator/collection_representer_test.rb
+- test/decorator/page_representer_test.rb
+- test/test_helper.rb