[ViewVC] Contents of: cvs/JSON-XS/Changes

Revision history for Perl extension JSON::XS

2.222 Sat Jul 19 06:15:34 CEST 2008
        - you work around one -DDEBUGGING assertion bug in perl 5.10
          just to hit the next one. work around this one, too.

2.22 Tue Jul 15 13:26:51 CEST 2008
        - allow higher nesting levels in incremental parser.
        - error out earlier in some cases in the incremental parser
          (as suggested by Yuval Kogman).
        - improve incr-parser test (Yuval Kogman).

2.21 Tue Jun  3 08:43:23 CEST 2008
        - (hopefully) work around a perl 5.10 bug with -DDEBUGGING.
        - remove the experimental status of the incremental parser interface.
        - move =encoding around again, to avoid bugs with search.cpan.org.
          when can we finally have utf-8 in pod???
        - add ->incr_reset method.

2.2  Wed Apr 16 20:37:25 CEST 2008
        - lifted the log2 rounding restriction of max_depth and max_size.
        - make booleans mutable by creating a copy instead of handing out
          the same scalar (reported by pasha sadri).
        - added support for incremental json parsing (still EXPERIMENTAL).
        - implemented and added a json_xs command line utility that can convert
          from/to a number of serialisation formats - tell me if you need more.
        - implement allow_unknown/get_allow_unknown methods.
        - fixed documentation of max_depth w.r.t. higher and equal.
        - moved down =encoding directive a bit, too much breaks if it's the first
          pod directive :/.
        - removed documentation section on other modules, it became somewhat
          outdated and is nowadays mostly of historical interest.

2.1  Wed Mar 19 23:23:18 CET 2008
        - update documentation here and there: add a large section
          about utf8/latin1/ascii flags, add a security consideration
          and extend and clarify the JSON and YAML section.
        - medium speed enhancements when encoding/decoding non-ascii chars.
        - minor speedup in number encoding case.
        - 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.
        - fix some issues with UV to JSON conversion of unknown impact.
        - published the yahoo locals search result used in benchmarks as the
          original url changes so comparison is impossible.

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 debugging 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

Revision:	1.117
Committed:	Sat Jul 19 04:21:32 2008 UTC (15 years, 10 months ago) by root
Branch:	MAIN
CVS Tags:	rel-2_222
Changes since 1.116:	+4 -0 lines
Log Message:	2.222
#	Content
1	Revision history for Perl extension JSON::XS
2
3	2.222 Sat Jul 19 06:15:34 CEST 2008
4	- you work around one -DDEBUGGING assertion bug in perl 5.10
5	just to hit the next one. work around this one, too.
6
7	2.22 Tue Jul 15 13:26:51 CEST 2008
8	- allow higher nesting levels in incremental parser.
9	- error out earlier in some cases in the incremental parser
10	(as suggested by Yuval Kogman).
11	- improve incr-parser test (Yuval Kogman).
12
13	2.21 Tue Jun 3 08:43:23 CEST 2008
14	- (hopefully) work around a perl 5.10 bug with -DDEBUGGING.
15	- remove the experimental status of the incremental parser interface.
16	- move =encoding around again, to avoid bugs with search.cpan.org.
17	when can we finally have utf-8 in pod???
18	- add ->incr_reset method.
19
20	2.2 Wed Apr 16 20:37:25 CEST 2008
21	- lifted the log2 rounding restriction of max_depth and max_size.
22	- make booleans mutable by creating a copy instead of handing out
23	the same scalar (reported by pasha sadri).
24	- added support for incremental json parsing (still EXPERIMENTAL).
25	- implemented and added a json_xs command line utility that can convert
26	from/to a number of serialisation formats - tell me if you need more.
27	- implement allow_unknown/get_allow_unknown methods.
28	- fixed documentation of max_depth w.r.t. higher and equal.
29	- moved down =encoding directive a bit, too much breaks if it's the first
30	pod directive :/.
31	- removed documentation section on other modules, it became somewhat
32	outdated and is nowadays mostly of historical interest.
33
34	2.1 Wed Mar 19 23:23:18 CET 2008
35	- update documentation here and there: add a large section
36	about utf8/latin1/ascii flags, add a security consideration
37	and extend and clarify the JSON and YAML section.
38	- medium speed enhancements when encoding/decoding non-ascii chars.
39	- minor speedup in number encoding case.
40	- extend and clarify the section on incompatibilities
41	between YAML and JSON.
42	- switch to static inline from just inline when using gcc.
43	- add =encoding utf-8 to the manpage, now that perl 5.10 supports it.
44	- fix some issues with UV to JSON conversion of unknown impact.
45	- published the yahoo locals search result used in benchmarks as the
46	original url changes so comparison is impossible.
47
48	2.01 Wed Dec 5 11:40:28 CET 2007
49	- INCOMPATIBLE API CHANGE: to_json and from_json have been
50	renamed to encode_json/decode_json for JSON.pm compatibility.
51	The old functions croak and might be replaced by JSON.pm
52	comaptible versions in some later release.
53
54	2.0 Tue Dec 4 11:30:46 CET 2007
55	- this is supposed to be the first version of JSON::XS
56	compatible with version 2.0+ of the JSON module.
57	Using the JSON module as frontend to JSON::XS should be
58	as fast as using JSON::XS directly, so consider using it
59	instead.
60	- added get_* methods for all "simple" options.
61	- make JSON::XS subclassable.
62
63	1.53 Tue Nov 13 23:58:33 CET 2007
64	- minor doc clarifications.
65	- fixed many doc typos (patch by Thomas L. Shinnick).
66
67	1.52 Mon Oct 15 03:22:06 CEST 2007
68	- remove =encoding pod directive again, it confuses too many pod
69	parsers :/.
70
71	1.51 Sat Oct 13 03:55:56 CEST 2007
72	- encode empty arrays/hashes in a compact way when pretty is enabled.
73	- apparently JSON::XS was used to find some bugs in the
74	JSON_checker testsuite, so add (the corrected) JSON_checker tests to
75	the testsuite.
76	- quite a bit of doc updates/extension.
77	- require 5.8.2, as this seems to be the first unicode-stable version.
78
79	1.5 Tue Aug 28 04:05:38 CEST 2007
80	- add support for tied hashes, based on ideas and testcase by
81	Marcus Holland-Moritz.
82	- implemented relaxed parsing mode where some extensions are being
83	accepted. generation is still JSON-only.
84
85	1.44 Wed Aug 22 01:02:44 CEST 2007
86	- very experimental process-emulation support, slowing everything down.
87	the horribly broken perl threads are still not supported - YMMV.
88
89	1.43 Thu Jul 26 13:26:37 CEST 2007
90	- convert big json numbers exclusively consisting of digits to NV
91	only when there is no loss of precision, otherwise to string.
92
93	1.42 Tue Jul 24 00:51:18 CEST 2007
94	- fix a crash caused by not handling missing array elements
95	(report and testcase by Jay Kuri).
96
97	1.41 Tue Jul 10 18:21:44 CEST 2007
98	- fix compilation with NDEBUG (assert side-effect),
99	affects convert_blessed only.
100	- fix a bug in decode filters calling ENTER; SAVETMPS;
101	one time too often.
102	- catch a typical error in TO_JSON methods.
103	- antique-ised XS.xs again to work with outdated
104	C compilers (windows...).
105
106	1.4 Mon Jul 2 10:06:30 CEST 2007
107	- add convert_blessed setting.
108	- encode did not catch all blessed objects, encoding their
109	contents in most cases. This has been fixed by introducing
110	the allow_blessed setting.
111	- added filter_json_object and filter_json_single_key_object
112	settings that specify a callback to be called when
113	all/specific json objects are encountered.
114	- assume that most object keys are simple ascii words and
115	optimise this case, penalising the general case. This can
116	speed up decoding by 30% in typical cases and gives
117	a smaller and faster perl hash.
118	- implemented simpleminded, optional resource size checking
119	in decode_json.
120	- remove objToJson/jsonToObj aliases, as the next version
121	of JSON will not have them either.
122	- bit the bullet and converted the very simple json object
123	into a more complex one.
124	- work around a bug where perl wrongly claims an integer
125	is not an integer.
126	- unbundle JSON::XS::Boolean into own pm file so Storable
127	and similar modules can resolve the overloading when thawing.
128
129	1.3 Sun Jun 24 01:55:02 CEST 2007
130	- make JSON::XS::true and false special overloaded objects
131	and return those instead of 1 and 0 for those json atoms
132	(JSON::PP compatibility is NOT achieved yet).
133	- add JSON::XS::is_bool predicate to test for those special
134	values.
135	- add a reference to
136	http://jpsykes.com/47/practical-csrf-and-json-security.
137	- removed require 5.8.8 again, it is just not very expert-friendly.
138	Also try to be more compatible with slightly older versions,
139	which are not recommended (because they are buggy).
140
141	1.24 Mon Jun 11 05:40:49 CEST 2007
142	- added informative section on JSON-as-YAML.
143	- get rid of some c99-isms again.
144	- localise dec->cur in decode_str, speeding up
145	string decoding considerably (>15% on my amd64 + gcc).
146	- increased SHORT_STRING_LEN to 16kb: stack space is
147	usually plenty, and this actually saves memory
148	when !shrinking as short strings will fit perfectly.
149
150	1.23 Wed Jun 6 20:13:06 CEST 2007
151	- greatly improved small integer encoding and decoding speed.
152	- implement a number of µ-optimisations.
153	- updated benchmarks.
154
155	1.22 Thu May 24 00:07:25 CEST 2007
156	- require 5.8.8 explicitly as older perls do not seem to offer
157	the required macros.
158	- possibly made it compile on so-called C compilers by microsoft.
159
160	1.21 Wed May 9 18:40:32 CEST 2007
161	- character offset reported for trailing garbage was random.
162
163	1.2 Wed May 9 18:35:01 CEST 2007
164	- decode did not work with magical scalars (doh!).
165	- added latin1 flag to produce JSON texts in the latin1 subset
166	of unicode.
167	- flag trailing garbage as error.
168	- new decode_prefix method that returns the number
169	of characters consumed by a decode.
170	- max octets/char in perls UTF-X is actually 13, not 11,
171	as pointed out by Glenn Linderman.
172	- fixed typoe reported by YAMASHINA Hio.
173
174	1.11 Mon Apr 9 07:05:49 CEST 2007
175	- properly 0-terminate sv's returned by encode to help
176	C libraries that expect that 0 to be there.
177	- partially "port" JSON from C to microsofts fucking broken
178	pseudo-C. They should be burned to the ground for pissing
179	on standards. And I should be stoned for even trying to
180	support this filthy excuse for a c compiler.
181
182	1.1 Wed Apr 4 01:45:00 CEST 2007
183	- clarify documentation (pointed out by Quinn Weaver).
184	- decode_utf8 sometimes did not correctly flag errors,
185	leading to segfaults.
186	- further reduced default nesting depth to 512 due to the test
187	failure by that anonymous "chris" whose e-mail address seems
188	to be impossible to get. Tests on other freebsd systems indicate
189	that this is likely a problem in his/her configuration and not this
190	module.
191	- renamed json => JSON in error messages.
192	- corrected the character offset in some error messages.
193
194	1.01 Sat Mar 31 16:15:40 CEST 2007
195	- do not segfault when from_json/decode gets passed
196	a non-string object (reported by Florian Ragwitz).
197	This has no effect on normal operation.
198
199	1.0 Thu Mar 29 04:43:34 CEST 2007
200	- the long awaited (by me) 1.0 version.
201	- add \0 (JSON::XS::false) and \1 (JSON::XS::true) mappings to JSON
202	true and false.
203	- add some more notes to shrink, as suggested by Alex Efros.
204	- improve testsuite.
205	- halve the default nesting depth limit, to hopefully make it
206	work on Freebsd (unfortunately, the cpan tester did not
207	send me his report, so I cannot ask about the stack limit on fbsd).
208
209	0.8 Mon Mar 26 00:10:48 CEST 2007
210	- fix a memleak when decoding hashes.
211	- export jsonToBj and objToJson as aliases
212	to to_json and from_json, to reduce incompatibilities
213	between JSON/JSON::PC and JSON::XS. (experimental).
214	- implement a maximum nesting depth for both en- and de-coding.
215	- added a security considerations sections.
216
217	0.7 Sun Mar 25 01:46:30 CET 2007
218	- code cleanup.
219	- fix a memory overflow bug when indenting.
220	- pretty-printing now up to 15% faster.
221	- improve decoding speed of strings by
222	up to 50% by specialcasing short strings.
223	- further decoding speedups for strings using
224	lots of \u escapes.
225	- improve utf8 decoding speed for U+80 .. U+7FF.
226
227	0.5 Sat Mar 24 20:41:51 CET 2007
228	- added the UTF-16 encoding example hinted at in previous
229	versions.
230	- minor documentation fixes.
231	- fix a bug in and optimise canonicalising fastpath
232	(reported by Craig Manley).
233	- remove a subtest that breaks with bleadperl (reported
234	by Andreas König).
235
236	0.31 Sat Mar 24 02:14:34 CET 2007
237	- documentation updates.
238	- do some casting to hopefully fix Andreas' problem.
239	- nuke bogus json rpc stuff.
240
241	0.3 Fri Mar 23 19:33:21 CET 2007
242	- remove spurious PApp::Util reference (John McNamara).
243	- adapted lots of tests from other json modules
244	(idea by Chris Carline).
245	- documented mapping from json to perl and vice versa.
246	- improved the documentation by adding more examples.
247	- added short escaping forms, reducing the created
248	json texts a bit.
249	- added shrink flag.
250	- when flag methods are called without enable argument
251	they will by default enable their flag.
252	- considerably improved string encoding speed (at least
253	with gcc 4).
254	- added a test that covers lots of different characters.
255	- clarified some error messages.
256	- error messages now use correct character offset
257	with F_UTF8.
258	- improve the "no bytes" and "no warnings" hacks in
259	case the called functions do... stuff.
260	- croak when encoding to ascii and an out-of-range
261	(non-unicode) codepoint is encountered.
262
263	0.2 Fri Mar 23 00:23:34 CET 2007
264	- the "could not sleep without debugging release".
265	it should basically work now, with many bugs as
266	no production tests have been run yet.
267	- added more testcases.
268	- the expected shitload of bugfixes.
269	- handle utf8 flag correctly in decode.
270	- fix segfault in decoder.
271	- utf8n_to_uvuni sets retlen to -1, but retlen is an
272	unsigned types (argh).
273	- fix decoding of utf-8 strings.
274	- improved error diagnostics.
275	- fix decoding of 'null'.
276	- fix parsing of empty array/hashes
277	- silence warnings when we prepare the croak message.
278
279	0.1 Thu Mar 22 22:13:43 CET 2007
280	- first release, very untested, basically just to claim
281	the namespace.
282
283	0.01 Thu Mar 22 06:08:12 CET 2007
284	- original version; cloned from Convert-Scalar
285