8 releases

0.1.8 Oct 10, 2023
0.1.7 Sep 6, 2023
0.1.6 May 9, 2023
0.1.5 Mar 21, 2023
0.1.2 Nov 14, 2022

#227 in Procedural macros

Download history 86593/week @ 2023-12-06 94189/week @ 2023-12-13 79593/week @ 2023-12-20 69940/week @ 2023-12-27 113328/week @ 2024-01-03 119618/week @ 2024-01-10 138379/week @ 2024-01-17 144980/week @ 2024-01-24 161250/week @ 2024-01-31 142877/week @ 2024-02-07 144743/week @ 2024-02-14 159097/week @ 2024-02-21 176867/week @ 2024-02-28 184076/week @ 2024-03-06 190190/week @ 2024-03-13 150546/week @ 2024-03-20

734,695 downloads per month
Used in 627 crates (6 directly)

MIT/Apache

17KB
302 lines

A simple crate for reducing the boilerplate when writing parsers with syn.

Structs

#[derive(Clone, Debug, syn_derive::Parse, syn_derive::ToTokens)]
struct ExampleStruct {
	#[parse(Attribute::parse_outer)]
	#[to_tokens(|tokens, val| tokens.append_all(val))]
	attrs: Vec<Attribute>,

	path: Path,

	#[syn(parenthesized)]
	paren_token: Paren,

	#[syn(in = brace_token)]
	#[parse(Punctuated::parse_terminated)]
	args: Punctuated<Box<Expr>, Token![,]>,

	semi_token: Token![;],
}

[syn(parenthesized)], [syn(braced)], [syn(bracketed)]: Corresponds to the isonymous macros in syn. Must be attached to Paren, Brace, and Bracket fields, respectively.

#[syn(in = Ident)]: The field is read from inside the named delimiter pair.

#[parse(fn(ParseStream) -> syn::Result<T>)]: A function used to parse the field, often used with Punctuated::parse_terminated or Attribute::parse_outer.

#[to_tokens(fn(&mut TokenStream, &T)]: A function used to tokenize the field. Often used with TokenStreamExt::append_all, though for type resolution reasons this needs to be indirected through a closure expression.

Enums

#[derive(Clone, Debug, syn_derive::Parse, syn_derive::ToTokens)]
enum ExampleEnum {
	#[parse(peek = Token![struct])]
	Struct(ItemStruct),
	#[parse(peek = Token![enum])]
	Enum(ItemEnum),

	Other {
		path: Path,
		semi_token: Token![;],
	}
}

#[parse(prefix = fn(ParseStream) -> syn::Result<_>)]: A prefix used for all branches, before doing the peeking. Useful when all branches support attributes, for example. The return value is ignored, which gives somewhat suboptimal performance, since the prefix is parsed twice.

#[parse(peek = Token)]: Checks whether the variant should be parsed. Even if multiple peeks succeed, only the first successful variant is attempted.

#[parse(peek_func = fn(ParseStream) -> bool)]: More powerful than peek (such as allowing peek2), but gives worse error messages on failure. peek should be preferred when possible.

Feature flags

  • full (enabled by default): enables syn/full, which is needed to parse complex expressions — such as closures — in attribute values. Without this, you can still use for example paths to functions, but this is much less convenient.

Alternatives

  • derive-syn-parse does not handle ToTokens. It also seems to encourage throwing tokens away with its prefix and postfix attributes.
  • parsel uses its own types for parentheses, meaning the AST types have different API from syn's own.

Dependencies

~0.4–0.8MB
~19K SLoC