--- JSON-XS/Changes 2007/03/22 16:40:16 1.1 +++ JSON-XS/Changes 2008/03/19 04:09:41 1.98 @@ -1,4 +1,247 @@ Revision history for Perl extension JSON::XS + + - update documentation here and there, add a large section + about utf8/latin1/ascii flags, add a security consideration. + - medium speed enhancements when encoding/decoding non-ascii chars. + - extend and clarify the section on incompatibilities + between YAML and JSON. + - switch to static inline from just inline when using gcc. + - add =encoding utf-8 to the manpage, now that perl 5.10 supports it. + +2.01 Wed Dec 5 11:40:28 CET 2007 + - INCOMPATIBLE API CHANGE: to_json and from_json have been + renamed to encode_json/decode_json for JSON.pm compatibility. + The old functions croak and might be replaced by JSON.pm + comaptible versions in some later release. + +2.0 Tue Dec 4 11:30:46 CET 2007 + - this is supposed to be the first version of JSON::XS + compatible with version 2.0+ of the JSON module. + Using the JSON module as frontend to JSON::XS should be + as fast as using JSON::XS directly, so consider using it + instead. + - added get_* methods for all "simple" options. + - make JSON::XS subclassable. + +1.53 Tue Nov 13 23:58:33 CET 2007 + - minor doc clarifications. + - fixed many doc typos (patch by Thomas L. Shinnick). + +1.52 Mon Oct 15 03:22:06 CEST 2007 + - remove =encoding pod directive again, it confuses too many pod + parsers :/. + +1.51 Sat Oct 13 03:55:56 CEST 2007 + - encode empty arrays/hashes in a compact way when pretty is enabled. + - apparently JSON::XS was used to find some bugs in the + JSON_checker testsuite, so add (the corrected) JSON_checker tests to + the testsuite. + - quite a bit of doc updates/extension. + - require 5.8.2, as this seems to be the first unicode-stable version. + +1.5 Tue Aug 28 04:05:38 CEST 2007 + - add support for tied hashes, based on ideas and testcase by + Marcus Holland-Moritz. + - implemented relaxed parsing mode where some extensions are being + accepted. generation is still JSON-only. + +1.44 Wed Aug 22 01:02:44 CEST 2007 + - very experimental process-emulation support, slowing everything down. + the horribly broken perl threads are still not supported - YMMV. + +1.43 Thu Jul 26 13:26:37 CEST 2007 + - convert big json numbers exclusively consisting of digits to NV + only when there is no loss of precision, otherwise to string. + +1.42 Tue Jul 24 00:51:18 CEST 2007 + - fix a crash caused by not handling missing array elements + (report and testcase by Jay Kuri). + +1.41 Tue Jul 10 18:21:44 CEST 2007 + - fix compilation with NDEBUG (assert side-effect), + affects convert_blessed only. + - fix a bug in decode filters calling ENTER; SAVETMPS; + one time too often. + - catch a typical error in TO_JSON methods. + - antique-ised XS.xs again to work with outdated + C compilers (windows...). + +1.4 Mon Jul 2 10:06:30 CEST 2007 + - add convert_blessed setting. + - encode did not catch all blessed objects, encoding their + contents in most cases. This has been fixed by introducing + the allow_blessed setting. + - added filter_json_object and filter_json_single_key_object + settings that specify a callback to be called when + all/specific json objects are encountered. + - assume that most object keys are simple ascii words and + optimise this case, penalising the general case. This can + speed up decoding by 30% in typical cases and gives + a smaller and faster perl hash. + - implemented simpleminded, optional resource size checking + in decode_json. + - remove objToJson/jsonToObj aliases, as the next version + of JSON will not have them either. + - bit the bullet and converted the very simple json object + into a more complex one. + - work around a bug where perl wrongly claims an integer + is not an integer. + - unbundle JSON::XS::Boolean into own pm file so Storable + and similar modules can resolve the overloading when thawing. + +1.3 Sun Jun 24 01:55:02 CEST 2007 + - make JSON::XS::true and false special overloaded objects + and return those instead of 1 and 0 for those json atoms + (JSON::PP compatibility is NOT achieved yet). + - add JSON::XS::is_bool predicate to test for those special + values. + - add a reference to + http://jpsykes.com/47/practical-csrf-and-json-security. + - removed require 5.8.8 again, it is just not very expert-friendly. + Also try to be more compatible with slightly older versions, + which are not recommended (because they are buggy). + +1.24 Mon Jun 11 05:40:49 CEST 2007 + - added informative section on JSON-as-YAML. + - get rid of some c99-isms again. + - localise dec->cur in decode_str, speeding up + string decoding considerably (>15% on my amd64 + gcc). + - increased SHORT_STRING_LEN to 16kb: stack space is + usually plenty, and this actually saves memory + when !shrinking as short strings will fit perfectly. + +1.23 Wed Jun 6 20:13:06 CEST 2007 + - greatly improved small integer encoding and decoding speed. + - implement a number of µ-optimisations. + - updated benchmarks. + +1.22 Thu May 24 00:07:25 CEST 2007 + - require 5.8.8 explicitly as older perls do not seem to offer + the required macros. + - possibly made it compile on so-called C compilers by microsoft. + +1.21 Wed May 9 18:40:32 CEST 2007 + - character offset reported for trailing garbage was random. + +1.2 Wed May 9 18:35:01 CEST 2007 + - decode did not work with magical scalars (doh!). + - added latin1 flag to produce JSON texts in the latin1 subset + of unicode. + - flag trailing garbage as error. + - new decode_prefix method that returns the number + of characters consumed by a decode. + - max octets/char in perls UTF-X is actually 13, not 11, + as pointed out by Glenn Linderman. + - fixed typoe reported by YAMASHINA Hio. + +1.11 Mon Apr 9 07:05:49 CEST 2007 + - properly 0-terminate sv's returned by encode to help + C libraries that expect that 0 to be there. + - partially "port" JSON from C to microsofts fucking broken + pseudo-C. They should be burned to the ground for pissing + on standards. And I should be stoned for even trying to + support this filthy excuse for a c compiler. + +1.1 Wed Apr 4 01:45:00 CEST 2007 + - clarify documentation (pointed out by Quinn Weaver). + - decode_utf8 sometimes did not correctly flag errors, + leading to segfaults. + - further reduced default nesting depth to 512 due to the test + failure by that anonymous "chris" whose e-mail address seems + to be impossible to get. Tests on other freebsd systems indicate + that this is likely a problem in his/her configuration and not this + module. + - renamed json => JSON in error messages. + - corrected the character offset in some error messages. + +1.01 Sat Mar 31 16:15:40 CEST 2007 + - do not segfault when from_json/decode gets passed + a non-string object (reported by Florian Ragwitz). + This has no effect on normal operation. + +1.0 Thu Mar 29 04:43:34 CEST 2007 + - the long awaited (by me) 1.0 version. + - add \0 (JSON::XS::false) and \1 (JSON::XS::true) mappings to JSON + true and false. + - add some more notes to shrink, as suggested by Alex Efros. + - improve testsuite. + - halve the default nesting depth limit, to hopefully make it + work on Freebsd (unfortunately, the cpan tester did not + send me his report, so I cannot ask about the stack limit on fbsd). + +0.8 Mon Mar 26 00:10:48 CEST 2007 + - fix a memleak when decoding hashes. + - export jsonToBj and objToJson as aliases + to to_json and from_json, to reduce incompatibilities + between JSON/JSON::PC and JSON::XS. (experimental). + - implement a maximum nesting depth for both en- and de-coding. + - added a security considerations sections. + +0.7 Sun Mar 25 01:46:30 CET 2007 + - code cleanup. + - fix a memory overflow bug when indenting. + - pretty-printing now up to 15% faster. + - improve decoding speed of strings by + up to 50% by specialcasing short strings. + - further decoding speedups for strings using + lots of \u escapes. + - improve utf8 decoding speed for U+80 .. U+7FF. + +0.5 Sat Mar 24 20:41:51 CET 2007 + - added the UTF-16 encoding example hinted at in previous + versions. + - minor documentation fixes. + - fix a bug in and optimise canonicalising fastpath + (reported by Craig Manley). + - remove a subtest that breaks with bleadperl (reported + by Andreas König). + +0.31 Sat Mar 24 02:14:34 CET 2007 + - documentation updates. + - do some casting to hopefully fix Andreas' problem. + - nuke bogus json rpc stuff. + +0.3 Fri Mar 23 19:33:21 CET 2007 + - remove spurious PApp::Util reference (John McNamara). + - adapted lots of tests from other json modules + (idea by Chris Carline). + - documented mapping from json to perl and vice versa. + - improved the documentation by adding more examples. + - added short escaping forms, reducing the created + json texts a bit. + - added shrink flag. + - when flag methods are called without enable argument + they will by default enable their flag. + - considerably improved string encoding speed (at least + with gcc 4). + - added a test that covers lots of different characters. + - clarified some error messages. + - error messages now use correct character offset + with F_UTF8. + - improve the "no bytes" and "no warnings" hacks in + case the called functions do... stuff. + - croak when encoding to ascii and an out-of-range + (non-unicode) codepoint is encountered. + +0.2 Fri Mar 23 00:23:34 CET 2007 + - the "could not sleep without debuggign release". + it should basically work now, with many bugs as + no production tests have been run yet. + - added more testcases. + - the expected shitload of bugfixes. + - handle utf8 flag correctly in decode. + - fix segfault in decoder. + - utf8n_to_uvuni sets retlen to -1, but retlen is an + unsigned types (argh). + - fix decoding of utf-8 strings. + - improved error diagnostics. + - fix decoding of 'null'. + - fix parsing of empty array/hashes + - silence warnings when we prepare the croak message. + +0.1 Thu Mar 22 22:13:43 CET 2007 + - first release, very untested, basically just to claim + the namespace. 0.01 Thu Mar 22 06:08:12 CET 2007 - original version; cloned from Convert-Scalar