35 releases

0.4.4 Mar 19, 2024
0.4.2 Jan 4, 2024
0.4.1 Dec 21, 2023
0.3.5 Nov 30, 2023
0.1.0 Nov 20, 2022

#34 in Emulators

Download history 7/week @ 2023-12-04 2/week @ 2023-12-18 10/week @ 2024-01-01 2/week @ 2024-02-05 220/week @ 2024-02-12 3/week @ 2024-02-19 14/week @ 2024-02-26 16/week @ 2024-03-11 141/week @ 2024-03-18

171 downloads per month

MIT/Apache

710KB
13K SLoC

codecov

NetsBlox is a browser-based visual programming environment (based on Snap!) that extends the typical block-based programming features with internet and distributed computing tools such as RPCs (remote procedure calls) that access network resources (e.g., databases or web APIs), and message passing between projects over the internet.

netsblox-vm is a native Rust implementation of the NetsBlox code execution engine and runtime. This makes it possible to execute NetsBlox program code at blistering speeds on any device targeted by the Rust compiler. But more importantly, netsblox-vm has several extension APIs which make it possible to extend its features with new hardware peripheral access capabilities (e.g., controlling sensors and actuators through GPIO), all with safe, native Rust.

Features

netsblox-vm contains the following feature flags.

name default description
std on Enables the std crate dependency and access to a number of helper types that depend on the standard library
std-system on Enables the std feature flag and also the StdSystem implementation of System
cli on Enables the std-system feature flag and additionally gives access to the cli submodule, which gives API access to the standard CLI rather than having to write a CLI from scratch
serde on Enables serialization of some types
native-tls on Enables the native-tls feature for TLS-capable dependencies (only used if std-system is also enabled)
native-tls-vendored off Enables the native-tls-vendored feature for TLS-capable dependencies (only used if std-system is also enabled)
rustls-tls-native-roots off Enables the rustls-tls-native-roots feature for TLS-capable dependencies (only used if std-system is also enabled)
rustls-tls-webpki-roots off Enables the rustls-tls-webpki-roots feature for TLS-capable dependencies (only used if std-system is also enabled)

Note that if std-system is enabled, one of the TLS feature flags must also be enabled in order to connect to the NetsBlox server with StdSystem. The native-tls feature is enabled by default to support this on common desktop and server environments; however you may need to disable default features and explicitly opt into a different TLS option for other targets (e.g., Android or iOS).

no-std

netsblox-vm supports building in no-std environments by disabling the default std feature flag. However, the alloc crate is still required in this case.

[dependencies]
netsblox_vm = { version = "...", default-features = false }

Note that this precludes access to StdSystem, meaning a new implementation of System would be required for your target platform. If your target platform supports the standard library but not standard networking crates (e.g., esp32), you may use the std feature flag without the std-system feature flag, which will aid in creating a custom implementation of System.

Example

Some boilerplate code is required for using this crate to implement a fully-capable, isolated system. An example CLI program with basic stdout printing features is available here. Note that your dependencies should include both this crate, as well as the specific version of gc-arena used by this crate (or else any derived Collect implementations will be incompatible).

CLI Installation

This crate includes a binary called nb which serves as a shallow wrapper for the cli API with a default suite of syscall extensions. Note: if you need to create your own syscall extensions, you must do so in a separate binary using this crate as a dependency.

cargo install netsblox-vm

Dependencies

~4–22MB
~321K SLoC