Awesome
Bum - Bun Version Manager
<img src=".docs/new-logo.jpg" height="auto" width="150" style="border-radius:50%"> <br/> <div style="display: flex; gap: 1; align-items: center;"> <a href="https://github.com/owenizedd/bum/actions/workflows/deploy.yml"><img alt="GitHub CI Status" src="https://img.shields.io/github/actions/workflow/status/owenizedd/bum/deploy.yml?label=CI&logo=GitHub"></a> <img src="https://img.shields.io/badge/Made%20with-Rust-orange?style=for-the-badge&logo=Rust" height="20px"> </div> <br/> Introducing Bum, a fast Bun version manager written in Rust from scratch. <img src=".docs/bum-quick-demo.gif" width="600">How to install:
Unix
- Open your terminal and execute:
curl -fsSL https://github.com/owenizedd/bum/raw/main/install.sh | bash
This installation will install bun for you and also bum altogether.
Windows
I only own a Mac, so I can't test at all if Windows is working, and I can't write a script to auto-install on Windows as well. So here are a few instructions on how to install Bum for Windows:
- Install Bun
- Download the last exe in the latest release, and unzip it
- Put the exe in your favorite directory, add the path to this directory in your PATH, and that's it!
As Bum is not tested at all on Windows, it may not works. If it's the case please open an issue and I'll be glad to fix it.
How to use:
- You can just run
bum
without any parameter to see default help menu.
Commands
-
bum use <version>
- Change the current active bun version, e.g.
bum use 1.0.3
. This will automatically use v1.0.3. - If there's no target version is installed in the local, it will install that version then use it.
- Else, it will just use that version directly as the active version.
- Change the current active bun version, e.g.
-
bum remove <version>
- Remove the installed version locally.
This feature will only remove local copy, but if you're using the removed version, you will still be able to use that version, but once you change to other version, you will not be able to change to that version anymore.
- In the future we will automatically switch to the latest version available upon removal of the version.
- Remove the installed version locally.
-
bum list
- Show all local installed versions of Bun.
-
bum list-remote
- Show all remote versions of Bun that could be installed.
-
.bumrc file
- When file exists, everytime you use
bum use
command without<version>
argument, Bum will try to use the version from the .bumrc file.
- When file exists, everytime you use
Future features (possibly)
bum default <version>
Any contribution is appreciated, have any doubts/questions/suggestions/ideas? Drop them in the Discussion page.