All notable changes to this project will be documented in this file.
- Exception messages for ConfigErrors() and PostLoad() now include the Dec name.
- Reading recorder files with objects with a missing Converter could result in an unhandled exception.
- Cloning objects with children with missing Converters could result in an unhandled exception.
- SetupDependsOnAttribute, which allows you to define ConfigErrors/PostLoad dependencies between Dec classes. This is a prototype and will probably change in the future.
- A general-purpose stable dag evaluator, which is exposed mostly because it's often convenient.
- Recorder.InputContext, which gives contextual diagnostic information useful for reporting Recorder issues.
- Debug-log functions to Context and Recorder, making it easier to report issues.
- The ability to reference class objects contained within Decs. Right now the path generation works only for members, lists, arrays, and values of dictionaries that are input with non-
likeys; this will probably be improved later. - Added Database.RegisterLookup() to manually add global lookup references. No guarantee this interface keeps existing in this form. But it's there, and one way or another I'll continue to support similar functionality.
- Dec doesn't guarantee what order Decs are initialized in, and it still doesn't . . . but it was pretty consistent, and boy, did the above change seriously scramble the order they tend to get initialized in! If you have load dependencies, even if you don't realize that you do, don't be surprised if stuff breaks. Future versions of Dec might include a Dev Mode that intentionally randomizes load order (within the bounds of dependencies) to help catch these issues.
- PostLoad() no longer runs after all ConfigErrors(), but only after its own ConfigError(). This was never guaranteed either but you might have been relying on it. This entire system really needs a revamp. Sorry. Come pester me on Discord if you have a strong opinion on how it should work.
- Rename Dec.InputContext to Dec.Context, since it will now also apply to things that aren't input. Sorry about this one too - it'll take some renaming.
- Split CloneWithAssignmentAttribute into CloneStructPiecewiseAttribute and CloneClassAsSharedRef, because the description of CloneWithAssignmentAttribute was just plain confusing. I don't think anyone's using Clone besides me. If you are, come talk to me on Discord so I can make sure it's doing what you need.
- Error messages regarding Shared/Unshared conflicts now report the actual location of those conflicts. This is a first revision; please give feedback.
- Clone performance on Dictionaries with asymmetrical clone-as-valuelike parameters.
- General Clone performance regarding asymmetrical clone-as-valuelike parameters.
- The new Path system is probably a performance and memory hit. For now, I'm just living with it; if it's a problem for you, please report it so I can work on it with actual numbers.
- Several Clone pathways that would incorrectly Record objects with a TreatAsValuelike converter.
- Proper support for Nullable.
- Bespoke_KeyTypeDict() parameter for Recorder which allows dictionary key fields to be implicitly treated as
classtags for their values. This will be removed once I've figured out a more general way to support this.
- Type parse cache bug that could cause non-arrays to be incorrectly parsed as arrays.
- Cloning an object with a factory that depends on a non-shared recorded object can, if the stack depth is too deep, result in the non-shared recorded object not yet being ready.
- Decs that are also IRecordable cause errors when referenced in other Decs.
- Security issue: XML documents could cause arbitrary HTTP requests.
- New Recorder.WriteSimple()/ReadSimple() modes that produce much simpler XML, at the cost of no references.
- Type parsing now accepts curly braces in place of generic angle braces, in order to make XML easier to write.
- Decs can now include
classtags, if you need to specify a type that doesn't work as an XML node name.
- Bespoke.IgnoreRecordDuringParserAttribute has been removed in favor of IConditionalRecorder. If you want a version that supports both for ease of porting, check out v0.6.0.
- Documentation regarding Recorder load order.
- RecorderEnumerator: List.Enumerator would not properly serialize if the enumerator was empty.
- RecorderEnumerator: Recordable Closures did not serialize properly if they were created in a generic function.
- Added a small test.
- Added IUserSettings, which is passed throughout the Dec system and can be used to change the behavior of Parser and Recorder.
- Added IConditionalRecorder, which can be used to conditionally record objects.
- CloneWithAssignmentAttribute can now be used to specify that objects can be cloned with basic assignment, speeding up array cloning considerably.
- IPostCloneOriginal/IPostCloneNew interfaces that can be used to perform post-clone operations on objects.
- Converter.TreatAsValuelike() which can be used to treat any type like a valuelike. See documentation for details.
- Ignoring provided fields in a Recorder is now considered a warning. Use the new recorder.Ignore() method to explicitly suppress this warning for a field.
- Extra RecorderEnumerator's RecordableClosures attribute now needs to be applied to the class instead of the function (but you weren't using this yet, right?)
- Bespoke.IgnoreRecordDuringParserAttribute has been obsoleted in favor of IConditionalRecorder. It remains in the codebase for now but will be removed in the future.
- Major revamp of Recorder.Clone functionality to dramatically improve performance (approx 200x in one real-life test case.)
- Recorder no longer depends on Parser.Finish() to find Converters.
- Better support for parallel operations in multiple threads (but not Parser.)
- Fleshed out an error message.
- Inconsistent behavior in Extra RecorderEnumerator Delegate deserialization. (Hopefully.)
- Improper storage of
thiswith Extra RecorderEnumerator iterators. - Unexpected shrapnel caused by the above two fixes.
- Improved consistency of a few tests.
- Proper support for multidimensional arrays.
- Changed default culture from
en-UStoInvariantCulture. I don't think this should have any effects given the manual string parsing for Infinity, but I may be missing something; report problems, please.
- Error messages for database queries interacting with AbstractAttribute.
- Error message for inappropriately-timed StaticReferences initialization.
- More consistent usage of the Dec.Config culture.
- Support case-insensitive nan/infinity float/double parsing.
- Added proper testing for AbstractAttribute.
- Add a self-reference test that might be redundant.
- Now properly serializes NaN-boxed floats and doubles without loss of information.
- Error messages when passing null or empty strings to Parser.
- Project configuration revamp to follow established standards for framework choice.
- Better error reporting for Converter read exceptions.
- Tagged an internal-error message as an internal error.
- Error message when attempting to use a class that doesn't inherit from Dec as a Dec.
- A lot of warnings.
- TypeSerialization.Overloaded test inconsistencies.
- Despite the length of this changelog, this is mostly minor bugfixes and documentation. The "big feature" is an Extra package that I do not recommend using in production until it has a lot more work.
- Converters now support generic arguments; they must be converting a generic with the same number of arguments in the same order. This might get changed later.
- Recorder.Clone() function to duplicate objects.
- Added the first extra package, recorder_enumerator, capable of serializing and deserializing both Linq and user-defined enumerators mid-iteration.
- Added support for Stack and Queue.
- Type parsing system no longer supports + separator for nested types, but it never wrote these in the first place, so this shouldn't be a big problem. If you have to edit some xml files, sorry 'bout that, this was an oversight.
- Improved error message when trying to initialize a composite with a string.
- First-time Parser startup speed now faster.
- Type parsing system now properly supports generic nested types of generics.
- User-types now don't include anything under the Dec namespace.
- Type caching system no longer results in silent errors.
- Missing Mode property on Recorder.Parameters.
boolnot recognized as a primitive type.
- Made test harness more durable regarding errors happening during parsing.
- Fixed a test that was accidentally testing the wrong thing.
- Detect internal errors and report them as true test failures, even if a failure was expected.
- Added an integration-unified test for the case where people are just copypasting source files into their project.
- Improved testing of locale issues.
- Reduced compiler warnings in test suite.
- ParserModular, a more complicated parser that supports game mods.
- A large number of new merge modes intended for game modding.
- Minor changes to Parser API to cleanly support more file types.
- Picked a more modern and less awkwardly stifling visual style.
- Minor errors in several error messages.
- Comment typos in unit tests.
- Added internal validation checks.
- Better coverage in various areas.
- Recorder no longer shares class references by default. The new
.Shared()recorder decorator can be used to allow this, although it will error on non-null defaults. - Converter has been split into ConverterString, ConverterRecord, and ConverterFactory.
- RecordAsThis() does not (and currently cannot) work on a polymorphic object; document this and explicitly report it as an error.
- Recorder now defaults to not doing pretty-print.
- Failed ref instantiations can later cause unhandled exceptions.
- Recorder breaks when trying to deal with multiply referenced Array objects.
- Various problems with both Visual Studio compatibility and VS Code compatibility.
- Fixed a variety of obscure errors with shared objects.
- Fixed typos.
- Suppressed index pages for things that aren't really meant to be used.
- Cleaned up example of InputContext.
- Better diagnostic output on missing expected errors.
- Added more thorough tests for sharing.
- Added
Bespoke.IgnoreRecordDuringParserAttribute, which provides special-purpose functionality that will be rolled into an eventual Converter redesign. - Added system-wide CultureInfo support so your games stop breaking in France.
- Better text quoting among many error messages.
- Dec.ToString() now returns type data as well.
- Better error message if attempting to Record a never-registered Dec.
- Better error messages and recovery on errors with
keyandvalueelements in - Dictionary lists.
- Better error message for capitalization in
- tags.
- Parser.LoadDirectory's prefix filtering breaks if given a directory that includes
.or... - RecordAsThis documentation refers to code that is no longer an example.
- Fixed broken relative links.
- Fixed commandline parameter that docfx originally misspelled and finally dropped support for.
- Added tests for a few edge cases (none of which were actually broken, as it turned out.)
- Recording a referenced object that would otherwise need a class tag results in an invalid (but still readable) file.
- Errors when multiple Decs inherit from a Dec with attributes on its members.
- Documentation crosslink error.
- Better error message when failing to find a Dec.
- Better error messages when failing to load StaticReferences.
- Better error message when parsing a Dec without a decName.
- Private constructors are now considered valid to use.
- Fix incorrect tl;dr instructions.
- Improve tl;dr instructions.
- Connect the Inheritance documentation to the Merge Mode documentation.
- Rewrite Index documentation.
- Added clarity regarding the interaction between NonSerialized and Recorder.
- Parser.LoadDirectory no longer loads files or directories with . prefixes.
- Added a
modeattribute that lets you specify how things are updated through inheritance.
- Internal parser error when encountering refs in Parser XML.
- Proper support for fields with abstract Dec types.
- Slight improvement to error handling behavior when dealing with a ref tag in Parser input.
- Various small error message improvements.
- Minor test cleanup and augmentation.
- Improved code coverage.
- Added an optional factory callback for Recorder functionality, allowing contextual default options for deserialization.
- Added native Tuple and ValueTuple support.
- Various small documentation improvements and error message improvements.
- Removed the Null writer, which was intended for benchmarking and testing but which was a giant pain and frankly not worth the effort.
- Fix several test bugs that could generate false passes (but weren't.)
- Passing derived classes to Recorder.Write() resulted in the wrong type when deserialized.
- Misleading error messages when attempting to Record an unsupported derived class.
- Converter detection fails if applied to an unsupported base class with a supported derived class.
- Added Recorder.RecordAsThis(), which allows objects to turn over their entire node to a child object.
- Incorrect error message on duplicate decs.
- 10-20% performance improvement for Recorder serialization.
- Removed user-facing XML exposure, including Converter.ToXml, Converter.FromXml, and Recorder.Xml. This functionality wasn't being used by anyone I could find, was reducing performance, and was seriously complicating development. There is currently no replacement planned.
- Add small tests.
- Implemented HashSet support in both Dec and Record.
- Parser.AddDirectory was not reading recursively.
- structs could not be created via constructor (which happens if you have a List<> of them.)
- A Converter returning an incompatible type would result in a null field even if a valid default existed.
- Many things did not serialize properly if stored in
objectfields.
- Filtered out more non-user assemblies for a minor startup performance gain.
- Parser.AddDirectory is now recursive.
- StaticReferences will no longer work if your project is named "dec" or "netstandard".
- Various small documentation improvements and error message improvements.
- Significant improvements to Validation testing on containers.
- Significant improvements to Dec testing on containers.
- Added lots of small tests.
- Initial release.
The format is based on Keep a Changelog.
This project does not currently adhere to Semantic Versioning.