https://github.com/sam0x17/sin
Sin aims to be an alternative to the proc-macro2/syn ecosystem geared towards developer UX and custom syntax parsing.
https://github.com/sam0x17/sin
Last synced: 8 months ago
JSON representation
Sin aims to be an alternative to the proc-macro2/syn ecosystem geared towards developer UX and custom syntax parsing.
- Host: GitHub
- URL: https://github.com/sam0x17/sin
- Owner: sam0x17
- Created: 2023-06-02T15:56:28.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-10-23T07:23:23.000Z (about 2 years ago)
- Last Synced: 2025-05-07T03:08:27.993Z (8 months ago)
- Language: Rust
- Size: 194 KB
- Stars: 5
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Sin
Sin (a perversion of dtolnay's [syn](https://crates.io/crates/syn) crate), aims to be a
compatible (via optional features), friendly alternative to the
[proc-macro2](https://crates.io/crates/proc-macro2) / [syn](https://crates.io/crates/syn) /
[quote](https://crates.io/crates/quote) ecosystem. The goal of sin is to provide all of the
same features, but without some of the limitations of `syn`. For example, `sin::parse` will be
implemented for _all_ underlying sin types without the need for awkward situational macros such
as `parenthesized!`, `parse_inner`, etc., and implementing `sin::parse` will require
implementing sin's equivalent of `quote::ToTokens`, meaning anything in the sin ecosystem that
can be parsed can also be turned back into tokens automatically. Compatibility with the
`proc-macro2` ecosystem will also be provided via feature-gated `From` and
`To` implementations.
Where the `proc-macro2`/`syn` ecosystem aims to provide accurate+complete parsing of valid Rust
syntax, including complex structures like functions, impl blocks, etc, sin aims to maximize the
developer UX to make syntax parsing a joy, while at the same time catering to those who wish to
parse arbitrary syntax that may not necessarily be valid Rust code. Thus sin aims to be the
tool you reach for when you want to define and parse _custom syntax_ in Rust proc and attribute
macros, including implementing support for non-Rust grammars.
Sin is a work in progress. The first usable version will be 0.1.0.