Skip to content

Releases: omonien/DX.TOML

v1.0.1 - UTF-8 BOM Handling Fix

Choose a tag to compare

@omonien omonien released this 15 Dec 11:39

This release fixes a critical bug with UTF-8 BOM handling and adds comprehensive UTF-8 encoding documentation.

🐛 Fixed

UTF-8 BOM Handling (#1)

  • SaveToFile() now writes UTF-8 without BOM to avoid parser errors
  • FromFile() now correctly handles files with UTF-8 BOM by skipping it
  • FromFile() validates encoding and rejects non-UTF-8 BOMs (UTF-16, UTF-32) with clear error messages
  • Added regression test TestSaveAndLoadFile to ensure save/load roundtrip works correctly

📚 Added

UTF-8 Encoding Documentation

  • Added comprehensive UTF-8 encoding section to README
  • Documented TOML 1.0 specification requirement (UTF-8 mandatory)
  • Explained BOM handling (optional but supported)
  • Provided Delphi-specific guidance for reading TOML files with correct encoding
  • Added examples showing correct vs incorrect file reading patterns

🔧 Changed

  • Renamed .github/README.md to .github/GITHUB_FILES.md to prevent GitHub from displaying it as repository README

✅ Testing

  • All 43 unit tests pass
  • 556/556 toml-test suite tests pass (100% TOML 1.0 compliance maintained)

📖 Full Changelog

See CHANGELOG.md for complete details.