-
Notifications
You must be signed in to change notification settings - Fork 21
Description
TL;DR: This crate will receive only basic maintenance and keep a stable API. saphyr
will accept new features, at the cost of a less stable API
Initially, this crate was meant to be a replacement of yaml-rust
. As it is today, it serves this specific purpose well.
However, we very rapidly have made API-breaking changes that required us to bump versions multiple times in a short timespan. This prevents us from evolving the library as we would like to. A balance needs to be found between improving the API and its usability and providing a library that people who already depend on yaml-rust
can switch to easily if they do not want to spend the time migrating to another YAML library.
To that end, we have created a new set of libraries that is intended to evolve, whether it be performance, large API refactoring or new features, without being bound to the stability needs of the existing yaml-rust
user base. This means that yaml-rust2
will receive fixes and very minor improvements if they can easily be ported, but no major change/feature will happen on this crate.
Users looking for a YAML library that will improve over time and are willing to pay the price of a bit of refactoring with new releases are directed to saphyr
. At the time of this writing, both are very similar. If you happen to only use the parser (and not the Yaml
object), you may use saphyr-parser
instead.