active_model_serializers 0.10.0 → 0.10.5

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_model_serializers
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.10.5
 platform: ruby
 authors:
 - Steve Klabnik
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-17 00:00:00.000000000 Z
+date: 2017-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -16,56 +16,114 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: jsonapi-renderer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1.beta1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: 0.1.1.beta1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: case_transform
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '4.1'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6'
 - !ruby/object:Gem::Dependency
   name: kaminari
   requirement: !ruby/object:Gem::Requirement
@@ -208,10 +266,10 @@ files:
 - ".github/PULL_REQUEST_TEMPLATE.md"
 - ".gitignore"
 - ".rubocop.yml"
-- ".rubocop_todo.yml"
 - ".simplecov"
 - ".travis.yml"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - Gemfile
 - MIT-LICENSE
@@ -222,13 +280,13 @@ files:
 - bin/bench
 - bin/bench_regression
 - bin/serve_benchmark
-- docs/ARCHITECTURE.md
 - docs/README.md
 - docs/STYLE.md
 - docs/general/adapters.md
 - docs/general/caching.md
 - docs/general/configuration_options.md
 - docs/general/deserialization.md
+- docs/general/fields.md
 - docs/general/getting_started.md
 - docs/general/instrumentation.md
 - docs/general/key_transforms.md
@@ -237,11 +295,14 @@ files:
 - docs/general/serializers.md
 - docs/how-open-source-maintained.jpg
 - docs/howto/add_pagination_links.md
+- docs/howto/add_relationship_links.md
 - docs/howto/add_root_key.md
+- docs/howto/grape_integration.md
 - docs/howto/outside_controller_use.md
 - docs/howto/passing_arbitrary_options.md
 - docs/howto/serialize_poro.md
 - docs/howto/test.md
+- docs/howto/upgrade_from_0_8_to_0_10.md
 - docs/integrations/ember-and-json-api.md
 - docs/integrations/grape.md
 - docs/jsonapi/errors.md
@@ -260,28 +321,27 @@ files:
 - lib/active_model/serializer/adapter/null.rb
 - lib/active_model/serializer/array_serializer.rb
 - lib/active_model/serializer/association.rb
-- lib/active_model/serializer/associations.rb
 - lib/active_model/serializer/attribute.rb
-- lib/active_model/serializer/attributes.rb
 - lib/active_model/serializer/belongs_to_reflection.rb
-- lib/active_model/serializer/caching.rb
 - lib/active_model/serializer/collection_reflection.rb
 - lib/active_model/serializer/collection_serializer.rb
-- lib/active_model/serializer/configuration.rb
+- lib/active_model/serializer/concerns/associations.rb
+- lib/active_model/serializer/concerns/attributes.rb
+- lib/active_model/serializer/concerns/caching.rb
+- lib/active_model/serializer/concerns/configuration.rb
+- lib/active_model/serializer/concerns/links.rb
+- lib/active_model/serializer/concerns/meta.rb
+- lib/active_model/serializer/concerns/type.rb
 - lib/active_model/serializer/error_serializer.rb
 - lib/active_model/serializer/errors_serializer.rb
 - lib/active_model/serializer/field.rb
 - lib/active_model/serializer/fieldset.rb
 - lib/active_model/serializer/has_many_reflection.rb
 - lib/active_model/serializer/has_one_reflection.rb
-- lib/active_model/serializer/include_tree.rb
-- lib/active_model/serializer/links.rb
 - lib/active_model/serializer/lint.rb
-- lib/active_model/serializer/meta.rb
 - lib/active_model/serializer/null.rb
 - lib/active_model/serializer/reflection.rb
 - lib/active_model/serializer/singular_reflection.rb
-- lib/active_model/serializer/type.rb
 - lib/active_model/serializer/version.rb
 - lib/active_model_serializers.rb
 - lib/active_model_serializers/adapter.rb
@@ -302,8 +362,8 @@ files:
 - lib/active_model_serializers/deprecate.rb
 - lib/active_model_serializers/deserialization.rb
 - lib/active_model_serializers/json_pointer.rb
-- lib/active_model_serializers/key_transform.rb
 - lib/active_model_serializers/logging.rb
+- lib/active_model_serializers/lookup_chain.rb
 - lib/active_model_serializers/model.rb
 - lib/active_model_serializers/railtie.rb
 - lib/active_model_serializers/register_jsonapi_renderer.rb
@@ -324,21 +384,25 @@ files:
 - test/action_controller/json/include_test.rb
 - test/action_controller/json_api/deserialization_test.rb
 - test/action_controller/json_api/errors_test.rb
+- test/action_controller/json_api/fields_test.rb
 - test/action_controller/json_api/linked_test.rb
 - test/action_controller/json_api/pagination_test.rb
 - test/action_controller/json_api/transform_test.rb
+- test/action_controller/lookup_proc_test.rb
+- test/action_controller/namespace_lookup_test.rb
 - test/action_controller/serialization_scope_name_test.rb
 - test/action_controller/serialization_test.rb
 - test/active_model_serializers/adapter_for_test.rb
 - test/active_model_serializers/json_pointer_test.rb
-- test/active_model_serializers/key_transform_test.rb
 - test/active_model_serializers/logging_test.rb
 - test/active_model_serializers/model_test.rb
 - test/active_model_serializers/railtie_test_isolated.rb
+- test/active_model_serializers/register_jsonapi_renderer_test_isolated.rb
 - test/active_model_serializers/serialization_context_test_isolated.rb
 - test/active_model_serializers/test/schema_test.rb
 - test/active_model_serializers/test/serializer_test.rb
 - test/active_record_test.rb
+- test/adapter/attributes_test.rb
 - test/adapter/deprecation_test.rb
 - test/adapter/json/belongs_to_test.rb
 - test/adapter/json/collection_test.rb
@@ -352,13 +416,13 @@ files:
 - test/adapter/json_api/has_many_explicit_serializer_test.rb
 - test/adapter/json_api/has_many_test.rb
 - test/adapter/json_api/has_one_test.rb
+- test/adapter/json_api/include_data_if_sideloaded_test.rb
 - test/adapter/json_api/json_api_test.rb
 - test/adapter/json_api/linked_test.rb
 - test/adapter/json_api/links_test.rb
 - test/adapter/json_api/pagination_links_test.rb
 - test/adapter/json_api/parse_test.rb
 - test/adapter/json_api/relationship_test.rb
-- test/adapter/json_api/relationships_test.rb
 - test/adapter/json_api/resource_identifier_test.rb
 - test/adapter/json_api/resource_meta_test.rb
 - test/adapter/json_api/toplevel_jsonapi_test.rb
@@ -371,7 +435,10 @@ files:
 - test/array_serializer_test.rb
 - test/benchmark/app.rb
 - test/benchmark/benchmarking_support.rb
+- test/benchmark/bm_active_record.rb
+- test/benchmark/bm_adapter.rb
 - test/benchmark/bm_caching.rb
+- test/benchmark/bm_lookup_chain.rb
 - test/benchmark/bm_transform.rb
 - test/benchmark/config.ru
 - test/benchmark/controllers.rb
@@ -383,9 +450,6 @@ files:
 - test/generators/scaffold_controller_generator_test.rb
 - test/generators/serializer_generator_test.rb
 - test/grape_test.rb
-- test/include_tree/from_include_args_test.rb
-- test/include_tree/from_string_test.rb
-- test/include_tree/include_args_to_hash_test.rb
 - test/lint_test.rb
 - test/logger_test.rb
 - test/poro_test.rb
@@ -403,6 +467,7 @@ files:
 - test/serializers/root_test.rb
 - test/serializers/serialization_test.rb
 - test/serializers/serializer_for_test.rb
+- test/serializers/serializer_for_with_namespace_test.rb
 - test/support/custom_schemas/active_model_serializers/test/schema_test/my/index.json
 - test/support/isolated_unit.rb
 - test/support/rails5_shims.rb
@@ -419,10 +484,7 @@ homepage: https://github.com/rails-api/active_model_serializers
 licenses:
 - MIT
 metadata: {}
-post_install_message: |
-  NOTE: The default key case for the JsonApi adapter has changed to dashed.
-  See https://github.com/rails-api/active_model_serializers/blob/master/docs/general/key_transforms.md
-  for more information on configuring this behavior.
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -430,7 +492,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -438,7 +500,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Conventions-based JSON generation for Rails.
@@ -448,21 +510,25 @@ test_files:
 - test/action_controller/json/include_test.rb
 - test/action_controller/json_api/deserialization_test.rb
 - test/action_controller/json_api/errors_test.rb
+- test/action_controller/json_api/fields_test.rb
 - test/action_controller/json_api/linked_test.rb
 - test/action_controller/json_api/pagination_test.rb
 - test/action_controller/json_api/transform_test.rb
+- test/action_controller/lookup_proc_test.rb
+- test/action_controller/namespace_lookup_test.rb
 - test/action_controller/serialization_scope_name_test.rb
 - test/action_controller/serialization_test.rb
 - test/active_model_serializers/adapter_for_test.rb
 - test/active_model_serializers/json_pointer_test.rb
-- test/active_model_serializers/key_transform_test.rb
 - test/active_model_serializers/logging_test.rb
 - test/active_model_serializers/model_test.rb
 - test/active_model_serializers/railtie_test_isolated.rb
+- test/active_model_serializers/register_jsonapi_renderer_test_isolated.rb
 - test/active_model_serializers/serialization_context_test_isolated.rb
 - test/active_model_serializers/test/schema_test.rb
 - test/active_model_serializers/test/serializer_test.rb
 - test/active_record_test.rb
+- test/adapter/attributes_test.rb
 - test/adapter/deprecation_test.rb
 - test/adapter/json/belongs_to_test.rb
 - test/adapter/json/collection_test.rb
@@ -476,13 +542,13 @@ test_files:
 - test/adapter/json_api/has_many_explicit_serializer_test.rb
 - test/adapter/json_api/has_many_test.rb
 - test/adapter/json_api/has_one_test.rb
+- test/adapter/json_api/include_data_if_sideloaded_test.rb
 - test/adapter/json_api/json_api_test.rb
 - test/adapter/json_api/linked_test.rb
 - test/adapter/json_api/links_test.rb
 - test/adapter/json_api/pagination_links_test.rb
 - test/adapter/json_api/parse_test.rb
 - test/adapter/json_api/relationship_test.rb
-- test/adapter/json_api/relationships_test.rb
 - test/adapter/json_api/resource_identifier_test.rb
 - test/adapter/json_api/resource_meta_test.rb
 - test/adapter/json_api/toplevel_jsonapi_test.rb
@@ -495,7 +561,10 @@ test_files:
 - test/array_serializer_test.rb
 - test/benchmark/app.rb
 - test/benchmark/benchmarking_support.rb
+- test/benchmark/bm_active_record.rb
+- test/benchmark/bm_adapter.rb
 - test/benchmark/bm_caching.rb
+- test/benchmark/bm_lookup_chain.rb
 - test/benchmark/bm_transform.rb
 - test/benchmark/config.ru
 - test/benchmark/controllers.rb
@@ -507,9 +576,6 @@ test_files:
 - test/generators/scaffold_controller_generator_test.rb
 - test/generators/serializer_generator_test.rb
 - test/grape_test.rb
-- test/include_tree/from_include_args_test.rb
-- test/include_tree/from_string_test.rb
-- test/include_tree/include_args_to_hash_test.rb
 - test/lint_test.rb
 - test/logger_test.rb
 - test/poro_test.rb
@@ -527,6 +593,7 @@ test_files:
 - test/serializers/root_test.rb
 - test/serializers/serialization_test.rb
 - test/serializers/serializer_for_test.rb
+- test/serializers/serializer_for_with_namespace_test.rb
 - test/support/custom_schemas/active_model_serializers/test/schema_test/my/index.json
 - test/support/isolated_unit.rb
 - test/support/rails5_shims.rb
@@ -539,4 +606,3 @@ test_files:
 - test/support/schemas/simple_json_pointers.json
 - test/support/serialization_testing.rb
 - test/test_helper.rb
-has_rdoc: 

data/.rubocop_todo.yml

@@ -1,167 +0,0 @@
-# This configuration was generated by
-# `rubocop --auto-gen-config`
-# on 2016-03-08 22:29:52 +0100 using RuboCop version 0.37.2.
-# The point is for the user to remove these configuration records
-# one by one as the offenses are removed from the code base.
-# Note that changes in the inspected code, or installation of new
-# versions of RuboCop, may require this file to be generated again.
-
-# Offense count: 2
-Lint/HandleExceptions:
-  Exclude:
-    - 'Rakefile'
-
-# Offense count: 2
-# Cop supports --auto-correct.
-# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods.
-Lint/UnusedMethodArgument:
-  Exclude:
-    - 'test/lint_test.rb'
-
-# Offense count: 4
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: strict, flexible
-Rails/TimeZone:
-  Exclude:
-    - 'test/action_controller/serialization_test.rb'
-    - 'test/serializers/cache_test.rb'
-
-# Offense count: 16
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle, SupportedLastArgumentHashStyles.
-# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
-Style/AlignHash:
-  Exclude:
-    - 'test/action_controller/json_api/pagination_test.rb'
-
-# Offense count: 27
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: braces, no_braces, context_dependent
-Style/BracesAroundHashParameters:
-  Exclude:
-    - 'test/action_controller/adapter_selector_test.rb'
-    - 'test/action_controller/json_api/pagination_test.rb'
-    - 'test/adapter/json_api/linked_test.rb'
-    - 'test/adapter/json_api/pagination_links_test.rb'
-    - 'test/adapter/null_test.rb'
-    - 'test/adapter_test.rb'
-    - 'test/collection_serializer_test.rb'
-    - 'test/serializable_resource_test.rb'
-    - 'test/serializers/associations_test.rb'
-    - 'test/serializers/attributes_test.rb'
-    - 'test/serializers/root_test.rb'
-
-# Offense count: 271
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: nested, compact
-Style/ClassAndModuleChildren:
-  Enabled: false
-
-# Offense count: 6
-# Cop supports --auto-correct.
-Style/CommentIndentation:
-  Exclude:
-    - 'active_model_serializers.gemspec'
-
-# Offense count: 1
-Style/DoubleNegation:
-  Exclude:
-    - 'lib/active_model/serializable_resource.rb'
-
-# Offense count: 1
-# Configuration parameters: MinBodyLength.
-Style/GuardClause:
-  Exclude:
-    - 'lib/active_model/serializer.rb'
-
-# Offense count: 58
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles, UseHashRocketsWithSymbolValues.
-# SupportedStyles: ruby19, ruby19_no_mixed_keys, hash_rockets
-Style/HashSyntax:
-  Enabled: false
-
-# Offense count: 4
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles, IndentationWidth.
-# SupportedStyles: special_inside_parentheses, consistent, align_brackets
-Style/IndentArray:
-  Enabled: false
-
-# Offense count: 10
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles, IndentationWidth.
-# SupportedStyles: special_inside_parentheses, consistent, align_braces
-Style/IndentHash:
-  Enabled: false
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/Lambda:
-  Exclude:
-    - 'lib/active_model/serializer.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: require_parentheses, require_no_parentheses, require_no_parentheses_except_multiline
-Style/MethodDefParentheses:
-  Enabled: false
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles, IndentationWidth.
-# SupportedStyles: aligned, indented
-Style/MultilineOperationIndentation:
-  Enabled: false
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/NegatedIf:
-  Exclude:
-    - 'lib/action_controller/serialization.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/PerlBackrefs:
-  Exclude:
-    - 'test/fixtures/poro.rb'
-
-# Offense count: 3
-# Configuration parameters: NamePrefix, NamePrefixBlacklist, NameWhitelist.
-# NamePrefix: is_, has_, have_
-# NamePrefixBlacklist: is_, has_, have_
-# NameWhitelist: is_a?
-Style/PredicateName:
-  Exclude:
-    - 'lib/active_model/serializer/associations.rb'
-    - 'test/action_controller/json_api/linked_test.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/RedundantSelf:
-  Exclude:
-    - 'test/fixtures/poro.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: AllowIfMethodIsEmpty.
-Style/SingleLineMethods:
-  Exclude:
-    - 'test/serializers/serializer_for_test.rb'
-
-# Offense count: 4
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: single_quotes, double_quotes
-Style/StringLiteralsInInterpolation:
-  Enabled: false
-
-# Offense count: 1
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle, SupportedStyles.
-# SupportedStyles: final_newline, final_blank_line
-Style/TrailingBlankLines:
-  Exclude:
-    - 'test/adapter/null_test.rb'

data/docs/ARCHITECTURE.md

@@ -1,126 +0,0 @@
-[Back to Guides](README.md)
-
-This document focuses on architecture the 0.10.x version of ActiveModelSerializers. If you are interested in the architecture of the 0.8 or 0.9 versions,
-please refer to the [0.8 README](https://github.com/rails-api/active_model_serializers/blob/0-8-stable/README.md) or
-[0.9 README](https://github.com/rails-api/active_model_serializers/blob/0-9-stable/README.md).
-
-The original design is also available [here](https://github.com/rails-api/active_model_serializers/blob/d72b66d4c5355b0ff0a75a04895fcc4ea5b0c65e/README.textile).
-
-# ARCHITECTURE
-
-An **`ActiveModel::Serializer`** wraps a [serializable resource](https://github.com/rails/rails/blob/4-2-stable/activemodel/lib/active_model/serialization.rb)
-and exposes an `attributes` method, among a few others.
-It allows you to specify which attributes and associations should be represented in the serializatation of the resource.
-It requires an adapter to transform its attributes into a JSON document; it cannot be serialized itself.
-It may be useful to think of it as a
-[presenter](http://blog.steveklabnik.com/posts/2011-09-09-better-ruby-presenters).
-
-The **`ActiveModel::ArraySerializer`** represent a collection of resources as serializers
-and, if there is no serializer, primitives.
-
-The **`ActiveModel::Adapter`** describes the structure of the JSON document generated from a
-serializer. For example, the `Attributes` example represents each serializer as its
-unmodified attributes.  The `JsonApi` adapter represents the serializer as a [JSON
-API](http://jsonapi.org/) document.
-
-The **`ActiveModelSerializers::SerializableResource`** acts to coordinate the serializer(s) and adapter
-to an object that responds to `to_json`, and `as_json`.  It is used in the controller to
-encapsulate the serialization resource when rendered. However, it can also be used on its own
-to serialize a resource outside of a controller, as well.
-
-## Primitive handling
-
-Definitions: A primitive is usually a String or Array. There is no serializer
-defined for them; they will be serialized when the resource is converted to JSON (`as_json` or
-`to_json`).  (The below also applies for any object with no serializer.)
-
-ActiveModelSerializers doesn't handle primitives passed to `render json:` at all.
-
-However, when a primitive value is an attribute or in a collection,
-it is not modified.
-
-Internally, if no serializer can be found in the controller, the resource is not decorated by
-ActiveModelSerializers.
-
-If the collection serializer (ArraySerializer) cannot
-identify a serializer for a resource in its collection, it raises [`NoSerializerError`](https://github.com/rails-api/active_model_serializers/issues/1191#issuecomment-142327128)
-which is rescued in `ActiveModel::Serializer::Reflection#build_association` which sets
-the association value directly:
-
-```ruby
-reflection_options[:virtual_value] = association_value.try(:as_json) || association_value
-```
-
-(which is called by the adapter as `serializer.associations(*)`.)
-
-## How options are parsed
-
-High-level overview:
-
-- For a collection
-  - `:serializer` specifies the collection serializer and
-  - `:each_serializer` specifies the serializer for each resource in the collection.
-- For a single resource, the `:serializer` option is the resource serializer.
-- Options are partitioned in serializer options and adapter options.  Keys for adapter options are specified by
-    [`ADAPTER_OPTION_KEYS`](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model_serializers/serializable_resource.rb#L5).
-    The remaining options are serializer options.
-
-Details:
-
-1. **ActionController::Serialization**
-  1. `serializable_resource = ActiveModelSerializers::SerializableResource.new(resource, options)`
-    1. `options` are partitioned into `adapter_opts` and everything else (`serializer_opts`).
-      The `adapter_opts`  keys are defined in `ActiveModelSerializers::SerializableResource::ADAPTER_OPTION_KEYS`.
-1. **ActiveModelSerializers::SerializableResource**
-  1. `if serializable_resource.serializer?` (there is a serializer for the resource, and an adapter is used.)
-    - Where `serializer?` is `use_adapter? && !!(serializer)`
-      - Where `use_adapter?`: 'True when no explicit adapter given, or explicit value is truthy (non-nil);
-        False when explicit adapter is falsy (nil or false)'
-      - Where `serializer`:
-        1. from explicit `:serializer` option, else
-        2. implicitly from resource `ActiveModel::Serializer.serializer_for(resource)`
-  1. A side-effect of checking `serializer` is:
-     - The `:serializer` option is removed from the serializer_opts hash
-     - If the `:each_serializer` option is present, it is removed from the serializer_opts hash and set as the `:serializer` option
-  1. The serializer and adapter are created as
-    1. `serializer_instance = serializer.new(resource, serializer_opts)`
-    2. `adapter_instance = ActiveModel::Serializer::Adapter.create(serializer_instance, adapter_opts)`
-1. **ActiveModel::Serializer::ArraySerializer#new**
-  1. If the `serializer_instance` was a `ArraySerializer` and the `:serializer` serializer_opts
-    is present, then [that serializer is passed into each resource](https://github.com/rails-api/active_model_serializers/blob/a54d237e2828fe6bab1ea5dfe6360d4ecc8214cd/lib/active_model/serializer/array_serializer.rb#L14-L16).
-1. **ActiveModel::Serializer#attributes** is used by the adapter to get the attributes for
-  resource as defined by the serializer.
-
-## What does a 'serializable resource' look like?
-
-- An `ActiveRecord::Base` object.
-- Any Ruby object that passes the
-  [Lint](http://www.rubydoc.info/github/rails-api/active_model_serializers/ActiveModel/Serializer/Lint/Tests)
-  [code](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model/serializer/lint.rb).
-
-ActiveModelSerializers provides a
-[`ActiveModelSerializers::Model`](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model_serializers/model.rb),
-which is a simple serializable PORO (Plain-Old Ruby Object).
-
-ActiveModelSerializers::Model may be used either as a template, or in production code.
-
-```ruby
-class MyModel < ActiveModelSerializers::Model
-  attr_accessor :id, :name, :level
-end
-```
-
-The default serializer for `MyModel` would be `MyModelSerializer` whether MyModel is an
-ActiveRecord::Base object or not.
-
-Outside of the controller the rules are **exactly** the same as for records. For example:
-
-```ruby
-render json: MyModel.new(level: 'awesome'), adapter: :json
-```
-
-would be serialized the same as
-
-```ruby
-ActiveModelSerializers::SerializableResource.new(MyModel.new(level: 'awesome'), adapter: :json).as_json
-```