fast_jsonapi 1.0.17 → 1.1.0

data/README.rdoc

@@ -1,231 +0,0 @@
-# Fast JSON API
-
-[![NetflixOSS Lifecycle](https://img.shields.io/osslifecycle/Netflix/osstracker.svg)]()
-
-A lightning fast [JSON:API](http://jsonapi.org/) serializer for Ruby Objects.
-
-# Performance Comparision
-
-We compare serialization times with Active Model Serializer as part of RSpec performance tests included on this library. We want to ensure that with every change on this library, serialization time is at least `25 times` faster than Active Model Serializers on up to current benchmark of 1000 records.
-
-## Benchmark times for 250 records
-
-```bash
-  $ rspec
-  Active Model Serializer serialized 250 records in 138.71 ms
-  Fast JSON API serialized 250 records in 3.01 ms
-```
-
-# Table of Contents
-
-* [Features](#features)
-* [Installation](#installation)
-* [Usage](#usage)
-  * [Model Definition](#model-definition)
-  * [Serializer Definition](#serializer-definition)
-  * [Object Serialization](#object-serialization)
-  * [Compound Document](#compound-document)
-  * [Collection Serialization](#collection-serialization)
-  * [Caching](#caching)
-* [Contributing](#contributing)
-
-
-## Features
-
-* Declaration syntax similar to Active Model serializer
-* Support for belongs_to, has_many and has_one
-* Support for compound documents (included)
-* Optimized serialization of compound documents
-* Caching
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'fast_jsonapi'
-```
-
-Execute:
-
-```ruby
-$ bundle install
-```
-
-## Usage
-
-### Model Definition
-
-```ruby
-class Movie
-  attr_accessor :id, :name, :year, :actor_ids, :owner_id
-end
-```
-
-### Serializer Definition
-
-```ruby
-class MovieSerializer
-  include FastJsonapi::ObjectSerializer
-  set_type :movie  # optional
-  attributes :name, :year
-  has_many :actors
-  belongs_to :owner, record_type: :user
-  belongs_to :movie_type
-end
-```
-
-### Sample Object
-
-```ruby
-m = Movie.new
-m.id = 232
-m.name = 'test movie'
-m.actor_ids = [1, 2, 3]
-m.owner_id = 3
-m.movie_type_id = 1
-m
-```
-
-### Object Serialization
-
-#### Return a hash
-```ruby
-hash = MovieSerializer.new(movie).serializable_hash
-```
-
-#### Return Serialized JSON
-```ruby
-json_string = MovieSerializer.new(movie).serialized_json
-```
-
-#### Serialized Output
-
-```json
-{
-  "data": {
-    "id": "232",
-    "type": "movie",
-    "attributes": {
-      "name": "test movie",
-      "year": null
-    },
-    "relationships": {
-      "actors": {
-        "data": [
-          {
-            "id": "1",
-            "type": "actor"
-          },
-          {
-            "id": "2",
-            "type": "actor"
-          }
-        ]
-      },
-      "owner": {
-        "data": {
-          "id": "3",
-          "type": "user"
-        }
-      }
-    }
-  }
-}
-
-```
-### Compound Document
-
-Support for top-level included member through ` options[:include] `.
-
-```ruby
-options = {}
-options[:meta] = { total: 2 }
-options[:include] = [:actors]
-MovieSerializer.new([movie, movie], options).serialized_json
-```
-
-### Collection Serialization
-
-```ruby
-options[:meta] = { total: 2 }
-hash = MovieSerializer.new([movie, movie], options).serializable_hash
-json_string = MovieSerializer.new([movie, movie], options).serialized_json
-```
-
-### Caching
-
-```ruby
-class MovieSerializer
-  include FastJsonapi::ObjectSerializer
-  set_type :movie  # optional
-  cache_options enabled: true cache_length: 12.hours
-  attributes :name, :year
-end
-```
-
-### Customizable Options
-
-Option | Purpose | Example
------------- | ------------- | -------------
-set_type | Type name of Object | ```set_type :movie ```
-cache_options | Hash to enable caching and set cache length | ```cache_options enabled: true cache_length: 12.hours```
-id_method_name | Set custom method name to get ID of an object | ```has_many :locations, id_method_name: :place_ids ```
-object_method_name | Set custom method name to get related objects | ```has_many :locations, object_method_name: :places ```
-record_type | Set custom Object Type for a relationship | ```belongs_to :owner, record_type: :user```
-serializer | Set custom Serializer for a relationship | ```has_many :actors, serializer: :custom_actor```
-cache_options | Hash to enable caching and set cache length | ```cache_options enabled: true cache_length: 12.hours ```
-
-
-## Contributing
-
-This gem is built using a gem building gem called [juwelier](https://github.com/flajann2/juwelier).
-
-Beyond just editing source code, you’ll be interacting with the gem using rake a lot. To see all the tasks available with a brief description, you can run:
-
-```bash
-rake -T
-```
-
-### Updating Project information
-You can update the project information of the gem by updating the [Rakefile](Rakefile). Then you need to generate a new gemspec
-
-```bash
-rake gemspec
-```
-
-### Running Tests
-We use rspec for testing. We have unit tests, functional tests and performance tests. To run tests use the following rake task
-
-```bash
-rake spec
-```
-
-### Installation
-
-```bash
-$ rake install
-```
-
-The install rake task builds the gem installs it. You're all
-set if you're using [RVM](http://rvm.beginrescueend.com/), but you may
-need to run it with sudo if you have a system-installed ruby:
-
-### Bumping Version
-
-It feels good to release code. Do it, do it often. But before that, bump
-the version. Then release it. There's a few ways to update the version:
-
-```ruby
-# version:write like before
-$ rake version:write MAJOR=0 MINOR=3 PATCH=0
-
-# bump just major, ie 0.1.0 -> 1.0.0
-$ rake version:bump:major
-
-# bump just minor, ie 0.1.0 -> 0.2.0
-$ rake version:bump:minor
-
-# bump just patch, ie 0.1.0 -> 0.1.1
-$ rake version:bump:patch
-```

data/Rakefile

@@ -1,55 +0,0 @@
-# encoding: utf-8
-
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'rake'
-require 'juwelier'
-Juwelier::Tasks.new do |gem|
-  # gem is a Gem::Specification... see http://guides.rubygems.org/specification-reference/ for more options
-  gem.name = "fast_jsonapi"
-  gem.homepage = "http://github.com/Netflix/fast_jsonapi"
-  gem.license = "Apache-2.0"
-  gem.summary = %Q{fast JSON API(jsonapi.org) serializer}
-  gem.description = %Q{JSON API(jsonapi.org) serializer that works with rails and can be used to serialize any kind of ruby objects}
-  gem.email = ""
-  gem.authors = ["Shishir Kakaraddi", "Srinivas Raghunathan", "Adam Gross"]
-
-
-  if gem.respond_to?(:metadata)
-    gem.metadata['allowed_push_host'] = 'https://rubygems.org'
-  else
-    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
-  end
-  # dependencies defined in Gemfile
-end
-Juwelier::RubygemsDotOrgTasks.new
-require 'rspec/core'
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = FileList['spec/**/*_spec.rb']
-end
-
-desc "Code coverage detail"
-task :simplecov do
-  ENV['COVERAGE'] = "true"
-  Rake::Task['spec'].execute
-end
-
-task :default => :spec
-
-require 'rdoc/task'
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "fast_jsonapi #{version}"
-  rdoc.rdoc_files.include('README*')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end

data/VERSION

@@ -1 +0,0 @@
-1.0.17

data/docs/collection_serializer_output.json

@@ -1,35 +0,0 @@
-{
-  "data": [
-    {
-      "id": "232",
-      "type": "movie",
-      "attributes": {
-        "name": "test movie",
-        "year": null
-      },
-      "relationships": {
-        "actors": {
-          "data": [
-            {
-              "id": "1",
-              "type": "actor"
-            },
-            {
-              "id": "2",
-              "type": "actor"
-            }
-          ]
-        },
-        "owner": {
-          "data": {
-            "id": "3",
-            "type": "user"
-          }
-        }
-      }
-    }
-  ],
-  "meta": {
-    "total": 2
-  }
-}

data/docs/object_serializer.json

@@ -1,30 +0,0 @@
-{
-  "data": {
-    "id": "232",
-    "type": "movie",
-    "attributes": {
-      "name": "test movie",
-      "year": null
-    },
-    "relationships": {
-      "actors": {
-        "data": [
-          {
-            "id": "1",
-            "type": "actor"
-          },
-          {
-            "id": "2",
-            "type": "actor"
-          }
-        ]
-      },
-      "owner": {
-        "data": {
-          "id": "3",
-          "type": "user"
-        }
-      }
-    }
-  }
-}

data/fast_jsonapi.gemspec

@@ -1,108 +0,0 @@
-# Generated by juwelier
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-# stub: fast_jsonapi 1.0.16 ruby lib
-
-Gem::Specification.new do |s|
-  s.name = "fast_jsonapi"
-  s.version = "1.0.17"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.metadata = { "allowed_push_host" => "https://rubygems.org" } if s.respond_to? :metadata=
-  s.require_paths = ["lib"]
-  s.authors = ["Shishir Kakaraddi", "Srinivas Raghunathan", "Adam Gross"]
-  s.date = "2018-02-01"
-  s.description = "JSON API(jsonapi.org) serializer that works with rails and can be used to serialize any kind of ruby objects"
-  s.email = ""
-  s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.md",
-    "README.rdoc"
-  ]
-  s.files = [
-    ".document",
-    ".rspec",
-    "Gemfile",
-    "Gemfile.lock",
-    "LICENSE.txt",
-    "README.md",
-    "README.rdoc",
-    "Rakefile",
-    "VERSION",
-    "docs/collection_serializer_output.json",
-    "docs/object_serializer.json",
-    "fast_jsonapi.gemspec",
-    "lib/extensions/has_one.rb",
-    "lib/fast_jsonapi.rb",
-    "lib/fast_jsonapi/object_serializer.rb",
-    "lib/fast_jsonapi/serialization_core.rb",
-    "spec/lib/extensions/active_record_spec.rb",
-    "spec/lib/object_serializer_caching_spec.rb",
-    "spec/lib/object_serializer_class_methods_spec.rb",
-    "spec/lib/object_serializer_hyphen_spec.rb",
-    "spec/lib/object_serializer_performance_spec.rb",
-    "spec/lib/object_serializer_spec.rb",
-    "spec/lib/object_serializer_struct_spec.rb",
-    "spec/lib/serialization_core_spec.rb",
-    "spec/shared/contexts/ams_context.rb",
-    "spec/shared/contexts/movie_context.rb",
-    "spec/spec_helper.rb"
-  ]
-  s.homepage = "http://github.com/Netflix/fast_jsonapi"
-  s.licenses = ["Apache-2.0"]
-  s.rubygems_version = "2.5.1"
-  s.summary = "fast JSON API(jsonapi.org) serializer"
-
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<activesupport>, ["~> 5.0"])
-      s.add_runtime_dependency(%q<multi_json>, ["~> 1.12"])
-      s.add_runtime_dependency(%q<oj>, ["~> 3.3"])
-      s.add_runtime_dependency(%q<activerecord>, ["~> 5.0"])
-      s.add_development_dependency(%q<skylight>, ["~> 1.3"])
-      s.add_development_dependency(%q<rspec>, ["~> 3.5.0"])
-      s.add_development_dependency(%q<rspec-benchmark>, ["~> 0.3.0"])
-      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_development_dependency(%q<juwelier>, ["~> 2.1.0"])
-      s.add_development_dependency(%q<simplecov>, [">= 0"])
-      s.add_development_dependency(%q<byebug>, [">= 0"])
-      s.add_development_dependency(%q<active_model_serializers>, ["~> 0.10.4"])
-      s.add_development_dependency(%q<sqlite3>, ["~> 1.3"])
-    else
-      s.add_dependency(%q<activesupport>, ["~> 5.0"])
-      s.add_dependency(%q<multi_json>, ["~> 1.12"])
-      s.add_dependency(%q<oj>, ["~> 3.3"])
-      s.add_dependency(%q<skylight>, ["~> 1.3"])
-      s.add_dependency(%q<activerecord>, ["~> 5.0"])
-      s.add_dependency(%q<rspec>, ["~> 3.5.0"])
-      s.add_dependency(%q<rspec-benchmark>, ["~> 0.3.0"])
-      s.add_dependency(%q<rdoc>, ["~> 3.12"])
-      s.add_dependency(%q<bundler>, ["~> 1.0"])
-      s.add_dependency(%q<juwelier>, ["~> 2.1.0"])
-      s.add_dependency(%q<simplecov>, [">= 0"])
-      s.add_dependency(%q<byebug>, [">= 0"])
-      s.add_dependency(%q<active_model_serializers>, ["~> 0.10.4"])
-      s.add_dependency(%q<sqlite3>, ["~> 1.3"])
-    end
-  else
-    s.add_dependency(%q<activesupport>, ["~> 5.0"])
-    s.add_dependency(%q<multi_json>, ["~> 1.12"])
-    s.add_dependency(%q<oj>, ["~> 3.3"])
-    s.add_dependency(%q<skylight>, ["~> 1.3"])
-    s.add_dependency(%q<activerecord>, ["~> 5.0"])
-    s.add_dependency(%q<rspec>, ["~> 3.5.0"])
-    s.add_dependency(%q<rspec-benchmark>, ["~> 0.3.0"])
-    s.add_dependency(%q<rdoc>, ["~> 3.12"])
-    s.add_dependency(%q<bundler>, ["~> 1.0"])
-    s.add_dependency(%q<juwelier>, ["~> 2.1.0"])
-    s.add_dependency(%q<simplecov>, [">= 0"])
-    s.add_dependency(%q<byebug>, [">= 0"])
-    s.add_dependency(%q<active_model_serializers>, ["~> 0.10.4"])
-    s.add_dependency(%q<sqlite3>, ["~> 1.3"])
-  end
-end
-