8 releases
0.1.1 | Aug 1, 2024 |
---|---|
0.1.0 | Jul 25, 2024 |
0.0.0 | Jul 15, 2024 |
#673 in Development tools
120 downloads per month
58KB
1.5K
SLoC
moonup
Manage multiple MoonBit installations
Getting Started
If you have the Rust toolchain installed, you can install moonup easily with Cargo:
cargo install moonup
Or you may download the latest release from GitHub releases,
manuallly extract the archive and put the executables in a directory that is in your PATH
.
After installation, run moonup help
to see the available commands.
$ moonup help
Moonup is a tool to manage multiple MoonBit installations.
If you find any bugs or have a feature request, please open an issue on
GitHub: https://github.com/chawyehsu/moonup/issues
Usage: moonup [OPTIONS] <COMMAND>
Commands:
completions Generate shell completions
default Set the default toolchain
install Install or update a MoonBit toolchain [aliases: i]
pin Pin the MoonBit toolchain to a specific version
run Run a command with a specific toolchain
show Show installed and currently active toolchains
update Update MoonBit latest toolchain and moonup [aliases: u]
which Show the actual binary that will be run for a given command
help Print this message or the help of the given subcommand(s)
Options:
-v, --verbose... Increase logging verbosity
-q, --quiet... Decrease logging verbosity
-h, --help Print help
-V, --version Print version
How It Works
Moonup allows you to install multiple MoonBit toolchains and switch between
them easily. All MoonBit toolchains (with the core standard library) are
installed in Moonup's toolchains
directory.
Moonup creates shim executables that replace the original MoonBit executables in the PATH. When you run a MoonBit command, the shim executable determines which MoonBit toolchain to use and proxies the command to the actual MoonBit executable in the desired toolchain.
With this approach, you can switch between MoonBit toolchains across projects easily without needing to change the PATH.
MoonBit Releases
Moonup downloads MoonBit releases from chawyehsu/moonbit-binaries, which is powered by GitHub Actions and archives MoonBit releases continuously from the official website.
Known Limitations
- Isolation of MoonBit core standard library is problematic, see #7.
Development
Prerequisites: Git, Rust
# clone the repo
git clone https://github.com/chawyehsu/moonup
cd moonup
# build
cargo build
# run and test
cargo run -- help
0.1.0 Roadmap
- An
install
command to install multiple MoonBit toolchains - A
pin
command to pin toolchain to a specific version in a project - Create shim executables to switch between toolchains automatically
- A
default
command to set the default toolchain - A
show
command to show installed and currently active toolchains - A
which
command to show the actual binary that will be run for a given command - A
run
command to run a command with a specific toolchain - A
update
command to self-update and update the toolchain - A
completions
command to generate shell completions
License
moonup © Chawye Hsu. Released under the Apache-2.0 license.
Blog · GitHub @chawyehsu · Twitter @chawyehsu
Dependencies
~26–42MB
~702K SLoC