active_model_serializers 0.10.7 → 0.10.10

Sign up to get free protection for your applications and to get access to all the features.
Files changed (212) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +45 -1
  3. data/README.md +2 -2
  4. data/lib/action_controller/serialization.rb +11 -1
  5. data/lib/active_model/serializable_resource.rb +2 -0
  6. data/lib/active_model/serializer/adapter/attributes.rb +2 -0
  7. data/lib/active_model/serializer/adapter/base.rb +2 -0
  8. data/lib/active_model/serializer/adapter/json.rb +2 -0
  9. data/lib/active_model/serializer/adapter/json_api.rb +2 -0
  10. data/lib/active_model/serializer/adapter/null.rb +2 -0
  11. data/lib/active_model/serializer/adapter.rb +2 -0
  12. data/lib/active_model/serializer/array_serializer.rb +2 -0
  13. data/lib/active_model/serializer/association.rb +2 -0
  14. data/lib/active_model/serializer/attribute.rb +2 -0
  15. data/lib/active_model/serializer/belongs_to_reflection.rb +2 -0
  16. data/lib/active_model/serializer/collection_serializer.rb +6 -6
  17. data/lib/active_model/serializer/concerns/caching.rb +5 -1
  18. data/lib/active_model/serializer/error_serializer.rb +2 -0
  19. data/lib/active_model/serializer/errors_serializer.rb +2 -0
  20. data/lib/active_model/serializer/field.rb +2 -0
  21. data/lib/active_model/serializer/fieldset.rb +2 -0
  22. data/lib/active_model/serializer/has_many_reflection.rb +2 -0
  23. data/lib/active_model/serializer/has_one_reflection.rb +2 -0
  24. data/lib/active_model/serializer/lazy_association.rb +6 -2
  25. data/lib/active_model/serializer/link.rb +23 -0
  26. data/lib/active_model/serializer/lint.rb +2 -0
  27. data/lib/active_model/serializer/null.rb +2 -0
  28. data/lib/active_model/serializer/reflection.rb +5 -0
  29. data/lib/active_model/serializer/version.rb +3 -1
  30. data/lib/active_model/serializer.rb +32 -16
  31. data/lib/active_model_serializers/adapter/attributes.rb +23 -0
  32. data/lib/active_model_serializers/adapter/base.rb +2 -0
  33. data/lib/active_model_serializers/adapter/json.rb +2 -0
  34. data/lib/active_model_serializers/adapter/json_api/deserialization.rb +2 -0
  35. data/lib/active_model_serializers/adapter/json_api/error.rb +2 -0
  36. data/lib/active_model_serializers/adapter/json_api/jsonapi.rb +2 -0
  37. data/lib/active_model_serializers/adapter/json_api/link.rb +2 -0
  38. data/lib/active_model_serializers/adapter/json_api/meta.rb +2 -0
  39. data/lib/active_model_serializers/adapter/json_api/pagination_links.rb +2 -0
  40. data/lib/active_model_serializers/adapter/json_api/relationship.rb +2 -0
  41. data/lib/active_model_serializers/adapter/json_api/resource_identifier.rb +3 -1
  42. data/lib/active_model_serializers/adapter/json_api.rb +14 -9
  43. data/lib/active_model_serializers/adapter/null.rb +2 -0
  44. data/lib/active_model_serializers/adapter.rb +3 -1
  45. data/lib/active_model_serializers/callbacks.rb +2 -0
  46. data/lib/active_model_serializers/deprecate.rb +2 -0
  47. data/lib/active_model_serializers/deserialization.rb +2 -0
  48. data/lib/active_model_serializers/json_pointer.rb +2 -0
  49. data/lib/active_model_serializers/logging.rb +2 -0
  50. data/lib/active_model_serializers/lookup_chain.rb +2 -0
  51. data/lib/active_model_serializers/model.rb +2 -0
  52. data/lib/active_model_serializers/railtie.rb +4 -0
  53. data/lib/active_model_serializers/register_jsonapi_renderer.rb +2 -0
  54. data/lib/active_model_serializers/serializable_resource.rb +4 -2
  55. data/lib/active_model_serializers/serialization_context.rb +2 -0
  56. data/lib/active_model_serializers/test/schema.rb +2 -0
  57. data/lib/active_model_serializers/test/serializer.rb +2 -0
  58. data/lib/active_model_serializers/test.rb +2 -0
  59. data/lib/active_model_serializers.rb +20 -10
  60. data/lib/generators/rails/resource_override.rb +2 -0
  61. data/lib/generators/rails/serializer_generator.rb +2 -0
  62. data/lib/grape/active_model_serializers.rb +2 -0
  63. data/lib/grape/formatters/active_model_serializers.rb +2 -0
  64. data/lib/grape/helpers/active_model_serializers.rb +2 -0
  65. data/lib/tasks/rubocop.rake +2 -0
  66. metadata +64 -290
  67. data/.github/ISSUE_TEMPLATE.md +0 -29
  68. data/.github/PULL_REQUEST_TEMPLATE.md +0 -15
  69. data/.gitignore +0 -35
  70. data/.rubocop.yml +0 -105
  71. data/.simplecov +0 -110
  72. data/.travis.yml +0 -52
  73. data/CODE_OF_CONDUCT.md +0 -74
  74. data/CONTRIBUTING.md +0 -105
  75. data/Gemfile +0 -72
  76. data/Rakefile +0 -74
  77. data/active_model_serializers.gemspec +0 -63
  78. data/appveyor.yml +0 -28
  79. data/bin/bench +0 -171
  80. data/bin/bench_regression +0 -316
  81. data/bin/rubocop +0 -38
  82. data/bin/serve_benchmark +0 -39
  83. data/docs/README.md +0 -41
  84. data/docs/STYLE.md +0 -58
  85. data/docs/general/adapters.md +0 -269
  86. data/docs/general/caching.md +0 -58
  87. data/docs/general/configuration_options.md +0 -185
  88. data/docs/general/deserialization.md +0 -100
  89. data/docs/general/fields.md +0 -31
  90. data/docs/general/getting_started.md +0 -133
  91. data/docs/general/instrumentation.md +0 -40
  92. data/docs/general/key_transforms.md +0 -40
  93. data/docs/general/logging.md +0 -21
  94. data/docs/general/rendering.md +0 -293
  95. data/docs/general/serializers.md +0 -483
  96. data/docs/how-open-source-maintained.jpg +0 -0
  97. data/docs/howto/add_pagination_links.md +0 -138
  98. data/docs/howto/add_relationship_links.md +0 -140
  99. data/docs/howto/add_root_key.md +0 -62
  100. data/docs/howto/grape_integration.md +0 -42
  101. data/docs/howto/outside_controller_use.md +0 -66
  102. data/docs/howto/passing_arbitrary_options.md +0 -27
  103. data/docs/howto/serialize_poro.md +0 -73
  104. data/docs/howto/test.md +0 -154
  105. data/docs/howto/upgrade_from_0_8_to_0_10.md +0 -265
  106. data/docs/integrations/ember-and-json-api.md +0 -147
  107. data/docs/integrations/grape.md +0 -19
  108. data/docs/jsonapi/errors.md +0 -56
  109. data/docs/jsonapi/schema/schema.json +0 -366
  110. data/docs/jsonapi/schema.md +0 -151
  111. data/docs/rfcs/0000-namespace.md +0 -106
  112. data/docs/rfcs/template.md +0 -15
  113. data/test/action_controller/adapter_selector_test.rb +0 -62
  114. data/test/action_controller/explicit_serializer_test.rb +0 -135
  115. data/test/action_controller/json/include_test.rb +0 -246
  116. data/test/action_controller/json_api/deserialization_test.rb +0 -112
  117. data/test/action_controller/json_api/errors_test.rb +0 -40
  118. data/test/action_controller/json_api/fields_test.rb +0 -66
  119. data/test/action_controller/json_api/linked_test.rb +0 -202
  120. data/test/action_controller/json_api/pagination_test.rb +0 -124
  121. data/test/action_controller/json_api/transform_test.rb +0 -189
  122. data/test/action_controller/lookup_proc_test.rb +0 -49
  123. data/test/action_controller/namespace_lookup_test.rb +0 -232
  124. data/test/action_controller/serialization_scope_name_test.rb +0 -235
  125. data/test/action_controller/serialization_test.rb +0 -472
  126. data/test/active_model_serializers/adapter_for_test.rb +0 -208
  127. data/test/active_model_serializers/json_pointer_test.rb +0 -22
  128. data/test/active_model_serializers/logging_test.rb +0 -77
  129. data/test/active_model_serializers/model_test.rb +0 -142
  130. data/test/active_model_serializers/railtie_test_isolated.rb +0 -68
  131. data/test/active_model_serializers/register_jsonapi_renderer_test_isolated.rb +0 -161
  132. data/test/active_model_serializers/serialization_context_test_isolated.rb +0 -71
  133. data/test/active_model_serializers/test/schema_test.rb +0 -131
  134. data/test/active_model_serializers/test/serializer_test.rb +0 -62
  135. data/test/active_record_test.rb +0 -9
  136. data/test/adapter/attributes_test.rb +0 -40
  137. data/test/adapter/deprecation_test.rb +0 -100
  138. data/test/adapter/json/belongs_to_test.rb +0 -45
  139. data/test/adapter/json/collection_test.rb +0 -104
  140. data/test/adapter/json/has_many_test.rb +0 -53
  141. data/test/adapter/json/transform_test.rb +0 -93
  142. data/test/adapter/json_api/belongs_to_test.rb +0 -155
  143. data/test/adapter/json_api/collection_test.rb +0 -96
  144. data/test/adapter/json_api/errors_test.rb +0 -76
  145. data/test/adapter/json_api/fields_test.rb +0 -96
  146. data/test/adapter/json_api/has_many_explicit_serializer_test.rb +0 -96
  147. data/test/adapter/json_api/has_many_test.rb +0 -173
  148. data/test/adapter/json_api/has_one_test.rb +0 -80
  149. data/test/adapter/json_api/include_data_if_sideloaded_test.rb +0 -213
  150. data/test/adapter/json_api/json_api_test.rb +0 -33
  151. data/test/adapter/json_api/linked_test.rb +0 -413
  152. data/test/adapter/json_api/links_test.rb +0 -95
  153. data/test/adapter/json_api/pagination_links_test.rb +0 -206
  154. data/test/adapter/json_api/parse_test.rb +0 -137
  155. data/test/adapter/json_api/relationship_test.rb +0 -397
  156. data/test/adapter/json_api/resource_meta_test.rb +0 -100
  157. data/test/adapter/json_api/toplevel_jsonapi_test.rb +0 -82
  158. data/test/adapter/json_api/transform_test.rb +0 -512
  159. data/test/adapter/json_api/type_test.rb +0 -193
  160. data/test/adapter/json_test.rb +0 -46
  161. data/test/adapter/null_test.rb +0 -22
  162. data/test/adapter/polymorphic_test.rb +0 -218
  163. data/test/adapter_test.rb +0 -67
  164. data/test/array_serializer_test.rb +0 -22
  165. data/test/benchmark/app.rb +0 -65
  166. data/test/benchmark/benchmarking_support.rb +0 -67
  167. data/test/benchmark/bm_active_record.rb +0 -81
  168. data/test/benchmark/bm_adapter.rb +0 -38
  169. data/test/benchmark/bm_caching.rb +0 -119
  170. data/test/benchmark/bm_lookup_chain.rb +0 -83
  171. data/test/benchmark/bm_transform.rb +0 -45
  172. data/test/benchmark/config.ru +0 -3
  173. data/test/benchmark/controllers.rb +0 -83
  174. data/test/benchmark/fixtures.rb +0 -219
  175. data/test/cache_test.rb +0 -651
  176. data/test/collection_serializer_test.rb +0 -127
  177. data/test/fixtures/active_record.rb +0 -113
  178. data/test/fixtures/poro.rb +0 -225
  179. data/test/generators/scaffold_controller_generator_test.rb +0 -24
  180. data/test/generators/serializer_generator_test.rb +0 -75
  181. data/test/grape_test.rb +0 -196
  182. data/test/lint_test.rb +0 -49
  183. data/test/logger_test.rb +0 -20
  184. data/test/poro_test.rb +0 -9
  185. data/test/serializable_resource_test.rb +0 -79
  186. data/test/serializers/association_macros_test.rb +0 -37
  187. data/test/serializers/associations_test.rb +0 -468
  188. data/test/serializers/attribute_test.rb +0 -153
  189. data/test/serializers/attributes_test.rb +0 -52
  190. data/test/serializers/caching_configuration_test_isolated.rb +0 -170
  191. data/test/serializers/configuration_test.rb +0 -32
  192. data/test/serializers/fieldset_test.rb +0 -14
  193. data/test/serializers/meta_test.rb +0 -202
  194. data/test/serializers/options_test.rb +0 -32
  195. data/test/serializers/read_attribute_for_serialization_test.rb +0 -79
  196. data/test/serializers/reflection_test.rb +0 -427
  197. data/test/serializers/root_test.rb +0 -21
  198. data/test/serializers/serialization_test.rb +0 -55
  199. data/test/serializers/serializer_for_test.rb +0 -136
  200. data/test/serializers/serializer_for_with_namespace_test.rb +0 -88
  201. data/test/support/custom_schemas/active_model_serializers/test/schema_test/my/index.json +0 -6
  202. data/test/support/isolated_unit.rb +0 -84
  203. data/test/support/rails5_shims.rb +0 -53
  204. data/test/support/rails_app.rb +0 -38
  205. data/test/support/schemas/active_model_serializers/test/schema_test/my/index.json +0 -6
  206. data/test/support/schemas/active_model_serializers/test/schema_test/my/show.json +0 -6
  207. data/test/support/schemas/custom/show.json +0 -7
  208. data/test/support/schemas/hyper_schema.json +0 -93
  209. data/test/support/schemas/render_using_json_api.json +0 -43
  210. data/test/support/schemas/simple_json_pointers.json +0 -10
  211. data/test/support/serialization_testing.rb +0 -79
  212. data/test/test_helper.rb +0 -70
@@ -1,366 +0,0 @@
1
- {
2
- "$schema": "http://json-schema.org/draft-04/schema#",
3
- "title": "JSON API Schema",
4
- "description": "This is a schema for responses in the JSON API format. For more, see http://jsonapi.org",
5
- "oneOf": [
6
- {
7
- "$ref": "#/definitions/success"
8
- },
9
- {
10
- "$ref": "#/definitions/failure"
11
- },
12
- {
13
- "$ref": "#/definitions/info"
14
- }
15
- ],
16
-
17
- "definitions": {
18
- "success": {
19
- "type": "object",
20
- "required": [
21
- "data"
22
- ],
23
- "properties": {
24
- "data": {
25
- "$ref": "#/definitions/data"
26
- },
27
- "included": {
28
- "description": "To reduce the number of HTTP requests, servers **MAY** allow responses that include related resources along with the requested primary resources. Such responses are called \"compound documents\".",
29
- "type": "array",
30
- "items": {
31
- "$ref": "#/definitions/resource"
32
- },
33
- "uniqueItems": true
34
- },
35
- "meta": {
36
- "$ref": "#/definitions/meta"
37
- },
38
- "links": {
39
- "description": "Link members related to the primary data.",
40
- "allOf": [
41
- {
42
- "$ref": "#/definitions/links"
43
- },
44
- {
45
- "$ref": "#/definitions/pagination"
46
- }
47
- ]
48
- },
49
- "jsonapi": {
50
- "$ref": "#/definitions/jsonapi"
51
- }
52
- },
53
- "additionalProperties": false
54
- },
55
- "failure": {
56
- "type": "object",
57
- "required": [
58
- "errors"
59
- ],
60
- "properties": {
61
- "errors": {
62
- "type": "array",
63
- "items": {
64
- "$ref": "#/definitions/error"
65
- },
66
- "uniqueItems": true
67
- },
68
- "meta": {
69
- "$ref": "#/definitions/meta"
70
- },
71
- "jsonapi": {
72
- "$ref": "#/definitions/jsonapi"
73
- }
74
- },
75
- "additionalProperties": false
76
- },
77
- "info": {
78
- "type": "object",
79
- "required": [
80
- "meta"
81
- ],
82
- "properties": {
83
- "meta": {
84
- "$ref": "#/definitions/meta"
85
- },
86
- "links": {
87
- "$ref": "#/definitions/links"
88
- },
89
- "jsonapi": {
90
- "$ref": "#/definitions/jsonapi"
91
- }
92
- },
93
- "additionalProperties": false
94
- },
95
-
96
- "meta": {
97
- "description": "Non-standard meta-information that can not be represented as an attribute or relationship.",
98
- "type": "object",
99
- "additionalProperties": true
100
- },
101
- "data": {
102
- "description": "The document's \"primary data\" is a representation of the resource or collection of resources targeted by a request.",
103
- "oneOf": [
104
- {
105
- "$ref": "#/definitions/resource"
106
- },
107
- {
108
- "description": "An array of resource objects, an array of resource identifier objects, or an empty array ([]), for requests that target resource collections.",
109
- "type": "array",
110
- "items": {
111
- "$ref": "#/definitions/resource"
112
- },
113
- "uniqueItems": true
114
- }
115
- ]
116
- },
117
- "resource": {
118
- "description": "\"Resource objects\" appear in a JSON API document to represent resources.",
119
- "type": "object",
120
- "required": [
121
- "type",
122
- "id"
123
- ],
124
- "properties": {
125
- "type": {
126
- "type": "string"
127
- },
128
- "id": {
129
- "type": "string"
130
- },
131
- "attributes": {
132
- "$ref": "#/definitions/attributes"
133
- },
134
- "relationships": {
135
- "$ref": "#/definitions/relationships"
136
- },
137
- "links": {
138
- "$ref": "#/definitions/links"
139
- },
140
- "meta": {
141
- "$ref": "#/definitions/meta"
142
- }
143
- },
144
- "additionalProperties": false
145
- },
146
-
147
- "links": {
148
- "description": "A resource object **MAY** contain references to other resource objects (\"relationships\"). Relationships may be to-one or to-many. Relationships can be specified by including a member in a resource's links object.",
149
- "type": "object",
150
- "properties": {
151
- "self": {
152
- "description": "A `self` member, whose value is a URL for the relationship itself (a \"relationship URL\"). This URL allows the client to directly manipulate the relationship. For example, it would allow a client to remove an `author` from an `article` without deleting the people resource itself.",
153
- "type": "string",
154
- "format": "uri"
155
- },
156
- "related": {
157
- "$ref": "#/definitions/link"
158
- }
159
- },
160
- "additionalProperties": true
161
- },
162
- "link": {
163
- "description": "A link **MUST** be represented as either: a string containing the link's URL or a link object.",
164
- "oneOf": [
165
- {
166
- "description": "A string containing the link's URL.",
167
- "type": "string",
168
- "format": "uri"
169
- },
170
- {
171
- "type": "object",
172
- "required": [
173
- "href"
174
- ],
175
- "properties": {
176
- "href": {
177
- "description": "A string containing the link's URL.",
178
- "type": "string",
179
- "format": "uri"
180
- },
181
- "meta": {
182
- "$ref": "#/definitions/meta"
183
- }
184
- }
185
- }
186
- ]
187
- },
188
-
189
- "attributes": {
190
- "description": "Members of the attributes object (\"attributes\") represent information about the resource object in which it's defined.",
191
- "type": "object",
192
- "patternProperties": {
193
- "^(?!relationships$|links$)\\w[-\\w_]*$": {
194
- "description": "Attributes may contain any valid JSON value."
195
- }
196
- },
197
- "additionalProperties": false
198
- },
199
-
200
- "relationships": {
201
- "description": "Members of the relationships object (\"relationships\") represent references from the resource object in which it's defined to other resource objects.",
202
- "type": "object",
203
- "patternProperties": {
204
- "^\\w[-\\w_]*$": {
205
- "properties": {
206
- "links": {
207
- "$ref": "#/definitions/links"
208
- },
209
- "data": {
210
- "description": "Member, whose value represents \"resource linkage\".",
211
- "oneOf": [
212
- {
213
- "$ref": "#/definitions/relationshipToOne"
214
- },
215
- {
216
- "$ref": "#/definitions/relationshipToMany"
217
- }
218
- ]
219
- },
220
- "meta": {
221
- "$ref": "#/definitions/meta"
222
- }
223
- },
224
- "additionalProperties": false
225
- }
226
- },
227
- "additionalProperties": false
228
- },
229
- "relationshipToOne": {
230
- "description": "References to other resource objects in a to-one (\"relationship\"). Relationships can be specified by including a member in a resource's links object.",
231
- "anyOf": [
232
- {
233
- "$ref": "#/definitions/empty"
234
- },
235
- {
236
- "$ref": "#/definitions/linkage"
237
- }
238
- ]
239
- },
240
- "relationshipToMany": {
241
- "description": "An array of objects each containing \"type\" and \"id\" members for to-many relationships.",
242
- "type": "array",
243
- "items": {
244
- "$ref": "#/definitions/linkage"
245
- },
246
- "uniqueItems": true
247
- },
248
- "empty": {
249
- "description": "Describes an empty to-one relationship.",
250
- "type": "null"
251
- },
252
- "linkage": {
253
- "description": "The \"type\" and \"id\" to non-empty members.",
254
- "type": "object",
255
- "required": [
256
- "type",
257
- "id"
258
- ],
259
- "properties": {
260
- "type": {
261
- "type": "string"
262
- },
263
- "id": {
264
- "type": "string"
265
- },
266
- "meta": {
267
- "$ref": "#/definitions/meta"
268
- }
269
- },
270
- "additionalProperties": false
271
- },
272
- "pagination": {
273
- "type": "object",
274
- "properties": {
275
- "first": {
276
- "description": "The first page of data",
277
- "oneOf": [
278
- { "type": "string", "format": "uri" },
279
- { "type": "null" }
280
- ]
281
- },
282
- "last": {
283
- "description": "The last page of data",
284
- "oneOf": [
285
- { "type": "string", "format": "uri" },
286
- { "type": "null" }
287
- ]
288
- },
289
- "prev": {
290
- "description": "The previous page of data",
291
- "oneOf": [
292
- { "type": "string", "format": "uri" },
293
- { "type": "null" }
294
- ]
295
- },
296
- "next": {
297
- "description": "The next page of data",
298
- "oneOf": [
299
- { "type": "string", "format": "uri" },
300
- { "type": "null" }
301
- ]
302
- }
303
- }
304
- },
305
-
306
- "jsonapi": {
307
- "description": "An object describing the server's implementation",
308
- "type": "object",
309
- "properties": {
310
- "version": {
311
- "type": "string"
312
- },
313
- "meta": {
314
- "$ref": "#/definitions/meta"
315
- }
316
- },
317
- "additionalProperties": false
318
- },
319
-
320
- "error": {
321
- "type": "object",
322
- "properties": {
323
- "id": {
324
- "description": "A unique identifier for this particular occurrence of the problem.",
325
- "type": "string"
326
- },
327
- "links": {
328
- "$ref": "#/definitions/links"
329
- },
330
- "status": {
331
- "description": "The HTTP status code applicable to this problem, expressed as a string value.",
332
- "type": "string"
333
- },
334
- "code": {
335
- "description": "An application-specific error code, expressed as a string value.",
336
- "type": "string"
337
- },
338
- "title": {
339
- "description": "A short, human-readable summary of the problem. It **SHOULD NOT** change from occurrence to occurrence of the problem, except for purposes of localization.",
340
- "type": "string"
341
- },
342
- "detail": {
343
- "description": "A human-readable explanation specific to this occurrence of the problem.",
344
- "type": "string"
345
- },
346
- "source": {
347
- "type": "object",
348
- "properties": {
349
- "pointer": {
350
- "description": "A JSON Pointer [RFC6901] to the associated entity in the request document [e.g. \"/data\" for a primary data object, or \"/data/attributes/title\" for a specific attribute].",
351
- "type": "string"
352
- },
353
- "parameter": {
354
- "description": "A string indicating which query parameter caused the error.",
355
- "type": "string"
356
- }
357
- }
358
- },
359
- "meta": {
360
- "$ref": "#/definitions/meta"
361
- }
362
- },
363
- "additionalProperties": false
364
- }
365
- }
366
- }
@@ -1,151 +0,0 @@
1
- [Back to Guides](../README.md)
2
-
3
- [![JSON API 1.0](https://img.shields.io/badge/JSON%20API-1.0-lightgrey.svg)](http://jsonapi.org/)
4
-
5
- ## JSON API Requests
6
-
7
- - [Query Parameters Spec](http://jsonapi.org/format/#query-parameters)
8
-
9
- Headers:
10
-
11
- - Request: `Accept: application/vnd.api+json`
12
- - Response: `Content-Type: application/vnd.api+json`
13
-
14
- ### [Fetching Data](http://jsonapi.org/format/#fetching)
15
-
16
- A server MUST support fetching resource data for every URL provided as:
17
-
18
- - a `self` link as part of the top-level links object
19
- - a `self` link as part of a resource-level links object
20
- - a `related` link as part of a relationship-level links object
21
-
22
- Example supported requests
23
-
24
- - Individual resource or collection
25
- - GET /articles
26
- - GET /articles/1
27
- - GET /articles/1/author
28
- - Relationships
29
- - GET /articles/1/relationships/comments
30
- - GET /articles/1/relationships/author
31
- - Optional: [Inclusion of related resources](http://jsonapi.org/format/#fetching-includes) `JSONAPI::IncludeDirective`
32
- - GET /articles/1?`include`=comments
33
- - GET /articles/1?`include`=comments.author
34
- - GET /articles/1?`include`=author,comments.author
35
- - GET /articles/1/relationships/comments?`include`=comments.author
36
- - Optional: [Sparse Fieldsets](http://jsonapi.org/format/#fetching-sparse-fieldsets) `ActiveModel::Serializer::Fieldset`
37
- - GET /articles?`include`=author&`fields`[articles]=title,body&`fields`[people]=name
38
- - Optional: [Sorting](http://jsonapi.org/format/#fetching-sorting)
39
- - GET /people?`sort`=age
40
- - GET /people?`sort`=age,author.name
41
- - GET /articles?`sort`=-created,title
42
- - Optional: [Pagination](http://jsonapi.org/format/#fetching-pagination)
43
- - GET /articles?`page`[number]=3&`page`[size]=1
44
- - Optional: [Filtering](http://jsonapi.org/format/#fetching-filtering)
45
- - GET /comments?`filter`[post]=1
46
- - GET /comments?`filter`[post]=1,2
47
- - GET /comments?`filter`[post]=1,2
48
-
49
- ### [CRUD Actions](http://jsonapi.org/format/#crud)
50
-
51
- ### [Asynchronous Processing](http://jsonapi.org/recommendations/#asynchronous-processing)
52
-
53
- ### [Bulk Operations Extension](http://jsonapi.org/extensions/bulk/)
54
-
55
- ## JSON API Document Schema
56
-
57
- | JSON API object | JSON API properties | Required | ActiveModelSerializers representation |
58
- |-----------------------|----------------------------------------------------------------------------------------------------|----------|---------------------------------------|
59
- | schema | oneOf (success, failure, info) | |
60
- | success | data, included, meta, links, jsonapi | | AM::SerializableResource
61
- | success.meta | meta | | AMS::Adapter::Base#meta
62
- | success.included | UniqueArray(resource) | | AMS::Adapter::JsonApi#serializable_hash_for_collection
63
- | success.data | data | |
64
- | success.links | allOf (links, pagination) | | AMS::Adapter::JsonApi#links_for
65
- | success.jsonapi | jsonapi | |
66
- | failure | errors, meta, jsonapi | errors | AMS::Adapter::JsonApi#failure_document, #1004
67
- | failure.errors | UniqueArray(error) | | AM::S::ErrorSerializer, #1004
68
- | meta | Object | |
69
- | data | oneOf (resource, UniqueArray(resource)) | | AMS::Adapter::JsonApi#serializable_hash_for_collection,#serializable_hash_for_single_resource
70
- | resource | String(type), String(id),<br>attributes, relationships,<br>links, meta | type, id | AM::S::Adapter::JsonApi#primary_data_for
71
- | links | Uri(self), Link(related) | | #1028, #1246, #1282
72
- | link | oneOf (linkString, linkObject) | |
73
- | link.linkString | Uri | |
74
- | link.linkObject | Uri(href), meta | href |
75
- | attributes | patternProperties(<br>`"^(?!relationships$|links$)\\w[-\\w_]*$"`),<br>any valid JSON | | AM::Serializer#attributes, AMS::Adapter::JsonApi#resource_object_for
76
- | relationships | patternProperties(<br>`"^\\w[-\\w_]*$"`);<br>links, relationships.data, meta | | AMS::Adapter::JsonApi#relationships_for
77
- | relationships.data | oneOf (relationshipToOne, relationshipToMany) | | AMS::Adapter::JsonApi#resource_identifier_for
78
- | relationshipToOne | anyOf(empty, linkage) | |
79
- | relationshipToMany | UniqueArray(linkage) | |
80
- | empty | null | |
81
- | linkage | String(type), String(id), meta | type, id | AMS::Adapter::JsonApi#primary_data_for
82
- | pagination | pageObject(first), pageObject(last),<br>pageObject(prev), pageObject(next) | | AMS::Adapter::JsonApi::PaginationLinks#serializable_hash
83
- | pagination.pageObject | oneOf(Uri, null) | |
84
- | jsonapi | String(version), meta | | AMS::Adapter::JsonApi::Jsonapi#as_json
85
- | error | String(id), links, String(status),<br>String(code), String(title),<br>String(detail), error.source, meta | | AM::S::ErrorSerializer, AMS::Adapter::JsonApi::Error.resource_errors
86
- | error.source | String(pointer), String(parameter) | | AMS::Adapter::JsonApi::Error.error_source
87
- | pointer | [JSON Pointer RFC6901](https://tools.ietf.org/html/rfc6901) | | AMS::JsonPointer
88
-
89
-
90
- The [http://jsonapi.org/schema](schema/schema.json) makes a nice roadmap.
91
-
92
- ### Success Document
93
- - [ ] success
94
- - [ ] data: `"$ref": "#/definitions/data"`
95
- - [ ] included: array of unique items of type `"$ref": "#/definitions/resource"`
96
- - [ ] meta: `"$ref": "#/definitions/meta"`
97
- - [ ] links:
98
- - [ ] link: `"$ref": "#/definitions/links"`
99
- - [ ] pagination: ` "$ref": "#/definitions/pagination"`
100
- - [ ] jsonapi: ` "$ref": "#/definitions/jsonapi"`
101
-
102
- ### Failure Document
103
-
104
- - [ ] failure
105
- - [x] errors: array of unique items of type ` "$ref": "#/definitions/error"`
106
- - [ ] meta: `"$ref": "#/definitions/meta"`
107
- - [ ] jsonapi: `"$ref": "#/definitions/jsonapi"`
108
-
109
- ### Info Document
110
-
111
- - [ ] info
112
- - [ ] meta: `"$ref": "#/definitions/meta"`
113
- - [ ] links: `"$ref": "#/definitions/links"`
114
- - [ ] jsonapi: ` "$ref": "#/definitions/jsonapi"`
115
-
116
- ### Definitions
117
-
118
- - [ ] definitions:
119
- - [ ] meta
120
- - [ ] data: oneOf (resource, array of unique resources)
121
- - [ ] resource
122
- - [ ] attributes
123
- - [ ] relationships
124
- - [ ] relationshipToOne
125
- - [ ] empty
126
- - [ ] linkage
127
- - [ ] meta
128
- - [ ] relationshipToMany
129
- - [ ] linkage
130
- - [ ] meta
131
- - [ ] links
132
- - [ ] meta
133
- - [ ] links
134
- - [ ] link
135
- - [ ] uri
136
- - [ ] href, meta
137
- - [ ] pagination
138
- - [ ] jsonapi
139
- - [ ] meta
140
- - [ ] error
141
- - [ ] id: a unique identifier for this particular occurrence of the problem.
142
- - [ ] links: a links object containing the following members:
143
- - [ ] about: a link that leads to further details about this particular occurrence of the problem.
144
- - [ ] status: the HTTP status code applicable to this problem, expressed as a string value.
145
- - [ ] code: an application-specific error code, expressed as a string value.
146
- - [ ] title: a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
147
- - [x] detail: a human-readable explanation specific to this occurrence of the problem.
148
- - [x] source: an object containing references to the source of the error, optionally including any of the following members:
149
- - [x] pointer: a JSON Pointer [RFC6901](https://tools.ietf.org/html/rfc6901) to the associated entity in the request document [e.g. "/data" for a primary data object, or "/data/attributes/title" for a specific attribute].
150
- - [x] parameter: a string indicating which query parameter caused the error.
151
- - [ ] meta: a meta object containing non-standard meta-information about the error.
@@ -1,106 +0,0 @@
1
- - Start Date: (2015-10-29)
2
- - RFC PR: https://github.com/rails-api/active_model_serializers/pull/1310
3
- - ActiveModelSerializers Issue: https://github.com/rails-api/active_model_serializers/issues/1298
4
-
5
- # Summary
6
-
7
- Provide a consistent API for the user of the AMS.
8
-
9
- # Motivation
10
-
11
- The actual public API is defined under `ActiveModelSerializers`,
12
- `ActiveModel::Serializer` and `ActiveModel`.
13
-
14
- At the `ActiveModel::Serializer` we have:
15
-
16
- - `ActiveModel::Serializer.config`
17
- - `ActiveModel::Serializer`
18
-
19
- At the `ActiveModelSerializers` we have:
20
-
21
- - `ActiveModelSerializers::Model`
22
- - `ActiveModelSerializers.logger`
23
-
24
- At `ActiveModel` we have:
25
-
26
- - `ActiveModel::SerializableResource`
27
-
28
- The idea here is to provide a single namespace `ActiveModelSerializers` to the user.
29
- Following the same idea we have on other gems like
30
- [Devise](https://github.com/plataformatec/devise/blob/e9c82472ffe7c43a448945f77e034a0e47dde0bb/lib/devise.rb),
31
- [Refile](https://github.com/refile/refile/blob/6b24c293d044862dafbf1bfa4606672a64903aa2/lib/refile.rb) and
32
- [Active Job](https://github.com/rails/rails/blob/30bacc26f8f258b39e12f63fe52389a968d9c1ea/activejob/lib/active_job.rb)
33
- for example.
34
-
35
- This way we are clarifing the boundaries of
36
- [ActiveModelSerializers and Rails](https://github.com/rails-api/active_model_serializers/blob/master/CHANGELOG.md#prehistory)
37
- and make clear that the `ActiveModel::Serializer` class is no longer the primary
38
- behavior of the ActiveModelSerializers.
39
-
40
- # Detailed design
41
-
42
- ## New classes and modules organization
43
-
44
- Since this will be a big change we can do this on baby steps, read small pull requests. A
45
- possible approach is:
46
-
47
- - All new code will be in `lib/active_model_serializers/` using
48
- the module namespace `ActiveModelSerializers`.
49
- - Move all content under `ActiveModel::Serializer` to be under
50
- `ActiveModelSerializers`, the adapter is on this steps;
51
- - Move all content under `ActiveModel` to be under `ActiveModelSerializers`,
52
- the `SerializableResource` is on this step;
53
- - Change all public API that doesn't make sense, keeping in mind only to keep
54
- this in the same namespace
55
- - Update the README;
56
- - Update the docs;
57
-
58
- The following table represents the current and the desired classes and modules
59
- at the first moment.
60
-
61
- | Current | Desired | Notes |
62
- |--------------------------------------------------------|--------------------------------------------------|--------------------|
63
- | `ActiveModelSerializers` and `ActiveModel::Serializer` | `ActiveModelSerializers` | The main namespace |
64
- | `ActiveModelSerializers.logger` | `ActiveModelSerializers.logger` ||
65
- | `ActiveModelSerializers::Model` | `ActiveModelSerializers::Model` ||
66
- | `ActiveModel::SerializableResource` | `ActiveModelSerializers::SerializableResource` ||
67
- | `ActiveModel::Serializer` | `ActiveModelSerializers::Serializer` | The name can be discussed in a future pull request. For example, we can rename this to `Resource` [following this idea](https://github.com/rails-api/active_model_serializers/pull/1301/files#r42963185) more info about naming in the next section|
68
- | `ActiveModel::Serializer.config` | `ActiveModelSerializers.config` ||
69
-
70
- ## Renaming of class and modules
71
-
72
- When moving some content to the new namespace we can find some names that does
73
- not make much sense like `ActiveModel::Serializer::Adapter::JsonApi`.
74
- Discussion of renaming existing classes / modules and JsonApi objects will
75
- happen in separate pull requests, and issues, and in the google doc
76
- https://docs.google.com/document/d/1rcrJr0sVcazY2Opd_6Kmv1iIwuHbI84s1P_NzFn-05c/edit?usp=sharing
77
-
78
- Some of names already have a definition.
79
-
80
- - Adapters get their own namespace under ActiveModelSerializers. E.g
81
- `ActiveModelSerializers::Adapter`
82
- - Serializers get their own namespace under ActiveModelSerializers. E.g
83
- `ActiveModelSerializers::Serializer`
84
-
85
- ## Keeping compatibility
86
-
87
- All moved classes or modules be aliased to their old name and location with
88
- deprecation warnings, such as
89
- [was done for CollectionSerializer](https://github.com/rails-api/active_model_serializers/pull/1251).
90
-
91
- # Drawbacks
92
-
93
- This will be a breaking change, so all users serializers will be broken after a
94
- major bump.
95
- All pull requests will need to rebase since the architeture will change a lot.
96
-
97
- # Alternatives
98
-
99
- We can keep the way it is, and keep in mind to not add another namespace as a
100
- public API.
101
-
102
- # Unresolved questions
103
-
104
- What is the better class name to be used to the class that will be inherited at
105
- the creation of a serializer. This can be discussed in other RFC or directly via
106
- pull request.
@@ -1,15 +0,0 @@
1
- - Start Date: (YYYY-MM-DD)
2
- - RFC PR: https://github.com/rails-api/active_model_serializers/pull/dddd
3
- - ActiveModelSerializers Issue: https://github.com/rails-api/active_model_serializers/issues/dddd
4
-
5
- # Summary
6
-
7
- # Motivation
8
-
9
- # Detailed design
10
-
11
- # Drawbacks
12
-
13
- # Alternatives
14
-
15
- # Unresolved questions