Molten icon indicating copy to clipboard operation
Molten copied to clipboard

[WIP] Molten - Style-preserving TOML parser.

Molten

Build Status Windows build status

[WIP] Molten - Style-preserving TOML parser

Molten is a WIP lossless TOML parser that preserves all comments, indentations, whitespace and internal element ordering, and makes all of these fully editable via an easy API. It is written with the intent of replacing the current TOML parser used in cargo-edit, and, eventually, adding that functionality to Cargo itself.

Goals

  • Speed: Molten is a one-pass parser which avoids allocation.
  • Unopinionated: Molten respects the way you wrote your document, to the letter.
  • Fully addressable: All TOML elements can be edited, created, or deleted via the API.
  • Strong API: The API does not let you create an invalid TOML file.

Non-Goals

  • Error recovery: Molten does not try to correct recoverable errors.
  • Serde support: See toml-rs for this.

License

This project is licensed under either of

  • Apache License, Version 2.0, (LICENSE-APACHE)
  • MIT license (LICENSE-MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Molten by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.