JsonRazor 1.3.0

1.3.0:

Changes to existing code:

I don't like to break compatibility but it somehow had to be done. So:

• IToken.LoadTokens() behaviour was changed, since it was terribly stupid. It would stream tokens only once, when loaded. Now it streams them no matter in what loaded-state IToken is. Also all arguments were removed.
• IToken.QueryTokens() still maintains only-one-enumeration behaviour (at least now that is documented), but optimizeLoad argument was removed. This is sole purpose of this method. Now, since LoadTokens works, it can replace it in other scenarios.
• Assembly versioning abandons this retarded, 4-number notation. Now, 3-number notation may prevail.

I was also gonna add default values to Serializer's methods ModelMembers args, but value Both is poorly choosen; changing it to Property would be inconsistent in the API, so i ended up givin' up. I will refrain from changing defaults, as it way have lots of unintended side effects.

Fixes:

• JsonArray with only simple values could be in 'dirty' state even after being parsed.
• JsonObject when parsed would throw exception on property names of 1 char.
• JsonStream.StreamConverted() would throw on List<T>.
• IToken.QueryTokens() would incorrectly manage loading when optimize load was enabled. Also QueryResult.Fail was handled incorrectly.
• IToken.LoadTokens (and Count) would break state of object/array.
• Quote-writing policy would be inconsistent. Now null, true and false serialize without quotes. Everything else with them.
• There was something else but I totally forgot what it was, nvm it's fixed now.

New features:

• Serialization and deserialization support for Nullable<T> - when in null state, it serializes to null, otherwise to content T of nullable.
• Support for nulls in arrays! Previously when array was serialized with nulls, they would have been removed in deserialization. Now this behaviour stays only with standard JsonToken parsing, but when deserializing such an array, nulls will stay at their original index. This is sadly impossible for base parsing, since there's no type info.
• JsonToken now exposes three new constants. This is really important to mention (really).

Performance:

• Sadly, no noticeable change, probably. Some old code was dumped, so assembly size went down around 1KB. IToken.Count was optimised a bit.

Docs:

Some of documentation headers were edited (in placed when they obviously stated some gibberish) and new were added where appriopriate, altho there're still blanks.

New year, new better version, etc etc. I'm really sorry that it took that long for these changes, i've just been busy and doing other important stuff. Now things will change a bit (I hope). Next version release will most likely bring better IToken query method, maybe with overloads for de/serializing that take Type, instead of being generic.