3.7.0: NightConfig rejuvenated ✨

[TheElectronWill]

Major changes

• FileWatcher now comes with out-of-the-box debouncing, which improves the performance of autoreloading and autosaving configurations ⚡, see Optimize the file watcher #148
• FileConfig instances are now actually thread-safe and work better with autoreload, which should prevent most of the corruption issues 🛡️, see Improves thread-safety and ensures that FileConfigs reload properly #152
• A new Serialization/Deserialization framework is available in the serde package 🚀, see Serialization/deserialization revamped 🚀  #163.
  Unlike the old ObjectConverter, the new ObjectSerializer and ObjectDeserializer are modular and extensible: you can register your own serializers and deserializers. Deserializers (config -> object) are chosen based on the generic type of the field to set and the type of the config value to deserialize. This allows for fine-grained deserialization. The old ObjectConverter still works but is now deprecated. The goal is to remove the old conversion package in version 4.0.0.

NightConfig 3.7.0 is backward-compatible with previous releases, but I encourage you to upgrade to 3.7.0 in order to benefit from its many improvements.

Enhancements

• Allow multiple spec conditions to be checked by @vaperion in Allow multiple spec conditions to be checked #151 (Note: this fix applies to the deprecated conversion package; the new serde package supports multiple @SerdeAssert conditions out of the box)
• Support UTF-16 and UTF-8 BOM by @TheElectronWill in 68502b9
• In ConfigSpec and in the new serde Deserializer, automatically apply some "risky" conversions (e.g. long -> int) when it is not lossy, close ConfigSpec defineInRange doesn't play nicely with Long values #119
• Allow custom Config storage in ConfigSpec, by @PaintNinja in Allow custom Config storage in ConfigSpec #168

Bug fixes

• toml: Fix squeezed Files by @Stein-N in Fix squeezed Toml Files #154
• toml: Align List ending when in a "group" by @Stein-N in Align List ending when in a "group" #160
• toml: Allow header comments by @Stein-N in toml: allow header comments #162
• json: Disallow trailing data (configurable) by @TheElectronWill, close json files can have arbitrary data on the end of them #167
• Multiple bugs have been fixed in ObjectConverter by @TheElectronWill in Serialization/deserialization revamped 🚀  #163

New Contributors

• @vaperion made their first contribution in Allow multiple spec conditions to be checked #151
• @Stein-N made their first contribution in Fix squeezed Toml Files #154
• @PaintNinja made their first contribution in Allow custom Config storage in ConfigSpec #168

Thank you everyone!

Full Changelog: v3.6.7...v3.7.0

---

This discussion was created from the release 3.7.0: NightConfig rejuvenated ✨.