multi_json 1.5.0 → 1.15.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/CHANGELOG.md +275 -0
- data/CONTRIBUTING.md +46 -0
- data/LICENSE.md +1 -1
- data/README.md +70 -37
- data/lib/multi_json/adapter.rb +49 -0
- data/lib/multi_json/adapter_error.rb +15 -0
- data/lib/multi_json/adapters/gson.rb +20 -0
- data/lib/multi_json/adapters/jr_jackson.rb +25 -0
- data/lib/multi_json/adapters/json_common.rb +13 -15
- data/lib/multi_json/adapters/json_gem.rb +2 -3
- data/lib/multi_json/adapters/json_pure.rb +2 -3
- data/lib/multi_json/adapters/nsjsonserialization.rb +9 -8
- data/lib/multi_json/adapters/oj.rb +50 -13
- data/lib/multi_json/adapters/ok_json.rb +8 -33
- data/lib/multi_json/adapters/yajl.rb +5 -4
- data/lib/multi_json/convertible_hash_keys.rb +43 -0
- data/lib/multi_json/options.rb +39 -0
- data/lib/multi_json/options_cache.rb +29 -0
- data/lib/multi_json/parse_error.rb +17 -0
- data/lib/multi_json/vendor/okjson.rb +97 -93
- data/lib/multi_json/version.rb +15 -1
- data/lib/multi_json.rb +141 -110
- metadata +44 -81
- data/.document +0 -5
- data/.rspec +0 -3
- data/.travis.yml +0 -10
- data/Gemfile +0 -7
- data/Rakefile +0 -20
- data/multi_json.gemspec +0 -23
- data/spec/adapter_shared_example.rb +0 -127
- data/spec/helper.rb +0 -39
- data/spec/multi_json_spec.rb +0 -100
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: ba3f1870ebd467a8356a8138d7bba83f224659a5cea2d4f9a845fa88e8d4934f
|
4
|
+
data.tar.gz: 89051067684a2f7f101dbc1b00e8cc4a417fdb9b829e476db6d90ea2cc4cf37b
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 3f317d2719838c2466a2ca066b25259a2653cf639198a9e47fc0c0365a8a02e8307feaa4392b445ae1f918c92c4cc7deb833e1c1945c4682cd3dac3d91af9789
|
7
|
+
data.tar.gz: 81b37aeb82f9744a93eec867a54e3a83537bedb6f29747818187b6fc27d599a6ee88f239db382f85ed840319e19452f43f09c29655ac664e9a4680bc33c335a8
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,275 @@
|
|
1
|
+
1.14.2
|
2
|
+
------
|
3
|
+
|
4
|
+
* [Improve detection of json_gem adapter](https://github.com/intridea/multi_json/commit/62d54019b17ebf83b28c8deb871a02a122e7d9cf)
|
5
|
+
|
6
|
+
1.14.1
|
7
|
+
------
|
8
|
+
|
9
|
+
* [Fix a warning in Ruby 2.7](https://github.com/intridea/multi_json/commit/26a94ab8c78a394cc237e2ea292c1de4f6ed30d7)
|
10
|
+
|
11
|
+
1.14.0
|
12
|
+
------
|
13
|
+
|
14
|
+
* [Support Oj 3.x gem](https://github.com/intridea/multi_json/commit/5d8febdbebc428882811b90d514f3628617a61d5)
|
15
|
+
|
16
|
+
1.13.1
|
17
|
+
------
|
18
|
+
|
19
|
+
* [Fix missing stdlib set dependency in oj adapter](https://github.com/intridea/multi_json/commit/c4ff66e7bee6fb4f45e54429813d7fada1c152b8)
|
20
|
+
|
21
|
+
1.13.0
|
22
|
+
-----
|
23
|
+
|
24
|
+
* [Make Oj adapter handle JSON::ParseError correctly](https://github.com/intridea/multi_json/commit/275e3ffd8169797c510d23d9ef5b8b07e64c3b42)
|
25
|
+
|
26
|
+
1.12.2
|
27
|
+
------
|
28
|
+
|
29
|
+
* [Renew gem certificate](https://github.com/intridea/multi_json/commit/57922d898c6eb587cc9a28ba5724c11e81724700)
|
30
|
+
|
31
|
+
1.12.1
|
32
|
+
------
|
33
|
+
|
34
|
+
* [Prevent memory leak in OptionsCache](https://github.com/intridea/multi_json/commit/aa7498199ad272f3d4a13750d7c568a66047e2ee)
|
35
|
+
|
36
|
+
1.12.0
|
37
|
+
------
|
38
|
+
|
39
|
+
* [Introduce global options cache to improve peroformance](https://github.com/intridea/multi_json/commit/7aaef2a1bc2b83c95e4208b12dad5d1d87ff20a6)
|
40
|
+
|
41
|
+
1.11.2
|
42
|
+
------
|
43
|
+
|
44
|
+
* [Only pass one argument to JrJackson when two is not supported](https://github.com/intridea/multi_json/commit/e798fa517c817fc706982d3f3c61129b6651d601)
|
45
|
+
|
46
|
+
1.11.1
|
47
|
+
------
|
48
|
+
|
49
|
+
* [Dump method passes options throught for JrJackson adapter](https://github.com/intridea/multi_json/commit/3c730fd12135c3e7bf212f878958004908f13909)
|
50
|
+
|
51
|
+
1.11.0
|
52
|
+
------
|
53
|
+
|
54
|
+
* [Make all adapters read IO object before load](https://github.com/intridea/multi_json/commit/167f559e18d4efee05e1f160a2661d16dbb215d4)
|
55
|
+
|
56
|
+
1.10.1
|
57
|
+
------
|
58
|
+
* [Explicitly require stringio for Gson adapter](https://github.com/intridea/multi_json/commit/623ec8142d4a212fa0db763bb71295789a119929)
|
59
|
+
* [Do not read StringIO object before passing it to JrJackson](https://github.com/intridea/multi_json/commit/a6dc935df08e7b3d5d701fbb9298384c96df0fde)
|
60
|
+
|
61
|
+
1.10.0
|
62
|
+
------
|
63
|
+
* [Performance tweaks](https://github.com/intridea/multi_json/commit/58724acfed31866d079eaafb1cd824e341ade287)
|
64
|
+
|
65
|
+
1.9.3
|
66
|
+
-----
|
67
|
+
* [Convert indent option to Fixnum before passing to Oj](https://github.com/intridea/multi_json/commit/826fc5535b863b74fc9f981dfdda3e26f1ee4e5b)
|
68
|
+
|
69
|
+
1.9.2
|
70
|
+
-----
|
71
|
+
* [Enable use_to_json option for Oj adapter by default](https://github.com/intridea/multi_json/commit/76a4aaf697b10bbabd5d535d83cf1149efcfe5c7)
|
72
|
+
|
73
|
+
1.9.1
|
74
|
+
-----
|
75
|
+
* [Remove unused LoadError file](https://github.com/intridea/multi_json/commit/65dedd84d59baeefc25c477fedf0bbe85e7ce2cd)
|
76
|
+
|
77
|
+
1.9.0
|
78
|
+
----
|
79
|
+
* [Rename LoadError to ParseError](https://github.com/intridea/multi_json/commit/4abb98fe3a90b2a7b3d1594515c8a06042b4a27d)
|
80
|
+
* [Adapter load failure throws AdapterError instead of ArgumentError](https://github.com/intridea/multi_json/commit/4da612b617bd932bb6fa1cc4c43210327f98f271)
|
81
|
+
|
82
|
+
1.8.4
|
83
|
+
-----
|
84
|
+
* [Make Gson adapter explicitly read StringIO object](https://github.com/intridea/multi_json/commit/b58b498747ff6e94f41488c971b2a30a98760ef2)
|
85
|
+
|
86
|
+
1.8.3
|
87
|
+
-----
|
88
|
+
* [Make JrJackson explicitly read StringIO objects](https://github.com/intridea/multi_json/commit/e1f162d5b668e5e4db5afa175361a601a8aa2b05)
|
89
|
+
* [Prevent calling #downcase on alias symbols](https://github.com/intridea/multi_json/commit/c1cf075453ce0110f7decc4f906444b1233bb67c)
|
90
|
+
|
91
|
+
1.8.2
|
92
|
+
-----
|
93
|
+
* [Downcase adapter string name for OS compatibility](https://github.com/intridea/multi_json/commit/b8e15a032247a63f1410d21a18add05035f3fa66)
|
94
|
+
|
95
|
+
1.8.1
|
96
|
+
-----
|
97
|
+
* [Let the adapter handle strings with invalid encoding](https://github.com/intridea/multi_json/commit/6af2bf87b89f44eabf2ae9ca96779febc65ea94b)
|
98
|
+
|
99
|
+
1.8.0
|
100
|
+
-----
|
101
|
+
* [Raise MultiJson::LoadError on blank input](https://github.com/intridea/multi_json/commit/c44f9c928bb25fe672246ad394b3e5b991be32e6)
|
102
|
+
|
103
|
+
1.7.9
|
104
|
+
-----
|
105
|
+
* [Explicitly require json gem code even when constant is defined](https://github.com/intridea/multi_json/commit/36f7906c66477eb4b55b7afeaa3684b6db69eff2)
|
106
|
+
|
107
|
+
1.7.8
|
108
|
+
-----
|
109
|
+
* [Reorder JrJackson before json_gem](https://github.com/intridea/multi_json/commit/315b6e460b6e4dcdb6c82e04e4be8ee975d395da)
|
110
|
+
* [Update vendored OkJson to version 43](https://github.com/intridea/multi_json/commit/99a6b662f6ef4036e3ee94d7eb547fa72fb2ab50)
|
111
|
+
|
112
|
+
1.7.7
|
113
|
+
-----
|
114
|
+
* [Fix options caching issues](https://github.com/intridea/multi_json/commit/a3f14c3661688c5927638fa6088c7b46a67e875e)
|
115
|
+
|
116
|
+
1.7.6
|
117
|
+
-----
|
118
|
+
* [Bring back MultiJson::VERSION constant](https://github.com/intridea/multi_json/commit/31b990c2725e6673bf8ce57540fe66b57a751a72)
|
119
|
+
|
120
|
+
1.7.5
|
121
|
+
-----
|
122
|
+
* [Fix warning '*' interpreted as argument prefix](https://github.com/intridea/multi_json/commit/b698962c7f64430222a1f06430669706a47aff89)
|
123
|
+
* [Remove stdlib warning](https://github.com/intridea/multi_json/commit/d06eec6b7996ac8b4ff0e2229efd835379b0c30f)
|
124
|
+
|
125
|
+
1.7.4
|
126
|
+
-----
|
127
|
+
* [Cache options for better performance](https://github.com/intridea/multi_json/commit/8a26ee93140c4bed36194ed9fb887a1b6919257b)
|
128
|
+
|
129
|
+
1.7.3
|
130
|
+
-----
|
131
|
+
* [Require json/ext to ensure extension version gets loaded for json_gem](https://github.com/intridea/multi_json/commit/942686f7e8597418c6f90ee69e1d45242fac07b1)
|
132
|
+
* [Rename JrJackson](https://github.com/intridea/multi_json/commit/078de7ba8b6035343c3e96b4767549e9ec43369a)
|
133
|
+
* [Prefer JrJackson to JSON gem if present](https://github.com/intridea/multi_json/commit/af8bd9799a66855f04b3aff1c488485950cec7bf)
|
134
|
+
* [Print a warning if outdated gem versions are used](https://github.com/intridea/multi_json/commit/e7438e7ba2be0236cfa24c2bb9ad40ee821286d1)
|
135
|
+
* [Loosen required_rubygems_version for compatibility with Ubuntu 10.04](https://github.com/intridea/multi_json/commit/59fad014e8fe41dbc6f09485ea0dc21fc42fd7a7)
|
136
|
+
|
137
|
+
1.7.2
|
138
|
+
-----
|
139
|
+
* [Rename Jrjackson adapter to JrJackson](https://github.com/intridea/multi_json/commit/b36dc915fc0e6548cbad06b5db6f520e040c9c8b)
|
140
|
+
* [Implement jrjackson -> jr_jackson alias for back-compatability](https://github.com/intridea/multi_json/commit/aa50ab8b7bb646b8b75d5d65dfeadae8248a4f10)
|
141
|
+
* [Update vendored OkJson module](https://github.com/intridea/multi_json/commit/30a3f474e17dd86a697c3fab04f468d1a4fd69d7)
|
142
|
+
|
143
|
+
1.7.1
|
144
|
+
-----
|
145
|
+
* [Fix capitalization of JrJackson class](https://github.com/intridea/multi_json/commit/5373a5e38c647f02427a0477cb8e0e0dafad1b8d)
|
146
|
+
|
147
|
+
1.7.0
|
148
|
+
-----
|
149
|
+
* [Add load_options/dump_options to MultiJson](https://github.com/intridea/multi_json/commit/a153956be6b0df06ea1705ce3c1ff0b5b0e27ea5)
|
150
|
+
* [MultiJson does not modify arguments](https://github.com/intridea/multi_json/commit/58525b01c4c2f6635ba2ac13d6fd987b79f3962f)
|
151
|
+
* [Enable quirks_mode by default for json_gem/json_pure adapters](https://github.com/intridea/multi_json/commit/1fd4e6635c436515b7d7d5a0bee4548de8571520)
|
152
|
+
* [Add JrJackson adapter](https://github.com/intridea/multi_json/commit/4dd86fa96300aaaf6d762578b9b31ea82adb056d)
|
153
|
+
* [Raise ArgumentError on bad adapter input](https://github.com/intridea/multi_json/commit/911a3756bdff2cb5ac06497da3fa3e72199cb7ad)
|
154
|
+
|
155
|
+
1.6.1
|
156
|
+
-----
|
157
|
+
* [Revert "Use JSON.generate instead of #to_json"](https://github.com/intridea/multi_json/issues/86)
|
158
|
+
|
159
|
+
1.6.0
|
160
|
+
-----
|
161
|
+
* [Add gson.rb support](https://github.com/intridea/multi_json/pull/71)
|
162
|
+
* [Add MultiJson.default_options](https://github.com/intridea/multi_json/pull/70)
|
163
|
+
* [Add MultiJson.with_adapter](https://github.com/intridea/multi_json/pull/67)
|
164
|
+
* [Stringify all possible keys for ok_json](https://github.com/intridea/multi_json/pull/66)
|
165
|
+
* [Use JSON.generate instead of #to_json](https://github.com/intridea/multi_json/issues/73)
|
166
|
+
* [Alias `MultiJson::DecodeError` to `MultiJson::LoadError`](https://github.com/intridea/multi_json/pull/79)
|
167
|
+
|
168
|
+
1.5.1
|
169
|
+
-----
|
170
|
+
* [Do not allow Oj or JSON to create symbols by searching for classes](https://github.com/intridea/multi_json/commit/193e28cf4dc61b6e7b7b7d80f06f74c76df65c41)
|
171
|
+
|
172
|
+
1.5.0
|
173
|
+
-----
|
174
|
+
* [Add `MultiJson.with_adapter` method](https://github.com/intridea/multi_json/commit/d14c5d28cae96557a0421298621b9499e1f28104)
|
175
|
+
* [Stringify all possible keys for `ok_json`](https://github.com/intridea/multi_json/commit/73998074058e1e58c557ffa7b9541d486d6041fa)
|
176
|
+
|
177
|
+
1.4.0
|
178
|
+
-----
|
179
|
+
* [Allow `load`/`dump` of JSON fragments](https://github.com/intridea/multi_json/commit/707aae7d48d39c85b38febbd2c210ba87f6e4a36)
|
180
|
+
|
181
|
+
1.3.7
|
182
|
+
-----
|
183
|
+
* [Fix rescue clause for MagLev](https://github.com/intridea/multi_json/commit/39abdf50199828c50e85b2ce8f8ba31fcbbc9332)
|
184
|
+
* [Remove unnecessary check for string version of options key](https://github.com/intridea/multi_json/commit/660101b70e962b3c007d0b90d45944fa47d13ec4)
|
185
|
+
* [Explicitly set default adapter when adapter is set to `nil` or `false`](https://github.com/intridea/multi_json/commit/a9e587d5a63eafb4baee9fb211265e4dd96a26bc)
|
186
|
+
* [Fix Oj `ParseError` mapping for Oj 1.4.0](https://github.com/intridea/multi_json/commit/7d9045338cc9029401c16f3c409d54ce97f275e2)
|
187
|
+
|
188
|
+
1.3.6
|
189
|
+
-----
|
190
|
+
* [Allow adapter-specific options to be passed through to Oj](https://github.com/intridea/multi_json/commit/d0e5feeebcba0bc69400dd203a295f5c30971223)
|
191
|
+
|
192
|
+
1.3.5
|
193
|
+
-----
|
194
|
+
* [Add pretty support to Oj adapter](https://github.com/intridea/multi_json/commit/0c8f75f03020c53bcf4c6be258faf433d24b2c2b)
|
195
|
+
|
196
|
+
1.3.4
|
197
|
+
-----
|
198
|
+
* [Use `class << self` instead of `module_function` to create aliases](https://github.com/intridea/multi_json/commit/ba1451c4c48baa297e049889be241a424cb05980)
|
199
|
+
|
200
|
+
1.3.3
|
201
|
+
-----
|
202
|
+
* [Remove deprecation warnings](https://github.com/intridea/multi_json/commit/36b524e71544eb0186826a891bcc03b2820a008f)
|
203
|
+
|
204
|
+
1.3.2
|
205
|
+
-----
|
206
|
+
* [Add ability to use adapter per call](https://github.com/intridea/multi_json/commit/106bbec469d5d0a832bfa31fffcb8c0f0cdc9bd3)
|
207
|
+
* [Add and deprecate `default_engine` method](https://github.com/intridea/multi_json/commit/fc3df0c7a3e2ab9ce0c2c7e7617a4da97dd13f6e)
|
208
|
+
|
209
|
+
1.3.1
|
210
|
+
-----
|
211
|
+
* [Only warn once for each instance a deprecated method is called](https://github.com/intridea/multi_json/commit/e21d6eb7da74b3f283995c1d27d5880e75f0ae84)
|
212
|
+
|
213
|
+
1.3.0
|
214
|
+
-----
|
215
|
+
* [Implement `load`/`dump`; deprecate `decode`/`encode`](https://github.com/intridea/multi_json/commit/e90fd6cb1b0293eb0c73c2f4eb0f7a1764370216)
|
216
|
+
* [Rename engines to adapters](https://github.com/intridea/multi_json/commit/ae7fd144a7949a9c221dcaa446196ec23db908df)
|
217
|
+
|
218
|
+
1.2.0
|
219
|
+
-----
|
220
|
+
* [Add support for Oj](https://github.com/intridea/multi_json/commit/acd06b233edabe6c44f226873db7b49dab560c60)
|
221
|
+
|
222
|
+
1.1.0
|
223
|
+
-----
|
224
|
+
* [`NSJSONSerialization` support for MacRuby](https://github.com/intridea/multi_json/commit/f862e2fc966cac8867fe7da3997fc76e8a6cf5d4)
|
225
|
+
|
226
|
+
1.0.4
|
227
|
+
-----
|
228
|
+
* [Set data context to `DecodeError` exception](https://github.com/intridea/multi_json/commit/19ddafd44029c6681f66fae2a0f6eabfd0f85176)
|
229
|
+
* [Allow `ok_json` to fallback to `to_json`](https://github.com/intridea/multi_json/commit/c157240b1193b283d06d1bd4d4b5b06bcf3761f8)
|
230
|
+
* [Add warning when using `ok_json`](https://github.com/intridea/multi_json/commit/dd4b68810c84f826fb98f9713bfb29ab96888d57)
|
231
|
+
* [Options can be passed to an engine on encode](https://github.com/intridea/multi_json/commit/e0a7ff5d5ff621ffccc61617ed8aeec5816e81f7)
|
232
|
+
|
233
|
+
1.0.3
|
234
|
+
-----
|
235
|
+
* [`Array` support for `stringify_keys`](https://github.com/intridea/multi_json/commit/644d1c5c7c7f6a27663b11668527b346094e38b9)
|
236
|
+
* [`Array` support for `symbolize_keys`](https://github.com/intridea/multi_json/commit/c885377d47a2aa39cb0d971fea78db2d2fa479a7)
|
237
|
+
|
238
|
+
1.0.2
|
239
|
+
-----
|
240
|
+
* [Allow encoding of rootless JSON when `ok_json` is used](https://github.com/intridea/multi_json/commit/d1cde7de97cb0f6152aef8daf14037521cdce8c6)
|
241
|
+
|
242
|
+
1.0.1
|
243
|
+
-----
|
244
|
+
* [Correct an issue with `ok_json` not being returned as the default engine](https://github.com/intridea/multi_json/commit/d33c141619c54cccd770199694da8fd1bd8f449d)
|
245
|
+
|
246
|
+
1.0.0
|
247
|
+
-----
|
248
|
+
* [Remove `ActiveSupport::JSON` support](https://github.com/intridea/multi_json/commit/c2f4140141d785a24b3f56e58811b0e561b37f6a)
|
249
|
+
* [Fix `@engine` ivar warning](https://github.com/intridea/multi_json/commit/3b978a8995721a8dffedc3b75a7f49e5494ec553)
|
250
|
+
* [Only `rescue` from parsing errors during decoding, not any `StandardError`](https://github.com/intridea/multi_json/commit/391d00b5e85294d42d41347605d8d46b4a7f66cc)
|
251
|
+
* [Rename `okjson` engine and vendored lib to `ok_json`](https://github.com/intridea/multi_json/commit/5bd1afc977a8208ddb0443e1d57cb79665c019f1)
|
252
|
+
* [Add `StringIO` support to `json` gem and `ok_json`](https://github.com/intridea/multi_json/commit/1706b11568db7f50af451fce5f4d679aeb3bbe8f)
|
253
|
+
|
254
|
+
0.0.5
|
255
|
+
-----
|
256
|
+
* [Trap all JSON decoding errors; raise `MultiJson::DecodeError`](https://github.com/intridea/multi_json/commit/dea9a1aef6dd1212aa1e5a37ab1669f9b045b732)
|
257
|
+
|
258
|
+
0.0.4
|
259
|
+
-----
|
260
|
+
* [Fix default_engine check for `json` gem](https://github.com/intridea/multi_json/commit/caced0c4e8c795922a109ebc00c3c4fa8635bed8)
|
261
|
+
* [Make requirement mapper an `Array` to preserve order in Ruby versions < 1.9](https://github.com/intridea/multi_json/commit/526f5f29a42131574a088ad9bbb43d7f48439b2c)
|
262
|
+
|
263
|
+
0.0.3
|
264
|
+
-----
|
265
|
+
* [Improve defaulting and documentation](https://github.com/sferik/twitter/commit/3a0e41b9e4b0909201045fa47704b78c9d949b73)
|
266
|
+
|
267
|
+
0.0.2
|
268
|
+
-----
|
269
|
+
|
270
|
+
* [Rename to `multi_json`](https://github.com/sferik/twitter/commit/461ab89ce071c8c9fabfc183581e0ec523788b62)
|
271
|
+
|
272
|
+
0.0.1
|
273
|
+
-----
|
274
|
+
|
275
|
+
* [Initial commit](https://github.com/sferik/twitter/commit/518c21ab299c500527491e6c049ab2229e22a805)
|
data/CONTRIBUTING.md
ADDED
@@ -0,0 +1,46 @@
|
|
1
|
+
## Contributing
|
2
|
+
In the spirit of [free software][free-sw], **everyone** is encouraged to help
|
3
|
+
improve this project.
|
4
|
+
|
5
|
+
[free-sw]: http://www.fsf.org/licensing/essays/free-sw.html
|
6
|
+
|
7
|
+
Here are some ways *you* can contribute:
|
8
|
+
|
9
|
+
* by using alpha, beta, and prerelease versions
|
10
|
+
* by reporting bugs
|
11
|
+
* by suggesting new features
|
12
|
+
* by writing or editing documentation
|
13
|
+
* by writing specifications
|
14
|
+
* by writing code (**no patch is too small**: fix typos, add comments, clean up
|
15
|
+
inconsistent whitespace)
|
16
|
+
* by refactoring code
|
17
|
+
* by closing [issues][]
|
18
|
+
* by reviewing patches
|
19
|
+
|
20
|
+
[issues]: https://github.com/intridea/multi_json/issues
|
21
|
+
|
22
|
+
## Submitting an Issue
|
23
|
+
We use the [GitHub issue tracker][issues] to track bugs and features. Before
|
24
|
+
submitting a bug report or feature request, check to make sure it hasn't
|
25
|
+
already been submitted. When submitting a bug report, please include a [Gist][]
|
26
|
+
that includes a stack trace and any details that may be necessary to reproduce
|
27
|
+
the bug, including your gem version, Ruby version, and operating system.
|
28
|
+
Ideally, a bug report should include a pull request with failing specs.
|
29
|
+
|
30
|
+
[gist]: https://gist.github.com/
|
31
|
+
|
32
|
+
## Submitting a Pull Request
|
33
|
+
1. [Fork the repository.][fork]
|
34
|
+
2. [Create a topic branch.][branch]
|
35
|
+
3. Add specs for your unimplemented feature or bug fix.
|
36
|
+
4. Run `bundle exec rake spec`. If your specs pass, return to step 3.
|
37
|
+
5. Implement your feature or bug fix.
|
38
|
+
6. Run `bundle exec rake spec`. If your specs fail, return to step 5.
|
39
|
+
7. Run `open coverage/index.html`. If your changes are not completely covered
|
40
|
+
by your tests, return to step 3.
|
41
|
+
8. Add, commit, and push your changes.
|
42
|
+
9. [Submit a pull request.][pr]
|
43
|
+
|
44
|
+
[fork]: http://help.github.com/fork-a-repo/
|
45
|
+
[branch]: http://learn.github.com/p/branching.html
|
46
|
+
[pr]: http://help.github.com/send-pull-requests/
|
data/LICENSE.md
CHANGED
@@ -1,4 +1,4 @@
|
|
1
|
-
Copyright (c) 2010 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober,
|
1
|
+
Copyright (c) 2010-2013 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober, Pavel Pravosud
|
2
2
|
|
3
3
|
Permission is hereby granted, free of charge, to any person obtaining
|
4
4
|
a copy of this software and associated documentation files (the
|
data/README.md
CHANGED
@@ -1,58 +1,77 @@
|
|
1
|
-
# MultiJSON
|
1
|
+
# MultiJSON
|
2
2
|
|
3
|
-
[
|
4
|
-
[
|
3
|
+
[][gem]
|
4
|
+
[][travis]
|
5
|
+
[][codeclimate]
|
5
6
|
|
6
7
|
Lots of Ruby libraries parse JSON and everyone has their favorite JSON coder.
|
7
8
|
Instead of choosing a single JSON coder and forcing users of your library to be
|
8
9
|
stuck with it, you can use MultiJSON instead, which will simply choose the
|
9
10
|
fastest available JSON coder. Here's how to use it:
|
10
11
|
|
11
|
-
|
12
|
+
```ruby
|
13
|
+
require 'multi_json'
|
14
|
+
|
15
|
+
MultiJson.load('{"abc":"def"}') #=> {"abc" => "def"}
|
16
|
+
MultiJson.load('{"abc":"def"}', :symbolize_keys => true) #=> {:abc => "def"}
|
17
|
+
MultiJson.dump({:abc => 'def'}) # convert Ruby back to JSON
|
18
|
+
MultiJson.dump({:abc => 'def'}, :pretty => true) # encoded in a pretty form (if supported by the coder)
|
19
|
+
```
|
20
|
+
|
21
|
+
When loading invalid JSON, MultiJSON will throw a `MultiJson::ParseError`. `MultiJson::DecodeError` and `MultiJson::LoadError` are aliases for backwards compatibility.
|
12
22
|
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
23
|
+
```ruby
|
24
|
+
begin
|
25
|
+
MultiJson.load('{invalid json}')
|
26
|
+
rescue MultiJson::ParseError => exception
|
27
|
+
exception.data # => "{invalid json}"
|
28
|
+
exception.cause # => JSON::ParserError: 795: unexpected token at '{invalid json}'
|
29
|
+
end
|
30
|
+
```
|
17
31
|
|
18
|
-
|
32
|
+
`ParseError` instance has `cause` reader which contains the original exception.
|
33
|
+
It also has `data` reader with the input that caused the problem.
|
34
|
+
|
35
|
+
The `use` method, which sets the MultiJSON adapter, takes either a symbol or a
|
19
36
|
class (to allow for custom JSON parsers) that responds to both `.load` and `.dump`
|
20
37
|
at the class level.
|
21
38
|
|
39
|
+
When MultiJSON fails to load the specified adapter, it'll throw `MultiJson::AdapterError`
|
40
|
+
which inherits from `ArgumentError`.
|
41
|
+
|
22
42
|
MultiJSON tries to have intelligent defaulting. That is, if you have any of the
|
23
43
|
supported engines already loaded, it will utilize them before attempting to
|
24
44
|
load any. When loading, libraries are ordered by speed. First Oj, then Yajl,
|
25
45
|
then the JSON gem, then JSON pure. If no other JSON library is available,
|
26
46
|
MultiJSON falls back to [OkJson][], a simple, vendorable JSON parser.
|
27
47
|
|
28
|
-
[okjson]: https://github.com/kr/okjson
|
29
|
-
|
30
48
|
## Supported JSON Engines
|
31
49
|
|
32
|
-
* [Oj]
|
33
|
-
* [Yajl]
|
34
|
-
* [JSON]
|
35
|
-
* [JSON Pure]
|
36
|
-
* [NSJSONSerialization]
|
50
|
+
* [Oj][oj] Optimized JSON by Peter Ohler
|
51
|
+
* [Yajl][yajl] Yet Another JSON Library by Brian Lopez
|
52
|
+
* [JSON][json-gem] The default JSON gem with C-extensions (ships with Ruby 1.9+)
|
53
|
+
* [JSON Pure][json-gem] A Ruby variant of the JSON gem
|
54
|
+
* [NSJSONSerialization][nsjson] Wrapper for Apple's NSJSONSerialization in the Cocoa Framework (MacRuby only)
|
55
|
+
* [gson.rb][gson] A Ruby wrapper for google-gson library (JRuby only)
|
56
|
+
* [JrJackson][jrjackson] JRuby wrapper for Jackson (JRuby only)
|
37
57
|
* [OkJson][okjson] A simple, vendorable JSON parser
|
38
58
|
|
39
59
|
## Supported Ruby Versions
|
40
60
|
This library aims to support and is [tested against][travis] the following Ruby
|
41
61
|
implementations:
|
42
62
|
|
43
|
-
* Ruby 1.8
|
44
|
-
* Ruby 1.9
|
45
|
-
* Ruby
|
63
|
+
* Ruby 1.8
|
64
|
+
* Ruby 1.9
|
65
|
+
* Ruby 2.0
|
66
|
+
* Ruby 2.1
|
67
|
+
* Ruby 2.2
|
68
|
+
* Ruby 2.4
|
69
|
+
* Ruby 2.5
|
70
|
+
* Ruby 2.6
|
71
|
+
* Ruby 2.7
|
46
72
|
* [JRuby][]
|
47
|
-
* [Rubinius][]
|
48
|
-
* [MacRuby][] (not tested on Travis CI)
|
49
|
-
|
50
|
-
[jruby]: http://www.jruby.org/
|
51
|
-
[rubinius]: http://rubini.us/
|
52
|
-
[macruby]: http://www.macruby.org/
|
53
73
|
|
54
|
-
If something doesn't work
|
55
|
-
a bug.
|
74
|
+
If something doesn't work in one of these implementations, it's a bug.
|
56
75
|
|
57
76
|
This library may inadvertently work (or seem to work) on other Ruby
|
58
77
|
implementations, however support will only be provided for the versions listed
|
@@ -61,9 +80,9 @@ above.
|
|
61
80
|
If you would like this library to support another Ruby version, you may
|
62
81
|
volunteer to be a maintainer. Being a maintainer entails making sure all tests
|
63
82
|
run and pass on that implementation. When something breaks on your
|
64
|
-
implementation, you will be
|
65
|
-
|
66
|
-
|
83
|
+
implementation, you will be responsible for providing patches in a timely
|
84
|
+
fashion. If critical issues for a particular implementation exist at the time
|
85
|
+
of a major release, support for that Ruby version may be dropped.
|
67
86
|
|
68
87
|
## Versioning
|
69
88
|
|
@@ -76,13 +95,27 @@ introduced with new major versions. As a result of this policy, you can (and
|
|
76
95
|
should) specify a dependency on this gem using the [Pessimistic Version
|
77
96
|
Constraint][pvc] with two digits of precision. For example:
|
78
97
|
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
[pvc]: http://docs.rubygems.org/read/chapter/16#page74
|
98
|
+
```ruby
|
99
|
+
spec.add_dependency 'multi_json', '~> 1.0'
|
100
|
+
```
|
83
101
|
|
84
102
|
## Copyright
|
85
|
-
Copyright (c) 2010 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober,
|
86
|
-
See [LICENSE][] for details.
|
103
|
+
Copyright (c) 2010-2018 Michael Bleigh, Josh Kalderimis, Erik Michaels-Ober,
|
104
|
+
and Pavel Pravosud. See [LICENSE][] for details.
|
87
105
|
|
88
|
-
[
|
106
|
+
[codeclimate]: https://codeclimate.com/github/intridea/multi_json
|
107
|
+
[gem]: https://rubygems.org/gems/multi_json
|
108
|
+
[gson]: https://github.com/avsej/gson.rb
|
109
|
+
[jrjackson]: https://github.com/guyboertje/jrjackson
|
110
|
+
[jruby]: http://www.jruby.org/
|
111
|
+
[json-gem]: https://github.com/flori/json
|
112
|
+
[json-pure]: https://github.com/flori/json
|
113
|
+
[license]: LICENSE.md
|
114
|
+
[macruby]: http://www.macruby.org/
|
115
|
+
[nsjson]: https://developer.apple.com/library/ios/#documentation/Foundation/Reference/NSJSONSerialization_Class/Reference/Reference.html
|
116
|
+
[oj]: https://github.com/ohler55/oj
|
117
|
+
[okjson]: https://github.com/kr/okjson
|
118
|
+
[pvc]: http://docs.rubygems.org/read/chapter/16#page74
|
119
|
+
[semver]: http://semver.org/
|
120
|
+
[travis]: http://travis-ci.org/intridea/multi_json
|
121
|
+
[yajl]: https://github.com/brianmario/yajl-ruby
|
@@ -0,0 +1,49 @@
|
|
1
|
+
require 'singleton'
|
2
|
+
require 'multi_json/options'
|
3
|
+
|
4
|
+
module MultiJson
|
5
|
+
class Adapter
|
6
|
+
extend Options
|
7
|
+
include Singleton
|
8
|
+
|
9
|
+
class << self
|
10
|
+
def defaults(action, value)
|
11
|
+
metaclass = class << self; self; end
|
12
|
+
|
13
|
+
metaclass.instance_eval do
|
14
|
+
define_method("default_#{action}_options") { value }
|
15
|
+
end
|
16
|
+
end
|
17
|
+
|
18
|
+
def load(string, options = {})
|
19
|
+
string = string.read if string.respond_to?(:read)
|
20
|
+
fail self::ParseError if blank?(string)
|
21
|
+
instance.load(string, cached_load_options(options))
|
22
|
+
end
|
23
|
+
|
24
|
+
def dump(object, options = {})
|
25
|
+
instance.dump(object, cached_dump_options(options))
|
26
|
+
end
|
27
|
+
|
28
|
+
private
|
29
|
+
|
30
|
+
def blank?(input)
|
31
|
+
input.nil? || /\A\s*\z/ === input
|
32
|
+
rescue ArgumentError # invalid byte sequence in UTF-8
|
33
|
+
false
|
34
|
+
end
|
35
|
+
|
36
|
+
def cached_dump_options(options)
|
37
|
+
OptionsCache.fetch(:dump, options) do
|
38
|
+
dump_options(options).merge(MultiJson.dump_options(options)).merge!(options)
|
39
|
+
end
|
40
|
+
end
|
41
|
+
|
42
|
+
def cached_load_options(options)
|
43
|
+
OptionsCache.fetch(:load, options) do
|
44
|
+
load_options(options).merge(MultiJson.load_options(options)).merge!(options)
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
@@ -0,0 +1,15 @@
|
|
1
|
+
module MultiJson
|
2
|
+
class AdapterError < ArgumentError
|
3
|
+
attr_reader :cause
|
4
|
+
|
5
|
+
def self.build(original_exception)
|
6
|
+
message = "Did not recognize your adapter specification (#{original_exception.message})."
|
7
|
+
new(message).tap do |exception|
|
8
|
+
exception.instance_eval do
|
9
|
+
@cause = original_exception
|
10
|
+
set_backtrace original_exception.backtrace
|
11
|
+
end
|
12
|
+
end
|
13
|
+
end
|
14
|
+
end
|
15
|
+
end
|
@@ -0,0 +1,20 @@
|
|
1
|
+
require 'gson'
|
2
|
+
require 'stringio'
|
3
|
+
require 'multi_json/adapter'
|
4
|
+
|
5
|
+
module MultiJson
|
6
|
+
module Adapters
|
7
|
+
# Use the gson.rb library to dump/load.
|
8
|
+
class Gson < Adapter
|
9
|
+
ParseError = ::Gson::DecodeError
|
10
|
+
|
11
|
+
def load(string, options = {})
|
12
|
+
::Gson::Decoder.new(options).decode(string)
|
13
|
+
end
|
14
|
+
|
15
|
+
def dump(object, options = {})
|
16
|
+
::Gson::Encoder.new(options).encode(object)
|
17
|
+
end
|
18
|
+
end
|
19
|
+
end
|
20
|
+
end
|
@@ -0,0 +1,25 @@
|
|
1
|
+
require 'jrjackson' unless defined?(::JrJackson)
|
2
|
+
require 'multi_json/adapter'
|
3
|
+
|
4
|
+
module MultiJson
|
5
|
+
module Adapters
|
6
|
+
# Use the jrjackson.rb library to dump/load.
|
7
|
+
class JrJackson < Adapter
|
8
|
+
ParseError = ::JrJackson::ParseError
|
9
|
+
|
10
|
+
def load(string, options = {}) #:nodoc:
|
11
|
+
::JrJackson::Json.load(string, options)
|
12
|
+
end
|
13
|
+
|
14
|
+
if ::JrJackson::Json.method(:dump).arity == 1
|
15
|
+
def dump(object, _)
|
16
|
+
::JrJackson::Json.dump(object)
|
17
|
+
end
|
18
|
+
else
|
19
|
+
def dump(object, options = {})
|
20
|
+
::JrJackson::Json.dump(object, options)
|
21
|
+
end
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
25
|
+
end
|
@@ -1,25 +1,23 @@
|
|
1
|
+
require 'multi_json/adapter'
|
2
|
+
|
1
3
|
module MultiJson
|
2
4
|
module Adapters
|
3
|
-
|
5
|
+
class JsonCommon < Adapter
|
6
|
+
defaults :load, :create_additions => false, :quirks_mode => true
|
4
7
|
|
5
|
-
def load(string, options={})
|
6
|
-
|
7
|
-
|
8
|
-
|
8
|
+
def load(string, options = {})
|
9
|
+
if string.respond_to?(:force_encoding)
|
10
|
+
string = string.dup.force_encoding(::Encoding::ASCII_8BIT)
|
11
|
+
end
|
9
12
|
|
10
|
-
|
11
|
-
|
13
|
+
options[:symbolize_names] = true if options.delete(:symbolize_keys)
|
14
|
+
::JSON.parse(string, options)
|
12
15
|
end
|
13
16
|
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
return options if options.empty?
|
18
|
-
opts = {}
|
19
|
-
opts.merge!(JSON::PRETTY_STATE_PROTOTYPE.to_h) if options.delete(:pretty)
|
20
|
-
opts.merge!(options)
|
17
|
+
def dump(object, options = {})
|
18
|
+
options.merge!(::JSON::PRETTY_STATE_PROTOTYPE.to_h) if options.delete(:pretty)
|
19
|
+
object.to_json(options)
|
21
20
|
end
|
22
|
-
|
23
21
|
end
|
24
22
|
end
|
25
23
|
end
|
@@ -1,12 +1,11 @@
|
|
1
|
-
require 'json'
|
1
|
+
require 'json/ext'
|
2
2
|
require 'multi_json/adapters/json_common'
|
3
3
|
|
4
4
|
module MultiJson
|
5
5
|
module Adapters
|
6
6
|
# Use the JSON gem to dump/load.
|
7
|
-
class JsonGem
|
7
|
+
class JsonGem < JsonCommon
|
8
8
|
ParseError = ::JSON::ParserError
|
9
|
-
extend JsonCommon
|
10
9
|
end
|
11
10
|
end
|
12
11
|
end
|