Skip to content

dragazo/netsblox-ast

Repository files navigation

NetsBlox-AST

For the time being, this crate is in active development and its API is highly unstable

NetsBlox is a block-based programming language (extended from Snap!) which provides access to advanced web and distributed computing capabilities such as accessing web APIs and sending messages between clients (e.g. to create multi-user programs). NetsBlox-AST is a rust crate that takes as input a NetsBlox project XML file and outputs a sanitized Abstract Syntax Tree, which is useful for code generation.

Development

This crate is intended to be used directly on some embedded platforms. Thus, because the parser is recursive, we need to keep the stack size to an absolute minimum. To do this, we use cargo-call-stack to check call stack usage.

For the time being, you should install from this fork.

You'll also need dot from graphviz.

sudo apt install graphviz

To generate the call graph, run the following commands:

RUSTFLAGS="-C embed-bitcode" cargo +nightly call-stack --bin netsblox_ast --target x86_64-unknown-linux-gnu >cg.dot
gawk 'match($0, /label="(.*)\\nmax >?= ([0-9]+)\\nlocal = ([0-9]+)"/, m) { print m[3] " " m[1] }' cg.dot | sort -n

Optionally you can generate a visual graph, but this is likely VERY cluttered:

dot -Tsvg cg.dot >cg.svg

About

A rust crate for parsing/sanitizing NetsBlox projects into AST for code generation

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
license-apache.txt
MIT
license-mit.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published