glast

glast is a crate for parsing and manipulating glsl abstract syntax trees, and a lot more.

⚠ This crate is still heavily work-in-progress.

The aims of this crate are to allow for parsing and analysis of the OpenGL Shading Language. This includes parsing source strings into ASTs, generating file formatting and syntax highlighting information, as well as performing analysis such as name resolution and type checking.

Unlike other similar crates and libraries, glast is designed to be 100% specification compliant. That means it correctly handles complex behaviours such as macro expansion and conditional compilation, even under some extremely unusual edge-cases.

glast is also made for IDEs in mind, meaning it handles syntax errors gracefully and has excellent error recovery strategies to produce "best effort" results. It also produces syntax and semantic diagnostics, as well as information for syntax highlighting purposes.

Current status

Lexer

[1]: Minor discrepancy that would almost never be hit. See Issue#4.

Parser

[2]: Only GLSL 450 & 460 are currently supported.

[3]: Not enough tests to validate with great certainty.

Analyzer

❌ Work not started yet.

License

This project is licensed under the MIT license - see LICENSE for details.