| 1 |
Revision history for Perl extension JSON::XS |
| 2 |
|
| 3 |
TODO: maybe detetc and croak on more invalid inputs (e.g. +-inf/nan) |
| 4 |
TODO: maybe avoid the reblessing and better support readonly objects. |
| 5 |
TODO: http://stevehanov.ca/blog/index.php?id=104 compression |
| 6 |
|
| 7 |
TODO: how to cope with tagged values and standard json decoders |
| 8 |
TODO: work around <=5.16 bugs (Reini Urban) |
| 9 |
3.01 Tue Oct 29 16:55:15 CET 2013 |
| 10 |
- backport to perls < 5.18 (reported by Paul Howarth). |
| 11 |
|
| 12 |
3.0 Tue Oct 29 01:35:37 CET 2013 |
| 13 |
- implemented an object tagging extension (using the |
| 14 |
Types::Serialiser serialisation protocol). |
| 15 |
- reworked the documentation regarding object serialisation, |
| 16 |
add a new OBJECT SERIALISATION section that explains the |
| 17 |
whole process. |
| 18 |
- new setting: allow_tags. |
| 19 |
- switch to Types::Serialiser booleans. |
| 20 |
- remove to_json/from_json. |
| 21 |
- other minor improvements to the documentation. |
| 22 |
|
| 23 |
2.34 Thu May 23 11:30:34 CEST 2013 |
| 24 |
- work around bugs in perl 5.18 breaking more than 100 |
| 25 |
widely used modules, without a fix in sight because |
| 26 |
p5pers don't care about CPAN anymore. |
| 27 |
- when canonicalising, only allocate up to 64 hash key |
| 28 |
pointers on the stack. for larger hashes, use the heap, |
| 29 |
to avoid using too much stackspace. |
| 30 |
- discuss the problem with setlocale (reported by a few victims). |
| 31 |
|
| 32 |
2.33 Wed Aug 1 21:03:52 CEST 2012 |
| 33 |
- internal encode/decode XS wrappers did not expect stack |
| 34 |
moves caused by callbacks (analyzed and testcase by Jesse Luehrs). |
| 35 |
- add bencode as to/from option in bin/json_xs. |
| 36 |
- add -e option to json_xs, and none and string in/out formats. |
| 37 |
|
| 38 |
2.32 Thu Aug 11 19:06:38 CEST 2011 |
| 39 |
- fix a bug in the initial whitespace accumulation. |
| 40 |
|
| 41 |
2.31 Wed Jul 27 17:53:05 CEST 2011 |
| 42 |
- don't accumulate initial whitespace in the incremental buffer |
| 43 |
(this can be useful to allow whitespace-keepalive on a tcp |
| 44 |
connection without triggering the max_size limit). |
| 45 |
- properly croak on some invalid inputs that are not strings |
| 46 |
(e.g. undef) when trying to decode a json text (reported |
| 47 |
and analyzed by Goro Fuji). |
| 48 |
|
| 49 |
2.3 Wed Aug 18 01:26:47 CEST 2010 |
| 50 |
- make sure decoder doesn't change the decoding in the incremental |
| 51 |
parser (testcase provided by Hendrik Schumacher). |
| 52 |
- applied patch by DaTa for Data::Dumper support in json_xs. |
| 53 |
- added -t dump support to json_xs, using Data::Dump. |
| 54 |
- added -f eval support to json_xs. |
| 55 |
|
| 56 |
2.29 Wed Mar 17 02:39:12 CET 2010 |
| 57 |
- fix a memory leak when callbacks set using filter_json_object |
| 58 |
or filter_json_single_key_object were called (great testcase |
| 59 |
by Eric Wilhelm). |
| 60 |
|
| 61 |
2.28 Thu Mar 11 20:30:46 CET 2010 |
| 62 |
- implement our own atof function - perl's can be orders of |
| 63 |
magnitudes slower than even the system one. on the positive |
| 64 |
side, ours seems to be more exact in general than perl's. |
| 65 |
(testcase provided by Tim Meadowcroft). |
| 66 |
- clarify floating point conversion issues a bit. |
| 67 |
- update jpsykes csrf article url. |
| 68 |
- updated benchmark section - JSON::PP became much faster! |
| 69 |
|
| 70 |
2.27 Thu Jan 7 07:35:08 CET 2010 |
| 71 |
- support relaxed option inside the incremental parser |
| 72 |
(testcase provided by IKEGAMI via Makamaka). |
| 73 |
|
| 74 |
2.26 Sat Oct 10 03:26:19 CEST 2009 |
| 75 |
- big integers could become truncated (based on patch |
| 76 |
by Strobl Anton). |
| 77 |
- output format change: indent now adds a final newline, which is |
| 78 |
more expected and more true to the documentation. |
| 79 |
|
| 80 |
2.25 Sat Aug 8 12:04:41 CEST 2009 |
| 81 |
- the perl debugger completely breaks lvalue subs - try to work |
| 82 |
around the issue. |
| 83 |
- ignore RMAGICAL hashes w.r.t. CANONICAL. |
| 84 |
- try to work around a possible char signedness issue on aix. |
| 85 |
- require common sense. |
| 86 |
|
| 87 |
2.24 Sat May 30 08:25:45 CEST 2009 |
| 88 |
- the incremental parser did not update its parse offset |
| 89 |
pointer correctly when parsing utf8-strings (nicely |
| 90 |
debugged by Martin Evans). |
| 91 |
- appending a non-utf8-string to the incremental parser |
| 92 |
in utf8 mode failed to upgrade the string. |
| 93 |
- wording of parse error messages has been improved. |
| 94 |
|
| 95 |
2.232 Sun Feb 22 11:12:25 CET 2009 |
| 96 |
- use an exponential algorithm to extend strings, to |
| 97 |
help platforms with bad or abysmal==windows memory |
| 98 |
allocater performance, at the expense of some memory |
| 99 |
wastage (use shrink to recover this extra memory). |
| 100 |
(nicely analysed by Dmitry Karasik). |
| 101 |
|
| 102 |
2.2311 Thu Feb 19 02:12:54 CET 2009 |
| 103 |
- add a section "JSON and ECMAscript" to explain some |
| 104 |
incompatibilities between the two (problem was noted by |
| 105 |
various people). |
| 106 |
- add t/20_faihu.t. |
| 107 |
|
| 108 |
2.231 Thu Nov 20 04:59:08 CET 2008 |
| 109 |
- work around 5.10.0 magic bugs where manipulating magic values |
| 110 |
(such as $1) would permanently damage them as perl would |
| 111 |
ignore the magicalness, by making a full copy of the string, |
| 112 |
reported by Dmitry Karasik. |
| 113 |
- work around spurious warnings under older perl 5.8's. |
| 114 |
|
| 115 |
2.23 Mon Sep 29 05:08:29 CEST 2008 |
| 116 |
- fix a compilation problem when perl is not using char * as, well, |
| 117 |
char *. |
| 118 |
- use PL_hexdigit in favour of rolling our own. |
| 119 |
|
| 120 |
2.2222 Sun Jul 20 18:49:00 CEST 2008 |
| 121 |
- same game again, broken 5.10 finds yet another assertion |
| 122 |
failure, and the workaround causes additional runtime warnings. |
| 123 |
Work around the next assertion AND the warning. 5.10 seriously |
| 124 |
needs to adjust it's attitude against working code. |
| 125 |
|
| 126 |
2.222 Sat Jul 19 06:15:34 CEST 2008 |
| 127 |
- you work around one -DDEBUGGING assertion bug in perl 5.10 |
| 128 |
just to hit the next one. work around this one, too. |
| 129 |
|
| 130 |
2.22 Tue Jul 15 13:26:51 CEST 2008 |
| 131 |
- allow higher nesting levels in incremental parser. |
| 132 |
- error out earlier in some cases in the incremental parser |
| 133 |
(as suggested by Yuval Kogman). |
| 134 |
- improve incr-parser test (Yuval Kogman). |
| 135 |
|
| 136 |
2.21 Tue Jun 3 08:43:23 CEST 2008 |
| 137 |
- (hopefully) work around a perl 5.10 bug with -DDEBUGGING. |
| 138 |
- remove the experimental status of the incremental parser interface. |
| 139 |
- move =encoding around again, to avoid bugs with search.cpan.org. |
| 140 |
when can we finally have utf-8 in pod??? |
| 141 |
- add ->incr_reset method. |
| 142 |
|
| 143 |
2.2 Wed Apr 16 20:37:25 CEST 2008 |
| 144 |
- lifted the log2 rounding restriction of max_depth and max_size. |
| 145 |
- make booleans mutable by creating a copy instead of handing out |
| 146 |
the same scalar (reported by pasha sadri). |
| 147 |
- added support for incremental json parsing (still EXPERIMENTAL). |
| 148 |
- implemented and added a json_xs command line utility that can convert |
| 149 |
from/to a number of serialisation formats - tell me if you need more. |
| 150 |
- implement allow_unknown/get_allow_unknown methods. |
| 151 |
- fixed documentation of max_depth w.r.t. higher and equal. |
| 152 |
- moved down =encoding directive a bit, too much breaks if it's the first |
| 153 |
pod directive :/. |
| 154 |
- removed documentation section on other modules, it became somewhat |
| 155 |
outdated and is nowadays mostly of historical interest. |
| 156 |
|
| 157 |
2.1 Wed Mar 19 23:23:18 CET 2008 |
| 158 |
- update documentation here and there: add a large section |
| 159 |
about utf8/latin1/ascii flags, add a security consideration |
| 160 |
and extend and clarify the JSON and YAML section. |
| 161 |
- medium speed enhancements when encoding/decoding non-ascii chars. |
| 162 |
- minor speedup in number encoding case. |
| 163 |
- extend and clarify the section on incompatibilities |
| 164 |
between YAML and JSON. |
| 165 |
- switch to static inline from just inline when using gcc. |
| 166 |
- add =encoding utf-8 to the manpage, now that perl 5.10 supports it. |
| 167 |
- fix some issues with UV to JSON conversion of unknown impact. |
| 168 |
- published the yahoo locals search result used in benchmarks as the |
| 169 |
original url changes so comparison is impossible. |
| 170 |
|
| 171 |
2.01 Wed Dec 5 11:40:28 CET 2007 |
| 172 |
- INCOMPATIBLE API CHANGE: to_json and from_json have been |
| 173 |
renamed to encode_json/decode_json for JSON.pm compatibility. |
| 174 |
The old functions croak and might be replaced by JSON.pm |
| 175 |
comaptible versions in some later release. |
| 176 |
|
| 177 |
2.0 Tue Dec 4 11:30:46 CET 2007 |
| 178 |
- this is supposed to be the first version of JSON::XS |
| 179 |
compatible with version 2.0+ of the JSON module. |
| 180 |
Using the JSON module as frontend to JSON::XS should be |
| 181 |
as fast as using JSON::XS directly, so consider using it |
| 182 |
instead. |
| 183 |
- added get_* methods for all "simple" options. |
| 184 |
- make JSON::XS subclassable. |
| 185 |
|
| 186 |
1.53 Tue Nov 13 23:58:33 CET 2007 |
| 187 |
- minor doc clarifications. |
| 188 |
- fixed many doc typos (patch by Thomas L. Shinnick). |
| 189 |
|
| 190 |
1.52 Mon Oct 15 03:22:06 CEST 2007 |
| 191 |
- remove =encoding pod directive again, it confuses too many pod |
| 192 |
parsers :/. |
| 193 |
|
| 194 |
1.51 Sat Oct 13 03:55:56 CEST 2007 |
| 195 |
- encode empty arrays/hashes in a compact way when pretty is enabled. |
| 196 |
- apparently JSON::XS was used to find some bugs in the |
| 197 |
JSON_checker testsuite, so add (the corrected) JSON_checker tests to |
| 198 |
the testsuite. |
| 199 |
- quite a bit of doc updates/extension. |
| 200 |
- require 5.8.2, as this seems to be the first unicode-stable version. |
| 201 |
|
| 202 |
1.5 Tue Aug 28 04:05:38 CEST 2007 |
| 203 |
- add support for tied hashes, based on ideas and testcase by |
| 204 |
Marcus Holland-Moritz. |
| 205 |
- implemented relaxed parsing mode where some extensions are being |
| 206 |
accepted. generation is still JSON-only. |
| 207 |
|
| 208 |
1.44 Wed Aug 22 01:02:44 CEST 2007 |
| 209 |
- very experimental process-emulation support, slowing everything down. |
| 210 |
the horribly broken perl threads are still not supported - YMMV. |
| 211 |
|
| 212 |
1.43 Thu Jul 26 13:26:37 CEST 2007 |
| 213 |
- convert big json numbers exclusively consisting of digits to NV |
| 214 |
only when there is no loss of precision, otherwise to string. |
| 215 |
|
| 216 |
1.42 Tue Jul 24 00:51:18 CEST 2007 |
| 217 |
- fix a crash caused by not handling missing array elements |
| 218 |
(report and testcase by Jay Kuri). |
| 219 |
|
| 220 |
1.41 Tue Jul 10 18:21:44 CEST 2007 |
| 221 |
- fix compilation with NDEBUG (assert side-effect), |
| 222 |
affects convert_blessed only. |
| 223 |
- fix a bug in decode filters calling ENTER; SAVETMPS; |
| 224 |
one time too often. |
| 225 |
- catch a typical error in TO_JSON methods. |
| 226 |
- antique-ised XS.xs again to work with outdated |
| 227 |
C compilers (windows...). |
| 228 |
|
| 229 |
1.4 Mon Jul 2 10:06:30 CEST 2007 |
| 230 |
- add convert_blessed setting. |
| 231 |
- encode did not catch all blessed objects, encoding their |
| 232 |
contents in most cases. This has been fixed by introducing |
| 233 |
the allow_blessed setting. |
| 234 |
- added filter_json_object and filter_json_single_key_object |
| 235 |
settings that specify a callback to be called when |
| 236 |
all/specific json objects are encountered. |
| 237 |
- assume that most object keys are simple ascii words and |
| 238 |
optimise this case, penalising the general case. This can |
| 239 |
speed up decoding by 30% in typical cases and gives |
| 240 |
a smaller and faster perl hash. |
| 241 |
- implemented simpleminded, optional resource size checking |
| 242 |
in decode_json. |
| 243 |
- remove objToJson/jsonToObj aliases, as the next version |
| 244 |
of JSON will not have them either. |
| 245 |
- bit the bullet and converted the very simple json object |
| 246 |
into a more complex one. |
| 247 |
- work around a bug where perl wrongly claims an integer |
| 248 |
is not an integer. |
| 249 |
- unbundle JSON::XS::Boolean into own pm file so Storable |
| 250 |
and similar modules can resolve the overloading when thawing. |
| 251 |
|
| 252 |
1.3 Sun Jun 24 01:55:02 CEST 2007 |
| 253 |
- make JSON::XS::true and false special overloaded objects |
| 254 |
and return those instead of 1 and 0 for those json atoms |
| 255 |
(JSON::PP compatibility is NOT achieved yet). |
| 256 |
- add JSON::XS::is_bool predicate to test for those special |
| 257 |
values. |
| 258 |
- add a reference to |
| 259 |
http://jpsykes.com/47/practical-csrf-and-json-security. |
| 260 |
- removed require 5.8.8 again, it is just not very expert-friendly. |
| 261 |
Also try to be more compatible with slightly older versions, |
| 262 |
which are not recommended (because they are buggy). |
| 263 |
|
| 264 |
1.24 Mon Jun 11 05:40:49 CEST 2007 |
| 265 |
- added informative section on JSON-as-YAML. |
| 266 |
- get rid of some c99-isms again. |
| 267 |
- localise dec->cur in decode_str, speeding up |
| 268 |
string decoding considerably (>15% on my amd64 + gcc). |
| 269 |
- increased SHORT_STRING_LEN to 16kb: stack space is |
| 270 |
usually plenty, and this actually saves memory |
| 271 |
when !shrinking as short strings will fit perfectly. |
| 272 |
|
| 273 |
1.23 Wed Jun 6 20:13:06 CEST 2007 |
| 274 |
- greatly improved small integer encoding and decoding speed. |
| 275 |
- implement a number of µ-optimisations. |
| 276 |
- updated benchmarks. |
| 277 |
|
| 278 |
1.22 Thu May 24 00:07:25 CEST 2007 |
| 279 |
- require 5.8.8 explicitly as older perls do not seem to offer |
| 280 |
the required macros. |
| 281 |
- possibly made it compile on so-called C compilers by microsoft. |
| 282 |
|
| 283 |
1.21 Wed May 9 18:40:32 CEST 2007 |
| 284 |
- character offset reported for trailing garbage was random. |
| 285 |
|
| 286 |
1.2 Wed May 9 18:35:01 CEST 2007 |
| 287 |
- decode did not work with magical scalars (doh!). |
| 288 |
- added latin1 flag to produce JSON texts in the latin1 subset |
| 289 |
of unicode. |
| 290 |
- flag trailing garbage as error. |
| 291 |
- new decode_prefix method that returns the number |
| 292 |
of characters consumed by a decode. |
| 293 |
- max octets/char in perls UTF-X is actually 13, not 11, |
| 294 |
as pointed out by Glenn Linderman. |
| 295 |
- fixed typoe reported by YAMASHINA Hio. |
| 296 |
|
| 297 |
1.11 Mon Apr 9 07:05:49 CEST 2007 |
| 298 |
- properly 0-terminate sv's returned by encode to help |
| 299 |
C libraries that expect that 0 to be there. |
| 300 |
- partially "port" JSON from C to microsofts fucking broken |
| 301 |
pseudo-C. They should be burned to the ground for pissing |
| 302 |
on standards. And I should be stoned for even trying to |
| 303 |
support this filthy excuse for a c compiler. |
| 304 |
|
| 305 |
1.1 Wed Apr 4 01:45:00 CEST 2007 |
| 306 |
- clarify documentation (pointed out by Quinn Weaver). |
| 307 |
- decode_utf8 sometimes did not correctly flag errors, |
| 308 |
leading to segfaults. |
| 309 |
- further reduced default nesting depth to 512 due to the test |
| 310 |
failure by that anonymous "chris" whose e-mail address seems |
| 311 |
to be impossible to get. Tests on other freebsd systems indicate |
| 312 |
that this is likely a problem in his/her configuration and not this |
| 313 |
module. |
| 314 |
- renamed json => JSON in error messages. |
| 315 |
- corrected the character offset in some error messages. |
| 316 |
|
| 317 |
1.01 Sat Mar 31 16:15:40 CEST 2007 |
| 318 |
- do not segfault when from_json/decode gets passed |
| 319 |
a non-string object (reported by Florian Ragwitz). |
| 320 |
This has no effect on normal operation. |
| 321 |
|
| 322 |
1.0 Thu Mar 29 04:43:34 CEST 2007 |
| 323 |
- the long awaited (by me) 1.0 version. |
| 324 |
- add \0 (JSON::XS::false) and \1 (JSON::XS::true) mappings to JSON |
| 325 |
true and false. |
| 326 |
- add some more notes to shrink, as suggested by Alex Efros. |
| 327 |
- improve testsuite. |
| 328 |
- halve the default nesting depth limit, to hopefully make it |
| 329 |
work on Freebsd (unfortunately, the cpan tester did not |
| 330 |
send me his report, so I cannot ask about the stack limit on fbsd). |
| 331 |
|
| 332 |
0.8 Mon Mar 26 00:10:48 CEST 2007 |
| 333 |
- fix a memleak when decoding hashes. |
| 334 |
- export jsonToBj and objToJson as aliases |
| 335 |
to to_json and from_json, to reduce incompatibilities |
| 336 |
between JSON/JSON::PC and JSON::XS. (experimental). |
| 337 |
- implement a maximum nesting depth for both en- and de-coding. |
| 338 |
- added a security considerations sections. |
| 339 |
|
| 340 |
0.7 Sun Mar 25 01:46:30 CET 2007 |
| 341 |
- code cleanup. |
| 342 |
- fix a memory overflow bug when indenting. |
| 343 |
- pretty-printing now up to 15% faster. |
| 344 |
- improve decoding speed of strings by |
| 345 |
up to 50% by specialcasing short strings. |
| 346 |
- further decoding speedups for strings using |
| 347 |
lots of \u escapes. |
| 348 |
- improve utf8 decoding speed for U+80 .. U+7FF. |
| 349 |
|
| 350 |
0.5 Sat Mar 24 20:41:51 CET 2007 |
| 351 |
- added the UTF-16 encoding example hinted at in previous |
| 352 |
versions. |
| 353 |
- minor documentation fixes. |
| 354 |
- fix a bug in and optimise canonicalising fastpath |
| 355 |
(reported by Craig Manley). |
| 356 |
- remove a subtest that breaks with bleadperl (reported |
| 357 |
by Andreas König). |
| 358 |
|
| 359 |
0.31 Sat Mar 24 02:14:34 CET 2007 |
| 360 |
- documentation updates. |
| 361 |
- do some casting to hopefully fix Andreas' problem. |
| 362 |
- nuke bogus json rpc stuff. |
| 363 |
|
| 364 |
0.3 Fri Mar 23 19:33:21 CET 2007 |
| 365 |
- remove spurious PApp::Util reference (John McNamara). |
| 366 |
- adapted lots of tests from other json modules |
| 367 |
(idea by Chris Carline). |
| 368 |
- documented mapping from json to perl and vice versa. |
| 369 |
- improved the documentation by adding more examples. |
| 370 |
- added short escaping forms, reducing the created |
| 371 |
json texts a bit. |
| 372 |
- added shrink flag. |
| 373 |
- when flag methods are called without enable argument |
| 374 |
they will by default enable their flag. |
| 375 |
- considerably improved string encoding speed (at least |
| 376 |
with gcc 4). |
| 377 |
- added a test that covers lots of different characters. |
| 378 |
- clarified some error messages. |
| 379 |
- error messages now use correct character offset |
| 380 |
with F_UTF8. |
| 381 |
- improve the "no bytes" and "no warnings" hacks in |
| 382 |
case the called functions do... stuff. |
| 383 |
- croak when encoding to ascii and an out-of-range |
| 384 |
(non-unicode) codepoint is encountered. |
| 385 |
|
| 386 |
0.2 Fri Mar 23 00:23:34 CET 2007 |
| 387 |
- the "could not sleep without debugging release". |
| 388 |
it should basically work now, with many bugs as |
| 389 |
no production tests have been run yet. |
| 390 |
- added more testcases. |
| 391 |
- the expected shitload of bugfixes. |
| 392 |
- handle utf8 flag correctly in decode. |
| 393 |
- fix segfault in decoder. |
| 394 |
- utf8n_to_uvuni sets retlen to -1, but retlen is an |
| 395 |
unsigned types (argh). |
| 396 |
- fix decoding of utf-8 strings. |
| 397 |
- improved error diagnostics. |
| 398 |
- fix decoding of 'null'. |
| 399 |
- fix parsing of empty array/hashes |
| 400 |
- silence warnings when we prepare the croak message. |
| 401 |
|
| 402 |
0.1 Thu Mar 22 22:13:43 CET 2007 |
| 403 |
- first release, very untested, basically just to claim |
| 404 |
the namespace. |
| 405 |
|
| 406 |
0.01 Thu Mar 22 06:08:12 CET 2007 |
| 407 |
- original version; cloned from Convert-Scalar |
| 408 |
|
