Commit graph

2812 commits

Author SHA1 Message Date
Gwilym Inzani aea8547f97
Ensure cargo fmt is run accross everything (#399)
I have fmt'd all the things!

- [x] Changelog updated / no changelog update needed
2023-03-23 23:11:19 +00:00
Gwilym Inzani 52e9e3eb32 Better error message for #[agb::entry] errors 2023-03-23 23:10:50 +00:00
Corwin 8eac033650
derive some traits on bitflags 2023-03-23 22:47:04 +00:00
GBA bot 09ec6c25b0 Update lockfiles 2023-03-23 22:30:47 +00:00
renovate[bot] 044261a2ff
Update Rust crate bitflags to v2 2023-03-23 22:28:28 +00:00
Gwilym Inzani 3793034ec3
Update Rust crate syn to v2 (#396)
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [syn](https://togithub.com/dtolnay/syn) | dependencies | major | `1`
-> `2` |

---

### Release Notes

<details>
<summary>dtolnay/syn</summary>

### [`v2.0.8`](https://togithub.com/dtolnay/syn/releases/tag/2.0.8)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.7...2.0.8)

- Treat `try` keyword as 2015-edition identifier in definition of try
macro ([#&#8203;1422](https://togithub.com/dtolnay/syn/issues/1422))

### [`v2.0.7`](https://togithub.com/dtolnay/syn/releases/tag/2.0.7)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.6...2.0.7)

-   Fix parsing of `mut self` inside of Type::BareFn

### [`v2.0.6`](https://togithub.com/dtolnay/syn/releases/tag/2.0.6)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.5...2.0.6)

- Improve error message on missing ';' between statements
([#&#8203;1419](https://togithub.com/dtolnay/syn/issues/1419))
- Keep non-brace macro invocations in trailing expr position as
Expr::Macro
([#&#8203;1420](https://togithub.com/dtolnay/syn/issues/1420))

### [`v2.0.5`](https://togithub.com/dtolnay/syn/releases/tag/2.0.5)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.4...2.0.5)

- Expose `ExprMacro` data structure even when `features="full"` is not
used ([#&#8203;1417](https://togithub.com/dtolnay/syn/issues/1417))

### [`v2.0.4`](https://togithub.com/dtolnay/syn/releases/tag/2.0.4)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.3...2.0.4)

- Improve error reporting when parsing identifiers and paths
([#&#8203;1415](https://togithub.com/dtolnay/syn/issues/1415),
[#&#8203;1416](https://togithub.com/dtolnay/syn/issues/1416))

### [`v2.0.3`](https://togithub.com/dtolnay/syn/releases/tag/2.0.3)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.2...2.0.3)

- Expose `ExprGroup` data structure even when `features="full"` is not
used ([#&#8203;1412](https://togithub.com/dtolnay/syn/issues/1412))

### [`v2.0.2`](https://togithub.com/dtolnay/syn/releases/tag/2.0.2)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.1...2.0.2)

-   Documentation improvements

### [`v2.0.1`](https://togithub.com/dtolnay/syn/releases/tag/2.0.1)

[Compare Source](https://togithub.com/dtolnay/syn/compare/2.0.0...2.0.1)

- Add methods on syn::Meta for reporting error on an incorrect kind of
attribute ([#&#8203;1409](https://togithub.com/dtolnay/syn/issues/1409))

### [`v2.0.0`](https://togithub.com/dtolnay/syn/releases/tag/2.0.0)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.109...2.0.0)

This release contains a batch of syntax tree improvements to incorporate
ongoing Rust language development from the past 3.5 years since syn 1.

It never seems like an ideal time to finalize a syntax tree design,
considering the frankly alarming number of syntax-disrupting language
features currently in flight: keyword generics, restrictions,
capabilities and contexts, conditional constness, new varieties of
literals, dyn revamp such as explicitly dyn-safe traits and dyn-star,
expression syntax in various phases of being added or being torn out
(const blocks, try blocks, raw references), auto traits and negative
impls, generalizations to higher rank trait bounds, async closures and
static async trait methods, postfix keywords, pattern types, return type
notation, unsafe attributes, …

The plan continues to be the same as laid out originally in the 1.0.0
release announcement:

> Be aware that the underlying Rust language will continue to evolve.
Syn is able to accommodate most kinds of Rust grammar changes via the
nonexhaustive enums and `Verbatim` variants in the syntax tree, but we
will plan to put out new major versions on a 12 to 24 month cadence to
incorporate ongoing language changes as needed.

If anything, the takeaway from the 3.5 year longevity of syn 1 is that
this period was tamer from a language development perspective than
anticipated, but that is unlikely to last and I think around 24 months
is still the correct cadence to expect between releases going forward.

<br>

<p align="center"><a href="https://docs.rs/syn/2/syn/">[API
documentation for 2.0]</a></p>

### Breaking changes

-   Minimum required Rust version is raised from rustc 1.31 to 1.56.

##### Expressions

- Support for `box expr` syntax has been deleted, as it has been deleted
recently from rustc.

- Support for type ascription syntax `expr: Type` in expression position
has been deleted.

- Support for unstable `&raw const expr` raw-pointer reference syntax
has been deleted.

- The representation of generic arguments has been unified between
method calls and non-method paths into a single `GenericArgument` type,
which supersedes the previous `GenericMethodArgument` and
`MethodTurbofish`.

- Generic arguments now distinguish between associated types
(`AssocType`) and associated constant values (`AssocConst`). Previously
these would be parsed ambiguously as `Binding`.

- The binary assignment operators in `BinOp` have been renamed to align
with the naming used by the standard library's `core::ops` module's
traits. For example `BinOp::AddEq` is now called `BinOp::AddAssign`.

- `Expr::Struct` struct construction expressions now support structs
which are a variant of an enum associated type of a trait, as in `<Type
as Trait>::Assoc::Variant { ... }`, which has recently been added to
Rust.

- `Expr::Range` now follows the `start` and `end` naming used by the
standard library's `RangeBounds` trait, rather than `from`/`to` or
`lo`/`hi`.

- `Expr::AssignOp` has been merged into `Expr::Binary`, which now
represents both non-assignment and assignment binary operators.

- Stricter parsing of ranges. None of the following are valid
expressions, but were previously accepted by syn: `..=`, `lo..=`, `...`,
`...hi`, `lo...`, `lo...hi`.

- `Expr::Closure` now includes a representation for `for<...>`
lifetimes.

##### Statements

- Variants `Stmt::Expr` (tail-position expression without trailing
semicolon) and `Stmt::Semi` (non-tail expression with trailing
semicolon) have been combined into `Stmt::Expr` with the optional
semicolon represented by `Option<Token![;]>`.

- The syntax tree for `Stmt::Local` has been extended to handle
`let`/`else` syntax.

- Macros in statement position are now uniformly parsed as
`Stmt::Macro`. Previously these would be disambiguated to `Stmt::Item`,
although it was ambiguous whether a macro in statement position would
expand to an item (like `thread_local! { ... }`) vs an expression (like
`println! { ... }`).

##### Patterns

- Pattern parsing for all the different syntactic positions in which
patterns are allowed has been split into `Pat::parse_single` (for
function- and closure-argument position, where top-level `|` is not
allowed), `Pat::parse_multi` (where `|` is allowed) and
`Pat::parse_multi_with_leading_vert` (for the pattern of match arms,
which allow an optional leading `|`). Previously only a single `parse`
behavior was supported and behaved like the new `parse_single`.

- The `Pat` syntax tree now shares more common data structures with the
`Expr` syntax tree where possible, such as for literals, paths, macros,
and ranges in pattern position.

- Parsing of struct field patterns does a better job rejecting bogus
syntax such as `Struct { 0 asdf }` and `Struct { ref mut 0: asdf }`,
which were previously incorrectly accepted.

- `Pat::Range` now supports one-sided ranges by representing the start
and end bound of the range by `Option<Expr>`.

- `Pat::Struct` keeps track of attributes on the optional `..` "rest"
part of the pattern, as in `let Struct { x, #[cfg(any())] .. } = _;`.

- Parsing unary negation now enforces that only literal patterns can be
unarily negated. For example `-self::CONST` and `-const { 0i32 }` are
not valid syntax in pattern position.

- `Pat::TupleStruct` no longer wraps a value of type `PatTuple` but
represents that information in its fields directly.

- A single parenthesized pattern without trailing comma inside the
parentheses is no longer considered a `Pat::Tuple`, it will be parsed as
`Pat::Paren`.

- One-sided range patterns are no longer allowed inside of slice
patterns. `[lo..]` and `[..=hi]` are not considered valid pattern syntax
by Rust.

##### Items

- Typed `self` in a method signature, such as `self: Pin<&mut Self>`,
will now be parsed as `FnArg::Receiver`. This means `self`, whether with
or without an explicit type, is always treated as a `Receiver`.
Previously only the `&self` and `&mut self` shorthand receivers were
parsed as `Receiver`.

- `TraitItem::Method` and `ImplItem::Method` have been renamed to
`TraitItem::Fn` and `ImplItem::Fn`, as they do not necessarily represent
methods if the function signature contains no `self`.

- `Item::Macro2` has been deleted as "macros 2.0" syntax is no longer
considered on track for stabilization.

- Various item kinds now hold `Generics` which didn't used to have them.

- The variadic argument of an extern function signature can now be given
an optional parameter name.

-   `WherePredicate::Eq` is no longer supported.

- `Visibility::Crate` is no longer supported. This syntax has been
removed from rustc.

- Public visibility is now represented by a single `Token![pub]` token
rather than the old `VisPublic` struct.

- `LifetimeDef` is now called `LifetimeParam`. This name makes more
sense in the context of the `GenericParam` enum (which also includes
`TypeParam` and `ConstParam`), and is the name that the Rust Reference
uses.

- Modules and extern blocks (`Item::Mod` and `Item::ForeignMod`) can now
be marked `unsafe`.

##### Attributes

- The syntax tree for `Attribute` has been redesigned. The new API
better accommodates attributes which mix structured and unstructured
content at different levels of nesting.

-   `AttributeArgs` has been removed. Use `Punctuated<Meta, Token![,]>`.

- For parsing attribute contents, `parse_meta()` is superseded by a new
parsing library called `syn::meta`, and the `parse_nested_meta` method
on `Attribute`.

##### Tokens

- In string literals, the handling of non-ASCII whitespace after
trailing `\` now matches what is implemented by rustc. Space, horizontal
tab, line feed, and carriage return are the only 4 whitespace characters
which are supposed to be stripped from the beginning of the next line.

- The delimiter tokens `syn::token::Paren`, `Bracket`, and `Brace` now
store 2 spans (the open and close punctuation separately) rather than
just 1. Use `.join()` to obtain a single `Span` spanning the whole
group.

- Keyword construction now requires a single span; an array of 1 span is
no longer accepted. Use `Token![trait](span)` instead of
`Token![trait]([span])`.

- Some token types have been renamed to conform with terminology used by
the [Rust
Reference](https://doc.rust-lang.org/1.68.0/reference/tokens.html#punctuation).
These are `Add`->`Plus`, `Bang`->`Not`, `Colon2`->`PathSep`,
`Div`->`Slash`, `Dot2`->`DotDot`, `Dot3`->`DotDotDot`, `Rem`->`Percent`,
and `Sub`->`Minus`.

##### More

- Several enums have been made `#[non_exhaustive]` in anticipation of
upcoming language changes. This includes `WherePredicate`, `Lit`, and
`GenericArgument`.

- The `impl Extend<Pair<T, P>> for Punctuated<T, P>` now requires `P:
Default` and will push a default punctuation between the pre-existing
elements and the new ones, if there is not already a trailing
punctuation. Previously it would panic in this situation.

- `ParseStream::parse_terminated` now takes a peek-style punctuation
argument instead of turbofish. Replace `input.parse_terminated::<_,
Token![,]>(Thing::parse)` with `input.parse_terminated(Thing::parse,
Token![,])`.

###
[`v1.0.109`](https://togithub.com/dtolnay/syn/compare/1.0.108...1.0.109)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.108...1.0.109)

### [`v1.0.108`](https://togithub.com/dtolnay/syn/releases/tag/1.0.108)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.107...1.0.108)

- Fix handling of unusual whitespace after escaped newlines in
`LitStr::value`
([#&#8203;1381](https://togithub.com/dtolnay/syn/issues/1381), thanks
[@&#8203;ModProg](https://togithub.com/ModProg))

### [`v1.0.107`](https://togithub.com/dtolnay/syn/releases/tag/1.0.107)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.106...1.0.107)

-   Opt out of `-Zrustdoc-scrape-examples` on docs.rs for now

### [`v1.0.106`](https://togithub.com/dtolnay/syn/releases/tag/1.0.106)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.105...1.0.106)

-   Documentation improvements

### [`v1.0.105`](https://togithub.com/dtolnay/syn/releases/tag/1.0.105)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.104...1.0.105)

- Improve parse errors related to `dyn` and `impl` type syntax
([#&#8203;1245](https://togithub.com/dtolnay/syn/issues/1245))

### [`v1.0.104`](https://togithub.com/dtolnay/syn/releases/tag/1.0.104)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.103...1.0.104)

-   Add `PathArguments::is_none()`

### [`v1.0.103`](https://togithub.com/dtolnay/syn/releases/tag/1.0.103)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.102...1.0.103)

- Implement `PartialOrd` for `Cursor`
([#&#8203;1236](https://togithub.com/dtolnay/syn/issues/1236),
[#&#8203;1237](https://togithub.com/dtolnay/syn/issues/1237), thanks
[@&#8203;CAD97](https://togithub.com/CAD97))

### [`v1.0.102`](https://togithub.com/dtolnay/syn/releases/tag/1.0.102)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.101...1.0.102)

- More efficient internal representation for `TokenBuffer`
([#&#8203;1223](https://togithub.com/dtolnay/syn/issues/1223), thanks
[@&#8203;CAD97](https://togithub.com/CAD97))
- Fix parsing of a left shift after macro metavariable in type position
([#&#8203;1229](https://togithub.com/dtolnay/syn/issues/1229))

### [`v1.0.101`](https://togithub.com/dtolnay/syn/releases/tag/1.0.101)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.100...1.0.101)

- Eliminate a bunch of redundant work done by LitStr::parse
([#&#8203;1221](https://togithub.com/dtolnay/syn/issues/1221))

### [`v1.0.100`](https://togithub.com/dtolnay/syn/releases/tag/1.0.100)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.99...1.0.100)

- Parse closures with explicit empty lifetime parameter list `for<> ||
-> T {…}` ([#&#8203;1212](https://togithub.com/dtolnay/syn/issues/1212),
[https://github.com/rust-lang/rust/issues/97362](https://togithub.com/rust-lang/rust/issues/97362))
- Parse `dyn*` provisional syntax
([#&#8203;1213](https://togithub.com/dtolnay/syn/issues/1213),
[https://github.com/rust-lang/rust/issues/91611](https://togithub.com/rust-lang/rust/issues/91611))
- Parse attributes on the "rest" pattern of a struct in pattern
position, `Struct { #[attr] .. }`
([#&#8203;1214](https://togithub.com/dtolnay/syn/issues/1214))
- Parse `static async` and `static async move` closures
([#&#8203;1215](https://togithub.com/dtolnay/syn/issues/1215),
[https://github.com/rust-lang/rust/issues/62290](https://togithub.com/rust-lang/rust/issues/62290))

### [`v1.0.99`](https://togithub.com/dtolnay/syn/releases/tag/1.0.99)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.98...1.0.99)

-   Add categories and keywords to crates.io metadata

### [`v1.0.98`](https://togithub.com/dtolnay/syn/releases/tag/1.0.98)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.97...1.0.98)

-   Format example code with rustfmt

### [`v1.0.97`](https://togithub.com/dtolnay/syn/releases/tag/1.0.97)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.96...1.0.97)

-   Update examples

### [`v1.0.96`](https://togithub.com/dtolnay/syn/releases/tag/1.0.96)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.95...1.0.96)

- Add a `punct_mut()` method on `syn::punctuated::Pair` to return
`Option<&mut P>`
([#&#8203;1183](https://togithub.com/dtolnay/syn/issues/1183))

### [`v1.0.95`](https://togithub.com/dtolnay/syn/releases/tag/1.0.95)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.94...1.0.95)

- Replace unicode-xid with unicode-ident crate:
https://github.com/dtolnay/unicode-ident

### [`v1.0.94`](https://togithub.com/dtolnay/syn/releases/tag/1.0.94)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.93...1.0.94)

-   Resolve some unused_macro_rules warnings

### [`v1.0.93`](https://togithub.com/dtolnay/syn/releases/tag/1.0.93)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.92...1.0.93)

- Fix compile error when `Some` means something unusual in the
expression namespace of the scope where `custom_keyword` is invoked
([#&#8203;1171](https://togithub.com/dtolnay/syn/issues/1171), thanks
[@&#8203;zakarumych](https://togithub.com/zakarumych))

### [`v1.0.92`](https://togithub.com/dtolnay/syn/releases/tag/1.0.92)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.91...1.0.92)

- Make compatible with Miri's tag-raw-pointers mode
([#&#8203;1166](https://togithub.com/dtolnay/syn/issues/1166), thanks
[@&#8203;saethlin](https://togithub.com/saethlin))

### [`v1.0.91`](https://togithub.com/dtolnay/syn/releases/tag/1.0.91)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.90...1.0.91)

-   impl ToTokens for RangeLimits
-   impl Parse for ExprAwait
-   impl Parse for GenericMethodArgument
-   impl Parse for MethodTurbofish

### [`v1.0.90`](https://togithub.com/dtolnay/syn/releases/tag/1.0.90)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.89...1.0.90)

- Update recommended exhaustive matching idiom to use
`non_exhaustive_omitted_patterns` lint:

    ```rust
    match expr {
        Expr::Array(e) => {…}
        Expr::Assign(e) => {…}
        ...
        Expr::Yield(e) => {…}

        #[cfg_attr(test, deny(non_exhaustive_omitted_patterns))]
        _ => {/* some sane fallback */}
    }
    ```

### [`v1.0.89`](https://togithub.com/dtolnay/syn/releases/tag/1.0.89)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.88...1.0.89)

- Remove support for inner attributes on non-block expressions
([#&#8203;1146](https://togithub.com/dtolnay/syn/issues/1146),
[https://github.com/rust-lang/rust/pull/83312](https://togithub.com/rust-lang/rust/pull/83312))
- Fix panic on comma after `mut self` in a bare fn type
([#&#8203;1148](https://togithub.com/dtolnay/syn/issues/1148))

### [`v1.0.88`](https://togithub.com/dtolnay/syn/releases/tag/1.0.88)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.87...1.0.88)

- Parse `..` pattern in pattern of `let`
([#&#8203;1136](https://togithub.com/dtolnay/syn/issues/1136))
- Parse `for<…>` lifetime introducer on closures
([#&#8203;1135](https://togithub.com/dtolnay/syn/issues/1135))
- Reject postfix operators after cast
([#&#8203;1117](https://togithub.com/dtolnay/syn/issues/1117))
- Implement extra-traits for `Nothing`
([#&#8203;1144](https://togithub.com/dtolnay/syn/issues/1144))

### [`v1.0.87`](https://togithub.com/dtolnay/syn/releases/tag/1.0.87)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.86...1.0.87)

- Parse trait bounds containing associated constant constraint
([#&#8203;1138](https://togithub.com/dtolnay/syn/issues/1138))
- Change syntax of where-clauses on generic associated types
([#&#8203;1071](https://togithub.com/dtolnay/syn/issues/1071),
[https://github.com/rust-lang/rust/issues/89122](https://togithub.com/rust-lang/rust/issues/89122))

### [`v1.0.86`](https://togithub.com/dtolnay/syn/releases/tag/1.0.86)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.85...1.0.86)

-   Add support for parsing if- and while-let-chains (RFC 2497)

### [`v1.0.85`](https://togithub.com/dtolnay/syn/releases/tag/1.0.85)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.84...1.0.85)

- Add `token()` method to each variant of syn::Lit to expose the
underlying token representation with original formatting

### [`v1.0.84`](https://togithub.com/dtolnay/syn/releases/tag/1.0.84)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.83...1.0.84)

- Add
[`parse_quote_spanned!`](https://docs.rs/syn/1.0.84/syn/macro.parse_quote_spanned.html)
macro which is a combination `parse_quote!` + `quote_spanned!`

### [`v1.0.83`](https://togithub.com/dtolnay/syn/releases/tag/1.0.83)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.82...1.0.83)

- Fix panic parsing trait impl with qself in trait type: `impl
<Thing<>>::Trait for Type {}`
([#&#8203;1109](https://togithub.com/dtolnay/syn/issues/1109))
- Preserve attributes on let-else stmt: `#[attr] let pat = val else {
return }` ([#&#8203;1110](https://togithub.com/dtolnay/syn/issues/1110))

### [`v1.0.82`](https://togithub.com/dtolnay/syn/releases/tag/1.0.82)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.81...1.0.82)

- Support parenthesized generic argument syntax with `::` disambiguator:
`Fn::() -> !`
([#&#8203;1096](https://togithub.com/dtolnay/syn/issues/1096))

### [`v1.0.81`](https://togithub.com/dtolnay/syn/releases/tag/1.0.81)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.80...1.0.81)

- Support arbitrary precision negative literal tokens on rustc 1.56+
([#&#8203;1087](https://togithub.com/dtolnay/syn/issues/1087),
[#&#8203;1088](https://togithub.com/dtolnay/syn/issues/1088))

### [`v1.0.80`](https://togithub.com/dtolnay/syn/releases/tag/1.0.80)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.79...1.0.80)

- Parse unstable `~const` syntax in where-clauses
([#&#8203;1083](https://togithub.com/dtolnay/syn/issues/1083), tracking
issue
[https://github.com/rust-lang/rust/issues/67792](https://togithub.com/rust-lang/rust/issues/67792))

### [`v1.0.79`](https://togithub.com/dtolnay/syn/releases/tag/1.0.79)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.78...1.0.79)

- Support trailing `+` in `dyn Trait` syntax, including bare (non-`dyn`)
pre-2018 trait object syntax
([#&#8203;1075](https://togithub.com/dtolnay/syn/issues/1075),
[#&#8203;1077](https://togithub.com/dtolnay/syn/issues/1077),
[#&#8203;1078](https://togithub.com/dtolnay/syn/issues/1078),
[#&#8203;1079](https://togithub.com/dtolnay/syn/issues/1079),
[#&#8203;1080](https://togithub.com/dtolnay/syn/issues/1080),
[#&#8203;1081](https://togithub.com/dtolnay/syn/issues/1081))

### [`v1.0.78`](https://togithub.com/dtolnay/syn/releases/tag/1.0.78)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.77...1.0.78)

- Parse trailing `+` in the bounds of `impl Trait` type
([#&#8203;1073](https://togithub.com/dtolnay/syn/issues/1073))

### [`v1.0.77`](https://togithub.com/dtolnay/syn/releases/tag/1.0.77)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.76...1.0.77)

- Match Rust 1.57+'s parsing of dot and question mark after a curly
braced macro invocation
([#&#8203;1068](https://togithub.com/dtolnay/syn/issues/1068))

### [`v1.0.76`](https://togithub.com/dtolnay/syn/releases/tag/1.0.76)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.75...1.0.76)

- Parse unstable `let`–`else` syntax
([#&#8203;1050](https://togithub.com/dtolnay/syn/issues/1050),
[#&#8203;1057](https://togithub.com/dtolnay/syn/issues/1057))
- Parse qualified braced variant expressions and patterns: `<E>::V {..}`
([#&#8203;1058](https://togithub.com/dtolnay/syn/issues/1058),
[#&#8203;1059](https://togithub.com/dtolnay/syn/issues/1059))
- Fix precedence of outer attributes in front of an assignment
expression in statement position
([#&#8203;1060](https://togithub.com/dtolnay/syn/issues/1060))

### [`v1.0.75`](https://togithub.com/dtolnay/syn/releases/tag/1.0.75)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.74...1.0.75)

-   Improve spans on a method without body inside an impl block
- Documentation improvements
([#&#8203;922](https://togithub.com/dtolnay/syn/issues/922), thanks
[@&#8203;Tamschi](https://togithub.com/Tamschi))

### [`v1.0.74`](https://togithub.com/dtolnay/syn/releases/tag/1.0.74)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.73...1.0.74)

- Reject `for<'a> dyn Trait<'a>` syntax; the correct representation is
`dyn for<'a> Trait<'a>`
([#&#8203;1042](https://togithub.com/dtolnay/syn/issues/1042))

### [`v1.0.73`](https://togithub.com/dtolnay/syn/releases/tag/1.0.73)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.72...1.0.73)

- Add From\<Ident>, From\<Index>, From\<usize> for Member
([#&#8203;1038](https://togithub.com/dtolnay/syn/issues/1038), thanks
[@&#8203;m-ou-se](https://togithub.com/m-ou-se))

### [`v1.0.72`](https://togithub.com/dtolnay/syn/releases/tag/1.0.72)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.71...1.0.72)

- Parse const generics which use value of a previous const generic
parameter as a default value
([#&#8203;1027](https://togithub.com/dtolnay/syn/issues/1027))

### [`v1.0.71`](https://togithub.com/dtolnay/syn/releases/tag/1.0.71)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.70...1.0.71)

- Fix panic deserializing an ItemImpl with a non-path in trait position
([#&#8203;1023](https://togithub.com/dtolnay/syn/issues/1023))
- Parse visibility on impl blocks
([#&#8203;1024](https://togithub.com/dtolnay/syn/issues/1024))
- Fix parsing a type parameter default on the first generic parameter of
an impl block
([#&#8203;1025](https://togithub.com/dtolnay/syn/issues/1025), thanks
[@&#8203;taiki-e](https://togithub.com/taiki-e))

### [`v1.0.70`](https://togithub.com/dtolnay/syn/releases/tag/1.0.70)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.69...1.0.70)

- Fix precedence of closure body vs ExprRange rhs: `|| .. .method()`
([#&#8203;1019](https://togithub.com/dtolnay/syn/issues/1019))
- Parse inner attributes inside of structs and enums
([#&#8203;1022](https://togithub.com/dtolnay/syn/issues/1022))

### [`v1.0.69`](https://togithub.com/dtolnay/syn/releases/tag/1.0.69)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.68...1.0.69)

- Improve Parse impls of ExprBox, ExprUnary, ExprLet, ExprClosure,
ExprReference, ExprBreak, ExprContinue, ExprReturn, ExprYield to respect
precedence for parsing a subexpression beginning with the respective
keyword/punctuation
([#&#8203;1007](https://togithub.com/dtolnay/syn/issues/1007),
[#&#8203;1008](https://togithub.com/dtolnay/syn/issues/1008),
[#&#8203;1009](https://togithub.com/dtolnay/syn/issues/1009),
[#&#8203;1010](https://togithub.com/dtolnay/syn/issues/1010),
[#&#8203;1011](https://togithub.com/dtolnay/syn/issues/1011),
[#&#8203;1012](https://togithub.com/dtolnay/syn/issues/1012),
[#&#8203;1013](https://togithub.com/dtolnay/syn/issues/1013),
[#&#8203;1014](https://togithub.com/dtolnay/syn/issues/1014),
[#&#8203;1015](https://togithub.com/dtolnay/syn/issues/1015))

### [`v1.0.68`](https://togithub.com/dtolnay/syn/releases/tag/1.0.68)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.67...1.0.68)

- Preserve span of `LexError` on conversion to `syn::Error`
([#&#8203;1006](https://togithub.com/dtolnay/syn/issues/1006))

### [`v1.0.67`](https://togithub.com/dtolnay/syn/releases/tag/1.0.67)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.66...1.0.67)

- Accept outer attributes in the Parse impl of ExprBlock
([#&#8203;1004](https://togithub.com/dtolnay/syn/issues/1004))

### [`v1.0.66`](https://togithub.com/dtolnay/syn/releases/tag/1.0.66)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.65...1.0.66)

- Parse equality constraints on generic associated types
([#&#8203;979](https://togithub.com/dtolnay/syn/issues/979))
- Parse default value exprs in const generic declarations
([#&#8203;980](https://togithub.com/dtolnay/syn/issues/980))
- Fix infinite loop parsing malformed type ascription expression in
non-`full` mode
([#&#8203;978](https://togithub.com/dtolnay/syn/issues/978))
- Improve Parse impls of ExprArray, ExprAsync, ExprBlock, ExprMacro,
ExprParen, ExprRepeat, ExprStruct, ExprTryBlock, ExprUnsafe to succeed
parsing even in the presence of trailing binary operators
([#&#8203;991](https://togithub.com/dtolnay/syn/issues/991),
[#&#8203;992](https://togithub.com/dtolnay/syn/issues/992),
[#&#8203;993](https://togithub.com/dtolnay/syn/issues/993),
[#&#8203;994](https://togithub.com/dtolnay/syn/issues/994),
[#&#8203;995](https://togithub.com/dtolnay/syn/issues/995),
[#&#8203;996](https://togithub.com/dtolnay/syn/issues/996),
[#&#8203;997](https://togithub.com/dtolnay/syn/issues/997),
[#&#8203;998](https://togithub.com/dtolnay/syn/issues/998),
[#&#8203;999](https://togithub.com/dtolnay/syn/issues/999))

### [`v1.0.65`](https://togithub.com/dtolnay/syn/releases/tag/1.0.65)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.64...1.0.65)

- Parse visibility on macro_rules
([#&#8203;981](https://togithub.com/dtolnay/syn/issues/981), tracking
issue
[rust-lang/rust#&#8203;78855](https://togithub.com/rust-lang/rust/issues/78855))
- Parse leading vert in or-patterns
([#&#8203;982](https://togithub.com/dtolnay/syn/issues/982), matching
the Rust grammar change in
[rust-lang/rust#&#8203;81869](https://togithub.com/rust-lang/rust/issues/81869))
- Parse static with omitted type
([#&#8203;983](https://togithub.com/dtolnay/syn/issues/983))
- Parse placeholder type in type parameter position
([#&#8203;984](https://togithub.com/dtolnay/syn/issues/984))

### [`v1.0.64`](https://togithub.com/dtolnay/syn/releases/tag/1.0.64)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.63...1.0.64)

- Avoid `clippy::expl_impl_clone_on_copy` pedantic lint in downstream
custom token types
([#&#8203;976](https://togithub.com/dtolnay/syn/issues/976))

### [`v1.0.63`](https://togithub.com/dtolnay/syn/releases/tag/1.0.63)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.62...1.0.63)

- Fix parsing associated types with empty trait bound list after colon
([#&#8203;974](https://togithub.com/dtolnay/syn/issues/974))

### [`v1.0.62`](https://togithub.com/dtolnay/syn/releases/tag/1.0.62)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.61...1.0.62)

- Republish to work around docs.rs bug
[https://github.com/rust-lang/docs.rs/issues/1300](https://togithub.com/rust-lang/docs.rs/issues/1300)

### [`v1.0.61`](https://togithub.com/dtolnay/syn/releases/tag/1.0.61)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.60...1.0.61)

- Improve assertion failures on invalid use of `Punctuated` API
([#&#8203;970](https://togithub.com/dtolnay/syn/issues/970), thanks
[@&#8203;osa1](https://togithub.com/osa1))
- Add `Lifetime::span` and `Lifetime::set_span` accessors
([#&#8203;971](https://togithub.com/dtolnay/syn/issues/971))

### [`v1.0.60`](https://togithub.com/dtolnay/syn/releases/tag/1.0.60)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.59...1.0.60)

- Provide an idiom for testing exhaustiveness of pattern matches on
`Expr`, `Type`, `Pat`, `Item`, `ForeignItem`, `TraitItem`, and
`ImplItem` ([#&#8203;694](https://togithub.com/dtolnay/syn/issues/694))

    ```rust
    match expr {
        Expr::Array(e) => {...}
        Expr::Assign(e) => {...}
        ...
        Expr::Yield(e) => {...}

        #[cfg(test)]
        Expr::__TestExhaustive(_) => unimplemented!(),
        #[cfg(not(test))]
        _ => { /* some sane fallback */ }
    }
    ```

The above is the only supported idiom for exhaustive matching of those
enum. Do not write anything differently as it is not supported.

The conditional compilation on match-arms lets us fail your tests but
not break your library when adding a variant. You will be notified by a
test failure when a variant is added, so that you can add code to handle
it, but your library will continue to compile and work for downstream
users in the interim.

### [`v1.0.59`](https://togithub.com/dtolnay/syn/releases/tag/1.0.59)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.58...1.0.59)

- Parse empty supertrait lists consistently with rustc
([#&#8203;952](https://togithub.com/dtolnay/syn/issues/952))
- Fix loss of span information on comma tokens inside of Type::Tuple
during parse
([#&#8203;959](https://togithub.com/dtolnay/syn/issues/959))

### [`v1.0.58`](https://togithub.com/dtolnay/syn/releases/tag/1.0.58)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.57...1.0.58)

- Allow literals to parse as a const generic path argument even without
"full" feature enabled
([#&#8203;951](https://togithub.com/dtolnay/syn/issues/951))

    ```rust
    pub struct Struct {
        array: Array<10>,  // used to require `features = "full"`
    }
    ```

### [`v1.0.57`](https://togithub.com/dtolnay/syn/releases/tag/1.0.57)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.56...1.0.57)

- Make Punctuated::new available as a `const fn`
([#&#8203;949](https://togithub.com/dtolnay/syn/issues/949))

### [`v1.0.56`](https://togithub.com/dtolnay/syn/releases/tag/1.0.56)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.55...1.0.56)

- Add
[`Error::into_compile_error`](https://docs.rs/syn/1.0.56/syn/struct.Error.html#method.into_compile_error)

### [`v1.0.55`](https://togithub.com/dtolnay/syn/releases/tag/1.0.55)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.54...1.0.55)

- Preserve None-delimited group around macro metavariable when parsing
`T<$ty>` ([#&#8203;944](https://togithub.com/dtolnay/syn/issues/944),
[#&#8203;945](https://togithub.com/dtolnay/syn/issues/945))

### [`v1.0.54`](https://togithub.com/dtolnay/syn/releases/tag/1.0.54)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.53...1.0.54)

- Fix parsing of `impl` items with macro metavariable in the trait path:
`impl $trait for Type {...}`
([#&#8203;942](https://togithub.com/dtolnay/syn/issues/942))

### [`v1.0.53`](https://togithub.com/dtolnay/syn/releases/tag/1.0.53)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.52...1.0.53)

- Parse `impl !Trait {...}` syntax
([#&#8203;936](https://togithub.com/dtolnay/syn/issues/936))

### [`v1.0.52`](https://togithub.com/dtolnay/syn/releases/tag/1.0.52)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.51...1.0.52)

- Parse `unsafe extern` block syntax
([#&#8203;918](https://togithub.com/dtolnay/syn/issues/918))
- Parse `unsafe mod` syntax
([#&#8203;919](https://togithub.com/dtolnay/syn/issues/919))
- Parse `const {...}` block syntax
([#&#8203;921](https://togithub.com/dtolnay/syn/issues/921))
- Parse destructuring assignment syntax
([#&#8203;933](https://togithub.com/dtolnay/syn/issues/933))

### [`v1.0.51`](https://togithub.com/dtolnay/syn/releases/tag/1.0.51)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.50...1.0.51)

- Allow parsing signatures in which const generic params appear in front
of lifetime params
([#&#8203;920](https://togithub.com/dtolnay/syn/issues/920))

### [`v1.0.50`](https://togithub.com/dtolnay/syn/releases/tag/1.0.50)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.48...1.0.50)

- Apply `doc(cfg(...))` on feature gated APIs for docs.rs-rendered
documentation
([#&#8203;925](https://togithub.com/dtolnay/syn/issues/925))

### [`v1.0.48`](https://togithub.com/dtolnay/syn/releases/tag/1.0.48)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.47...1.0.48)

-   Rebuild for https://astexplorer.net

### [`v1.0.47`](https://togithub.com/dtolnay/syn/releases/tag/1.0.47)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.46...1.0.47)

-   Documentation improvements

### [`v1.0.46`](https://togithub.com/dtolnay/syn/releases/tag/1.0.46)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.45...1.0.46)

- Fix parsing structured attributes that contain nested absolute paths,
such as `#[derive(::serde::Serialize)]`
([#&#8203;909](https://togithub.com/dtolnay/syn/issues/909))

### [`v1.0.45`](https://togithub.com/dtolnay/syn/releases/tag/1.0.45)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.44...1.0.45)

- Provide more detailed error messages when parsing specific literal
kind ([#&#8203;908](https://togithub.com/dtolnay/syn/issues/908))

### [`v1.0.44`](https://togithub.com/dtolnay/syn/releases/tag/1.0.44)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.43...1.0.44)

- Fix some parsing of patterns inside of None-delimited groups
([#&#8203;907](https://togithub.com/dtolnay/syn/issues/907))

### [`v1.0.43`](https://togithub.com/dtolnay/syn/releases/tag/1.0.43)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.42...1.0.43)

-   Add Parse impl for syn::Signature

### [`v1.0.42`](https://togithub.com/dtolnay/syn/releases/tag/1.0.42)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.41...1.0.42)

- Fix several bugs involving unusual suffixes on integer and floating
point literal tokens
([#&#8203;898](https://togithub.com/dtolnay/syn/issues/898),
[#&#8203;899](https://togithub.com/dtolnay/syn/issues/899),
[#&#8203;900](https://togithub.com/dtolnay/syn/issues/900))

### [`v1.0.41`](https://togithub.com/dtolnay/syn/releases/tag/1.0.41)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.40...1.0.41)

- Fix panic on printing an incomplete (having fewer path segments than
originally parsed with) qualified path (ExprPath, PatPath, TypePath
containing QSelf)
([#&#8203;891](https://togithub.com/dtolnay/syn/issues/891), thanks
[@&#8203;taiki-e](https://togithub.com/taiki-e))
- Fix panic triggered by syntactically invalid overflowing negative
float literal after `.` in a field access position, e.g. `let _ =
obj.-0.9E999999`
([#&#8203;895](https://togithub.com/dtolnay/syn/issues/895), thanks
[@&#8203;sameer](https://togithub.com/sameer))
- Enable using `parse_macro_input!` with a Parser function rather than
type having a Parse impl
([#&#8203;896](https://togithub.com/dtolnay/syn/issues/896), thanks
[@&#8203;sbrocket](https://togithub.com/sbrocket))

### [`v1.0.40`](https://togithub.com/dtolnay/syn/releases/tag/1.0.40)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.39...1.0.40)

- Fix panic on parsing float literals having both an exponent and a
suffix beginning with 'e' or 'E', such as `9e99e999`
([#&#8203;893](https://togithub.com/dtolnay/syn/issues/893))

### [`v1.0.39`](https://togithub.com/dtolnay/syn/releases/tag/1.0.39)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.38...1.0.39)

- Improve compile time by pre-expanding derives
([#&#8203;885](https://togithub.com/dtolnay/syn/issues/885))
- Parse const generic parameters in any order relative to type
parameters ([#&#8203;886](https://togithub.com/dtolnay/syn/issues/886))

### [`v1.0.38`](https://togithub.com/dtolnay/syn/releases/tag/1.0.38)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.37...1.0.38)

- Accept traits with parenthesized path arguments in impls
([#&#8203;880](https://togithub.com/dtolnay/syn/issues/880), thanks
[@&#8203;alecmocatta](https://togithub.com/alecmocatta))

### [`v1.0.37`](https://togithub.com/dtolnay/syn/releases/tag/1.0.37)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.36...1.0.37)

- Handle shebang in a way that matches rustc 1.46+
([#&#8203;876](https://togithub.com/dtolnay/syn/issues/876),
[https://github.com/rust-lang/rust/pull/71487](https://togithub.com/rust-lang/rust/pull/71487),
[https://github.com/rust-lang/rust/pull/73596](https://togithub.com/rust-lang/rust/pull/73596))

    ```rust
    #!//am/i/a/comment

    fn main() {} // ^ shebang
    ```

    ```rust
    #!//am/i/a/comment

    [allow(dead_code)] // ^ not a shebang
    fn main() {}
    ```

- Accept <code>tuple.0.  0</code> as a tuple indexing expression
([#&#8203;877](https://togithub.com/dtolnay/syn/issues/877))

### [`v1.0.36`](https://togithub.com/dtolnay/syn/releases/tag/1.0.36)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.35...1.0.36)

- Add Lit::span, Lit::set_span
([#&#8203;874](https://togithub.com/dtolnay/syn/issues/874))

### [`v1.0.35`](https://togithub.com/dtolnay/syn/releases/tag/1.0.35)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.34...1.0.35)

- Fix parsing of Expr::Field in non-full mode
([#&#8203;870](https://togithub.com/dtolnay/syn/issues/870))

### [`v1.0.34`](https://togithub.com/dtolnay/syn/releases/tag/1.0.34)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.33...1.0.34)

-   Documentation improvements

### [`v1.0.33`](https://togithub.com/dtolnay/syn/releases/tag/1.0.33)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.32...1.0.33)

- Parse `tuple.0.0` as an indexing expression
([https://github.com/rust-lang/rust/pull/71322](https://togithub.com/rust-lang/rust/pull/71322))
- Add `Parse` impls for optional of proc-macro2 types:
`Option<TokenTree>`, `Option<Punct>`, `Option<Literal>`, `Option<Group>`

### [`v1.0.32`](https://togithub.com/dtolnay/syn/releases/tag/1.0.32)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.31...1.0.32)

- Fix parsing $:item macro_rules metavariables containing outer
attributes ([#&#8203;852](https://togithub.com/dtolnay/syn/issues/852))

### [`v1.0.31`](https://togithub.com/dtolnay/syn/releases/tag/1.0.31)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.30...1.0.31)

- Add
[`Expr::parse_without_eager_brace`](https://docs.rs/syn/1.0.31/syn/enum.Expr.html#method.parse_without_eager_brace)
to parse expressions in ambiguous syntactic position.

Rust grammar has an ambiguity where braces sometimes turn a path
expression into a struct initialization and sometimes do not. In the
following code, the expression `S {}` is one expression. Presumably
there is an empty struct `struct S {}` defined somewhere which it is
instantiating.

    ```rust
    let _ = *S {};

    // parsed by rustc as: `*(S {})`
    ```

We would want to parse the above using `Expr::parse` after the `=`
token.

    But in the following, `S {}` is *not* a struct init expression.

    ```rust
    if *S {} {}

    // parsed by rustc as:
    //
    //    if (*S) {
    //        /* empty block */
    //    }
    //    {
    //        /* another empty block */
    //    }
    ```

For that reason we would want to parse if-conditions using
`Expr::parse_without_eager_brace` after the `if` token. Same for similar
syntactic positions such as the condition expr after a `while` token or
the expr at the top of a `match`.

The Rust grammar's choices around which way this ambiguity is resolved
at various syntactic positions is fairly arbitrary. Really either parse
behavior could work in most positions, and language designers just
decide each case based on which is more likely to be what the programmer
had in mind most of the time.

    ```rust
    if return S {} {}

    // parsed by rustc as:
    //
    //    if (return (S {})) {
    //    }
    //
    // but could equally well have been this other arbitrary choice:
    //
    //    if (return S) {
    //    }
    //    {}
    ```

Note the grammar ambiguity on trailing braces is distinct from
precedence and is not captured by assigning a precedence level to the
braced struct init expr in relation to other operators. This can be
illustrated by `return 0..S {}` vs `match 0..S {}`. The former parses as
`return (0..(S {}))` implying tighter precedence for struct init than
`..`, while the latter parses as `match (0..S) {}` implying tighter
precedence for `..` than struct init, a contradiction.

### [`v1.0.30`](https://togithub.com/dtolnay/syn/releases/tag/1.0.30)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.29...1.0.30)

- Parse struct init expressions where the type name is an interpolated
macro_rules metavariable, such as `$struct {}` where $struct:ident
([#&#8203;842](https://togithub.com/dtolnay/syn/issues/842))
- Handle nesting of None-delimited groups
([#&#8203;843](https://togithub.com/dtolnay/syn/issues/843), thanks
[@&#8203;Aaron1011](https://togithub.com/Aaron1011))

### [`v1.0.29`](https://togithub.com/dtolnay/syn/releases/tag/1.0.29)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.28...1.0.29)

- Parse macro call exprs where the macro name is an interpolated
macro_rules metavariable, such as `$macro!()`
([#&#8203;838](https://togithub.com/dtolnay/syn/issues/838))
- Parse paths containing generic parameters where the first path segment
is an interpolated macro_rules metavariable, such as `$seg<'a>`
([#&#8203;839](https://togithub.com/dtolnay/syn/issues/839))

### [`v1.0.28`](https://togithub.com/dtolnay/syn/releases/tag/1.0.28)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.27...1.0.28)

- Recognize empty None-delimited group produced by interpolating a $:vis
macro metavariable when parsing a Visibility
([#&#8203;836](https://togithub.com/dtolnay/syn/issues/836))

### [`v1.0.27`](https://togithub.com/dtolnay/syn/releases/tag/1.0.27)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.26...1.0.27)

- Parse function calls in which the callee is an interpolated macro
variable `$fn(...)`
([#&#8203;833](https://togithub.com/dtolnay/syn/issues/833))

### [`v1.0.26`](https://togithub.com/dtolnay/syn/releases/tag/1.0.26)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.25...1.0.26)

- Parse paths containing an interpolated first component, such as
`$first::rest`
([https://github.com/rust-lang/rust/issues/72608](https://togithub.com/rust-lang/rust/issues/72608),
[#&#8203;832](https://togithub.com/dtolnay/syn/issues/832))

### [`v1.0.25`](https://togithub.com/dtolnay/syn/releases/tag/1.0.25)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.24...1.0.25)

- Parse opt-out `?const` trait bounds
([#&#8203;767](https://togithub.com/dtolnay/syn/issues/767))
- Parse const generics in method generic arguments
([#&#8203;816](https://togithub.com/dtolnay/syn/issues/816), thanks
[@&#8203;yodaldevoid](https://togithub.com/yodaldevoid))
- Parse trait bounds on type alias items
([#&#8203;821](https://togithub.com/dtolnay/syn/issues/821))
- Parse const generics on impl blocks
([#&#8203;822](https://togithub.com/dtolnay/syn/issues/822))
- Fix precedence of attributes on binary expressions to match rustc
([#&#8203;823](https://togithub.com/dtolnay/syn/issues/823))
- Remove parsing of `extern::` paths which were removed from nightly in
January 2019
([#&#8203;825](https://togithub.com/dtolnay/syn/issues/825),
[https://github.com/rust-lang/rust/pull/57572](https://togithub.com/rust-lang/rust/pull/57572))
- Add `Punctuated::clear`, analogous to Vec::clear
([#&#8203;828](https://togithub.com/dtolnay/syn/issues/828))

### [`v1.0.24`](https://togithub.com/dtolnay/syn/releases/tag/1.0.24)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.23...1.0.24)

- Parse `mut self` receiver in function pointer type
([#&#8203;812](https://togithub.com/dtolnay/syn/issues/812),
[#&#8203;814](https://togithub.com/dtolnay/syn/issues/814))
- Parse const trait impls
([#&#8203;813](https://togithub.com/dtolnay/syn/issues/813))
- Improve error reporting inside struct expressions and struct patterns
([#&#8203;818](https://togithub.com/dtolnay/syn/issues/818))

### [`v1.0.23`](https://togithub.com/dtolnay/syn/releases/tag/1.0.23)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.22...1.0.23)

- Parse inner attributes in traits
([#&#8203;803](https://togithub.com/dtolnay/syn/issues/803))
- Parse const underscore in traits and impls
([#&#8203;804](https://togithub.com/dtolnay/syn/issues/804))
- Implement Extend<Error> for Error
([#&#8203;805](https://togithub.com/dtolnay/syn/issues/805))
- Parse Or patterns
([#&#8203;806](https://togithub.com/dtolnay/syn/issues/806))
- Parse outer attributes on Expr\* structs
([#&#8203;807](https://togithub.com/dtolnay/syn/issues/807))
- Parse top level const/static without value
([#&#8203;808](https://togithub.com/dtolnay/syn/issues/808))
- Parse syntactically accepted functions
([#&#8203;809](https://togithub.com/dtolnay/syn/issues/809))
- Parse extern static with value
([#&#8203;810](https://togithub.com/dtolnay/syn/issues/810))

Thanks [@&#8203;taiki-e](https://togithub.com/taiki-e) for all of these.

### [`v1.0.22`](https://togithub.com/dtolnay/syn/releases/tag/1.0.22)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.21...1.0.22)

- Parse literal suffix on byte string, byte, and char literal tokens:
`br#"..."#suffix`, `b'?'suffix`, `'?'suffix`
([#&#8203;799](https://togithub.com/dtolnay/syn/issues/799),
[#&#8203;800](https://togithub.com/dtolnay/syn/issues/800))

### [`v1.0.21`](https://togithub.com/dtolnay/syn/releases/tag/1.0.21)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.20...1.0.21)

-   Documentation improvements

### [`v1.0.20`](https://togithub.com/dtolnay/syn/releases/tag/1.0.20)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.19...1.0.20)

- Improve span of error message when an error during
`syn::Macro::parse_body` is triggered past the last token of the macro
body ([#&#8203;791](https://togithub.com/dtolnay/syn/issues/791))

### [`v1.0.19`](https://togithub.com/dtolnay/syn/releases/tag/1.0.19)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.18...1.0.19)

- Parse a more lenient extern type syntax inside extern blocks
([#&#8203;763](https://togithub.com/dtolnay/syn/issues/763))

### [`v1.0.18`](https://togithub.com/dtolnay/syn/releases/tag/1.0.18)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.17...1.0.18)

- Ignore unparsed empty None-delimited groups at the end of a macro
input ([#&#8203;783](https://togithub.com/dtolnay/syn/issues/783))

### [`v1.0.17`](https://togithub.com/dtolnay/syn/releases/tag/1.0.17)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.16...1.0.17)

-   Expose `syn::Lit` in `default-features = false` mode

### [`v1.0.16`](https://togithub.com/dtolnay/syn/releases/tag/1.0.16)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.15...1.0.16)

- Fix parsing of `&raw` raw reference operator
([https://github.com/rust-lang/rust/issues/64490](https://togithub.com/rust-lang/rust/issues/64490))
to require explicitly specified constness, `&raw mut` or `&raw const`

### [`v1.0.15`](https://togithub.com/dtolnay/syn/releases/tag/1.0.15)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.14...1.0.15)

- Add
[`Punctuated::first_mut`](https://docs.rs/syn/1.0.15/syn/punctuated/struct.Punctuated.html#method.first_mut)
to return a mut reference to the first sequence element

### [`v1.0.14`](https://togithub.com/dtolnay/syn/releases/tag/1.0.14)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.13...1.0.14)

- Produce more helpful error messages from
[Attribute::parse_args](https://docs.rs/syn/1.0/syn/struct.Attribute.html#method.parse_args)

### [`v1.0.13`](https://togithub.com/dtolnay/syn/releases/tag/1.0.13)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.12...1.0.13)

- Allow parse_quote! to parse Vec\<Stmt>, with the same behavior as
Block::parse_within
([#&#8203;741](https://togithub.com/dtolnay/syn/issues/741))

### [`v1.0.12`](https://togithub.com/dtolnay/syn/releases/tag/1.0.12)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.11...1.0.12)

- Reject function signatures with an incorrectly placed receiver
parameter, like `fn f(x: u8, &self)`
- Produce correctly spanned error when parsing punct beyond the end of a
delimited group
([#&#8203;739](https://togithub.com/dtolnay/syn/issues/739))

### [`v1.0.11`](https://togithub.com/dtolnay/syn/releases/tag/1.0.11)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.10...1.0.11)

- Implement quote::IdentFragment for syn::Member and syn::Index so that
spans are preserved when using these types in quote's `format_ident!`
macro

    ```rust
    use quote::format_ident;
    use syn::Index;

    let index: Index = /* ... */;
    let ident = format_ident!("__{}", index); // produces __0, __1, etc
    ```

### [`v1.0.10`](https://togithub.com/dtolnay/syn/releases/tag/1.0.10)

[Compare
Source](https://togithub.com/dtolnay/syn/compare/1.0.9...1.0.10)

- Provide `Hash` and `Eq` impls for syn::Member even without
"extra-traits" feature enabled, as this type is commonly useful in a
hashset

### [`v1.0.9`](https://togithub.com/dtolnay/syn/releases/tag/1.0.9)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.8...1.0.9)

- Fix failure to parse tuple struct fields of tuple type starting with
`crate` ([#&#8203;720](https://togithub.com/dtolnay/syn/issues/720),
[#&#8203;723](https://togithub.com/dtolnay/syn/issues/723), thanks
[@&#8203;mystor](https://togithub.com/mystor))
- Fix unexpected tokens being ignored when using Speculative::advance_to
([#&#8203;721](https://togithub.com/dtolnay/syn/issues/721),
[#&#8203;723](https://togithub.com/dtolnay/syn/issues/723), thanks
[@&#8203;mystor](https://togithub.com/mystor))

### [`v1.0.8`](https://togithub.com/dtolnay/syn/releases/tag/1.0.8)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.7...1.0.8)

- Require trailing comma when parsing TypeTuple with one element
([#&#8203;716](https://togithub.com/dtolnay/syn/issues/716), thanks
[@&#8203;8BitMate](https://togithub.com/8BitMate))

### [`v1.0.7`](https://togithub.com/dtolnay/syn/releases/tag/1.0.7)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.6...1.0.7)

- Add a receiver getter to syn::Signature
([#&#8203;714](https://togithub.com/dtolnay/syn/issues/714), thanks
[@&#8203;mystor](https://togithub.com/mystor))

    ```rust
    impl Signature {
/// A method's `self` receiver, such as `&self` or `self: Box<Self>`.
        pub fn receiver(&self) -> Option<&FnArg>;
    }
    ```

### [`v1.0.6`](https://togithub.com/dtolnay/syn/releases/tag/1.0.6)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.5...1.0.6)

- Add conversions from Item{Struct,Enum,Union} into DeriveInput
([#&#8203;711](https://togithub.com/dtolnay/syn/issues/711), thanks
[@&#8203;mystor](https://togithub.com/mystor))
- Add Fields::len and Fields::is_empty
([#&#8203;712](https://togithub.com/dtolnay/syn/issues/712), thanks
[@&#8203;mjbshaw](https://togithub.com/mjbshaw))

### [`v1.0.5`](https://togithub.com/dtolnay/syn/releases/tag/1.0.5)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.4...1.0.5)

- Expose syn::Variadic with just "derive" feature, not "full", because
it appears in Type::BareFn

### [`v1.0.4`](https://togithub.com/dtolnay/syn/releases/tag/1.0.4)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.3...1.0.4)

- Fix size_hint of Punctuated iterators
([#&#8203;700](https://togithub.com/dtolnay/syn/issues/700), thanks
[@&#8203;ExpHP](https://togithub.com/ExpHP))

### [`v1.0.3`](https://togithub.com/dtolnay/syn/releases/tag/1.0.3)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.2...1.0.3)

- Add
[`Path::get_ident`](https://docs.rs/syn/1.0/syn/struct.Path.html#method.get_ident)
([#&#8203;696](https://togithub.com/dtolnay/syn/issues/696), thanks
[@&#8203;infinity0](https://togithub.com/infinity0))

### [`v1.0.2`](https://togithub.com/dtolnay/syn/releases/tag/1.0.2)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.1...1.0.2)

-   Documentation improvements

### [`v1.0.1`](https://togithub.com/dtolnay/syn/releases/tag/1.0.1)

[Compare Source](https://togithub.com/dtolnay/syn/compare/1.0.0...1.0.1)

- Add
[`LitInt::base10_parse`](https://docs.rs/syn/1.0/syn/struct.LitInt.html#method.base10\_parse)
to produce error that has the right span when parsing literal digits

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://app.renovatebot.com/dashboard#github/agbrs/agb).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNS4xMC4yIiwidXBkYXRlZEluVmVyIjoiMzUuMTcuMSJ9-->
2023-03-23 22:24:36 +00:00
Gwilym Inzani 8a3660733d Add rustfmt as a component to rust-toolchain 2023-03-23 22:17:02 +00:00
GBA bot e864eb6c03 Update lockfiles 2023-03-23 22:04:22 +00:00
renovate[bot] 29c1661075
Update Rust crate syn to v2 2023-03-23 22:02:23 +00:00
Gwilym Inzani ec3e43da56 cargo fmt everywhere 2023-03-23 21:59:49 +00:00
Gwilym Inzani 85defe8e2b Add targets to format and check formatting 2023-03-23 21:59:49 +00:00
Corwin 4562c4ee17
workaround the rust issue (#397)
This works around rust-lang/rust#108853 by using an `opt-level` of `3`
rather than `s`.

- [x] Changelog updated / no changelog update needed
2023-03-23 21:59:08 +00:00
Gwilym Inzani 5ad2ad092e
Do an editing pass of the book using chatgpt (#398)
- [x] Changelog updated / no changelog update needed
2023-03-23 21:50:19 +00:00
Corwin 0127508061
fat lto to fix build :)
(not recommended as general strategy)
2023-03-23 21:40:20 +00:00
Corwin 76b3aecda0
workaround the rust issue
rust-lang/rust#108853
2023-03-23 20:47:15 +00:00
Gwilym Inzani cf8210c421 Add a section about why you would want to use agb 2023-02-25 23:05:28 +00:00
Gwilym Inzani 6a52e2be14 Improve README a little 2023-02-25 22:49:45 +00:00
Gwilym Inzani 11822e5c45 Remove references to agbrs 2023-02-25 22:39:52 +00:00
Gwilym Inzani 17a8f770ed It doesn't teach you that... 2023-02-25 22:36:32 +00:00
Gwilym Inzani 17de416efd Improve hardware section as well 2023-02-25 22:35:36 +00:00
Gwilym Inzani 12e9433b8d Further improvements 2023-02-25 22:29:06 +00:00
Gwilym Inzani d3b38d9e94 Rewrite the building step 2023-02-25 22:07:58 +00:00
Gwilym Inzani 0c6f3330aa Rewrite the introduction 2023-02-25 22:03:18 +00:00
Gwilym Inzani adeb24be4d Make the book more positive 2023-02-25 21:58:00 +00:00
Gwilym Inzani ea55278c7d
Fix 256 colours (#392)
Fixes #386.

Turns out we weren't correctly setting the 256 colour mode flag
🤦. It worked fine in affine mode because those are 256 colour
mode by default, but now it'll also work for regular backgrounds.

- [x] Changelog updated / no changelog update needed
2023-02-25 18:23:38 +00:00
Gwilym Inzani 4c6fbac41f Fix remaining issues with the new API usage 2023-02-25 18:10:54 +00:00
Gwilym Inzani eb56a4a9d2 Add a changelog entry 2023-02-24 08:56:04 +00:00
Gwilym Inzani 54311727ec Fix build errors 2023-02-24 08:55:02 +00:00
Gwilym Inzani 689bfc642f Check if the tiles passed are of the correct format 2023-02-24 08:47:45 +00:00
Gwilym Inzani c6bac34294 Make the number of colours a property of the background 2023-02-24 08:44:47 +00:00
Gwilym Inzani adad443e67
Add correct lifetimes to prevent double creation (#391)
Fixes #390 

- [x] Changelog updated / no changelog update needed
2023-02-23 22:17:58 +00:00
Gwilym Kuiper 152f96e953 Consistently use 'gba 2023-02-23 21:22:53 +00:00
Gwilym Kuiper 33c65474de Add changelog entry 2023-02-23 21:20:51 +00:00
Gwilym Kuiper b90a5829b8 Fix the games 2023-02-23 21:18:29 +00:00
Gwilym Kuiper 92066f7adb Add lifetimes to timers 2023-02-23 20:46:28 +00:00
Gwilym Kuiper 2bab48b422 Add lifetimes to the mixer 2023-02-23 20:44:20 +00:00
Gwilym Kuiper 5ac408d414 Do all the video modes 2023-02-23 20:42:48 +00:00
Gwilym Kuiper ce5641f5ef Add correct lifetimes for Blend 2023-02-23 20:39:23 +00:00
Gwilym Kuiper 9757f7ed54 Add correct lifetimes to windows 2023-02-23 20:37:03 +00:00
Gwilym Kuiper 0eec7e366c Add lifetimes to ObjectController 2023-02-23 20:36:00 +00:00
Gwilym Kuiper c4fac5a779
Fix clippy lints again (#388)
Fixes a bunch of clippy lints and updates edition to 2021

- [x] Changelog updated / no changelog update needed
2023-02-07 20:44:45 +00:00
Gwilym Kuiper aeca26bdef Add changelog entry for 2021 2023-02-07 20:33:25 +00:00
Gwilym Kuiper 97dec32fa2 Fix all the clippy lints 2023-02-07 20:32:43 +00:00
Gwilym Kuiper 33dafd29c2 Update everything to 2021 2023-02-07 20:32:35 +00:00
Corwin f293f8c48d
make vector2d new const (#383) 2023-01-29 19:15:14 +00:00
Corwin 650702ed4e modify changelog 2023-01-29 19:06:00 +00:00
Corwin f0dd544394 make vector2d new const 2023-01-29 19:04:25 +00:00
Gwilym Kuiper 64bd1ad7dd
Fix landing 1 pixel above the ground in purple night (#381)
- [x] Changelog updated / no changelog update needed
2023-01-26 21:04:32 +00:00
Gwilym Kuiper 0e1843bf6c
Update Rust crate toml_edit to 0.18 (#379)
[![Mend
Renovate](https://app.renovatebot.com/images/banner.svg)](https://renovatebot.com)

This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [toml_edit](https://togithub.com/ordian/toml_edit) | dependencies |
minor | `0.17` -> `0.18` |

---

### Release Notes

<details>
<summary>ordian/toml_edit</summary>

###
[`v0.18.0`](https://togithub.com/ordian/toml_edit/compare/v0.17.1...v0.18.0)

[Compare
Source](https://togithub.com/ordian/toml_edit/compare/v0.17.1...v0.18.0)

###
[`v0.17.1`](https://togithub.com/ordian/toml_edit/compare/v0.17.0...v0.17.1)

[Compare
Source](https://togithub.com/ordian/toml_edit/compare/v0.17.0...v0.17.1)

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Mend
Renovate](https://www.mend.io/free-developer-tools/renovate/). View
repository job log
[here](https://app.renovatebot.com/dashboard#github/agbrs/agb).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzNC4xMDkuMSIsInVwZGF0ZWRJblZlciI6IjM0LjEwOS4xIn0=-->
2023-01-26 20:56:04 +00:00
Gwilym Kuiper b0314f69c5 Fix landing 1 pixel above the ground in purple night 2023-01-26 20:52:54 +00:00