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 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, and Intridea, Inc.
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 [![Build Status](https://secure.travis-ci.org/intridea/multi_json.png?branch=master)][travis] [![Dependency Status](https://gemnasium.com/intridea/multi_json.png?travis)][gemnasium]
1
+ # MultiJSON
2
2
 
3
- [travis]: http://travis-ci.org/intridea/multi_json
4
- [gemnasium]: https://gemnasium.com/intridea/multi_json
3
+ [![Gem Version](http://img.shields.io/gem/v/multi_json.svg)][gem]
4
+ [![Build Status](http://travis-ci.org/intridea/multi_json.svg)][travis]
5
+ [![Code Climate](https://codeclimate.com/github/intridea/multi_json.svg)][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
- require 'multi_json'
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
- MultiJson.load('{"abc":"def"}') #=> {"abc" => "def"}
14
- MultiJson.load('{"abc":"def"}', :symbolize_keys => true) #=> {:abc => "def"}
15
- MultiJson.dump({:abc => 'def'}) # convert Ruby back to JSON
16
- MultiJson.dump({:abc => 'def'}, :pretty => true) # encoded in a pretty form (if supported by the coder)
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
- The `use` method, which sets the MultiJson adapter, takes either a symbol or a
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](https://github.com/ohler55/oj) Optimized JSON by Peter Ohler
33
- * [Yajl](https://github.com/brianmario/yajl-ruby) Yet Another JSON Library by Brian Lopez
34
- * [JSON](https://github.com/flori/json) The default JSON gem with C-extensions (ships with Ruby 1.9)
35
- * [JSON Pure](https://github.com/flori/json) A Ruby variant of the JSON gem
36
- * [NSJSONSerialization](https://developer.apple.com/library/ios/#documentation/Foundation/Reference/NSJSONSerialization_Class/Reference/Reference.html) Wrapper for Apple's NSJSONSerialization in the Cocoa Framework (MacRuby only)
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.7
44
- * Ruby 1.9.2
45
- * Ruby 1.9.3
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 on one of these interpreters, it should be considered
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 personally responsible for providing patches in a
65
- timely fashion. If critical issues for a particular implementation exist at the
66
- time of a major release, support for that Ruby version may be dropped.
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
- spec.add_dependency 'multi_json', '~> 1.0'
80
-
81
- [semver]: http://semver.org/
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, and Intridea, Inc.
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
- [license]: https://github.com/intridea/multi_json/blob/master/LICENSE.md
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
- module JsonCommon
5
+ class JsonCommon < Adapter
6
+ defaults :load, :create_additions => false, :quirks_mode => true
4
7
 
5
- def load(string, options={})
6
- string = string.read if string.respond_to?(:read)
7
- ::JSON.parse(string, :symbolize_names => options[:symbolize_keys], :quirks_mode => true)
8
- end
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
- def dump(object, options={})
11
- object.to_json(process_options(options))
13
+ options[:symbolize_names] = true if options.delete(:symbolize_keys)
14
+ ::JSON.parse(string, options)
12
15
  end
13
16
 
14
- protected
15
-
16
- def process_options(options={})
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' unless defined?(::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