vbscript

Rust VBScript lexer and parser

2 unstable releases

0.2.0 May 27, 2024
0.1.0 May 17, 2024

MIT license

260KB
7K SLoC

vbscript.rs

Rust VBScript lexer and parser

https://crates.io/crates/vbscript

Documentation

https://docs.rs/vpin

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

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