active_model_serializers 0.8.3 → 0.10.0.rc5

Sign up to get free protection for your applications and to get access to all the features.
Files changed (235) hide show
  1. checksums.yaml +4 -4
  2. data/.github/ISSUE_TEMPLATE.md +29 -0
  3. data/.github/PULL_REQUEST_TEMPLATE.md +15 -0
  4. data/.gitignore +7 -0
  5. data/.rubocop.yml +104 -0
  6. data/.rubocop_todo.yml +167 -0
  7. data/.simplecov +110 -0
  8. data/.travis.yml +46 -23
  9. data/CHANGELOG.md +442 -6
  10. data/CONTRIBUTING.md +95 -0
  11. data/Gemfile +51 -1
  12. data/{MIT-LICENSE.txt → MIT-LICENSE} +3 -2
  13. data/README.md +102 -590
  14. data/Rakefile +93 -8
  15. data/active_model_serializers.gemspec +65 -23
  16. data/appveyor.yml +28 -0
  17. data/bin/bench +171 -0
  18. data/bin/bench_regression +316 -0
  19. data/bin/serve_benchmark +39 -0
  20. data/docs/ARCHITECTURE.md +126 -0
  21. data/docs/README.md +39 -0
  22. data/docs/STYLE.md +58 -0
  23. data/docs/general/adapters.md +245 -0
  24. data/docs/general/caching.md +52 -0
  25. data/docs/general/configuration_options.md +100 -0
  26. data/docs/general/deserialization.md +100 -0
  27. data/docs/general/getting_started.md +133 -0
  28. data/docs/general/instrumentation.md +40 -0
  29. data/docs/general/key_transforms.md +40 -0
  30. data/docs/general/logging.md +14 -0
  31. data/docs/general/rendering.md +255 -0
  32. data/docs/general/serializers.md +339 -0
  33. data/docs/how-open-source-maintained.jpg +0 -0
  34. data/docs/howto/add_pagination_links.md +139 -0
  35. data/docs/howto/add_root_key.md +51 -0
  36. data/docs/howto/outside_controller_use.md +58 -0
  37. data/docs/howto/passing_arbitrary_options.md +27 -0
  38. data/docs/howto/test.md +152 -0
  39. data/docs/integrations/ember-and-json-api.md +112 -0
  40. data/docs/integrations/grape.md +19 -0
  41. data/docs/jsonapi/errors.md +56 -0
  42. data/docs/jsonapi/schema/schema.json +366 -0
  43. data/docs/jsonapi/schema.md +151 -0
  44. data/docs/rfcs/0000-namespace.md +106 -0
  45. data/docs/rfcs/template.md +15 -0
  46. data/lib/action_controller/serialization.rb +31 -36
  47. data/lib/active_model/serializable_resource.rb +11 -0
  48. data/lib/active_model/serializer/adapter/attributes.rb +15 -0
  49. data/lib/active_model/serializer/adapter/base.rb +16 -0
  50. data/lib/active_model/serializer/adapter/json.rb +15 -0
  51. data/lib/active_model/serializer/adapter/json_api.rb +15 -0
  52. data/lib/active_model/serializer/adapter/null.rb +15 -0
  53. data/lib/active_model/serializer/adapter.rb +24 -0
  54. data/lib/active_model/serializer/array_serializer.rb +9 -0
  55. data/lib/active_model/serializer/association.rb +19 -0
  56. data/lib/active_model/serializer/associations.rb +87 -220
  57. data/lib/active_model/serializer/attribute.rb +25 -0
  58. data/lib/active_model/serializer/attributes.rb +82 -0
  59. data/lib/active_model/serializer/belongs_to_reflection.rb +10 -0
  60. data/lib/active_model/serializer/caching.rb +151 -0
  61. data/lib/active_model/serializer/collection_reflection.rb +7 -0
  62. data/lib/active_model/serializer/collection_serializer.rb +64 -0
  63. data/lib/active_model/serializer/configuration.rb +35 -0
  64. data/lib/active_model/serializer/error_serializer.rb +10 -0
  65. data/lib/active_model/serializer/errors_serializer.rb +27 -0
  66. data/lib/active_model/serializer/field.rb +56 -0
  67. data/lib/active_model/serializer/fieldset.rb +31 -0
  68. data/lib/active_model/serializer/has_many_reflection.rb +10 -0
  69. data/lib/active_model/serializer/has_one_reflection.rb +10 -0
  70. data/lib/active_model/serializer/include_tree.rb +111 -0
  71. data/lib/active_model/serializer/links.rb +35 -0
  72. data/lib/active_model/serializer/lint.rb +156 -0
  73. data/lib/active_model/serializer/meta.rb +29 -0
  74. data/lib/active_model/serializer/null.rb +17 -0
  75. data/lib/active_model/serializer/reflection.rb +147 -0
  76. data/lib/active_model/serializer/singular_reflection.rb +7 -0
  77. data/lib/active_model/serializer/type.rb +25 -0
  78. data/lib/active_model/{serializers → serializer}/version.rb +1 -1
  79. data/lib/active_model/serializer.rb +156 -481
  80. data/lib/active_model_serializers/adapter/attributes.rb +94 -0
  81. data/lib/active_model_serializers/adapter/base.rb +90 -0
  82. data/lib/active_model_serializers/adapter/json.rb +11 -0
  83. data/lib/active_model_serializers/adapter/json_api/deserialization.rb +213 -0
  84. data/lib/active_model_serializers/adapter/json_api/error.rb +96 -0
  85. data/lib/active_model_serializers/adapter/json_api/jsonapi.rb +49 -0
  86. data/lib/active_model_serializers/adapter/json_api/link.rb +83 -0
  87. data/lib/active_model_serializers/adapter/json_api/meta.rb +37 -0
  88. data/lib/active_model_serializers/adapter/json_api/pagination_links.rb +57 -0
  89. data/lib/active_model_serializers/adapter/json_api/relationship.rb +52 -0
  90. data/lib/active_model_serializers/adapter/json_api/resource_identifier.rb +37 -0
  91. data/lib/active_model_serializers/adapter/json_api.rb +513 -0
  92. data/lib/active_model_serializers/adapter/null.rb +10 -0
  93. data/lib/active_model_serializers/adapter.rb +92 -0
  94. data/lib/active_model_serializers/cached_serializer.rb +87 -0
  95. data/lib/active_model_serializers/callbacks.rb +55 -0
  96. data/lib/active_model_serializers/deprecate.rb +55 -0
  97. data/lib/active_model_serializers/deserialization.rb +13 -0
  98. data/lib/active_model_serializers/fragment_cache.rb +118 -0
  99. data/lib/active_model_serializers/json_pointer.rb +14 -0
  100. data/lib/active_model_serializers/key_transform.rb +70 -0
  101. data/lib/active_model_serializers/logging.rb +122 -0
  102. data/lib/active_model_serializers/model.rb +49 -0
  103. data/lib/active_model_serializers/railtie.rb +46 -0
  104. data/lib/active_model_serializers/register_jsonapi_renderer.rb +64 -0
  105. data/lib/active_model_serializers/serializable_resource.rb +81 -0
  106. data/lib/active_model_serializers/serialization_context.rb +32 -0
  107. data/lib/active_model_serializers/test/schema.rb +103 -0
  108. data/lib/active_model_serializers/test/serializer.rb +125 -0
  109. data/lib/active_model_serializers/test.rb +7 -0
  110. data/lib/active_model_serializers.rb +34 -89
  111. data/lib/generators/rails/USAGE +6 -0
  112. data/lib/generators/rails/resource_override.rb +10 -0
  113. data/lib/generators/rails/serializer_generator.rb +36 -0
  114. data/lib/generators/rails/templates/serializer.rb.erb +8 -0
  115. data/lib/grape/active_model_serializers.rb +14 -0
  116. data/lib/grape/formatters/active_model_serializers.rb +15 -0
  117. data/lib/grape/helpers/active_model_serializers.rb +16 -0
  118. data/test/action_controller/adapter_selector_test.rb +53 -0
  119. data/test/action_controller/explicit_serializer_test.rb +134 -0
  120. data/test/action_controller/json/include_test.rb +167 -0
  121. data/test/action_controller/json_api/deserialization_test.rb +112 -0
  122. data/test/action_controller/json_api/errors_test.rb +41 -0
  123. data/test/action_controller/json_api/linked_test.rb +197 -0
  124. data/test/action_controller/json_api/pagination_test.rb +116 -0
  125. data/test/action_controller/json_api/transform_test.rb +180 -0
  126. data/test/action_controller/serialization_scope_name_test.rb +229 -0
  127. data/test/action_controller/serialization_test.rb +467 -0
  128. data/test/active_model_serializers/adapter_for_test.rb +208 -0
  129. data/test/active_model_serializers/cached_serializer_test.rb +80 -0
  130. data/test/active_model_serializers/fragment_cache_test.rb +34 -0
  131. data/test/active_model_serializers/json_pointer_test.rb +20 -0
  132. data/test/active_model_serializers/key_transform_test.rb +263 -0
  133. data/test/active_model_serializers/logging_test.rb +77 -0
  134. data/test/active_model_serializers/model_test.rb +9 -0
  135. data/test/active_model_serializers/railtie_test_isolated.rb +63 -0
  136. data/test/active_model_serializers/serialization_context_test_isolated.rb +58 -0
  137. data/test/active_model_serializers/test/schema_test.rb +128 -0
  138. data/test/active_model_serializers/test/serializer_test.rb +63 -0
  139. data/test/active_record_test.rb +9 -0
  140. data/test/adapter/deprecation_test.rb +100 -0
  141. data/test/adapter/json/belongs_to_test.rb +45 -0
  142. data/test/adapter/json/collection_test.rb +90 -0
  143. data/test/adapter/json/has_many_test.rb +45 -0
  144. data/test/adapter/json/transform_test.rb +93 -0
  145. data/test/adapter/json_api/belongs_to_test.rb +155 -0
  146. data/test/adapter/json_api/collection_test.rb +95 -0
  147. data/test/adapter/json_api/errors_test.rb +78 -0
  148. data/test/adapter/json_api/fields_test.rb +87 -0
  149. data/test/adapter/json_api/has_many_embed_ids_test.rb +43 -0
  150. data/test/adapter/json_api/has_many_explicit_serializer_test.rb +96 -0
  151. data/test/adapter/json_api/has_many_test.rb +143 -0
  152. data/test/adapter/json_api/has_one_test.rb +79 -0
  153. data/test/adapter/json_api/json_api_test.rb +35 -0
  154. data/test/adapter/json_api/linked_test.rb +392 -0
  155. data/test/adapter/json_api/links_test.rb +93 -0
  156. data/test/adapter/json_api/pagination_links_test.rb +148 -0
  157. data/test/adapter/json_api/parse_test.rb +137 -0
  158. data/test/adapter/json_api/relationship_test.rb +161 -0
  159. data/test/adapter/json_api/relationships_test.rb +199 -0
  160. data/test/adapter/json_api/resource_identifier_test.rb +85 -0
  161. data/test/adapter/json_api/resource_meta_test.rb +100 -0
  162. data/test/adapter/json_api/toplevel_jsonapi_test.rb +82 -0
  163. data/test/adapter/json_api/transform_test.rb +500 -0
  164. data/test/adapter/json_api/type_test.rb +61 -0
  165. data/test/adapter/json_test.rb +45 -0
  166. data/test/adapter/null_test.rb +23 -0
  167. data/test/adapter/polymorphic_test.rb +72 -0
  168. data/test/adapter_test.rb +40 -0
  169. data/test/array_serializer_test.rb +35 -73
  170. data/test/benchmark/app.rb +65 -0
  171. data/test/benchmark/benchmarking_support.rb +67 -0
  172. data/test/benchmark/bm_caching.rb +117 -0
  173. data/test/benchmark/bm_transform.rb +34 -0
  174. data/test/benchmark/config.ru +3 -0
  175. data/test/benchmark/controllers.rb +77 -0
  176. data/test/benchmark/fixtures.rb +167 -0
  177. data/test/cache_test.rb +388 -0
  178. data/test/collection_serializer_test.rb +110 -0
  179. data/test/fixtures/active_record.rb +68 -0
  180. data/test/fixtures/poro.rb +254 -0
  181. data/test/generators/scaffold_controller_generator_test.rb +24 -0
  182. data/test/generators/serializer_generator_test.rb +57 -0
  183. data/test/grape_test.rb +82 -0
  184. data/test/include_tree/from_include_args_test.rb +26 -0
  185. data/test/include_tree/from_string_test.rb +94 -0
  186. data/test/include_tree/include_args_to_hash_test.rb +64 -0
  187. data/test/lint_test.rb +49 -0
  188. data/test/logger_test.rb +18 -0
  189. data/test/poro_test.rb +9 -0
  190. data/test/serializable_resource_test.rb +83 -0
  191. data/test/serializers/association_macros_test.rb +36 -0
  192. data/test/serializers/associations_test.rb +267 -0
  193. data/test/serializers/attribute_test.rb +123 -0
  194. data/test/serializers/attributes_test.rb +52 -0
  195. data/test/serializers/caching_configuration_test_isolated.rb +170 -0
  196. data/test/serializers/configuration_test.rb +32 -0
  197. data/test/serializers/fieldset_test.rb +14 -0
  198. data/test/serializers/meta_test.rb +198 -0
  199. data/test/serializers/options_test.rb +21 -0
  200. data/test/serializers/read_attribute_for_serialization_test.rb +79 -0
  201. data/test/serializers/root_test.rb +21 -0
  202. data/test/serializers/serialization_test.rb +55 -0
  203. data/test/serializers/serializer_for_test.rb +134 -0
  204. data/test/support/custom_schemas/active_model_serializers/test/schema_test/my/index.json +6 -0
  205. data/test/support/isolated_unit.rb +80 -0
  206. data/test/support/rails5_shims.rb +47 -0
  207. data/test/support/rails_app.rb +45 -0
  208. data/test/support/schemas/active_model_serializers/test/schema_test/my/index.json +6 -0
  209. data/test/support/schemas/active_model_serializers/test/schema_test/my/show.json +6 -0
  210. data/test/support/schemas/custom/show.json +7 -0
  211. data/test/support/schemas/hyper_schema.json +93 -0
  212. data/test/support/schemas/render_using_json_api.json +43 -0
  213. data/test/support/schemas/simple_json_pointers.json +10 -0
  214. data/test/support/serialization_testing.rb +53 -0
  215. data/test/test_helper.rb +51 -24
  216. metadata +456 -45
  217. data/DESIGN.textile +0 -586
  218. data/Gemfile.edge +0 -9
  219. data/bench/perf.rb +0 -43
  220. data/cruft.md +0 -19
  221. data/lib/active_model/array_serializer.rb +0 -104
  222. data/lib/active_record/serializer_override.rb +0 -16
  223. data/lib/generators/resource_override.rb +0 -13
  224. data/lib/generators/serializer/USAGE +0 -9
  225. data/lib/generators/serializer/serializer_generator.rb +0 -42
  226. data/lib/generators/serializer/templates/serializer.rb +0 -19
  227. data/test/association_test.rb +0 -592
  228. data/test/caching_test.rb +0 -96
  229. data/test/generators_test.rb +0 -85
  230. data/test/no_serialization_scope_test.rb +0 -34
  231. data/test/serialization_scope_name_test.rb +0 -67
  232. data/test/serialization_test.rb +0 -392
  233. data/test/serializer_support_test.rb +0 -51
  234. data/test/serializer_test.rb +0 -1465
  235. data/test/test_fakes.rb +0 -217
@@ -0,0 +1,85 @@
1
+ require 'test_helper'
2
+
3
+ module ActiveModelSerializers
4
+ module Adapter
5
+ class JsonApi
6
+ class ResourceIdentifierTest < ActiveSupport::TestCase
7
+ class WithDefinedTypeSerializer < ActiveModel::Serializer
8
+ type 'with_defined_type'
9
+ end
10
+
11
+ class WithDefinedIdSerializer < ActiveModel::Serializer
12
+ def id
13
+ 'special_id'
14
+ end
15
+ end
16
+
17
+ class FragmentedSerializer < ActiveModel::Serializer; end
18
+
19
+ setup do
20
+ @model = Author.new(id: 1, name: 'Steve K.')
21
+ ActionController::Base.cache_store.clear
22
+ end
23
+
24
+ def test_defined_type
25
+ test_type(WithDefinedTypeSerializer, 'with-defined-type')
26
+ end
27
+
28
+ def test_singular_type
29
+ test_type_inflection(AuthorSerializer, 'author', :singular)
30
+ end
31
+
32
+ def test_plural_type
33
+ test_type_inflection(AuthorSerializer, 'authors', :plural)
34
+ end
35
+
36
+ def test_id_defined_on_object
37
+ test_id(AuthorSerializer, @model.id.to_s)
38
+ end
39
+
40
+ def test_id_defined_on_serializer
41
+ test_id(WithDefinedIdSerializer, 'special_id')
42
+ end
43
+
44
+ def test_id_defined_on_fragmented
45
+ FragmentedSerializer.fragmented(WithDefinedIdSerializer.new(@model))
46
+ test_id(FragmentedSerializer, 'special_id')
47
+ end
48
+
49
+ private
50
+
51
+ def test_type_inflection(serializer_class, expected_type, inflection)
52
+ original_inflection = ActiveModelSerializers.config.jsonapi_resource_type
53
+ ActiveModelSerializers.config.jsonapi_resource_type = inflection
54
+ test_type(serializer_class, expected_type)
55
+ ensure
56
+ ActiveModelSerializers.config.jsonapi_resource_type = original_inflection
57
+ end
58
+
59
+ def test_type(serializer_class, expected_type)
60
+ serializer = serializer_class.new(@model)
61
+ resource_identifier = ResourceIdentifier.new(serializer, nil)
62
+ expected = {
63
+ id: @model.id.to_s,
64
+ type: expected_type
65
+ }
66
+
67
+ assert_equal(expected, resource_identifier.as_json)
68
+ end
69
+
70
+ def test_id(serializer_class, id)
71
+ serializer = serializer_class.new(@model)
72
+ resource_identifier = ResourceIdentifier.new(serializer, nil)
73
+ inflection = ActiveModelSerializers.config.jsonapi_resource_type
74
+ type = @model.class.model_name.send(inflection)
75
+ expected = {
76
+ id: id,
77
+ type: type
78
+ }
79
+
80
+ assert_equal(expected, resource_identifier.as_json)
81
+ end
82
+ end
83
+ end
84
+ end
85
+ end
@@ -0,0 +1,100 @@
1
+ require 'test_helper'
2
+
3
+ module ActiveModel
4
+ class Serializer
5
+ module Adapter
6
+ class JsonApi
7
+ class ResourceMetaTest < Minitest::Test
8
+ class MetaHashPostSerializer < ActiveModel::Serializer
9
+ attributes :id
10
+ meta stuff: 'value'
11
+ end
12
+
13
+ class MetaBlockPostSerializer < ActiveModel::Serializer
14
+ attributes :id
15
+ meta do
16
+ { comments_count: object.comments.count }
17
+ end
18
+ end
19
+
20
+ class MetaBlockPostBlankMetaSerializer < ActiveModel::Serializer
21
+ attributes :id
22
+ meta do
23
+ {}
24
+ end
25
+ end
26
+
27
+ class MetaBlockPostEmptyStringSerializer < ActiveModel::Serializer
28
+ attributes :id
29
+ meta do
30
+ ''
31
+ end
32
+ end
33
+
34
+ def setup
35
+ @post = Post.new(id: 1337, comments: [], author: nil)
36
+ end
37
+
38
+ def test_meta_hash_object_resource
39
+ hash = ActiveModelSerializers::SerializableResource.new(
40
+ @post,
41
+ serializer: MetaHashPostSerializer,
42
+ adapter: :json_api
43
+ ).serializable_hash
44
+ expected = {
45
+ stuff: 'value'
46
+ }
47
+ assert_equal(expected, hash[:data][:meta])
48
+ end
49
+
50
+ def test_meta_block_object_resource
51
+ hash = ActiveModelSerializers::SerializableResource.new(
52
+ @post,
53
+ serializer: MetaBlockPostSerializer,
54
+ adapter: :json_api
55
+ ).serializable_hash
56
+ expected = {
57
+ :"comments-count" => @post.comments.count
58
+ }
59
+ assert_equal(expected, hash[:data][:meta])
60
+ end
61
+
62
+ def test_meta_object_resource_in_array
63
+ post2 = Post.new(id: 1339, comments: [Comment.new])
64
+ posts = [@post, post2]
65
+ hash = ActiveModelSerializers::SerializableResource.new(
66
+ posts,
67
+ each_serializer: MetaBlockPostSerializer,
68
+ adapter: :json_api
69
+ ).serializable_hash
70
+ expected = {
71
+ :data => [
72
+ { :id => '1337', :type => 'posts', :meta => { :"comments-count" => 0 } },
73
+ { :id => '1339', :type => 'posts', :meta => { :"comments-count" => 1 } }
74
+ ]
75
+ }
76
+ assert_equal(expected, hash)
77
+ end
78
+
79
+ def test_meta_object_blank_omitted
80
+ hash = ActiveModelSerializers::SerializableResource.new(
81
+ @post,
82
+ serializer: MetaBlockPostBlankMetaSerializer,
83
+ adapter: :json_api
84
+ ).serializable_hash
85
+ refute hash[:data].key? :meta
86
+ end
87
+
88
+ def test_meta_object_empty_string_omitted
89
+ hash = ActiveModelSerializers::SerializableResource.new(
90
+ @post,
91
+ serializer: MetaBlockPostEmptyStringSerializer,
92
+ adapter: :json_api
93
+ ).serializable_hash
94
+ refute hash[:data].key? :meta
95
+ end
96
+ end
97
+ end
98
+ end
99
+ end
100
+ end
@@ -0,0 +1,82 @@
1
+ require 'test_helper'
2
+
3
+ module ActiveModelSerializers
4
+ module Adapter
5
+ class JsonApi
6
+ class TopLevelJsonApiTest < ActiveSupport::TestCase
7
+ def setup
8
+ @author = Author.new(id: 1, name: 'Steve K.')
9
+ @author.bio = nil
10
+ @author.roles = []
11
+ @blog = Blog.new(id: 23, name: 'AMS Blog')
12
+ @post = Post.new(id: 42, title: 'New Post', body: 'Body')
13
+ @anonymous_post = Post.new(id: 43, title: 'Hello!!', body: 'Hello, world!!')
14
+ @comment = Comment.new(id: 1, body: 'ZOMG A COMMENT')
15
+ @post.comments = [@comment]
16
+ @post.blog = @blog
17
+ @anonymous_post.comments = []
18
+ @anonymous_post.blog = nil
19
+ @comment.post = @post
20
+ @comment.author = nil
21
+ @post.author = @author
22
+ @anonymous_post.author = nil
23
+ @blog = Blog.new(id: 1, name: 'My Blog!!')
24
+ @blog.writer = @author
25
+ @blog.articles = [@post, @anonymous_post]
26
+ @author.posts = []
27
+ end
28
+
29
+ def test_toplevel_jsonapi_defaults_to_false
30
+ assert_equal config.fetch(:jsonapi_include_toplevel_object), false
31
+ end
32
+
33
+ def test_disable_toplevel_jsonapi
34
+ with_config(jsonapi_include_toplevel_object: false) do
35
+ hash = serialize(@post)
36
+ assert_nil(hash[:jsonapi])
37
+ end
38
+ end
39
+
40
+ def test_enable_toplevel_jsonapi
41
+ with_config(jsonapi_include_toplevel_object: true) do
42
+ hash = serialize(@post)
43
+ refute_nil(hash[:jsonapi])
44
+ end
45
+ end
46
+
47
+ def test_default_toplevel_jsonapi_version
48
+ with_config(jsonapi_include_toplevel_object: true) do
49
+ hash = serialize(@post)
50
+ assert_equal('1.0', hash[:jsonapi][:version])
51
+ end
52
+ end
53
+
54
+ def test_toplevel_jsonapi_no_meta
55
+ with_config(jsonapi_include_toplevel_object: true) do
56
+ hash = serialize(@post)
57
+ assert_nil(hash[:jsonapi][:meta])
58
+ end
59
+ end
60
+
61
+ def test_toplevel_jsonapi_meta
62
+ new_config = {
63
+ jsonapi_include_toplevel_object: true,
64
+ jsonapi_toplevel_meta: {
65
+ 'copyright' => 'Copyright 2015 Example Corp.'
66
+ }
67
+ }
68
+ with_config(new_config) do
69
+ hash = serialize(@post)
70
+ assert_equal(new_config[:jsonapi_toplevel_meta], hash.fetch(:jsonapi).fetch(:meta))
71
+ end
72
+ end
73
+
74
+ private
75
+
76
+ def serialize(resource, options = {})
77
+ serializable(resource, { adapter: :json_api }.merge!(options)).serializable_hash
78
+ end
79
+ end
80
+ end
81
+ end
82
+ end