Macro for parsing KCL at Rust compile-time

[adamchalmers]

This adds a new parse_kcl! macro which takes a string as input. It parses the string into KCL source code at compile-time. Invalid KCL will make your Rust project fail to compile.

Here's an example of how to use it:

extern crate alloc; 
use kcl_compile_macro::parse_kcl;

let ast: kcl_lib::ast::types::Program = parse_kcl!("const y = 4");

The extern crate alloc is an external crate included with Rust in the standard distribution -- it's not a third-party crate, so you don't need to add it to Cargo.toml or anything.

Closes #1018

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
modeling-app	✅ Ready (Inspect)	Visit Preview	Nov 10, 2023 4:24pm

[lf94]

Might want to switch the naming for the future of adding more kcl macros: kcl_parse!, kcl_execute!, etc

[adamchalmers]

Renamed to kcl_macros::parse! I expect we'll re-export it from the kcl library so it would become kcl::parse!