pest is a general purpose parser written in Rust with a focus on accessibility, correctness, and performance. It uses parsing expression grammars (or PEG) as input, which are similar in spirit to regular expressions, but which offer the enhanced expressivity needed to parse complex languages.
The recommended way to start parsing with pest is to read the official book.
Other helpful resources:
- API reference on docs.rs
- play with grammars and share them on our fiddle
- find previous common questions answered or ask questions on GitHub Discussions
- leave feedback, ask questions, or greet us on Gitter or Discord
The pest-parser GitHub organization hosts several repositories. The main one is naturally pest where you can find the source code of main pest-related crates.
The pest.rs website is spanned across two repositories:
- book contains the source code for building the book on pest.rs.
- site contains the source code for bundling the book with the rest of the website source code (both the playground and the homepage)
There are two tooling-related pest crates:
- pest-fmt can help to format pest grammars (try it online).
- ast can help to reduce boilerplate when converting pest parse trees to abstract syntax trees (BTW the pest_consume crate can also help with the parse tree traversing boilerplate).
- tree-sitter-pest Pest grammar for the tree-sitter.
There are editor plugins for pest:
- pest.vim can do syntax highlighting of pest grammars in Vim.
- intellij-pest can do syntax highlighting, completion, refactoring (renaming, extracting rules, inlining) in IntelliJ editors, such as IDEA or CLion, of pest grammars in both external files and in ones embedded in Rust.
- vscode-pest Pest support for VS Code, via the LSP.
- zed-pest Pest support for Zed.
Finally, pest3 contains an unfinished effort of pest 3.0 that is stalled for now. You can follow the future progress on this milestone here: feel free to comment on its issues or open a discussion thread.
You can find more projects and ecosystem tools in the awesome-pest repo.
- pest_meta (bootstrapped)
- AshPaper
- brain
- cicada
- comrak
- elastic-rs
- graphql-parser
- handlebars-rust
- hexdino
- Huia
- insta
- jql
- json5-rs
- mt940
- Myoxine
- py_literal
- rouler
- RuSh
- rs_pbrt
- stache
- tera
- ui_gen
- ukhasnet-parser
- ZoKrates
- Vector
- AutoCorrect
- yaml-peg
- qubit
- caith (a dice roller crate)
- Melody