diff options
| author | Martin Fischer <martin@push-f.com> | 2023-09-10 19:37:34 +0200 |
|---|---|---|
| committer | Martin Fischer <martin@push-f.com> | 2023-09-28 10:36:08 +0200 |
| commit | 852d5c6f2e65a5ab466662ae1c649a0ed25c70a9 (patch) | |
| tree | 96d6bcdb2f2274f1081a0b6cfbde314f319159a1 /CHANGELOG.md | |
| parent | a03cea75d9d120a7519be91ec872b143b5d74276 (diff) | |
break!: move offsets out of Token
Previously the Token enum contained the offsets using the O generic
type parameter, which could be a usize if you're tracking offsets or
a zero-sized type if you didn't care about offsets. This commit moves
all the byte offset and syntax information to a new Trace enum,
which has several advantages:
* Traces can now easily be stored separately, while the tokens are
fed to the tree builder. (The tree builder only has to keep track
of which tree nodes originate from which tokens.)
* No needless generics for functions that take a token but don't
care about offsets (a tree construction implementation is bound
to have many of such functions).
* The FromIterator<(String, String)> impl for AttributeMap no longer
has to specify arbitrary values for the spans and the value_syntax).
* The PartialEq implementation of Token is now much more useful
(since it no longer includes all the offsets).
* The Debug formatting of Token is now more readable
(since it no longer includes all the offsets).
* Function pointers to functions accepting tokens are possible.
(Since function pointer types may not have generic parameters.)
Diffstat (limited to 'CHANGELOG.md')
| -rw-r--r-- | CHANGELOG.md | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md index 146d627..f0c1ed6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,8 @@ #### Breaking changes +* Byte offsets were moved out of the `Token` enum into a new `Trace` enum. + * `Token` enum * Removed the `Error` variant. @@ -21,6 +23,8 @@ * The `DefaultEmitter` has been renamed to `TracingEmitter`. +* The `DefaultEmitter` now yields `(Token, Trace)` instead of just `Token`. + * The `DefaultEmitter` now emits `Token::EndOfFile` on the end-of-file. (Previously it did not emit any token symbolizing the end-of-file.) |