restpack-resource 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+*.gem
+*.db

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - "1.9.3"
+script: bundle exec rake test

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+group :test do
+  gem 'rake', '~> 10.0.3'
+  gem 'rspec', :require => 'spec'
+  gem 'datamapper', '~> 1.2.0'
+  gem 'dm-pager', '~> 1.1.0'
+  gem 'dm-sqlite-adapter', '~> 1.2.0'
+  gem 'factory_girl', '~> 4.2.0'
+end
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,95 @@
+PATH
+  remote: .
+  specs:
+    restpack-resource (0.0.1)
+      active_support (~> 3.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    active_support (3.0.0)
+      activesupport (= 3.0.0)
+    activesupport (3.0.0)
+    addressable (2.2.8)
+    bcrypt-ruby (3.0.1)
+    data_objects (0.10.12)
+      addressable (~> 2.1)
+    datamapper (1.2.0)
+      dm-aggregates (~> 1.2.0)
+      dm-constraints (~> 1.2.0)
+      dm-core (~> 1.2.0)
+      dm-migrations (~> 1.2.0)
+      dm-serializer (~> 1.2.0)
+      dm-timestamps (~> 1.2.0)
+      dm-transactions (~> 1.2.0)
+      dm-types (~> 1.2.0)
+      dm-validations (~> 1.2.0)
+    diff-lcs (1.1.3)
+    dm-aggregates (1.2.0)
+      dm-core (~> 1.2.0)
+    dm-constraints (1.2.0)
+      dm-core (~> 1.2.0)
+    dm-core (1.2.0)
+      addressable (~> 2.2.6)
+    dm-do-adapter (1.2.0)
+      data_objects (~> 0.10.6)
+      dm-core (~> 1.2.0)
+    dm-migrations (1.2.0)
+      dm-core (~> 1.2.0)
+    dm-pager (1.1.0)
+      dm-aggregates (>= 0.10.1)
+      dm-core (>= 0.10.1)
+    dm-serializer (1.2.2)
+      dm-core (~> 1.2.0)
+      fastercsv (~> 1.5)
+      json (~> 1.6)
+      json_pure (~> 1.6)
+      multi_json (~> 1.0)
+    dm-sqlite-adapter (1.2.0)
+      dm-do-adapter (~> 1.2.0)
+      do_sqlite3 (~> 0.10.6)
+    dm-timestamps (1.2.0)
+      dm-core (~> 1.2.0)
+    dm-transactions (1.2.0)
+      dm-core (~> 1.2.0)
+    dm-types (1.2.2)
+      bcrypt-ruby (~> 3.0)
+      dm-core (~> 1.2.0)
+      fastercsv (~> 1.5)
+      json (~> 1.6)
+      multi_json (~> 1.0)
+      stringex (~> 1.4)
+      uuidtools (~> 2.1)
+    dm-validations (1.2.0)
+      dm-core (~> 1.2.0)
+    do_sqlite3 (0.10.12)
+      data_objects (= 0.10.12)
+    factory_girl (4.2.0)
+      activesupport (>= 3.0.0)
+    fastercsv (1.5.5)
+    json (1.7.6)
+    json_pure (1.7.6)
+    multi_json (1.5.0)
+    rake (10.0.3)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.2)
+    rspec-expectations (2.12.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.2)
+    stringex (1.5.1)
+    uuidtools (2.1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  datamapper (~> 1.2.0)
+  dm-pager (~> 1.1.0)
+  dm-sqlite-adapter (~> 1.2.0)
+  factory_girl (~> 4.2.0)
+  rake (~> 10.0.3)
+  restpack-resource!
+  rspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 Gavin Joyce and RestPack contributors
+
+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,25 @@
+# restpack-resource [![Build Status](https://api.travis-ci.org/RestPack/restpack-resource.png?branch=master)](https://travis-ci.org/RestPack/restpack-resource) [![Code Climate](https://codeclimate.com/github/RESTpack/restpack-resource.png)](https://codeclimate.com/github/RESTpack/restpack-resource) [![Dependency Status](https://gemnasium.com/RestPack/restpack-resource.png)](https://gemnasium.com/RestPack/restpack-resource)
+
+RESTful resource paging, side-loading, filtering and sorting:
+
+```ruby
+class Group
+  include DataMapper::Resource
+  include RestPack::Resource
+
+  property :id, Serial
+  property :name, String, :length => 128
+  property :created_by, Integer, :required => true
+  property :channel_id, Integer, :required => true
+  timestamps :at
+
+  validates_presence_of :name, :channel_id
+  
+  has n, :invitations
+  has n, :memberships
+  
+  resource_can_include :memberships, :invitations
+  resource_can_filter_by :channel_id, :created_by
+  resource_can_sort_by :id
+end
+```

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+
+task :default => :test
+task :test => :spec
+
+begin
+  require "rspec/core/rake_task"
+
+  desc "Run all specs"
+  RSpec::Core::RakeTask.new(:spec) do |t|
+    t.rspec_opts = ['-cfs']
+  end
+rescue LoadError
+end

data/lib/restpack-resource/resource/filterable.rb

@@ -0,0 +1,22 @@
+require 'active_support/core_ext/hash'
+
+module RestPack
+  module Resource
+    module Filterable
+      def resource_filterable_by
+        @resource_filterable_by || []
+      end
+      def resource_filterable_by=(columns)
+        @resource_filterable_by = columns
+      end
+      def resource_can_filter_by(*columns)
+        self.resource_filterable_by += columns
+      end
+      def resource_validate_filters!(filters)
+        filters.keys.each do |filter|
+          raise InvalidFilter.new unless self.resource_filterable_by.include?(filter)
+        end
+      end
+    end
+  end
+end

data/lib/restpack-resource/resource/includable.rb

@@ -0,0 +1,24 @@
+require 'active_support/core_ext/hash'
+
+module RestPack
+  module Resource
+    module Includable
+      def resource_includable_associations
+        @resource_includable_associations || []
+      end
+      def resource_includable_associations=(associations)
+        @resource_includable_associations = associations
+      end
+      def resource_can_include(*associations)
+        self.resource_includable_associations += associations
+      end
+      def resource_validate_includes!(includes)
+        includes.each do |include|
+          unless self.resource_includable_associations.include?(include)
+            raise InvalidInclude, "#{self.name}.#{include} is not an includable relation"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/restpack-resource/resource/pageable.rb

@@ -0,0 +1,114 @@
+require 'active_support/core_ext/hash'
+
+module RestPack
+  module Resource
+    module Pageable      
+      def paged_resource(params = {}, overrides = {})
+        options = build_options(params, overrides)
+        get_paged_resource(options)
+      end
+      
+      protected
+      
+      def get_paged_resource(options)
+        page = get_page(options)        
+
+        paged_resource = {
+          :page => page.pager.current_page,
+          :page_count => page.pager.total_pages,
+          :total => page.pager.total,
+          :previous_page => page.pager.previous_page,
+          :next_page => page.pager.next_page
+        }
+
+        paged_resource[self.resource_collection_name] = page.map { |item| item.to_resource() }
+
+        unless page.empty?
+          options[:includes].each do |association|
+            paged_resource[association] = side_load(page, association)
+          end
+        end
+
+        paged_resource
+      end
+      
+      def get_page(options)
+        order = options[:sort_by]
+        order = order.desc if order && options[:sort_direction] == :descending
+        
+        options[:scope].all(:conditions => options[:filters]).page(options[:page], :order => order)
+      end
+      
+      def side_load(page, association)
+        target_model_name = association.to_s.singularize.capitalize              
+        relationships = self.relationships.select {|r| r.target_model.to_s == target_model_name }
+        raise InvalidInclude if relationships.empty?
+
+        side_loaded_entities = []
+
+        relationships.each do |relationship|
+          unless relationship.is_a? DataMapper::Associations::ManyToOne::Relationship
+            raise InvalidInclude, "#{self.name}.#{relationship.name} can't be included when paging #{self.name.pluralize.downcase}"
+          end
+          side_loaded_entities += page.map do |entity| #TODO: GJ: PERF: we can bypass datamapper associations and get by a list of ids instead
+            relation = entity.send(relationship.name.to_sym)
+            relation ? relation.to_resource : nil
+          end
+          side_loaded_entities.uniq!
+          side_loaded_entities.compact!
+        end
+        
+        side_loaded_entities
+      end
+      
+      def resource_collection_name
+        self.name.to_s.downcase.pluralize.to_sym
+      end
+      
+      def build_options(params, overrides)        
+        options = overrides.reverse_merge( #overrides take precedence over params
+          :page => params[:page],
+          :includes => params[:includes].nil? ? [] : params[:includes].split(','),
+          :filters =>  self.extract_filters_from_params(params),
+          :sort_by => params[:sort_by], 
+          :sort_direction => params[:sort_direction]
+        )
+        
+        options.reverse_merge!( #defaults
+          :scope => self.all,
+          :page => 1,
+          :includes => [],
+          :filters => {},
+          :sort_by => nil,
+          :sort_direction => :ascending
+        )
+
+        resource_normalise_options!(options)
+        resource_validate_options!(options)
+        
+        options
+      end
+      
+      def extract_filters_from_params(params)
+        extracted = params.extract!(*self.resource_filterable_by)
+        extracted.delete_if { |k, v| v.nil? }
+      end
+      
+      private
+      
+      def resource_normalise_options!(options)
+        options[:includes].map!{|i| i.to_sym}
+        
+        [:sort_by, :sort_direction].each do |attribute|
+          options[attribute] = options[attribute].to_sym if options[attribute]
+        end
+      end
+      
+      def resource_validate_options!(options)
+        self.resource_validate_includes! options[:includes]
+        self.resource_validate_filters! options[:filters]
+        self.resource_validate_sort_by! options[:sort_by]
+      end
+    end
+  end
+end

data/lib/restpack-resource/resource/sortable.rb

@@ -0,0 +1,20 @@
+require 'active_support/core_ext/hash'
+
+module RestPack
+  module Resource
+    module Sortable
+      def resource_sortable_by
+        @resource_sortable_by || []
+      end
+      def resource_sortable_by=(columns)
+        @resource_sortable_by = columns
+      end
+      def resource_can_sort_by(*columns)
+        self.resource_sortable_by += columns
+      end
+      def resource_validate_sort_by!(sort_by)
+        raise InvalidSortBy.new unless sort_by.nil? || self.resource_sortable_by.include?(sort_by)
+      end
+    end
+  end
+end

data/lib/restpack-resource/resource.rb

@@ -0,0 +1,28 @@
+%w{pageable filterable sortable includable}.each {|m| require "restpack-resource/resource/#{m}" }
+
+module RestPack
+    module Resource
+    class InvalidInclude < Exception; end
+    class InvalidFilter < Exception; end
+    class InvalidSortBy < Exception; end
+    
+    def self.included(base)
+      base.extend(ClassMethods)
+      base.extend(RestPack::Resource::Pageable)
+      base.extend(RestPack::Resource::Filterable)
+      base.extend(RestPack::Resource::Sortable)
+      base.extend(RestPack::Resource::Includable)
+      super
+    end
+    
+    def to_resource(options = {})
+      self
+    end
+
+    module ClassMethods
+      def resource_single_resource(options = {})
+        
+      end
+    end
+  end
+end

data/lib/restpack-resource/version.rb

@@ -0,0 +1,5 @@
+module RestPack
+  module Resource
+    VERSION = "0.0.1"
+  end
+end

data/lib/restpack-resource.rb

@@ -0,0 +1,2 @@
+require 'restpack-resource/version'
+require 'restpack-resource/resource'

data/restpack-resource.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'restpack-resource/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "restpack-resource"
+  gem.version       = RestPack::Resource::VERSION
+  gem.authors       = ["Gavin Joyce"]
+  gem.email         = ["gavinjoyce@gmail.com"]
+  gem.description   = %q{RESTful resource paging, side-loading, filtering and sorting}
+  gem.summary       = %q{...}
+  gem.homepage      = "https://github.com/RESTpack/restpack-resource"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  
+  gem.add_dependency 'active_support', '~> 3.0.0'
+  gem.add_development_dependency 'rspec', '~> 2.12'
+end

data/spec/factories.rb

@@ -0,0 +1,21 @@
+FactoryGirl.define do  
+  factory :user do
+    sequence(:name) {|n| "User #{n}" }
+  end
+  
+  factory :artist do
+    sequence(:name) {|n| "Artist #{n}" }
+  end
+  
+  factory :song do
+    sequence(:name) {|n| "Song #{n}" }
+    artist
+    association :creator, factory: :user
+    association :modifier, factory: :user
+  end
+  
+  factory :comment do
+    sequence(:test) {|n| "This is comment #{n}" }
+    song
+  end
+end

data/spec/resource/filterable_spec.rb

@@ -0,0 +1,25 @@
+require './spec/spec_helper'
+
+describe RestPack::Resource do
+  describe "#paged_resource" do 
+    context "when filtering" do      
+      context "with valid options" do
+        before(:each) do
+          @artist = create(:artist)
+          3.times { create(:song, artist: @artist) }
+          9.times { create(:song) }
+        end
+        
+        it "should return the total count" do
+          result = Song.paged_resource()
+          result[:total].should == 12
+        end
+        
+        it "should filter results" do
+          result = Song.paged_resource(artist_id: @artist.id)
+          result[:total].should == 3
+        end
+      end
+    end
+  end
+end

data/spec/resource/pageable_spec.rb

@@ -0,0 +1,90 @@
+require './spec/spec_helper'
+
+describe RestPack::Resource do
+  describe "#paged_resource" do
+    context "when paging" do
+      context "with no data" do
+        before(:each) do
+          Song.destroy
+        end
+
+        it "should return an empty array" do
+          result = Song.paged_resource()
+          result.should_not == nil
+          result[:songs].should_not == nil
+        end
+      end
+      
+      context "with data" do
+        before(:each) do
+          16.times { create(:song) }
+        end
+      
+        it "has a valid first page" do
+          result = Artist.paged_resource()
+          result[:page].should == 1
+          result[:total].should == 16
+          result[:page_count].should == 2
+          result[:previous_page].should == nil
+          result[:next_page].should == 2
+          result[:artists].size.should == 10
+        end
+      
+        it "has a valid second page" do
+          result = Artist.paged_resource(page: 2)
+          result[:page].should == 2
+          result[:previous_page].should == 1
+          result[:next_page].should == nil
+          result[:artists].size.should == 6
+        end
+      
+        context "when including relations" do        
+          it "should not allow invalid relations" do
+            expect do
+              Artist.paged_resource(:includes => 'invalid_relations')
+            end.to raise_error(RestPack::Resource::InvalidInclude, "Artist.invalid_relations is not an includable relation")
+          end
+        
+          it "should not allow includes that have not been specified with 'resource_can_include' NEW" do
+            expect do
+              Comment.paged_resource(:includes => 'songs')
+            end.to raise_error(RestPack::Resource::InvalidInclude, "Comment.songs is not an includable relation")
+          end
+        
+          it "should not allow a 'has_many' include when paging" do
+            expect do
+              Artist.paged_resource(:includes => 'songs')
+            end.to raise_error(RestPack::Resource::InvalidInclude, "Artist.songs can't be included when paging artists")
+          end
+        
+          it "should return related entities from a 'belongs_to' relationship" do
+            result = Song.paged_resource(:includes => 'artists')
+            result.should_not == nil
+            result[:artists].should_not == nil
+            result[:artists].size.should == 10
+          end
+        
+          it "should allow multiple includes" do
+            result = Song.paged_resource(:includes => 'artists,users')
+            result.should_not == nil
+            result[:artists].should_not == nil
+            result[:artists].size.should == 10
+            result[:users].size.should == 20
+          end
+        
+          it "should return related entities with their #to_resource representation" do
+            result = Song.paged_resource(:includes => 'users')
+            result[:users][0][:custom].should == 'This is custom data'
+          end
+        
+          context "when specifying overrides" do
+            it "should give overrides precidence" do
+              result = Artist.paged_resource({ page: 2 }, { page: 3 })
+              result[:page].should == 3
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/resource/resource_spec.rb

@@ -0,0 +1,50 @@
+require './spec/spec_helper'
+require './lib/restpack-resource'
+
+describe RestPack::Resource do
+  context "Resource Setup" do
+    before :each do
+      class MyModel
+        include DataMapper::Resource
+        include RestPack::Resource
+        property :id, Serial
+        property :name, String
+        property :age, Integer
+      end
+      DataMapper.auto_migrate!
+    end
+    
+    describe "#resource_can_include" do
+      it "allows association to be set" do
+        MyModel.resource_includable_associations.length == 0
+        class MyModel        
+          resource_can_include :association1
+          resource_can_include :association2, :association3
+        end
+        MyModel.resource_includable_associations.should == [:association1, :association2, :association3]
+      end
+    end
+  
+   describe "#resource_can_filter_by" do
+     it "allows filterable columns to be set" do
+       MyModel.resource_filterable_by.length == 0
+       class MyModel        
+         resource_can_filter_by :id
+         resource_can_filter_by :name, :age
+       end
+       MyModel.resource_filterable_by.should == [:id, :name, :age]
+     end
+   end
+  
+   describe "#resource_can_sort_by" do
+     it "allows sortable columns to be set" do
+       MyModel.resource_sortable_by.length == 0
+       class MyModel        
+         resource_can_sort_by :id
+         resource_can_sort_by :name, :age
+       end
+       MyModel.resource_sortable_by.should == [:id, :name, :age]
+     end
+   end
+  end
+end

data/spec/resource/sortable_spec.rb

@@ -0,0 +1,42 @@
+require './spec/spec_helper'
+
+describe RestPack::Resource do
+  describe "#paged_resource" do    
+    context "when sorting" do
+      context "with invalid options" do
+        it "should not allow invalid sort column" do
+          expect do
+            Artist.paged_resource(:sort_by => :invalid_column)
+          end.to raise_error(RestPack::Resource::InvalidSortBy)
+        end
+      end
+      
+      context "with valid options" do
+        before(:each) do
+          20.times { create(:artist) }
+        end
+        
+        it "should default to ascending" do
+          result = Artist.paged_resource(:sort_by => :id)
+          result[:total].should == Artist.count
+          result[:artists].first[:id].should == 1
+          result[:artists].last[:id].should == 10
+        end
+
+        it "should allow sort_direction of descending" do
+          result = Artist.paged_resource(:sort_by => :id, :sort_direction => :descending)
+          result[:total].should == Artist.count
+          result[:artists].first[:id].should == 20
+          result[:artists].last[:id].should == 11
+        end
+
+        it "should allow sort_by and sort_direction to be string or symbol" do
+          result = Artist.paged_resource(:sort_by => 'id', :sort_direction => 'descending')
+          result[:total].should == Artist.count
+          result = Artist.paged_resource(:sort_by => :id, :sort_direction => :descending)
+          result[:total].should == Artist.count
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,99 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup(:default, :test)
+
+require 'dm-core'
+require 'dm-timestamps'
+require 'dm-validations'
+require 'dm-aggregates'
+require 'dm-migrations'
+require 'dm-types'
+require 'dm-serializer'
+require 'dm-pager'
+require 'factory_girl'
+
+require './lib/restpack-resource'
+
+ENV["RACK_ENV"] ||= 'test'
+
+DataMapper.setup(:default, "sqlite3::memory:")
+DataMapper::Model.raise_on_save_failure = true 
+DataMapper::Pagination.defaults[:per_page] = 10
+
+
+class Artist
+  include DataMapper::Resource
+  include RestPack::Resource
+  property :id, Serial
+  property :name, String
+  #timestamps :at #NOTE: GJ: FactoryGirl is not saving when DM timestamps are used
+  
+  validates_presence_of :name
+  has n, :songs
+  
+  resource_can_include :songs
+  resource_can_sort_by :id, :name
+end
+
+class Song
+  include DataMapper::Resource
+  include RestPack::Resource
+  property :id, Serial
+  property :name, String
+  property :artist_id, Integer
+  property :created_by, Integer
+  property :modified_by, Integer
+  #timestamps :at
+
+  validates_presence_of :name
+  belongs_to :artist
+  belongs_to :creator, 'User', :child_key  => [ :created_by ]
+  belongs_to :modifier, 'User', :child_key  => [ :modified_by ]
+  has n, :comments
+  
+  resource_can_include :artists, :users
+  resource_can_filter_by :artist_id
+end
+
+class Comment
+  include DataMapper::Resource
+  include RestPack::Resource
+  property :id, Serial
+  property :song_id, Integer
+  property :text, String
+  #timestamps :at
+  
+  validates_presence_of :text
+  belongs_to :song
+end
+
+class User
+  include DataMapper::Resource
+  include RestPack::Resource
+  property :id, Serial
+  property :name, String
+  #timestamps :at
+  
+  def to_resource
+    {
+      id: id,
+      name: name,
+      custom: "This is custom data"
+    }
+  end
+end
+
+FactoryGirl.find_definitions
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.order = 'random'
+  
+  config.include FactoryGirl::Syntax::Methods
+  
+  config.before(:each) do
+    DataMapper.auto_migrate!
+  end
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification
+name: restpack-resource
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Gavin Joyce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: active_support
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.12'
+description: RESTful resource paging, side-loading, filtering and sorting
+email:
+- gavinjoyce@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- lib/restpack-resource.rb
+- lib/restpack-resource/resource.rb
+- lib/restpack-resource/resource/filterable.rb
+- lib/restpack-resource/resource/includable.rb
+- lib/restpack-resource/resource/pageable.rb
+- lib/restpack-resource/resource/sortable.rb
+- lib/restpack-resource/version.rb
+- restpack-resource.gemspec
+- spec/factories.rb
+- spec/resource/filterable_spec.rb
+- spec/resource/pageable_spec.rb
+- spec/resource/resource_spec.rb
+- spec/resource/sortable_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/RESTpack/restpack-resource
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ! '...'
+test_files:
+- spec/factories.rb
+- spec/resource/filterable_spec.rb
+- spec/resource/pageable_spec.rb
+- spec/resource/resource_spec.rb
+- spec/resource/sortable_spec.rb
+- spec/spec_helper.rb