This crate is a GLSL450/GLSL460 compiler. It’s able to parse valid GLSL formatted source into
an abstract syntax tree (AST). That AST can then be transformed into SPIR-V, your own format or
even folded back to a raw GLSL [String] (think of a minifier, for instance).
You’ll find several modules:
parser], which exports the parsing interface.syntax], which exports the AST and language definitions.transpiler], which provides you with GLSL transpilers.visitor, which gives you a way to visit AST nodes and mutate them, both with inner and
outer mutation.Feel free to inspect those modules for further information.
Basically, the [Parse] trait gives you all you need to start parsing. This crate is designed
around the concept of type-driven parsing: parsers are hidden and you just have to state what
result type you expect.
The most common type you want to parse to is [TranslationUnit], which represents a set of
[ExternalDeclaration]s. An [ExternalDeclaration] is just a declaration at the top-most level
of a shader. It can be a global, uniform declarations, vertex attributes, a function, a
structure, etc.
The crate is also getting more and more combinators and functions to transform the AST or create
nodes with regular Rust. The [Visitor] trait will be a great friend of yours when you will
want to cope with deep mutation, filtering and validation.
This crate can parse both GLSL450 and GLSL460 formatted input sources. At the language level, the difference between GLSL450 and GLSL460 is pretty much nothing, so both cases are covered.
If you’re wondering, the only difference between both versions is that in GLSL460, it’s authorized to have semicolons (
;) on empty lines at top-level in a shader.