active_model_serializers 0.10.0 → 0.10.6
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.rubocop.yml +6 -5
- data/.travis.yml +17 -5
- data/CHANGELOG.md +126 -2
- data/CODE_OF_CONDUCT.md +74 -0
- data/Gemfile +5 -2
- data/README.md +166 -26
- data/Rakefile +3 -32
- data/active_model_serializers.gemspec +22 -25
- data/appveyor.yml +9 -3
- data/bin/rubocop +38 -0
- data/docs/README.md +2 -1
- data/docs/general/adapters.md +29 -11
- data/docs/general/caching.md +7 -1
- data/docs/general/configuration_options.md +70 -1
- data/docs/general/deserialization.md +1 -1
- data/docs/general/fields.md +31 -0
- data/docs/general/getting_started.md +1 -1
- data/docs/general/logging.md +7 -0
- data/docs/general/rendering.md +62 -24
- data/docs/general/serializers.md +121 -13
- data/docs/howto/add_pagination_links.md +16 -17
- data/docs/howto/add_relationship_links.md +140 -0
- data/docs/howto/add_root_key.md +4 -0
- data/docs/howto/grape_integration.md +42 -0
- data/docs/howto/outside_controller_use.md +12 -4
- data/docs/howto/passing_arbitrary_options.md +2 -2
- data/docs/howto/serialize_poro.md +46 -5
- data/docs/howto/test.md +2 -0
- data/docs/howto/upgrade_from_0_8_to_0_10.md +265 -0
- data/docs/integrations/ember-and-json-api.md +67 -32
- data/docs/jsonapi/schema.md +1 -1
- data/lib/action_controller/serialization.rb +13 -3
- data/lib/active_model/serializer/adapter/base.rb +2 -0
- data/lib/active_model/serializer/array_serializer.rb +8 -5
- data/lib/active_model/serializer/association.rb +62 -10
- data/lib/active_model/serializer/belongs_to_reflection.rb +4 -3
- data/lib/active_model/serializer/collection_serializer.rb +35 -12
- data/lib/active_model/serializer/{caching.rb → concerns/caching.rb} +82 -115
- data/lib/active_model/serializer/error_serializer.rb +11 -7
- data/lib/active_model/serializer/errors_serializer.rb +25 -20
- data/lib/active_model/serializer/has_many_reflection.rb +3 -3
- data/lib/active_model/serializer/has_one_reflection.rb +1 -4
- data/lib/active_model/serializer/lazy_association.rb +95 -0
- data/lib/active_model/serializer/lint.rb +134 -130
- data/lib/active_model/serializer/reflection.rb +127 -67
- data/lib/active_model/serializer/version.rb +1 -1
- data/lib/active_model/serializer.rb +296 -79
- data/lib/active_model_serializers/adapter/attributes.rb +3 -66
- data/lib/active_model_serializers/adapter/base.rb +39 -39
- data/lib/active_model_serializers/adapter/json_api/deserialization.rb +1 -1
- data/lib/active_model_serializers/adapter/json_api/link.rb +1 -1
- data/lib/active_model_serializers/adapter/json_api/pagination_links.rb +8 -1
- data/lib/active_model_serializers/adapter/json_api/relationship.rb +63 -23
- data/lib/active_model_serializers/adapter/json_api/resource_identifier.rb +32 -9
- data/lib/active_model_serializers/adapter/json_api.rb +71 -57
- data/lib/active_model_serializers/adapter.rb +6 -0
- data/lib/active_model_serializers/deprecate.rb +1 -2
- data/lib/active_model_serializers/deserialization.rb +2 -0
- data/lib/active_model_serializers/lookup_chain.rb +80 -0
- data/lib/active_model_serializers/model.rb +109 -28
- data/lib/active_model_serializers/railtie.rb +3 -1
- data/lib/active_model_serializers/register_jsonapi_renderer.rb +44 -31
- data/lib/active_model_serializers/serializable_resource.rb +6 -5
- data/lib/active_model_serializers/serialization_context.rb +10 -3
- data/lib/active_model_serializers/test/schema.rb +2 -2
- data/lib/active_model_serializers.rb +15 -0
- data/lib/generators/rails/resource_override.rb +1 -1
- data/lib/generators/rails/serializer_generator.rb +4 -4
- data/lib/grape/active_model_serializers.rb +7 -5
- data/lib/grape/formatters/active_model_serializers.rb +19 -2
- data/lib/grape/helpers/active_model_serializers.rb +1 -0
- data/lib/tasks/rubocop.rake +53 -0
- data/test/action_controller/adapter_selector_test.rb +14 -5
- data/test/action_controller/explicit_serializer_test.rb +5 -4
- data/test/action_controller/json/include_test.rb +106 -27
- data/test/action_controller/json_api/errors_test.rb +8 -9
- data/test/action_controller/json_api/fields_test.rb +66 -0
- data/test/action_controller/json_api/linked_test.rb +29 -24
- data/test/action_controller/json_api/pagination_test.rb +19 -19
- data/test/action_controller/json_api/transform_test.rb +11 -3
- data/test/action_controller/lookup_proc_test.rb +49 -0
- data/test/action_controller/namespace_lookup_test.rb +232 -0
- data/test/action_controller/serialization_scope_name_test.rb +12 -6
- data/test/action_controller/serialization_test.rb +12 -9
- data/test/active_model_serializers/json_pointer_test.rb +15 -13
- data/test/active_model_serializers/model_test.rb +137 -4
- data/test/active_model_serializers/railtie_test_isolated.rb +12 -7
- data/test/active_model_serializers/register_jsonapi_renderer_test_isolated.rb +161 -0
- data/test/active_model_serializers/serialization_context_test_isolated.rb +23 -10
- data/test/active_model_serializers/test/schema_test.rb +3 -2
- data/test/adapter/attributes_test.rb +40 -0
- data/test/adapter/json/collection_test.rb +14 -0
- data/test/adapter/json/has_many_test.rb +10 -2
- data/test/adapter/json/transform_test.rb +15 -15
- data/test/adapter/json_api/collection_test.rb +4 -3
- data/test/adapter/json_api/errors_test.rb +17 -19
- data/test/adapter/json_api/fields_test.rb +12 -3
- data/test/adapter/json_api/has_many_test.rb +49 -20
- data/test/adapter/json_api/include_data_if_sideloaded_test.rb +183 -0
- data/test/adapter/json_api/json_api_test.rb +5 -7
- data/test/adapter/json_api/linked_test.rb +33 -12
- data/test/adapter/json_api/links_test.rb +4 -2
- data/test/adapter/json_api/pagination_links_test.rb +35 -8
- data/test/adapter/json_api/relationship_test.rb +309 -73
- data/test/adapter/json_api/resource_identifier_test.rb +27 -2
- data/test/adapter/json_api/resource_meta_test.rb +3 -3
- data/test/adapter/json_api/transform_test.rb +263 -253
- data/test/adapter/json_api/type_test.rb +1 -1
- data/test/adapter/json_test.rb +8 -7
- data/test/adapter/null_test.rb +1 -2
- data/test/adapter/polymorphic_test.rb +5 -5
- data/test/adapter_test.rb +1 -1
- data/test/benchmark/app.rb +1 -1
- data/test/benchmark/benchmarking_support.rb +1 -1
- data/test/benchmark/bm_active_record.rb +81 -0
- data/test/benchmark/bm_adapter.rb +38 -0
- data/test/benchmark/bm_caching.rb +16 -16
- data/test/benchmark/bm_lookup_chain.rb +83 -0
- data/test/benchmark/bm_transform.rb +21 -10
- data/test/benchmark/controllers.rb +16 -17
- data/test/benchmark/fixtures.rb +72 -72
- data/test/cache_test.rb +235 -69
- data/test/collection_serializer_test.rb +25 -12
- data/test/fixtures/active_record.rb +45 -10
- data/test/fixtures/poro.rb +124 -181
- data/test/generators/serializer_generator_test.rb +23 -5
- data/test/grape_test.rb +170 -56
- data/test/lint_test.rb +1 -1
- data/test/logger_test.rb +13 -11
- data/test/serializable_resource_test.rb +18 -22
- data/test/serializers/association_macros_test.rb +3 -2
- data/test/serializers/associations_test.rb +178 -49
- data/test/serializers/attribute_test.rb +5 -3
- data/test/serializers/attributes_test.rb +1 -1
- data/test/serializers/caching_configuration_test_isolated.rb +6 -6
- data/test/serializers/fieldset_test.rb +1 -1
- data/test/serializers/meta_test.rb +12 -6
- data/test/serializers/options_test.rb +17 -6
- data/test/serializers/read_attribute_for_serialization_test.rb +3 -3
- data/test/serializers/reflection_test.rb +427 -0
- data/test/serializers/root_test.rb +1 -1
- data/test/serializers/serialization_test.rb +2 -2
- data/test/serializers/serializer_for_test.rb +12 -10
- data/test/serializers/serializer_for_with_namespace_test.rb +88 -0
- data/test/support/isolated_unit.rb +5 -2
- data/test/support/rails5_shims.rb +8 -2
- data/test/support/rails_app.rb +2 -9
- data/test/support/serialization_testing.rb +23 -5
- data/test/test_helper.rb +13 -0
- metadata +105 -42
- data/.rubocop_todo.yml +0 -167
- data/docs/ARCHITECTURE.md +0 -126
- data/lib/active_model/serializer/associations.rb +0 -100
- data/lib/active_model/serializer/attributes.rb +0 -82
- data/lib/active_model/serializer/collection_reflection.rb +0 -7
- data/lib/active_model/serializer/configuration.rb +0 -35
- data/lib/active_model/serializer/include_tree.rb +0 -111
- data/lib/active_model/serializer/links.rb +0 -35
- data/lib/active_model/serializer/meta.rb +0 -29
- data/lib/active_model/serializer/singular_reflection.rb +0 -7
- data/lib/active_model/serializer/type.rb +0 -25
- data/lib/active_model_serializers/key_transform.rb +0 -70
- data/test/active_model_serializers/key_transform_test.rb +0 -263
- data/test/adapter/json_api/relationships_test.rb +0 -199
- data/test/include_tree/from_include_args_test.rb +0 -26
- data/test/include_tree/from_string_test.rb +0 -94
- data/test/include_tree/include_args_to_hash_test.rb +0 -64
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: fbc0f811b036c328dccf411b6f8080b6605d8740
|
|
4
|
+
data.tar.gz: d4a0f6f7799b074aff45bc103c9c19b9ea873ab1
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 121ed054788e585e48e76af3e98490930fd26f18ebdd28d80d07cba78fe9b7c3aed8ea1e1f15ace59debb73562383657f89e4d52fa2c54391424ea53c3701a38
|
|
7
|
+
data.tar.gz: 88ab9022b49348ec463547196300480bcf02139d67cc11adfcbf8c5e4e38c3e44b27cdde7687baab54f8f8ce4bbe4fa606079dffae51ad7be42427dc15955d6e
|
data/.rubocop.yml
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
|
-
inherit_from: .rubocop_todo.yml
|
|
2
|
-
|
|
3
1
|
AllCops:
|
|
4
|
-
TargetRubyVersion: 2.
|
|
2
|
+
TargetRubyVersion: 2.1
|
|
5
3
|
Exclude:
|
|
6
|
-
- config/initializers/forbidden_yaml.rb
|
|
7
4
|
- !ruby/regexp /(vendor|bundle|bin|db|tmp)\/.*/
|
|
8
5
|
DisplayCopNames: true
|
|
9
6
|
DisplayStyleGuide: true
|
|
7
|
+
# https://github.com/bbatsov/rubocop/blob/master/manual/caching.md
|
|
8
|
+
# https://github.com/bbatsov/rubocop/blob/e8680418b351491e111a18cf5b453fc07a3c5239/config/default.yml#L60-L77
|
|
9
|
+
UseCache: true
|
|
10
|
+
CacheRootDirectory: tmp
|
|
10
11
|
|
|
11
12
|
Rails:
|
|
12
13
|
Enabled: true
|
|
@@ -46,7 +47,7 @@ Style/AlignParameters:
|
|
|
46
47
|
EnforcedStyle: with_fixed_indentation
|
|
47
48
|
|
|
48
49
|
Style/ClassAndModuleChildren:
|
|
49
|
-
EnforcedStyle:
|
|
50
|
+
EnforcedStyle: nested
|
|
50
51
|
|
|
51
52
|
Style/Documentation:
|
|
52
53
|
Enabled: false
|
data/.travis.yml
CHANGED
|
@@ -4,15 +4,19 @@ sudo: false
|
|
|
4
4
|
|
|
5
5
|
rvm:
|
|
6
6
|
- 2.1
|
|
7
|
-
- 2.2.
|
|
8
|
-
- 2.3.
|
|
7
|
+
- 2.2.6
|
|
8
|
+
- 2.3.3
|
|
9
9
|
- ruby-head
|
|
10
|
-
- jruby-9.0.
|
|
10
|
+
- jruby-9.1.5.0 # is precompiled per http://rubies.travis-ci.org/
|
|
11
11
|
- jruby-head
|
|
12
12
|
|
|
13
13
|
jdk:
|
|
14
14
|
- oraclejdk8
|
|
15
15
|
|
|
16
|
+
before_install:
|
|
17
|
+
- gem update --system
|
|
18
|
+
- rvm @global do gem uninstall bundler -a -x
|
|
19
|
+
- rvm @global do gem install bundler -v 1.13.7
|
|
16
20
|
install: bundle install --path=vendor/bundle --retry=3 --jobs=3
|
|
17
21
|
cache:
|
|
18
22
|
directories:
|
|
@@ -20,23 +24,31 @@ cache:
|
|
|
20
24
|
|
|
21
25
|
script:
|
|
22
26
|
- bundle exec rake ci
|
|
23
|
-
|
|
27
|
+
after_success:
|
|
28
|
+
- codeclimate-test-reporter
|
|
24
29
|
env:
|
|
25
30
|
global:
|
|
26
31
|
- "JRUBY_OPTS='--dev -J-Xmx1024M --debug'"
|
|
27
32
|
matrix:
|
|
28
33
|
- "RAILS_VERSION=4.1"
|
|
29
34
|
- "RAILS_VERSION=4.2"
|
|
35
|
+
- "RAILS_VERSION=5.0"
|
|
30
36
|
- "RAILS_VERSION=master"
|
|
31
37
|
|
|
32
38
|
matrix:
|
|
33
39
|
exclude:
|
|
34
40
|
- rvm: 2.1
|
|
35
41
|
env: RAILS_VERSION=master
|
|
36
|
-
- rvm: jruby-9.
|
|
42
|
+
- rvm: jruby-9.1.5.0
|
|
37
43
|
env: RAILS_VERSION=master
|
|
38
44
|
- rvm: jruby-head
|
|
39
45
|
env: RAILS_VERSION=master
|
|
46
|
+
- rvm: 2.1
|
|
47
|
+
env: RAILS_VERSION=5.0
|
|
48
|
+
- rvm: jruby-9.1.5.0
|
|
49
|
+
env: RAILS_VERSION=5.0
|
|
50
|
+
- rvm: jruby-head
|
|
51
|
+
env: RAILS_VERSION=5.0
|
|
40
52
|
allow_failures:
|
|
41
53
|
- rvm: ruby-head
|
|
42
54
|
- rvm: jruby-head
|
data/CHANGELOG.md
CHANGED
|
@@ -1,8 +1,131 @@
|
|
|
1
1
|
## 0.10.x
|
|
2
2
|
|
|
3
|
-
### [master (unreleased)](https://github.com/rails-api/active_model_serializers/compare/v0.10.
|
|
3
|
+
### [master (unreleased)](https://github.com/rails-api/active_model_serializers/compare/v0.10.6...master)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Breaking changes:
|
|
6
|
+
|
|
7
|
+
Features:
|
|
8
|
+
|
|
9
|
+
Fixes:
|
|
10
|
+
|
|
11
|
+
Misc:
|
|
12
|
+
|
|
13
|
+
### [v0.10.6 (2017-05-01)](https://github.com/rails-api/active_model_serializers/compare/v0.10.5...v0.10.6)
|
|
14
|
+
|
|
15
|
+
Fixes:
|
|
16
|
+
|
|
17
|
+
- [#1857](https://github.com/rails-api/active_model_serializers/pull/1857) JSON:API does not load belongs_to relation to get identifier id. (@bf4)
|
|
18
|
+
- [#2119](https://github.com/rails-api/active_model_serializers/pull/2119) JSON:API returns null resource object identifier when 'id' is null. (@bf4)
|
|
19
|
+
- [#2093](https://github.com/rails-api/active_model_serializers/pull/2093) undef problematic Serializer methods: display, select. (@bf4)
|
|
20
|
+
|
|
21
|
+
Misc:
|
|
22
|
+
|
|
23
|
+
- [#2104](https://github.com/rails-api/active_model_serializers/pull/2104) Documentation for serializers and rendering. (@cassidycodes)
|
|
24
|
+
- [#2081](https://github.com/rails-api/active_model_serializers/pull/2081) Documentation for `include` option in adapters. (@charlie-wasp)
|
|
25
|
+
- [#2120](https://github.com/rails-api/active_model_serializers/pull/2120) Documentation for association options: foreign_key, type, class_name, namespace. (@bf4)
|
|
26
|
+
|
|
27
|
+
### [v0.10.5 (2017-03-07)](https://github.com/rails-api/active_model_serializers/compare/v0.10.4...v0.10.5)
|
|
28
|
+
|
|
29
|
+
Breaking changes:
|
|
30
|
+
|
|
31
|
+
Features:
|
|
32
|
+
|
|
33
|
+
- [#2021](https://github.com/rails-api/active_model_serializers/pull/2021) ActiveModelSerializers::Model#attributes. Originally in [#1982](https://github.com/rails-api/active_model_serializers/pull/1982). (@bf4)
|
|
34
|
+
- [#2057](https://github.com/rails-api/active_model_serializers/pull/2057)
|
|
35
|
+
Update version constraint for jsonapi-renderer to `['>= 0.1.1.beta1', '< 0.2']`
|
|
36
|
+
(@jaredbeck)
|
|
37
|
+
|
|
38
|
+
Fixes:
|
|
39
|
+
|
|
40
|
+
- [#2022](https://github.com/rails-api/active_model_serializers/pull/2022) Mutation of ActiveModelSerializers::Model now changes the attributes. Originally in [#1984](https://github.com/rails-api/active_model_serializers/pull/1984). (@bf4)
|
|
41
|
+
|
|
42
|
+
Misc:
|
|
43
|
+
|
|
44
|
+
- [#2055](https://github.com/rails-api/active_model_serializers/pull/2055)
|
|
45
|
+
Replace deprecated dependency jsonapi with jsonapi-renderer. (@jaredbeck)
|
|
46
|
+
- [#2021](https://github.com/rails-api/active_model_serializers/pull/2021) Make test attributes explicit. Tests have Model#associations. (@bf4)
|
|
47
|
+
- [#1981](https://github.com/rails-api/active_model_serializers/pull/1981) Fix relationship link documentation. (@groyoh)
|
|
48
|
+
- [#2035](https://github.com/rails-api/active_model_serializers/pull/2035) Document how to disable the logger. (@MSathieu)
|
|
49
|
+
- [#2039](https://github.com/rails-api/active_model_serializers/pull/2039) Documentation fixes. (@biow0lf)
|
|
50
|
+
|
|
51
|
+
### [v0.10.4 (2017-01-06)](https://github.com/rails-api/active_model_serializers/compare/v0.10.3...v0.10.4)
|
|
52
|
+
|
|
53
|
+
Misc:
|
|
54
|
+
|
|
55
|
+
- [#2005](https://github.com/rails-api/active_model_serializers/pull/2005) Update jsonapi runtime dependency to 0.1.1.beta6, support Ruby 2.4. (@kofronpi)
|
|
56
|
+
- [#1993](https://github.com/rails-api/active_model_serializers/pull/1993) Swap out KeyTransform for CaseTransform gem for the possibility of native extension use. (@NullVoxPopuli)
|
|
57
|
+
|
|
58
|
+
### [v0.10.3 (2016-11-21)](https://github.com/rails-api/active_model_serializers/compare/v0.10.2...v0.10.3)
|
|
59
|
+
|
|
60
|
+
Fixes:
|
|
61
|
+
|
|
62
|
+
- [#1973](https://github.com/rails-api/active_model_serializers/pull/1973) Fix namespace lookup for collections and has_many relationships (@groyoh)
|
|
63
|
+
- [#1887](https://github.com/rails-api/active_model_serializers/pull/1887) Make the comment reflect what the function does (@johnnymo87)
|
|
64
|
+
- [#1890](https://github.com/rails-api/active_model_serializers/issues/1890) Ensure generator inherits from ApplicationSerializer when available (@richmolj)
|
|
65
|
+
- [#1922](https://github.com/rails-api/active_model_serializers/pull/1922) Make railtie an optional dependency in runtime (@ggpasqualino)
|
|
66
|
+
- [#1930](https://github.com/rails-api/active_model_serializers/pull/1930) Ensure valid jsonapi when relationship has no links or data (@richmolj)
|
|
67
|
+
|
|
68
|
+
Features:
|
|
69
|
+
|
|
70
|
+
- [#1757](https://github.com/rails-api/active_model_serializers/pull/1757) Make serializer lookup chain configurable. (@NullVoxPopuli)
|
|
71
|
+
- [#1968](https://github.com/rails-api/active_model_serializers/pull/1968) (@NullVoxPopuli)
|
|
72
|
+
- Add controller namespace to default controller lookup
|
|
73
|
+
- Provide a `namespace` render option
|
|
74
|
+
- document how set the namespace in the controller for implicit lookup.
|
|
75
|
+
- [#1791](https://github.com/rails-api/active_model_serializers/pull/1791) (@bf4, @youroff, @NullVoxPopuli)
|
|
76
|
+
- Added `jsonapi_namespace_separator` config option.
|
|
77
|
+
- [#1889](https://github.com/rails-api/active_model_serializers/pull/1889) Support key transformation for Attributes adapter (@iancanderson, @danbee)
|
|
78
|
+
- [#1917](https://github.com/rails-api/active_model_serializers/pull/1917) Add `jsonapi_pagination_links_enabled` configuration option (@richmolj)
|
|
79
|
+
- [#1797](https://github.com/rails-api/active_model_serializers/pull/1797) Only include 'relationships' when sideloading (@richmolj)
|
|
80
|
+
|
|
81
|
+
Fixes:
|
|
82
|
+
|
|
83
|
+
- [#1833](https://github.com/rails-api/active_model_serializers/pull/1833) Remove relationship links if they are null (@groyoh)
|
|
84
|
+
- [#1881](https://github.com/rails-api/active_model_serializers/pull/1881) ActiveModelSerializers::Model correctly works with string keys (@yevhene)
|
|
85
|
+
|
|
86
|
+
Misc:
|
|
87
|
+
- [#1767](https://github.com/rails-api/active_model_serializers/pull/1767) Replace raising/rescuing `CollectionSerializer::NoSerializerError`,
|
|
88
|
+
throw/catch `:no_serializer`. (@bf4)
|
|
89
|
+
- [#1839](https://github.com/rails-api/active_model_serializers/pull/1839) `fields` tests demonstrating usage for both attributes and relationships. (@NullVoxPopuli)
|
|
90
|
+
- [#1812](https://github.com/rails-api/active_model_serializers/pull/1812) add a code of conduct (@corainchicago)
|
|
91
|
+
|
|
92
|
+
- [#1878](https://github.com/rails-api/active_model_serializers/pull/1878) Cache key generation for serializers now uses `ActiveSupport::Cache.expand_cache_key` instead of `Array#join` by default and is also overridable. This change should be backward-compatible. (@markiz)
|
|
93
|
+
|
|
94
|
+
- [#1799](https://github.com/rails-api/active_model_serializers/pull/1799) Add documentation for setting the adapter. (@cassidycodes)
|
|
95
|
+
- [#1909](https://github.com/rails-api/active_model_serializers/pull/1909) Add documentation for relationship links. (@vasilakisfil, @NullVoxPopuli)
|
|
96
|
+
- [#1959](https://github.com/rails-api/active_model_serializers/pull/1959) Add documentation for root. (@shunsuke227ono)
|
|
97
|
+
- [#1967](https://github.com/rails-api/active_model_serializers/pull/1967) Improve type method documentation. (@yukideluxe)
|
|
98
|
+
|
|
99
|
+
### [v0.10.2 (2016-07-05)](https://github.com/rails-api/active_model_serializers/compare/v0.10.1...v0.10.2)
|
|
100
|
+
|
|
101
|
+
Fixes:
|
|
102
|
+
- [#1814](https://github.com/rails-api/active_model_serializers/pull/1814) Ensuring read_multi works with fragment cache
|
|
103
|
+
- [#1848](https://github.com/rails-api/active_model_serializers/pull/1848) Redefine associations on inherited serializers. (@EhsanYousefi)
|
|
104
|
+
|
|
105
|
+
Misc:
|
|
106
|
+
- [#1808](https://github.com/rails-api/active_model_serializers/pull/1808) Adds documentation for `fields` option. (@luizkowalski)
|
|
107
|
+
|
|
108
|
+
### [v0.10.1 (2016-06-16)](https://github.com/rails-api/active_model_serializers/compare/v0.10.0...v0.10.1)
|
|
109
|
+
|
|
110
|
+
Features:
|
|
111
|
+
- [#1668](https://github.com/rails-api/active_model_serializers/pull/1668) Exclude nil and empty links. (@sigmike)
|
|
112
|
+
- [#1426](https://github.com/rails-api/active_model_serializers/pull/1426) Add ActiveModelSerializers.config.default_includes (@empact)
|
|
113
|
+
|
|
114
|
+
Fixes:
|
|
115
|
+
- [#1754](https://github.com/rails-api/active_model_serializers/pull/1754) Fixes #1759, Grape integration, improves serialization_context
|
|
116
|
+
missing error message on pagination. Document overriding CollectionSerializer#paginated?. (@bf4)
|
|
117
|
+
Moved serialization_context creation to Grape formatter, so resource serialization works without explicit calls to the `render` helper method.
|
|
118
|
+
Added Grape collection tests. (@onomated)
|
|
119
|
+
- [#1287](https://github.com/rails-api/active_model_serializers/pull/1287) Pass `fields` options from adapter to serializer. (@vasilakisfil)
|
|
120
|
+
- [#1710](https://github.com/rails-api/active_model_serializers/pull/1710) Prevent association loading when `include_data` option
|
|
121
|
+
is set to `false`. (@groyoh)
|
|
122
|
+
- [#1747](https://github.com/rails-api/active_model_serializers/pull/1747) Improve jsonapi mime type registration for Rails 5 (@remear)
|
|
123
|
+
|
|
124
|
+
Misc:
|
|
125
|
+
- [#1734](https://github.com/rails-api/active_model_serializers/pull/1734) Adds documentation for conditional attribute (@lambda2)
|
|
126
|
+
- [#1685](https://github.com/rails-api/active_model_serializers/pull/1685) Replace `IncludeTree` with `IncludeDirective` from the jsonapi gem.
|
|
127
|
+
|
|
128
|
+
### [v0.10.0 (2016-05-17)](https://github.com/rails-api/active_model_serializers/compare/4a2d9853ba7...v0.10.0)
|
|
6
129
|
|
|
7
130
|
Breaking changes:
|
|
8
131
|
- [#1662](https://github.com/rails-api/active_model_serializers/pull/1662) Drop support for Rails 4.0 and Ruby 2.0.0. (@remear)
|
|
@@ -22,6 +145,7 @@ Fixes:
|
|
|
22
145
|
|
|
23
146
|
Misc:
|
|
24
147
|
- [#1673](https://github.com/rails-api/active_model_serializers/pull/1673) Adds "How to" guide on using AMS with POROs (@DrSayre)
|
|
148
|
+
- [#1730](https://github.com/rails-api/active_model_serializers/pull/1730) Adds documentation for overriding default serializer based on conditions (@groyoh/@cgmckeever)
|
|
25
149
|
|
|
26
150
|
### [v0.10.0.rc5 (2016-04-04)](https://github.com/rails-api/active_model_serializers/compare/v0.10.0.rc4...v0.10.0.rc5)
|
|
27
151
|
|
data/CODE_OF_CONDUCT.md
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Contributor Covenant Code of Conduct
|
|
2
|
+
|
|
3
|
+
## Our Pledge
|
|
4
|
+
|
|
5
|
+
In the interest of fostering an open and welcoming environment, we as
|
|
6
|
+
contributors and maintainers pledge to making participation in our project and
|
|
7
|
+
our community a harassment-free experience for everyone, regardless of age, body
|
|
8
|
+
size, disability, ethnicity, gender identity and expression, level of experience,
|
|
9
|
+
nationality, personal appearance, race, religion, or sexual identity and
|
|
10
|
+
orientation.
|
|
11
|
+
|
|
12
|
+
## Our Standards
|
|
13
|
+
|
|
14
|
+
Examples of behavior that contributes to creating a positive environment
|
|
15
|
+
include:
|
|
16
|
+
|
|
17
|
+
* Using welcoming and inclusive language
|
|
18
|
+
* Being respectful of differing viewpoints and experiences
|
|
19
|
+
* Gracefully accepting constructive criticism
|
|
20
|
+
* Focusing on what is best for the community
|
|
21
|
+
* Showing empathy towards other community members
|
|
22
|
+
|
|
23
|
+
Examples of unacceptable behavior by participants include:
|
|
24
|
+
|
|
25
|
+
* The use of sexualized language or imagery and unwelcome sexual attention or
|
|
26
|
+
advances
|
|
27
|
+
* Trolling, insulting/derogatory comments, and personal or political attacks
|
|
28
|
+
* Public or private harassment
|
|
29
|
+
* Publishing others' private information, such as a physical or electronic
|
|
30
|
+
address, without explicit permission
|
|
31
|
+
* Other conduct which could reasonably be considered inappropriate in a
|
|
32
|
+
professional setting
|
|
33
|
+
|
|
34
|
+
## Our Responsibilities
|
|
35
|
+
|
|
36
|
+
Project maintainers are responsible for clarifying the standards of acceptable
|
|
37
|
+
behavior and are expected to take appropriate and fair corrective action in
|
|
38
|
+
response to any instances of unacceptable behavior.
|
|
39
|
+
|
|
40
|
+
Project maintainers have the right and responsibility to remove, edit, or
|
|
41
|
+
reject comments, commits, code, wiki edits, issues, and other contributions
|
|
42
|
+
that are not aligned to this Code of Conduct, or to ban temporarily or
|
|
43
|
+
permanently any contributor for other behaviors that they deem inappropriate,
|
|
44
|
+
threatening, offensive, or harmful.
|
|
45
|
+
|
|
46
|
+
## Scope
|
|
47
|
+
|
|
48
|
+
This Code of Conduct applies both within project spaces and in public spaces
|
|
49
|
+
when an individual is representing the project or its community. Examples of
|
|
50
|
+
representing a project or community include using an official project e-mail
|
|
51
|
+
address, posting via an official social media account, or acting as an appointed
|
|
52
|
+
representative at an online or offline event. Representation of a project may be
|
|
53
|
+
further defined and clarified by project maintainers.
|
|
54
|
+
|
|
55
|
+
## Enforcement
|
|
56
|
+
|
|
57
|
+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
|
|
58
|
+
reported by contacting one of the owners listed at https://rubygems.org/gems/active_model_serializers. All
|
|
59
|
+
complaints will be reviewed and investigated and will result in a response that
|
|
60
|
+
is deemed necessary and appropriate to the circumstances. The project team is
|
|
61
|
+
obligated to maintain confidentiality with regard to the reporter of an incident.
|
|
62
|
+
Further details of specific enforcement policies may be posted separately.
|
|
63
|
+
|
|
64
|
+
Project maintainers who do not follow or enforce the Code of Conduct in good
|
|
65
|
+
faith may face temporary or permanent repercussions as determined by other
|
|
66
|
+
members of the project's leadership.
|
|
67
|
+
|
|
68
|
+
## Attribution
|
|
69
|
+
|
|
70
|
+
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
|
|
71
|
+
available at [http://contributor-covenant.org/version/1/4][version]
|
|
72
|
+
|
|
73
|
+
[homepage]: http://contributor-covenant.org
|
|
74
|
+
[version]: http://contributor-covenant.org/version/1/4/
|
data/Gemfile
CHANGED
|
@@ -38,16 +38,19 @@ gem 'tzinfo-data', platforms: (@windows_platforms + [:jruby])
|
|
|
38
38
|
|
|
39
39
|
group :bench do
|
|
40
40
|
# https://github.com/rails-api/active_model_serializers/commit/cb4459580a6f4f37f629bf3185a5224c8624ca76
|
|
41
|
-
gem 'benchmark-ips', require: false, group: :development
|
|
41
|
+
gem 'benchmark-ips', '>= 2.7.2', require: false, group: :development
|
|
42
42
|
end
|
|
43
43
|
|
|
44
44
|
group :test do
|
|
45
45
|
gem 'sqlite3', platform: (@windows_platforms + [:ruby])
|
|
46
46
|
gem 'activerecord-jdbcsqlite3-adapter', platform: :jruby
|
|
47
47
|
gem 'codeclimate-test-reporter', require: false
|
|
48
|
+
gem 'm', '~> 1.5'
|
|
49
|
+
gem 'pry', '~> 0.10'
|
|
50
|
+
gem 'pry-byebug', '~> 3.4', platform: :ruby
|
|
48
51
|
end
|
|
49
52
|
|
|
50
53
|
group :development, :test do
|
|
51
|
-
gem 'rubocop', '~> 0.
|
|
54
|
+
gem 'rubocop', '~> 0.40.0', require: false
|
|
52
55
|
gem 'yard', require: false
|
|
53
56
|
end
|
data/README.md
CHANGED
|
@@ -24,17 +24,6 @@
|
|
|
24
24
|
</tr>
|
|
25
25
|
</table>
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
## Documentation
|
|
29
|
-
|
|
30
|
-
- [0.10 (master) Documentation](https://github.com/rails-api/active_model_serializers/tree/master)
|
|
31
|
-
- [](http://www.rubydoc.info/github/rails-api/active_model_serializers/v0.10.0)
|
|
32
|
-
- [Guides](docs)
|
|
33
|
-
- [0.9 (0-9-stable) Documentation](https://github.com/rails-api/active_model_serializers/tree/0-9-stable)
|
|
34
|
-
- [](http://www.rubydoc.info/github/rails-api/active_model_serializers/0-9-stable)
|
|
35
|
-
- [0.8 (0-8-stable) Documentation](https://github.com/rails-api/active_model_serializers/tree/0-8-stable)
|
|
36
|
-
- [](http://www.rubydoc.info/github/rails-api/active_model_serializers/0-8-stable)
|
|
37
|
-
|
|
38
27
|
## About
|
|
39
28
|
|
|
40
29
|
ActiveModelSerializers brings convention over configuration to your JSON generation.
|
|
@@ -50,33 +39,24 @@ resource serialization. The serialization has the `#as_json`, `#to_json` and `#s
|
|
|
50
39
|
methods used by the Rails JSON Renderer. (SerializableResource actually delegates
|
|
51
40
|
these methods to the adapter.)
|
|
52
41
|
|
|
53
|
-
By default ActiveModelSerializers will use the **Attributes Adapter
|
|
42
|
+
By default ActiveModelSerializers will use the **Attributes Adapter** (no JSON root).
|
|
54
43
|
But we strongly advise you to use **JsonApi Adapter**, which
|
|
55
44
|
follows 1.0 of the format specified in [jsonapi.org/format](http://jsonapi.org/format).
|
|
56
45
|
Check how to change the adapter in the sections below.
|
|
57
46
|
|
|
58
|
-
## RELEASE CANDIDATE, PLEASE READ
|
|
59
|
-
|
|
60
|
-
This is the **master** branch of ActiveModelSerializers.
|
|
61
|
-
|
|
62
|
-
It will become the `0.10.0` release when it's ready. Currently this is a release candidate.
|
|
63
|
-
|
|
64
47
|
`0.10.x` is **not** backward compatible with `0.9.x` nor `0.8.x`.
|
|
65
48
|
|
|
66
|
-
`0.10.x`
|
|
49
|
+
`0.10.x` is based on the `0.8.0` code, but with a more flexible
|
|
67
50
|
architecture. We'd love your help. [Learn how you can help here.](CONTRIBUTING.md)
|
|
68
51
|
|
|
69
52
|
It is generally safe and recommended to use the master branch.
|
|
70
53
|
|
|
71
|
-
For more information, see the post '[The future of
|
|
72
|
-
AMS](https://medium.com/@joaomdmoura/the-future-of-ams-e5f9047ca7e9)'.
|
|
73
|
-
|
|
74
54
|
## Installation
|
|
75
55
|
|
|
76
56
|
Add this line to your application's Gemfile:
|
|
77
57
|
|
|
78
58
|
```
|
|
79
|
-
gem 'active_model_serializers'
|
|
59
|
+
gem 'active_model_serializers', '~> 0.10.0'
|
|
80
60
|
```
|
|
81
61
|
|
|
82
62
|
And then execute:
|
|
@@ -103,8 +83,30 @@ If you'd like to chat, we have a [community slack](http://amserializers.herokuap
|
|
|
103
83
|
|
|
104
84
|
Thanks!
|
|
105
85
|
|
|
86
|
+
## Documentation
|
|
87
|
+
|
|
88
|
+
If you're reading this at https://github.com/rails-api/active_model_serializers you are
|
|
89
|
+
reading documentation for our `master`, which may include features that have not
|
|
90
|
+
been released yet. Please see below for the documentation relevant to you.
|
|
91
|
+
|
|
92
|
+
- [0.10 (master) Documentation](https://github.com/rails-api/active_model_serializers/tree/master)
|
|
93
|
+
- [0.10.6 (latest release) Documentation](https://github.com/rails-api/active_model_serializers/tree/v0.10.6)
|
|
94
|
+
- [](http://www.rubydoc.info/gems/active_model_serializers/0.10.6)
|
|
95
|
+
- [Guides](docs)
|
|
96
|
+
- [0.9 (0-9-stable) Documentation](https://github.com/rails-api/active_model_serializers/tree/0-9-stable)
|
|
97
|
+
- [](http://www.rubydoc.info/github/rails-api/active_model_serializers/0-9-stable)
|
|
98
|
+
- [0.8 (0-8-stable) Documentation](https://github.com/rails-api/active_model_serializers/tree/0-8-stable)
|
|
99
|
+
- [](http://www.rubydoc.info/github/rails-api/active_model_serializers/0-8-stable)
|
|
100
|
+
|
|
101
|
+
|
|
106
102
|
## High-level behavior
|
|
107
103
|
|
|
104
|
+
Choose an adapter from [adapters](lib/active_model_serializers/adapter):
|
|
105
|
+
|
|
106
|
+
``` ruby
|
|
107
|
+
ActiveModelSerializers.config.adapter = :json_api # Default: `:attributes`
|
|
108
|
+
```
|
|
109
|
+
|
|
108
110
|
Given a [serializable model](lib/active_model/serializer/lint.rb):
|
|
109
111
|
|
|
110
112
|
```ruby
|
|
@@ -114,7 +116,7 @@ class SomeResource < ActiveRecord::Base
|
|
|
114
116
|
end
|
|
115
117
|
# or
|
|
116
118
|
class SomeResource < ActiveModelSerializers::Model
|
|
117
|
-
|
|
119
|
+
attributes :title, :body
|
|
118
120
|
end
|
|
119
121
|
```
|
|
120
122
|
|
|
@@ -160,8 +162,146 @@ serializer = SomeSerializer.new(resource, serializer_options)
|
|
|
160
162
|
serializer.attributes
|
|
161
163
|
serializer.associations
|
|
162
164
|
```
|
|
163
|
-
See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for more information.
|
|
164
165
|
|
|
165
|
-
|
|
166
|
+
## Architecture
|
|
167
|
+
|
|
168
|
+
This section 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,
|
|
169
|
+
please refer to the [0.8 README](https://github.com/rails-api/active_model_serializers/blob/0-8-stable/README.md) or
|
|
170
|
+
[0.9 README](https://github.com/rails-api/active_model_serializers/blob/0-9-stable/README.md).
|
|
171
|
+
|
|
172
|
+
The original design is also available [here](https://github.com/rails-api/active_model_serializers/blob/d72b66d4c5355b0ff0a75a04895fcc4ea5b0c65e/README.textile).
|
|
173
|
+
|
|
174
|
+
### ActiveModel::Serializer
|
|
175
|
+
|
|
176
|
+
An **`ActiveModel::Serializer`** wraps a [serializable resource](https://github.com/rails/rails/blob/4-2-stable/activemodel/lib/active_model/serialization.rb)
|
|
177
|
+
and exposes an `attributes` method, among a few others.
|
|
178
|
+
It allows you to specify which attributes and associations should be represented in the serializatation of the resource.
|
|
179
|
+
It requires an adapter to transform its attributes into a JSON document; it cannot be serialized itself.
|
|
180
|
+
It may be useful to think of it as a
|
|
181
|
+
[presenter](http://blog.steveklabnik.com/posts/2011-09-09-better-ruby-presenters).
|
|
182
|
+
|
|
183
|
+
#### ActiveModel::CollectionSerializer
|
|
184
|
+
|
|
185
|
+
The **`ActiveModel::CollectionSerializer`** represents a collection of resources as serializers
|
|
186
|
+
and, if there is no serializer, primitives.
|
|
187
|
+
|
|
188
|
+
### ActiveModelSerializers::Adapter::Base
|
|
189
|
+
|
|
190
|
+
The **`ActiveModelSerializeres::Adapter::Base`** describes the structure of the JSON document generated from a
|
|
191
|
+
serializer. For example, the `Attributes` example represents each serializer as its
|
|
192
|
+
unmodified attributes. The `JsonApi` adapter represents the serializer as a [JSON
|
|
193
|
+
API](http://jsonapi.org/) document.
|
|
194
|
+
|
|
195
|
+
### ActiveModelSerializers::SerializableResource
|
|
196
|
+
|
|
197
|
+
The **`ActiveModelSerializers::SerializableResource`** acts to coordinate the serializer(s) and adapter
|
|
198
|
+
to an object that responds to `to_json`, and `as_json`. It is used in the controller to
|
|
199
|
+
encapsulate the serialization resource when rendered. However, it can also be used on its own
|
|
200
|
+
to serialize a resource outside of a controller, as well.
|
|
201
|
+
|
|
202
|
+
### Primitive handling
|
|
203
|
+
|
|
204
|
+
Definitions: A primitive is usually a String or Array. There is no serializer
|
|
205
|
+
defined for them; they will be serialized when the resource is converted to JSON (`as_json` or
|
|
206
|
+
`to_json`). (The below also applies for any object with no serializer.)
|
|
207
|
+
|
|
208
|
+
- ActiveModelSerializers doesn't handle primitives passed to `render json:` at all.
|
|
209
|
+
|
|
210
|
+
Internally, if no serializer can be found in the controller, the resource is not decorated by
|
|
211
|
+
ActiveModelSerializers.
|
|
212
|
+
|
|
213
|
+
- However, when a primitive value is an attribute or in a collection, it is not modified.
|
|
214
|
+
|
|
215
|
+
When serializing a collection and the collection serializer (CollectionSerializer) cannot
|
|
216
|
+
identify a serializer for a resource in its collection, it throws [`:no_serializer`](https://github.com/rails-api/active_model_serializers/issues/1191#issuecomment-142327128).
|
|
217
|
+
For example, when caught by `Reflection#build_association`, and the association value is set directly:
|
|
218
|
+
|
|
219
|
+
```ruby
|
|
220
|
+
reflection_options[:virtual_value] = association_value.try(:as_json) || association_value
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
(which is called by the adapter as `serializer.associations(*)`.)
|
|
224
|
+
|
|
225
|
+
### How options are parsed
|
|
226
|
+
|
|
227
|
+
High-level overview:
|
|
228
|
+
|
|
229
|
+
- For a **collection**
|
|
230
|
+
- `:serializer` specifies the collection serializer and
|
|
231
|
+
- `:each_serializer` specifies the serializer for each resource in the collection.
|
|
232
|
+
- For a **single resource**, the `:serializer` option is the resource serializer.
|
|
233
|
+
- Options are partitioned in serializer options and adapter options. Keys for adapter options are specified by
|
|
234
|
+
[`ADAPTER_OPTION_KEYS`](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model_serializers/serializable_resource.rb#L5).
|
|
235
|
+
The remaining options are serializer options.
|
|
236
|
+
|
|
237
|
+
Details:
|
|
238
|
+
|
|
239
|
+
1. **ActionController::Serialization**
|
|
240
|
+
1. `serializable_resource = ActiveModelSerializers::SerializableResource.new(resource, options)`
|
|
241
|
+
1. `options` are partitioned into `adapter_opts` and everything else (`serializer_opts`).
|
|
242
|
+
The `adapter_opts` keys are defined in [`ActiveModelSerializers::SerializableResource::ADAPTER_OPTION_KEYS`](lib/active_model_serializers/serializable_resource.rb#L5).
|
|
243
|
+
1. **ActiveModelSerializers::SerializableResource**
|
|
244
|
+
1. `if serializable_resource.serializer?` (there is a serializer for the resource, and an adapter is used.)
|
|
245
|
+
- Where `serializer?` is `use_adapter? && !!(serializer)`
|
|
246
|
+
- Where `use_adapter?`: 'True when no explicit adapter given, or explicit value is truthy (non-nil);
|
|
247
|
+
False when explicit adapter is falsy (nil or false)'
|
|
248
|
+
- Where `serializer`:
|
|
249
|
+
1. from explicit `:serializer` option, else
|
|
250
|
+
2. implicitly from resource `ActiveModel::Serializer.serializer_for(resource)`
|
|
251
|
+
1. A side-effect of checking `serializer` is:
|
|
252
|
+
- The `:serializer` option is removed from the serializer_opts hash
|
|
253
|
+
- If the `:each_serializer` option is present, it is removed from the serializer_opts hash and set as the `:serializer` option
|
|
254
|
+
1. The serializer and adapter are created as
|
|
255
|
+
1. `serializer_instance = serializer.new(resource, serializer_opts)`
|
|
256
|
+
2. `adapter_instance = ActiveModel::Serializer::Adapter.create(serializer_instance, adapter_opts)`
|
|
257
|
+
1. **ActiveModel::Serializer::CollectionSerializer#new**
|
|
258
|
+
1. If the `serializer_instance` was a `CollectionSerializer` and the `:serializer` serializer_opts
|
|
259
|
+
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).
|
|
260
|
+
1. **ActiveModel::Serializer#attributes** is used by the adapter to get the attributes for
|
|
261
|
+
resource as defined by the serializer.
|
|
262
|
+
|
|
263
|
+
(In Rails, the `options` are also passed to the `as_json(options)` or `to_json(options)`
|
|
264
|
+
methods on the resource serialization by the Rails JSON renderer. They are, therefore, important
|
|
265
|
+
to know about, but not part of ActiveModelSerializers.)
|
|
266
|
+
|
|
267
|
+
### What does a 'serializable resource' look like?
|
|
268
|
+
|
|
269
|
+
- An `ActiveRecord::Base` object.
|
|
270
|
+
- Any Ruby object that passes the
|
|
271
|
+
[Lint](http://www.rubydoc.info/github/rails-api/active_model_serializers/ActiveModel/Serializer/Lint/Tests)
|
|
272
|
+
[code](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model/serializer/lint.rb).
|
|
273
|
+
|
|
274
|
+
ActiveModelSerializers provides a
|
|
275
|
+
[`ActiveModelSerializers::Model`](https://github.com/rails-api/active_model_serializers/blob/master/lib/active_model_serializers/model.rb),
|
|
276
|
+
which is a simple serializable PORO (Plain-Old Ruby Object).
|
|
277
|
+
|
|
278
|
+
`ActiveModelSerializers::Model` may be used either as a reference implementation, or in production code.
|
|
279
|
+
|
|
280
|
+
```ruby
|
|
281
|
+
class MyModel < ActiveModelSerializers::Model
|
|
282
|
+
attributes :id, :name, :level
|
|
283
|
+
end
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
The default serializer for `MyModel` would be `MyModelSerializer` whether MyModel is an
|
|
287
|
+
ActiveRecord::Base object or not.
|
|
288
|
+
|
|
289
|
+
Outside of the controller the rules are **exactly** the same as for records. For example:
|
|
290
|
+
|
|
291
|
+
```ruby
|
|
292
|
+
render json: MyModel.new(level: 'awesome'), adapter: :json
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
would be serialized the same as
|
|
296
|
+
|
|
297
|
+
```ruby
|
|
298
|
+
ActiveModelSerializers::SerializableResource.new(MyModel.new(level: 'awesome'), adapter: :json).as_json
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
## Semantic Versioning
|
|
302
|
+
|
|
303
|
+
This project adheres to [semver](http://semver.org/)
|
|
304
|
+
|
|
305
|
+
## Contributing
|
|
166
306
|
|
|
167
307
|
See [CONTRIBUTING.md](CONTRIBUTING.md)
|
data/Rakefile
CHANGED
|
@@ -5,8 +5,9 @@ rescue LoadError
|
|
|
5
5
|
end
|
|
6
6
|
begin
|
|
7
7
|
require 'simplecov'
|
|
8
|
-
rescue LoadError
|
|
8
|
+
rescue LoadError # rubocop:disable Lint/HandleExceptions
|
|
9
9
|
end
|
|
10
|
+
import('lib/tasks/rubocop.rake')
|
|
10
11
|
|
|
11
12
|
Bundler::GemHelper.install_tasks
|
|
12
13
|
|
|
@@ -30,36 +31,6 @@ namespace :yard do
|
|
|
30
31
|
end
|
|
31
32
|
end
|
|
32
33
|
|
|
33
|
-
begin
|
|
34
|
-
require 'rubocop'
|
|
35
|
-
require 'rubocop/rake_task'
|
|
36
|
-
rescue LoadError
|
|
37
|
-
else
|
|
38
|
-
Rake::Task[:rubocop].clear if Rake::Task.task_defined?(:rubocop)
|
|
39
|
-
require 'rbconfig'
|
|
40
|
-
# https://github.com/bundler/bundler/blob/1b3eb2465a/lib/bundler/constants.rb#L2
|
|
41
|
-
windows_platforms = /(msdos|mswin|djgpp|mingw)/
|
|
42
|
-
if RbConfig::CONFIG['host_os'] =~ windows_platforms
|
|
43
|
-
desc 'No-op rubocop on Windows-- unsupported platform'
|
|
44
|
-
task :rubocop do
|
|
45
|
-
puts 'Skipping rubocop on Windows'
|
|
46
|
-
end
|
|
47
|
-
elsif defined?(::Rubinius)
|
|
48
|
-
desc 'No-op rubocop to avoid rbx segfault'
|
|
49
|
-
task :rubocop do
|
|
50
|
-
puts 'Skipping rubocop on rbx due to segfault'
|
|
51
|
-
puts 'https://github.com/rubinius/rubinius/issues/3499'
|
|
52
|
-
end
|
|
53
|
-
else
|
|
54
|
-
Rake::Task[:rubocop].clear if Rake::Task.task_defined?(:rubocop)
|
|
55
|
-
desc 'Execute rubocop'
|
|
56
|
-
RuboCop::RakeTask.new(:rubocop) do |task|
|
|
57
|
-
task.options = ['--rails', '--display-cop-names', '--display-style-guide']
|
|
58
|
-
task.fail_on_error = true
|
|
59
|
-
end
|
|
60
|
-
end
|
|
61
|
-
end
|
|
62
|
-
|
|
63
34
|
require 'rake/testtask'
|
|
64
35
|
|
|
65
36
|
Rake::TestTask.new(:test) do |t|
|
|
@@ -100,4 +71,4 @@ else
|
|
|
100
71
|
end
|
|
101
72
|
|
|
102
73
|
desc 'CI test task'
|
|
103
|
-
task :
|
|
74
|
+
task ci: [:default]
|