5 releases
0.7.0 | Aug 3, 2024 |
---|---|
0.6.3 | Jul 17, 2024 |
0.6.2 | Jul 16, 2024 |
0.6.1 | Jul 12, 2024 |
0.6.0 | Jul 11, 2024 |
#297 in Cargo plugins
161 downloads per month
35KB
698 lines
cargo-v5
Build, upload, run, and simulate Rust projects written for VEX!
cargo-v5 is a command line tool that simplifies working with VEX projects written in Rust (with a focus on the vexide runtime).
Install
cargo install cargo-v5
Usage
Build a vexide project for the V5's platform target:
cargo v5 build --release
Upload a vexide project over USB (you may be prompted to provide a slot number):
cargo v5 upload
View serial output from the current user program:
cargo v5 terminal
Configuration
Upload behavior can be configured through either your Cargo.toml
file or by providing arguments to cargo-v5
.
cargo-v5
will attempt to find Cargo.toml
files with the following structure for providing defaults to some upload options.
[package.metadata.v5]
slot = 1
icon = "cool-x"
compress = true
Properties
package.metadata.v5.slot
(integer): Set the default program slot to upload to.package.metadata.v5.icon
(string) (default"question-mark"
): Set the default program icon. (seecargo v5 upload -h
for a list of icon strings)package.metadata.v5.compress
(boolean) (defaulttrue
): Configure if program binaries should be gzipped before uploading. It is strongly recommended to keep this at default (true
), as disabling compression will greatly increase upload times.
cargo-v5
will also use your project's package.name
and package.description
fields for program name/description if nothing is explicitly provided.
For a full list of arguments, check
cargo v5 help
Dependencies
~13–24MB
~334K SLoC