fars 0.0.1

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/
+
+.ruby-*
+.rspec
+spec/config/database.yml

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in fars.gemspec
+gemspec
+
+gem 'pry-debugger'

data/Gemfile.lock

@@ -0,0 +1,80 @@
+PATH
+  remote: .
+  specs:
+    fars (0.0.1)
+      activerecord (>= 3.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (4.0.4)
+      activesupport (= 4.0.4)
+      builder (~> 3.1.0)
+    activerecord (4.0.4)
+      activemodel (= 4.0.4)
+      activerecord-deprecated_finders (~> 1.0.2)
+      activesupport (= 4.0.4)
+      arel (~> 4.0.0)
+    activerecord-deprecated_finders (1.0.3)
+    activesupport (4.0.4)
+      i18n (~> 0.6, >= 0.6.9)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    arel (4.0.2)
+    atomic (1.1.16)
+    builder (3.1.4)
+    coderay (1.1.0)
+    columnize (0.3.6)
+    database_cleaner (1.2.0)
+    debugger (1.6.6)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.3.2)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.3.2)
+    diff-lcs (1.2.5)
+    i18n (0.6.9)
+    method_source (0.8.2)
+    minitest (4.7.5)
+    multi_json (1.9.2)
+    pg (0.17.1)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-debugger (0.2.2)
+      debugger (~> 1.3)
+      pry (~> 0.9.10)
+    rake (10.1.1)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.8)
+    rspec-expectations (2.14.5)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.6)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.1.6)
+    shoulda-matchers (2.5.0)
+      activesupport (>= 3.0.0)
+    slop (3.5.0)
+    thread_safe (0.2.0)
+      atomic (>= 1.1.7, < 2)
+    tzinfo (0.3.39)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  database_cleaner
+  fars!
+  pg
+  pry-debugger
+  rake
+  rspec (>= 2.11)
+  shoulda

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Denis Yagofarov, Vitaliy Bezkrovny
+
+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
+NON INFRINGEMENT. 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,4 @@
+fars
+====
+
+Fast ActiveRecord Serializer

data/Rakefile

@@ -0,0 +1,7 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+
+Dir["#{File.dirname(__FILE__)}/spec/tasks/*.rake"].sort.each { |f| load f }

data/fars.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/fars/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ['Denyago', 'Lightpower']
+  gem.email         = ["bva@aejis.eu"]
+  gem.description   = %q{Fast ActiveRecord Serializer}
+  gem.summary       = "Gem provedes classes for fast serialisation of ActiveRecord relations."
+  gem.homepage      = "https://github.com/Lightpower/fars"
+
+  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.name          = "fars"
+  gem.require_paths = ["lib"]
+  gem.version       = Fars::VERSION
+
+  gem.add_dependency  'activerecord',  '>= 3.2'
+
+  gem.add_development_dependency 'rspec',        '>= 2.11'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'shoulda'
+  gem.add_development_dependency 'pg'
+  gem.add_development_dependency 'database_cleaner'
+
+end

data/lib/fars/base_collection_serializer.rb

@@ -0,0 +1,72 @@
+##
+# Class: BaseCollectionSerializer
+#
+# It is used to represent collections
+#
+class Fars::BaseCollectionSerializer
+  class << self
+    # Returns {String} capitalized API version
+    def api_version
+      namespace_array = name.split('::')
+      namespace_array.size > 1 ? namespace_array[0] : nil
+    end
+  end
+
+  def initialize(objects, opts={})
+    @objects      = objects
+    @scope        = opts[:scope]
+    @fields       = opts[:fields]
+    @add_metadata = opts[:add_metadata]
+    @root_key     = opts.fetch(:root_key, get_root_key)
+    @item_serializer_class = get_item_serializer_class
+  end
+
+  def as_json
+    items = []
+
+    the_class = item_serializer_class.new(
+      nil,
+      scope:        @scope,
+      add_metadata: add_metadata,
+      fields:       fields,
+      root_key:     get_instance_root_key,
+    )
+
+    objects.each do |object|
+      items << the_class.with_object(object).as_json
+    end
+
+    root_key ? {root_key => items} : items
+  end
+
+  def to_json
+    MultiJson.dump(as_json)
+  end
+
+  # Returns {String} - API version is got by instance class
+  def api_version
+    self.class.api_version
+  end
+
+private
+
+  attr_reader :objects, :scope, :fields, :add_metadata, :root_key, :item_serializer_class
+
+  def get_root_key
+    (self.to_s.match /#{api_prefix}(\w+)Serializer/)[1].underscore.to_sym
+  end
+
+  def get_instance_root_key
+    # If root_key is false, get a real one
+    (root_key || get_root_key).to_s.singularize.to_sym
+  end
+
+  def get_item_serializer_class
+    (self.class.to_s.gsub('Serializer', '').singularize + 'Serializer').constantize
+  end
+
+  # Returns {String} prefix for serializer class name using API version
+  def api_prefix
+    api_version ? api_version + '::' : ''
+  end
+end

data/lib/fars/base_model_serializer.rb

@@ -0,0 +1,231 @@
+##
+# Class: BaseModelSerializer
+#
+# Naming convention: <Name of Model, singular!>Serializer
+#
+# Ways to use:
+#   - create new instance, call to_json
+#   - create new instance, add objects to serialize one by one.
+#     This lets you reuse it without determining known data
+class Fars::BaseModelSerializer
+  class << self
+    def attributes(*attrs)
+      @attributes = attrs.map(&:to_sym)
+    end
+
+    def all_attributes
+      @attributes
+    end
+
+    # Returns {Object} of class, that corresponds to model,
+    # this class meant to serialize
+    def model
+      @klass ||= get_model
+    end
+
+    # Returns {Symbol} instance hash root key, as an underscored Model name
+    def root_key
+      model.to_s.underscore.to_sym
+    end
+
+    # Returns {String} capitalized API version
+    def api_version
+      namespace_array = name.split('::')
+      namespace_array.size > 1 ? namespace_array[0] : nil
+    end
+
+    # Returns {Array} with names of Model relations. Consists of Symbols.
+    # Filtrated by #all_attributes
+    def model_relations
+      @model_relations ||= get_model_relations
+    end
+
+    # Returns {Array} with names of Model methods. Consists of Symbols
+    # Filtrated by #all_attributes
+    def model_methods
+      @model_methods ||= get_model_methods
+    end
+
+    # Returns {Array} with names of this serializer instance methods. Consists of Symbols
+    # Filtrated by #all_attributes
+    def serializer_methods
+      @serializer_methods ||= get_serializer_methods
+    end
+
+    def serializer_for_relation(name, _api_version=nil)
+      serializers_cache[name] ||= resolve_serializer(name, _api_version)
+    end
+
+  private
+
+    def serializers_cache
+      @serializers_cache ||= {}
+    end
+
+    def resolve_serializer(relation_name, _api_version=nil)
+      (
+        api_prefix +
+        model.reflect_on_all_associations.
+          find { |assoc| assoc.name == relation_name }.
+            class_name.pluralize +
+        'Serializer'
+      ).constantize
+    end
+
+    def get_model
+      (self.to_s.match /#{api_prefix}(\w+)Serializer/)[1].singularize.constantize
+    end
+
+    def get_model_relations
+      (model.reflect_on_all_associations.map { |r| r.name.to_sym } - serializer_methods) & all_attributes
+    end
+
+    def get_model_methods
+      ((model.attribute_names.map(&:to_sym) | model.instance_methods) - model_relations - serializer_methods) & all_attributes
+    end
+
+    def get_serializer_methods
+      self.instance_methods & all_attributes
+    end
+
+    # Returns {String} prefix for serializer class name using API version
+    def api_prefix
+      api_version ? api_version + '::' : ''
+    end
+  end
+
+  # Initialize new instance
+  #
+  # Params:
+  #   - object {Object} to serialize
+  #   - opts {Hash} of options:
+  #     - fields {Array} of attributes to serialize. Can be {NilClass}.
+  #       If so - will use all available.
+  #     - scope {Object} context of request. Usually current user
+  #       or current ability. Can be passed as a {Proc}. If so -
+  #       evaluated only when actually called.
+  #     - :add_metadata {Boolean} if to add a node '_metadata'
+  #     - :root_key {Symbol} overwrites the default one from serializer's Class
+  def initialize(object, opts={})
+    @object       = object
+    @scope        = opts[:scope]
+    @fields       = opts[:fields]
+    @add_metadata = opts.fetch(:add_metadata, true)
+    @root_key     = opts.fetch(:root_key,     self.class.root_key)
+
+    @serialized_klass   = self.class.model # this goes first
+    @all_attributes     = self.class.all_attributes
+    @object_relations   = self.class.model_relations
+    @object_attributes  = self.class.model_methods
+    @serializer_methods = self.class.serializer_methods
+  end
+
+  def with_object(object)
+    @object = object
+    self
+  end
+
+  def as_json
+    # as we can re-use one class of serializer for
+    # many objects, we need to re-evaluate list
+    # of available_attributes for each of them
+    all_attrs = available_attributes
+    item      = {}
+
+    (requested_object_attributes & all_attrs).each do |attr|
+      item[attr] = object.send(attr)
+    end
+
+    (requested_serializer_methods & all_attrs).each do |meth|
+      item[meth] = self.send(meth)
+    end
+
+    (requested_object_relations & all_attrs).each do |rel|
+      item[rel] = serialize_relation(rel)
+    end
+
+    hash = {root_key => item}
+    hash[:_metadata] = meta if add_metadata?
+    hash
+  end
+
+  def to_json
+    MultiJson.dump(as_json)
+  end
+
+protected
+
+  # TODO: Document
+  def serialize_relation(relation_name, relation=nil)
+    klass = self.class.serializer_for_relation(relation_name)
+    relation ||= object.send(relation_name)
+    klass.new(relation,
+              root_key:     false,
+              scope:        @scope,
+              add_metadata: add_metadata?).as_json
+  end
+
+private
+
+  # Things we get from options
+  attr_reader :object, :fields, :root_key
+
+  # Utility things
+  attr_reader :serialized_klass
+
+  # Sets of attributes/methods/relations
+  attr_reader :all_attributes, :object_attributes, :serializer_methods, :object_relations
+
+  # List of attributes requested to be shown.
+  # This is frequently done by :fields HTTP request
+  # parameter
+  def requested_attributes
+    @requested_attributes ||= get_requested_attributes
+  end
+
+  def scope
+    if @scope.is_a? Proc
+      @scope = @scope.call
+    else
+      @scope
+    end
+  end
+
+  def add_metadata?
+    @add_metadata
+  end
+
+  def requested_object_attributes
+    @requested_object_attributes  ||= object_attributes & requested_attributes
+  end
+
+  def requested_serializer_methods
+    @requested_serializer_methods ||= serializer_methods & requested_attributes
+  end
+
+  def requested_object_relations
+    @requested_object_relations   ||= object_relations & requested_attributes
+  end
+
+  # List of attributes available to be shown
+  # by current security context.
+  #
+  # Can be re-defined in children classes
+  def available_attributes
+    all_attributes
+  end
+
+  def get_requested_attributes
+    case fields
+      when NilClass then all_attributes
+      when Array    then fields.map(&:to_sym) | [:id]
+      when Symbol   then [fields.to_sym]
+      when String   then [fields]
+    end
+  end
+
+  # Returns {String} - API version is got by instance class
+  def api_version
+    self.class.api_version
+  end
+end

data/lib/fars/version.rb

@@ -0,0 +1,3 @@
+module Fars
+  VERSION = "0.0.1"
+end

data/lib/fars.rb

@@ -0,0 +1,5 @@
+module Fars
+  require 'fars/base_collection_serializer'
+  require 'fars/base_model_serializer'
+
+end

data/spec/config/database.example.yml

@@ -0,0 +1,5 @@
+adapter:  postgresql
+database: fars_testing
+host:     localhost
+port:     5432
+username: rails

data/spec/fars/api_version_spec.rb

@@ -0,0 +1,77 @@
+require 'spec_helper'
+
+describe Fars::BaseModelSerializer do
+  before :all do
+    ActiveSupport::Inflector.inflections do |inflect|
+     inflect.irregular 'slave', 'slaves'
+    end
+
+    class Master < ActiveRecord::Base
+      has_many :slaves
+    end
+    class Slave < ActiveRecord::Base
+      belongs_to :master
+    end
+
+    module V1
+      class MasterSerializer < Fars::BaseModelSerializer
+        attributes :id, :name, :data, # attrs
+                   :slaves
+
+        def meta
+          {'metadata' => :present}
+        end
+      end
+      class SlaveSerializer < Fars::BaseModelSerializer
+        attributes :id, :name, :data # attrs
+      end
+
+      class MastersSerializer < Fars::BaseCollectionSerializer ; end
+      class SlavesSerializer  < Fars::BaseCollectionSerializer ; end
+    end
+  end
+
+  context '#to_json' do
+    before :each do
+      @object = Master.create(id: 1, name: 'Object1', data: '123')
+      2.times.each {|i| Slave.create(id: i+1, master_id: @object.id, name: "Slave #{i+1}") }
+    end
+
+    it 'returns all fields with metadata' do
+      json_data = {
+        master: {id: 1, name: 'Object1', data: '123'},
+        _metadata: {metadata: :present}
+      }.to_json
+
+      V1::MasterSerializer.new(
+        @object,
+        add_metadata: true,
+        fields: [:id, :name, :data]
+      ).to_json.should == json_data
+    end
+
+    it 'returns not all field, whithout metadata' do
+      json_data = {master: {id: 1, name: 'Object1'}}.to_json
+
+      V1::MasterSerializer.new(
+        @object,
+        add_metadata: false,
+        fields: [:id, :name]
+      ).to_json.should == json_data
+    end
+
+    it 'returns all field with slaves' do
+      json_data = {master: {id: 1, name: 'Object1', data: '123',
+        slaves: [
+          {slave: {id: 1, name: 'Slave 1', data: nil}},
+          {slave: {id: 2, name: 'Slave 2', data: nil}},
+        ]}}.to_json
+
+      V1::MasterSerializer.new(
+        @object,
+        add_metadata: false,
+        fields: [:id, :name, :data, :slaves]
+      ).to_json.should == json_data
+    end
+  end
+end

data/spec/fars/fars_spec.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+
+describe Fars::BaseModelSerializer do
+  before :all do
+    ActiveSupport::Inflector.inflections do |inflect|
+     inflect.irregular 'slave', 'slaves'
+    end
+
+    class Master < ActiveRecord::Base
+      has_many :slaves
+    end
+    class Slave < ActiveRecord::Base
+      belongs_to :master
+    end
+
+    class MasterSerializer < Fars::BaseModelSerializer
+      attributes :id, :name, :data, # attrs
+                 :slaves
+
+      def meta
+        {'metadata' => :present}
+      end
+    end
+    class SlaveSerializer < Fars::BaseModelSerializer
+      attributes :id, :name, :data # attrs
+    end
+
+    class MastersSerializer < Fars::BaseCollectionSerializer ; end
+    class SlavesSerializer  < Fars::BaseCollectionSerializer ; end
+  end
+
+  context '#to_json' do
+    before :each do
+      @object = Master.create(id: 1, name: 'Object1', data: '123')
+      2.times.each {|i| Slave.create(id: i+1, master_id: @object.id, name: "Slave #{i+1}") }
+    end
+
+    it 'returns all fields with metadata' do
+      json_data = {
+        master: {id: 1, name: 'Object1', data: '123'},
+        _metadata: {metadata: :present}
+      }.to_json
+
+      MasterSerializer.new(
+        @object,
+        add_metadata: true,
+        fields: [:id, :name, :data]
+      ).to_json.should == json_data
+    end
+
+    it 'returns not all field, whithout metadata' do
+      json_data = {master: {id: 1, name: 'Object1'}}.to_json
+
+      MasterSerializer.new(
+        @object,
+        add_metadata: false,
+        fields: [:id, :name]
+      ).to_json.should == json_data
+    end
+
+    it 'returns all field with slaves' do
+      json_data = {master: {id: 1, name: 'Object1', data: '123',
+        slaves: [
+          {slave: {id: 1, name: 'Slave 1', data: nil}},
+          {slave: {id: 2, name: 'Slave 2', data: nil}},
+        ]}}.to_json
+
+      MasterSerializer.new(
+        @object,
+        add_metadata: false,
+        fields: [:id, :name, :data, :slaves]
+      ).to_json.should == json_data
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,34 @@
+require 'rspec'
+require 'shoulda'
+require 'database_cleaner'
+require 'pry'
+
+require 'fars'
+
+require 'yaml'
+require 'active_record'
+
+RSpec.configure do |config|
+  config.color_enabled = true
+
+  config.before(:suite) do
+    DatabaseCleaner.strategy = :transaction
+  end
+
+  config.after(:suite) do
+    DatabaseCleaner.strategy = :truncation
+    DatabaseCleaner.clean
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.start
+  end
+
+  config.after(:each) do
+    DatabaseCleaner.clean
+  end
+end
+
+root      = File.dirname(__FILE__)
+db_config = YAML.load_file("#{root}/config/database.yml")
+ActiveRecord::Base.establish_connection(db_config)

data/spec/tasks/db_setup.rake

@@ -0,0 +1,68 @@
+require 'active_record'
+
+namespace :spec do
+  namespace :db do
+    desc 'Setup DB for tests'
+    task :setup do
+      puts 'Create database\n'
+      Rake::Task['spec:db:create'].invoke
+      puts 'Migrate database\n'
+      Rake::Task['spec:db:migrate'].invoke
+    end
+
+    desc 'Add tables required for tests'
+    task :migrate do
+      ActiveRecord::Base.establish_connection(db_config)
+
+      ActiveRecord::Base.connection.execute(<<SQL
+DROP TABLE IF EXISTS "public"."masters";
+
+CREATE TABLE "public"."masters" (
+	"id" int4 NOT NULL,
+	"name" varchar(255) NOT NULL,
+  "data" varchar(255),
+	CONSTRAINT "masters_pkey" PRIMARY KEY ("id") NOT DEFERRABLE INITIALLY IMMEDIATE
+)
+WITH (OIDS=FALSE);
+ALTER TABLE "public"."masters" OWNER TO "rails";
+
+DROP TABLE IF EXISTS "public"."slaves";
+
+CREATE TABLE "public"."slaves" (
+	"id" int4 NOT NULL,
+	"master_id" int4,
+  "name" varchar(255) NOT NULL,
+  "data" varchar(255),
+	CONSTRAINT "slaves_pkey" PRIMARY KEY ("id") NOT DEFERRABLE INITIALLY IMMEDIATE
+)
+WITH (OIDS=FALSE);
+ALTER TABLE "public"."slaves" OWNER TO "rails";
+
+SQL
+                                     )
+    end
+
+    desc 'Create DB for tests'
+    task :create do
+      encoding = db_config[:encoding] || ENV['CHARSET'] || 'utf8'
+      begin
+        ActiveRecord::Base.establish_connection(db_config.merge('database' => 'postgres', 'schema_search_path' => 'public'))
+        ActiveRecord::Base.connection.drop_database(db_config['database']) and puts "previously dropping DB..." if db_present?
+        ActiveRecord::Base.connection.create_database(db_config['database'], db_config.merge('encoding' => encoding))
+        ActiveRecord::Base.establish_connection(db_config)
+      rescue
+        $stderr.puts $!, *($!.backtrace)
+        $stderr.puts "Couldn't create database for #{db_config.inspect}"
+      end
+    end
+
+    def db_config
+      root    = File.expand_path('../../', __FILE__)
+      @db_conf ||= YAML.load_file("#{root}/config/database.yml")
+    end
+
+    def db_present?
+      ActiveRecord::Base.connection.execute("SELECT count(*) FROM pg_database where datname = '#{db_config['database']}'").values.flatten.first.to_i == 1
+    end
+  end
+end

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: fars
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Denyago
+- Lightpower
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Fast ActiveRecord Serializer
+email:
+- bva@aejis.eu
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- fars.gemspec
+- lib/fars.rb
+- lib/fars/base_collection_serializer.rb
+- lib/fars/base_model_serializer.rb
+- lib/fars/version.rb
+- spec/config/database.example.yml
+- spec/fars/api_version_spec.rb
+- spec/fars/fars_spec.rb
+- spec/spec_helper.rb
+- spec/tasks/db_setup.rake
+homepage: https://github.com/Lightpower/fars
+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: Gem provedes classes for fast serialisation of ActiveRecord relations.
+test_files:
+- spec/config/database.example.yml
+- spec/fars/api_version_spec.rb
+- spec/fars/fars_spec.rb
+- spec/spec_helper.rb
+- spec/tasks/db_setup.rake