saphyr-serde/saphyr/CHANGELOG.md

Changelog

Upcoming

Breaking Changes:

• Move load_from_* methods out of the YamlLoader. Now, YamlLoader gained a generic parameter. Moving those functions out of it spares having to manually specify the generic in YamlLoader::<Yaml>::load_from_str. Manipulating the YamlLoader directly was not common.
• Make LoadError Clone by storing an Arc<std::io::Error> instead of the error directly.

Features:

• (#19) Yaml now implements IndexMut<usize> and IndexMut<&'a str>. These functions may not return a mutable reference to a BAD_VALUE. Instead, index_mut() will panic if either:

  • The index is out of range, as per IndexMut's requirements
  • The inner Yaml variant doesn't match Yaml::Array for usize or Yaml::Hash for &'a str

• Use cargo features

  This allows for more fine-grained control over MSRV and to completely remove debug code from the library when it is consumed.

  The encoding feature, governing the YamlDecoder, has been enabled by default. Users of @davvid's fork of yaml-rust or of yaml-rust2 might already use this. Users of the original yaml-rust crate may freely disable this feature (cargo <...> --no-default-features) and lower MSRV to 1.65.0.

• Load with metadata

  The YamlLoader now supports adding metadata alongside the nodes. For now, the only one supported is the Marker, pointing to the position in the input stream of the start of the node.

  This feature is extensible and should allow (later) to add comments.

Fixes:

• 1fc4692: Fix trailing newlines when emitting multiline strings.

v0.8.0

Breaking Changes:

• The encoding library has been replaced with encoding_rs. If you use the trap of YamlDecoder, this change will make your code not compile. An additional enum YamlDecoderTrap has been added to abstract the underlying library and avoid breaking changes in the future. This additionally lifts the encoding dependency on your project if you were using that feature.
  • The signature of the function for YamlDecoderTrap::Call has changed:
  • The encoding::types::DecoderTrap has been replaced with YamlDecoderTrap.

    // Before, with `encoding::types::DecoderTrap::Call`
    fn(_: &mut encoding::RawDecoder, _: &[u8], _: &mut encoding::StringWriter) -> bool;
    // Now, with `YamlDecoderTrap::Call`
    fn(_: u8, _: u8, _: &[u8], _: &mut String) -> ControlFlow<Cow<'static str>>;
    

    Please refer to the YamlDecoderTrapFn documentation for more details.

Features:

• Tags can now be retained across documents by calling keep_tags(true) on a Parser before loading documents. (#10 (#12)

• YamlLoader structs now have a documents() method that returns the parsed documents associated with a loader.

• Parser::new_from_str(&str) and YamlLoader::load_from_parser(&Parser) were added.

Development:

• Linguist attributes were added for the tests/*.rs.inc files to prevent github from classifying them as C++ files.

v0.7.0

Features:

• Multi-line strings are now emitted using block scalars.

• Error messages now contain a byte offset to aid debugging. (#176)

• Yaml now has or and borrowed_or methods. (#179)

• Yaml::load_from_bytes() is now available. (#156)

• The parser and scanner now return Err() instead of calling panic.

Development:

• The documentation was updated to include a security note mentioning that yaml-rust is safe because it does not interpret types. (#195)

• Updated to quickcheck 1.0. (#188)

• hashlink is now used instead of linked_hash_map.

v0.6.0

Development:

• is_xxx functions were moved into the private char_traits module.

• Benchmarking tools were added.

• Performance was improved.

v0.5.0

• The parser now supports tag directives. (#35

• The info field has been exposed via a new Yaml::info() API method. (#190)