2 unstable releases
0.2.0 | May 27, 2024 |
---|---|
0.1.0 | May 17, 2024 |
260KB
7K
SLoC
vbscript.rs
Rust VBScript lexer and parser
https://crates.io/crates/vbscript
Documentation
Example code
Check the examples folder
Rationale
On October 2023 Microsoft deprecated VBScript. However, there are still many legacy systems that use it. This project aims to provide a lexer, parser and later interpreter for VBScript, so that it can be used in Rust projects.
A timeline is available at the Windows IT Pro Blog.
Projects using vbscript.rs
https://github.com/francisdb/vbsfmt
Other links
-
The wine project has a similar lexer/parser/interpreter in C, but it's COM based and not very easy to use as a library: https://gitlab.winehq.org/wine/wine/-/tree/master/dlls/vbscript
-
Vbsedit VBScript help: https://www.vbsedit.com/html/1c457e66-a6b2-4545-b2dd-33a59d8661e8.asp
-
Vbsedit Example vbs files: https://www.vbsedit.com/scripts/default.asp
-
vpx-js vbscript bnf grammar https://github.com/vpdb/vpx-js/blob/master/lib/scripting/grammar/grammar.bnf
-
wine vbscript bison grammar https://gitlab.winehq.org/wine/wine/-/blob/master/dlls/vbscript/parser.y
-
MS VBScript Language Reference https://docs.microsoft.com/en-us/previous-versions/t0aew7h6(v=vs.85)
Running the integration tests
Make sure you populate the testsctipts
folder, feel free to add more vbs files to the folder.
./testsctipts/populate.sh
Run the tests. They will also be included in the default cargo test
run.
RUST_BACKTRACE=1 cargo test -- --nocapture try_lexing_all_vbs_files
RUST_BACKTRACE=1 cargo test -- --nocapture try_parsing_all_vbs_files
Running the benchmarks
To run this benchmark, use the following command:
cargo bench
Making a release
We use https://github.com/MarcoIeni/release-plz which creates a release pr on every commit to master
Attributions
Thanks go to Domenic Quirl for his excellent blog post on parsing basics. This project was started from his blog post, you can find it here: https://domenicquirl.github.io/blog/parsing-basics/ https://github.com/domenicquirl/blog/tree/master/parsing-basics
Dependencies
~1.5MB