v2.6.0: node tags

[tomtau]

What's Changed

• Add basic support for node_tag, iterator, and meta grammar by @tomtau in Add basic support for node_tag, iterator, and meta grammar #832
• Fix Lines beginning with //! result in an error #838 grammar error when only have //!, /// or //, allow writing empty pest grammar. by @huacnlee in Fix #838 grammar error when only have //!, /// or //, allow writing empty pest grammar. #839
• Implement ExactSizeIterator for Pair iterators by @MucTepDayH16 in Implement ExactSizeIterator for Pair iterators #833
• fuzz: decrease the call limit in the json fuzzer by @tomtau in fuzz: decrease the call limit in the json fuzzer #841

New Contributors

• @MucTepDayH16 made their first contribution in Implement ExactSizeIterator for Pair iterators #833

Full Changelog: v2.5.7...v2.6.0

Introducing node tags

pest v2.6.0's grammar includes a new (optional) feature for labelling parts of rules (based on this idea posted by @oovm : #550 ), e.g.:

add = {#lhs = expr ~ "+" ~ #rhs = epxr}

This feature can help to distinguish tokens by labels instead of positions (which can help to reduce boilerplate code). You can read more about it here: https://pest.rs/book/grammars/syntax.html#tags

Warning: Semantic Versioning

Note that the node tag feature in 2.6.0 is a technically semver-breaking change even though it is a backwards-compatible / non-breaking change in the meta-grammar. There may be similar non-breaking changes to the meta-grammar between minor versions in the future. These non-breaking changes, however, may translate into semver-breaking changes due to the additional variants propagated from the generated Rule enum. This is a known issue and will be fixed in the future (e.g. by increasing MSRV and non_exhaustive annotations).

---

This discussion was created from the release v2.6.0: node tags.

[tomtau]

This version was yanked, you can still use the feature in 2.7.0 under a feature flag: #876

...
pest_derive = { version = "2.7", features = ["grammar-extras"] }