light_serializer 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc42bdb60c1c303a13fa6cb066dceb052f762612019c932c7db38363f8b5df94
-  data.tar.gz: 2464fcf561ba306e7c8c6b6377d9c3d4ed6f3ad9f0249b9836de002505bbcc56
+  metadata.gz: 25bb1a6af47fb69f5eabb3aaba9b52c2323751b86c3abd229c20935320f06c2c
+  data.tar.gz: 57b67a1e1d29806e0028c6f9b7ad069b99ba57253e99adcef249dd292b1cf633
 SHA512:
-  metadata.gz: '00884b745cedcac93b091fbdc3e58ce2c9d848112134580fa42c057736e680e26318fb4e3a09932fbd0781d504f51a871fc50a1a318e9ec8d6e7d56d4b6a4d4f'
-  data.tar.gz: 4a4b08cdc134007968182bcf6abf4512ccd720e8dc343f5367c75b0f7dcacb3b82d078f300a5f62086b1cba84d4c65cdfe2957764ef1fa5f1b0629ec5af10af4
+  metadata.gz: 6c6f7a76a1e8c6f618547a9d0dbbc6e0a475ae2d009b0122b4b32de9572b378c6ebd61ee1dc41ddb74e0eed27be1afa1644f584cbd5a46c7959f95dbbd8a9925
+  data.tar.gz: f3e6c53d11d2495711506281626c037f7870d061115cbafcb0f9b6741969dd9f4ef0615c8f310a0751ff65cd4c42342f0f1ad9e9cb3b5d6d92a1119dea1d34a3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    light_serializer (0.0.5)
+    light_serializer (0.0.6)
       oj (~> 3)
 
 GEM
@@ -37,7 +37,7 @@ GEM
     kwalify (0.7.2)
     method_source (0.9.0)
     minitest (5.11.3)
-    oj (3.7.0)
+    oj (3.7.1)
     parallel (1.12.1)
     parser (2.5.1.2)
       ast (~> 2.4.0)

data/README.md

@@ -1,4 +1,186 @@
-# light_serializer
+# Light Serializer
+
 Light and Fast serializer
 
 [![Build Status](https://travis-ci.org/krim/light_serializer.svg?branch=master)](https://travis-ci.org/krim/light_serializer)
+[![Maintainability](https://api.codeclimate.com/v1/badges/b9167078ec6b75117d0d/maintainability)](https://codeclimate.com/github/krim/light_serializer/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/b9167078ec6b75117d0d/test_coverage)](https://codeclimate.com/github/krim/light_serializer/test_coverage)
+
+LS is a JSON Object Presenter that takes business objects and breaks them down into simple hashes and serializes them to JSON. It can be used in Rails(or other ruby application) in place of other serializers (like JBuilder or ActiveModelSerializers). It is designed to be simple, direct, and performant.
+
+### Performant comparison
+All performant comparison results are available [here](https://github.com/krim/light_serializer/blob/master/performance_comparison.md). You can run benchmark by yourself.
+```bash
+git clone git@github.com:krim/light_serializer.git
+cd light_serializer
+ruby bench.rb
+
+```
+
+## Table of Contents
+
+* [Install](#install)
+* [Usage](#usage)
+  * [Basic](#basic)
+  * [Custom method names](#custom-method-names)
+  * [Associations](#associations)
+  * [Custom root](#custom-root)
+  * [Collection serializer](#collection-serializer)
+  
+## Install
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'light_serializer'
+```
+
+Execute:
+
+```bash
+$ bundle install
+```
+
+
+## Usage
+### Basic
+If you have an object you would like serialized, simply create a serializer. Say, for example, you have a User record with the following attributes `[:uuid, :email, :first_name, :last_name, :address]`.
+
+You may define a simple serializer like so:
+
+```ruby
+class UserSeriaizer < LightSerializer::Serializer
+  attributes :uuid, :first_name, :last_name, :email
+end
+```
+
+and then, in your code:
+```ruby
+puts UserSeriaizer.new(user).to_json # Output is a JSON string
+```
+
+And the output would look like:
+
+```json
+{
+  "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
+  "first_name": "John",
+  "last_name": "Doe",
+  "email": "john.doe@some.fake.email.domain"
+}
+```
+
+### Custom method names
+You can rename the resulting JSON keys in both fields and associations by defining custom method:
+
+```ruby
+class UserSeriaizer < LightSerializer::Serializer
+  attributes :id, :first_name, :last_name, :email
+
+  def id
+    object.uuid
+  end
+end
+```
+
+This will result in JSON that looks something like this:
+
+```json
+{
+  "id": "92a5c732-2874-41e4-98fc-4123cd6cfa86",
+  "first_name": "John",
+  "last_name": "Doe",
+  "email": "john.doe@some.fake.email.domain"
+}
+```
+
+### Associations
+You may include associated objects. Say, for example, a user has projects:
+
+```ruby
+class ProjectSerializer < LightSerializer::Serializer
+  attributes :uuid, :name
+end
+
+class UserSeriaizer < LightSerializer::Serializer
+  attributes(
+    :uuid,
+    :first_name,
+    :last_name,
+    :email,
+    { projects: ProjectSerializer }
+  )
+end
+```
+
+Usage:
+```ruby
+puts UserSeriaizer.new(user).to_json
+```
+
+Output:
+```json
+{
+  "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
+  "first_name": "John",
+  "last_name": "Doe",
+  "email": "john.doe@some.fake.email.domain",
+  "projects": [
+    {
+      "uuid": "dca94051-4195-42bc-a9aa-eb99f7723c82",
+      "name": "Beach Cleanup"
+    },
+    {
+      "uuid": "eb881bb5-9a51-4d27-8a29-b264c30e6160",
+      "name": "Storefront Revamp"
+    }
+  ]
+}
+```
+
+### Custom root
+By default, returned JSON doesn't have root. You may specify it by the option in serializer's initializer:
+```ruby
+puts UserSeriaizer.new(user, root: :person).to_json
+```
+
+Output:
+```json
+{
+  "person": {
+    "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
+    "first_name": "John",
+    "last_name": "Doe",
+    "email": "john.doe@some.fake.email.domain"
+  }
+}
+```
+
+### Collection serializer
+Use `LightSerializer::SerializeCollection` to serialize collection of objects. You have to specify seriaizer, and can specify root and context.
+```ruby
+puts LightSerializer::SerializeCollection.new(users, serializer: UserSerializer, root: :users).to_json
+```
+
+Output:
+```json
+{
+  "users": [
+    {
+      "uuid": "733f0758-8f21-4719-875f-262c3ec743af",
+      "first_name": "John",
+      "last_name": "Doe",
+      "email": "john.doe@some.fake.email.domain"
+    },
+    {
+      "uuid": "262c3ec743af-4719-4719-8f21-733f0758",
+      "first_name": "Foo",
+      "last_name": "Bar",
+      "email": "foo.bar@some.fake.email.domain"
+    },
+    {
+      ...
+    }
+  ]
+}
+```

data/bench.rb

@@ -1,12 +1,20 @@
 # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-require 'surrealist'
-require_relative 'lib/light_serializer'
-require 'benchmark/ips'
-require 'active_record'
-require 'active_model'
-require 'active_model_serializers'
-require 'blueprinter'
-require 'pry'
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+
+  gem 'activerecord', require: 'active_record'
+  gem 'activemodel'
+  gem 'sqlite3'
+  gem 'light_serializer'
+  gem 'active_model_serializers'
+  gem 'blueprinter'
+  gem 'surrealist'
+  gem 'benchmark-ips', require: 'benchmark/ips'
+end
+
+puts 'Gems installed and loaded!'
 
 ActiveRecord::Base.establish_connection(
   adapter:  'sqlite3',
@@ -204,7 +212,7 @@ def benchmark_collection(ams_arg: '', oj_arg: '')
                    ).to_json
                  end,
                  -> { Surrealist.surrealize_collection(users) },
-                 -> { UserLightSerializer.new(users).to_json },
+                 -> { LightSerializer::SerializeCollection.new(users, serializer: UserLightSerializer).to_json },
                  -> { UserSurrealistSerializer.new(users).surrealize },
                  -> { users.to_json(only: %i[name email]) },
                  -> { UserBlueprint.render(users) }]
@@ -251,7 +259,7 @@ def benchmark_associations_collection
                    ).to_json
                  end,
                  -> { Surrealist.surrealize_collection(collection) },
-                 -> { AuthorLightSerializer.new(collection).to_json },
+                 -> { LightSerializer::SerializeCollection.new(collection, serializer: AuthorLightSerializer).to_json },
                  -> { AuthorSurrealistSerializer.new(collection).surrealize },
                  lambda do
                    collection.to_json(only: %i[name last_name age], methods: %i[full_name],

data/lib/light_serializer/hashed_object.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'light_serializer/helpers/with_custom_root'
-
 module LightSerializer
   class HashedObject
     include Helpers::WithCustomRoot
@@ -38,17 +36,25 @@ module LightSerializer
     end
 
     def values_from_nested_resource(attribute, object, result)
-      attribute_name = attribute.keys.last
-      nested_serializer = attribute.values.last
+      attribute_name = attribute.keys[-1]
+      nested_serializer = attribute.values[-1]
 
       value = obtain_value(object, attribute_name)
       result[attribute_name] = hashed_nested_resource(value, nested_serializer)
     end
 
     def hashed_nested_resource(value, nested_serializer)
-      return hashed_entity(value, nested_serializer) unless value.is_a?(Enumerable)
+      return hashed_entity(value, nested_serializer) unless can_be_enumerated?(value)
+
+      value.each_with_object(nested_serializer).map { |entity, serializer| hashed_entity(entity, serializer) }
+    end
+
+    def can_be_enumerated?(value)
+      value.is_a?(Enumerable) || active_record_relation?(value)
+    end
 
-      value.each_with_object(nested_serializer).map(&method(:hashed_entity))
+    def active_record_relation?(object)
+      !!(defined?(ActiveRecord::Relation) && object.is_a?(ActiveRecord::Relation))
     end
 
     def hashed_entity(entity, nested_serializer)
@@ -76,7 +82,7 @@ module LightSerializer
     end
 
     def values_from_for_array(attribute, value, result)
-      value.map { |entity| obtain_values(attribute, entity, result) }
+      value.map { |entity| entity.is_a?(Hash) ? entity : obtain_values(attribute, entity, result) }
     end
   end
 end

data/lib/light_serializer/helpers/with_custom_root.rb

@@ -1,9 +1,11 @@
 # frozen_string_literal: true
 
-module LightSerializer::Helpers
-  module WithCustomRoot
-    def with_custom_root(root)
-      root ? { root.to_sym => yield } : yield
+module LightSerializer
+  module Helpers
+    module WithCustomRoot
+      def with_custom_root(root)
+        root ? { root.to_sym => yield } : yield
+      end
     end
   end
 end

data/lib/light_serializer/serialize_collection.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require 'light_serializer/helpers/with_custom_root'
-require 'light_serializer/serializer'
-
 module LightSerializer
   class SerializeCollection
     include Helpers::WithCustomRoot

data/lib/light_serializer/serializer.rb

@@ -1,16 +1,13 @@
 # frozen_string_literal: true
 
-require 'oj'
-require 'light_serializer/hashed_object'
-
 module LightSerializer
   class Serializer
-    attr_reader :object, :root, :context
+    attr_reader :object, :root, :context, :meta
 
     def self.attributes(*new_attributes)
       return @attributes if new_attributes.empty?
 
-      @attributes = @attributes ? @attributes + new_attributes : new_attributes
+      @attributes = @attributes ? @attributes.concat(new_attributes) : new_attributes
     end
 
     def self.inherited(subclass)
@@ -18,18 +15,19 @@ module LightSerializer
       super(subclass)
     end
 
-    def initialize(object, root: nil, context: nil)
+    def initialize(object, root: nil, context: nil, meta: nil)
       @object = object
       @root = root
       @context = context
+      @meta = meta
     end
 
     def to_json
-      Oj.dump(hashed_object, mode: :compat)
+      Oj.dump(to_hash, mode: :compat)
     end
 
     def to_hash
-      hashed_object
+      meta ? hashed_object.merge!(meta: meta) : hashed_object
     end
 
     private

data/lib/light_serializer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LightSerializer
-  VERSION = '0.0.5'
+  VERSION = '0.0.7'
 end

data/lib/light_serializer.rb

@@ -3,6 +3,7 @@
 module LightSerializer
 end
 
+require 'oj'
 require 'light_serializer/helpers/with_custom_root'
 require 'light_serializer/hashed_object'
 require 'light_serializer/serializer'

data/performance_comparison.md

@@ -0,0 +1,353 @@
+## Comparison:
+* LightSerializer
+* AMS
+* Surrealist
+* Blueprinter
+
+All tests were made on MB Pro 2015 15".
+
+```
+Warming up --------------------------------------
+      AMS : instance     2.225k i/100ms
+Surrealist: instance through .surrealize
+                         4.012k i/100ms
+LightSerializer: instance through .to_json
+                         8.733k i/100ms
+Surrealist: instance through Surrealist::Serializer
+                         2.854k i/100ms
+ActiveModel::Serializers::JSON instance
+                         2.404k i/100ms
+         Blueprinter     4.747k i/100ms
+Calculating -------------------------------------
+      AMS : instance     23.170k (± 3.1%) i/s -    117.925k in   5.094753s
+Surrealist: instance through .surrealize
+                         41.814k (± 2.6%) i/s -    212.636k in   5.089193s
+LightSerializer: instance through .to_json
+                         91.327k (± 2.5%) i/s -    462.849k in   5.071370s
+Surrealist: instance through Surrealist::Serializer
+                         29.131k (± 2.8%) i/s -    145.554k in   5.000956s
+ActiveModel::Serializers::JSON instance
+                         24.605k (± 2.0%) i/s -    125.008k in   5.082821s
+         Blueprinter     49.770k (± 3.3%) i/s -    251.591k in   5.061158s
+
+Comparison:
+LightSerializer: instance through .to_json:    91327.3 i/s
+         Blueprinter:    49770.4 i/s - 1.83x  slower
+Surrealist: instance through .surrealize:    41813.5 i/s - 2.18x  slower
+Surrealist: instance through Surrealist::Serializer:    29130.9 i/s - 3.14x  slower
+ActiveModel::Serializers::JSON instance:    24604.5 i/s - 3.71x  slower
+      AMS : instance:    23169.7 i/s - 3.94x  slower
+
+Warming up --------------------------------------
+    AMS : collection     1.000  i/100ms
+Surrealist: collection through Surrealist.surrealize_collection()
+                         1.000  i/100ms
+LightSerializer: collection through .to_json
+                         1.000  i/100ms
+Surrealist: collection through Surrealist::Serializer
+                         1.000  i/100ms
+ActiveModel::Serializers::JSON collection
+                         1.000  i/100ms
+Blueprinter collection
+                         1.000  i/100ms
+Calculating -------------------------------------
+    AMS : collection      5.801  (± 0.0%) i/s -     29.000  in   5.004853s
+Surrealist: collection through Surrealist.surrealize_collection()
+                          9.691  (± 0.0%) i/s -     49.000  in   5.063183s
+LightSerializer: collection through .to_json
+                         19.861  (± 5.0%) i/s -    100.000  in   5.044340s
+Surrealist: collection through Surrealist::Serializer
+                          7.964  (± 0.0%) i/s -     40.000  in   5.029143s
+ActiveModel::Serializers::JSON collection
+                          6.601  (± 0.0%) i/s -     33.000  in   5.002701s
+Blueprinter collection
+                         18.376  (± 5.4%) i/s -     92.000  in   5.015767s
+
+Comparison:
+LightSerializer: collection through .to_json:       19.9 i/s
+Blueprinter collection:       18.4 i/s - same-ish: difference falls within error
+Surrealist: collection through Surrealist.surrealize_collection():        9.7 i/s - 2.05x  slower
+Surrealist: collection through Surrealist::Serializer:        8.0 i/s - 2.49x  slower
+ActiveModel::Serializers::JSON collection:        6.6 i/s - 3.01x  slower
+    AMS : collection:        5.8 i/s - 3.42x  slower
+
+
+------- Turning off AMS logger -------
+Warming up --------------------------------------
+AMS(without logging) : instance
+                         2.554k i/100ms
+Surrealist: instance through .surrealize
+                         4.451k i/100ms
+LightSerializer: instance through .to_json
+                         9.498k i/100ms
+Surrealist: instance through Surrealist::Serializer
+                         3.090k i/100ms
+ActiveModel::Serializers::JSON instance
+                         2.683k i/100ms
+         Blueprinter     5.318k i/100ms
+Calculating -------------------------------------
+AMS(without logging) : instance
+                         25.965k (± 3.8%) i/s -    130.254k in   5.024395s
+Surrealist: instance through .surrealize
+                         45.524k (± 4.9%) i/s -    231.452k in   5.097901s
+LightSerializer: instance through .to_json
+                         99.406k (± 2.8%) i/s -    503.394k in   5.067891s
+Surrealist: instance through Surrealist::Serializer
+                         32.110k (± 2.9%) i/s -    160.680k in   5.008350s
+ActiveModel::Serializers::JSON instance
+                         27.232k (± 2.8%) i/s -    136.833k in   5.028844s
+         Blueprinter     54.973k (± 2.7%) i/s -    276.536k in   5.033870s
+
+Comparison:
+LightSerializer: instance through .to_json:    99406.0 i/s
+         Blueprinter:    54973.4 i/s - 1.81x  slower
+Surrealist: instance through .surrealize:    45523.7 i/s - 2.18x  slower
+Surrealist: instance through Surrealist::Serializer:    32110.0 i/s - 3.10x  slower
+ActiveModel::Serializers::JSON instance:    27232.1 i/s - 3.65x  slower
+AMS(without logging) : instance:    25965.2 i/s - 3.83x  slower
+
+Warming up --------------------------------------
+AMS(without logging) : collection
+                         1.000  i/100ms
+Surrealist: collection through Surrealist.surrealize_collection()
+                         1.000  i/100ms
+LightSerializer: collection through .to_json
+                         1.000  i/100ms
+Surrealist: collection through Surrealist::Serializer
+                         1.000  i/100ms
+ActiveModel::Serializers::JSON collection
+                         1.000  i/100ms
+Blueprinter collection
+                         1.000  i/100ms
+Calculating -------------------------------------
+AMS(without logging) : collection
+                          5.729  (± 0.0%) i/s -     29.000  in   5.065254s
+Surrealist: collection through Surrealist.surrealize_collection()
+                          9.684  (± 0.0%) i/s -     49.000  in   5.063764s
+LightSerializer: collection through .to_json
+                         19.538  (± 5.1%) i/s -     98.000  in   5.026798s
+Surrealist: collection through Surrealist::Serializer
+                          7.836  (± 0.0%) i/s -     40.000  in   5.110566s
+ActiveModel::Serializers::JSON collection
+                          6.518  (± 0.0%) i/s -     33.000  in   5.067046s
+Blueprinter collection
+                         18.106  (± 5.5%) i/s -     91.000  in   5.034963s
+
+Comparison:
+LightSerializer: collection through .to_json:       19.5 i/s
+Blueprinter collection:       18.1 i/s - same-ish: difference falls within error
+Surrealist: collection through Surrealist.surrealize_collection():        9.7 i/s - 2.02x  slower
+Surrealist: collection through Surrealist::Serializer:        7.8 i/s - 2.49x  slower
+ActiveModel::Serializers::JSON collection:        6.5 i/s - 3.00x  slower
+AMS(without logging) : collection:        5.7 i/s - 3.41x  slower
+
+Warming up --------------------------------------
+AMS (associations): instance
+                       338.000  i/100ms
+Surrealist (associations): instance through .surrealize
+                       907.000  i/100ms
+Light (associations): instance through .to_json
+                         2.627k i/100ms
+Surrealist (associations): instance through Surrealist::Serializer
+                       921.000  i/100ms
+ActiveModel::Serializers::JSON (associations)
+                         1.024k i/100ms
+Blueprinter (associations)
+                         2.029k i/100ms
+Calculating -------------------------------------
+AMS (associations): instance
+                          3.371k (± 2.9%) i/s -     16.900k in   5.018308s
+Surrealist (associations): instance through .surrealize
+                          9.139k (± 2.9%) i/s -     46.257k in   5.065403s
+Light (associations): instance through .to_json
+                         26.902k (± 2.8%) i/s -    136.604k in   5.081821s
+Surrealist (associations): instance through Surrealist::Serializer
+                          9.286k (± 3.0%) i/s -     46.971k in   5.062770s
+ActiveModel::Serializers::JSON (associations)
+                         10.313k (± 2.4%) i/s -     52.224k in   5.066930s
+Blueprinter (associations)
+                         20.826k (± 3.4%) i/s -    105.508k in   5.071876s
+
+Comparison:
+Light (associations): instance through .to_json:    26902.2 i/s
+Blueprinter (associations):    20825.6 i/s - 1.29x  slower
+ActiveModel::Serializers::JSON (associations):    10312.9 i/s - 2.61x  slower
+Surrealist (associations): instance through Surrealist::Serializer:     9286.0 i/s - 2.90x  slower
+Surrealist (associations): instance through .surrealize:     9139.5 i/s - 2.94x  slower
+AMS (associations): instance:     3370.6 i/s - 7.98x  slower
+
+Warming up --------------------------------------
+AMS (associations): collection
+                         1.000  i/100ms
+Surrealist (associations): collection through Surrealist.surrealize_collection()
+                         1.000  i/100ms
+Light (associations): collection through .to_json
+                         1.000  i/100ms
+Surrealist (associations): collection through Surrealist::Serializer
+                         1.000  i/100ms
+ActiveModel::Serializers::JSON (associations): collection
+                         1.000  i/100ms
+Blueprinter (associations): collection
+                         1.000  i/100ms
+Calculating -------------------------------------
+AMS (associations): collection
+                          1.172  (± 0.0%) i/s -      6.000  in   5.138824s
+Surrealist (associations): collection through Surrealist.surrealize_collection()
+                          2.694  (± 0.0%) i/s -     14.000  in   5.203211s
+Light (associations): collection through .to_json
+                          8.001  (± 0.0%) i/s -     40.000  in   5.008966s
+Surrealist (associations): collection through Surrealist::Serializer
+                          2.635  (± 0.0%) i/s -     14.000  in   5.319793s
+ActiveModel::Serializers::JSON (associations): collection
+                          3.309  (± 0.0%) i/s -     17.000  in   5.144606s
+Blueprinter (associations): collection
+                          7.817  (± 0.0%) i/s -     40.000  in   5.128954s
+
+Comparison:
+Light (associations): collection through .to_json:        8.0 i/s
+Blueprinter (associations): collection:        7.8 i/s - 1.02x  slower
+ActiveModel::Serializers::JSON (associations): collection:        3.3 i/s - 2.42x  slower
+Surrealist (associations): collection through Surrealist.surrealize_collection():        2.7 i/s - 2.97x  slower
+Surrealist (associations): collection through Surrealist::Serializer:        2.6 i/s - 3.04x  slower
+AMS (associations): collection:        1.2 i/s - 6.83x  slower
+
+
+------- Enabling Oj.optimize_rails() & Blueprinter config.generator = Oj -------
+Warming up --------------------------------------
+AMS(without logging) (with Oj): instance
+                         4.286k i/100ms
+Surrealist: instance through .surrealize
+                         4.466k i/100ms
+LightSerializer: instance through .to_json
+                         9.569k i/100ms
+Surrealist: instance through Surrealist::Serializer
+                         3.124k i/100ms
+ActiveModel::Serializers::JSON(with Oj) instance
+                         4.035k i/100ms
+Blueprinter(with Oj)     6.773k i/100ms
+Calculating -------------------------------------
+AMS(without logging) (with Oj): instance
+                         49.629k (± 4.8%) i/s -    248.588k in   5.020623s
+Surrealist: instance through .surrealize
+                         45.766k (± 3.2%) i/s -    232.232k in   5.079519s
+LightSerializer: instance through .to_json
+                         99.043k (± 2.6%) i/s -    497.588k in   5.027351s
+Surrealist: instance through Surrealist::Serializer
+                         31.665k (± 3.4%) i/s -    159.324k in   5.037471s
+ActiveModel::Serializers::JSON(with Oj) instance
+                         45.115k (± 4.0%) i/s -    225.960k in   5.017009s
+Blueprinter(with Oj)     70.319k (± 2.5%) i/s -    352.196k in   5.011834s
+
+Comparison:
+LightSerializer: instance through .to_json:    99042.9 i/s
+Blueprinter(with Oj):    70319.0 i/s - 1.41x  slower
+AMS(without logging) (with Oj): instance:    49629.4 i/s - 2.00x  slower
+Surrealist: instance through .surrealize:    45766.5 i/s - 2.16x  slower
+ActiveModel::Serializers::JSON(with Oj) instance:    45114.9 i/s - 2.20x  slower
+Surrealist: instance through Surrealist::Serializer:    31665.1 i/s - 3.13x  slower
+
+Warming up --------------------------------------
+AMS(without logging) (with Oj): collection
+                         1.000  i/100ms
+Surrealist: collection through Surrealist.surrealize_collection()
+                         1.000  i/100ms
+LightSerializer: collection through .to_json
+                         1.000  i/100ms
+Surrealist: collection through Surrealist::Serializer
+                         1.000  i/100ms
+ActiveModel::Serializers::JSON(with Oj) collection
+                         1.000  i/100ms
+Blueprinter collection(with Oj)
+                         2.000  i/100ms
+Calculating -------------------------------------
+AMS(without logging) (with Oj): collection
+                          9.921  (± 0.0%) i/s -     50.000  in   5.047071s
+Surrealist: collection through Surrealist.surrealize_collection()
+                          9.459  (± 0.0%) i/s -     48.000  in   5.080945s
+LightSerializer: collection through .to_json
+                         19.470  (± 5.1%) i/s -     98.000  in   5.046335s
+Surrealist: collection through Surrealist::Serializer
+                          7.720  (± 0.0%) i/s -     39.000  in   5.063697s
+ActiveModel::Serializers::JSON(with Oj) collection
+                         10.796  (± 9.3%) i/s -     54.000  in   5.024268s
+Blueprinter collection(with Oj)
+                         20.156  (± 5.0%) i/s -    102.000  in   5.064738s
+
+Comparison:
+Blueprinter collection(with Oj):       20.2 i/s
+LightSerializer: collection through .to_json:       19.5 i/s - same-ish: difference falls within error
+ActiveModel::Serializers::JSON(with Oj) collection:       10.8 i/s - 1.87x  slower
+AMS(without logging) (with Oj): collection:        9.9 i/s - 2.03x  slower
+Surrealist: collection through Surrealist.surrealize_collection():        9.5 i/s - 2.13x  slower
+Surrealist: collection through Surrealist::Serializer:        7.7 i/s - 2.61x  slower
+
+Warming up --------------------------------------
+AMS (associations): instance
+                       381.000  i/100ms
+Surrealist (associations): instance through .surrealize
+                       677.000  i/100ms
+Light (associations): instance through .to_json
+                         2.074k i/100ms
+Surrealist (associations): instance through Surrealist::Serializer
+                       687.000  i/100ms
+ActiveModel::Serializers::JSON (associations)
+                         1.390k i/100ms
+Blueprinter (associations)
+                         1.851k i/100ms
+Calculating -------------------------------------
+AMS (associations): instance
+                          3.743k (± 5.9%) i/s -     19.050k in   5.108122s
+Surrealist (associations): instance through .surrealize
+                          6.817k (± 2.8%) i/s -     34.527k in   5.068641s
+Light (associations): instance through .to_json
+                         21.131k (± 3.0%) i/s -    105.774k in   5.010100s
+Surrealist (associations): instance through Surrealist::Serializer
+                          6.874k (± 3.1%) i/s -     34.350k in   5.001779s
+ActiveModel::Serializers::JSON (associations)
+                         13.996k (± 3.2%) i/s -     70.890k in   5.069785s
+Blueprinter (associations)
+                         19.964k (± 3.5%) i/s -     99.954k in   5.013021s
+
+Comparison:
+Light (associations): instance through .to_json:    21131.3 i/s
+Blueprinter (associations):    19964.2 i/s - same-ish: difference falls within error
+ActiveModel::Serializers::JSON (associations):    13996.4 i/s - 1.51x  slower
+Surrealist (associations): instance through Surrealist::Serializer:     6874.1 i/s - 3.07x  slower
+Surrealist (associations): instance through .surrealize:     6817.0 i/s - 3.10x  slower
+AMS (associations): instance:     3742.8 i/s - 5.65x  slower
+
+Warming up --------------------------------------
+AMS (associations): collection
+                         1.000  i/100ms
+Surrealist (associations): collection through Surrealist.surrealize_collection()
+                         1.000  i/100ms
+Light (associations): collection through .to_json
+                         1.000  i/100ms
+Surrealist (associations): collection through Surrealist::Serializer
+                         1.000  i/100ms
+ActiveModel::Serializers::JSON (associations): collection
+                         1.000  i/100ms
+Blueprinter (associations): collection
+                         1.000  i/100ms
+Calculating -------------------------------------
+AMS (associations): collection
+                          1.387  (± 0.0%) i/s -      7.000  in   5.077429s
+Surrealist (associations): collection through Surrealist.surrealize_collection()
+                          2.649  (± 0.0%) i/s -     14.000  in   5.291537s
+Light (associations): collection through .to_json
+                          7.857  (± 0.0%) i/s -     40.000  in   5.103876s
+Surrealist (associations): collection through Surrealist::Serializer
+                          2.602  (± 0.0%) i/s -     13.000  in   5.003615s
+ActiveModel::Serializers::JSON (associations): collection
+                          5.693  (± 0.0%) i/s -     29.000  in   5.104138s
+Blueprinter (associations): collection
+                          8.603  (± 0.0%) i/s -     43.000  in   5.011885s
+
+Comparison:
+Blueprinter (associations): collection:        8.6 i/s
+Light (associations): collection through .to_json:        7.9 i/s - 1.09x  slower
+ActiveModel::Serializers::JSON (associations): collection:        5.7 i/s - 1.51x  slower
+Surrealist (associations): collection through Surrealist.surrealize_collection():        2.6 i/s - 3.25x  slower
+Surrealist (associations): collection through Surrealist::Serializer:        2.6 i/s - 3.31x  slower
+AMS (associations): collection:        1.4 i/s - 6.20x  slower
+```

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: light_serializer
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - Pavel Rodionov
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-09 00:00:00.000000000 Z
+date: 2018-11-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oj
@@ -162,6 +162,7 @@ files:
 - lib/light_serializer/serializer.rb
 - lib/light_serializer/version.rb
 - light_serializer.gemspec
+- performance_comparison.md
 homepage: https://github.com/krim/light_serializer
 licenses:
 - MIT