New API to get anchors and aliases from a document

[lucasvr]

When deserializing a YAML document, the location and names of anchors and aliases is not preserved. That information is useful, though, as users may want to deduplicate references to the same mapping.

This commit introduces an API that exposes such mappings by parsing the metadata in struct Document. The new API has been added to struct Deserializer and provides the following signature:

pub fn anchors(&self) -> Option<Vec<DocumentAnchor>>

As an example, given the following YAML document:

a:
    enum: &io
        INPUT: 0
        OUTPUT: 1
b:
    enum: *io
c:
    enum: *io

this API returns:

Some([DocumentAnchor {
    anchor_name: "io",
    anchor_path: "/a/enum",
    aliases: ["/b/enum", "/c/enum"],
}])

[dtolnay]

Thanks for the PR!

I am ordinarily not interested in growing the API of this library to support more of YAML. I would instead be interested in someone else making a more fully featured Rust YAML library that can be used for the use case you described, among others.

[lucasvr]

No worries, thanks for letting me know.