README
¶
- version-manager(vm)
- features
- vm versus vfox
- Installation/Update
- How to set a proxy?
- Subcommands
- Related dirs
- For Windows
- Contributors
- Supplementary
- Todo-List
version-manager(vm)
vm is a simple, cross-platform, and well-tested version manager for programming languages and tools. It is totally created for general purpose. You don't need any plugins, but just vm. Then everything can be managed.
Maybe you've already heard of fnm, sdkman, gvm, nvm, pyenv, phpenv, etc. However, none of them can manage multiple programming languages. Managers like asdf-vm support multiple languages, but only works on unix-like systems, and makes things look complicated. Therefore, vm comes.
features
- Installs or uninstalls versions of sdk.
- Swithes between versions of sdk.
- Using a version only in current terminal session is supported. See with command vm use -h.
- Handles envs.
- Friendly to VSCoders or Neovimers.
- Downloads files blazingly fast🚀🚀🚀 with multi-threads. See with command vm use -h.
- Auto-completions for shells. See with command vm completion -h.
- Generates command "use sdk-name@version" automatically using selected item from version list, and add the command to clipboard for later usage.
- No plugins needed.
- More stable.
vm versus vfox
| sdk | vm | vfox |
|---|---|---|
| java(jdk) | ✅︎ | ✅︎ |
| maven | ✅︎ | ✅︎ |
| gradle | ✅︎ | ✅︎ |
| kotlin | ✅︎ | ✅︎ |
| scala | ✅︎ | ✅︎ |
| groovy | ✅︎ | ✅︎ |
| python | ✅︎ | ✅︎ |
| pypy | ✅︎ | ❌︎ |
| miniconda | ✅︎ | ❌︎ |
| go | ✅︎ | ✅︎ |
| node | ✅︎ | ✅︎ |
| deno | ✅︎ | ✅︎ |
| bun | ✅︎ | ❌︎ |
| flutter(dart) | ✅︎ | ✅︎ |
| .net | ✅︎ | ✅︎ |
| zig | ✅︎ | ✅︎ |
| zls | ✅︎ | ❌︎ |
| php | ✅︎ | ✅︎ |
| rust | ✅︎ | ❌︎ |
| cmdline-tool(android) | ✅︎ | ❌︎ |
| vlang | ✅︎ | ❌︎ |
| v-analyzer | ✅︎ | ❌︎ |
| cygwin-installer | ✅︎ | ❌︎ |
| msys2-installer | ✅︎ | ❌︎ |
| julia | ✅︎ | ❌︎ |
| typst | ✅︎ | ❌︎ |
| typst-lsp | ✅︎ | ❌︎ |
| typst-preview | ✅︎ | ❌︎ |
| gleam | ✅︎ | ❌︎ |
| git-for-windows | ✅︎ | ❌︎ |
| neovim | ✅︎ | ❌︎ |
| vscode | ✅︎ | ❌︎ |
| protobuf(protoc) | ✅︎ | ❌︎ |
| lazygit | ✅︎ | ❌︎ |
| kubectl | ✅︎ | ❌︎ |
| acast(asciinema) | ✅︎ | ❌︎ |
| erlang(need compilation) | ❌︎ | ✅︎ |
| elixir(need compilation) | ❌︎ | ✅︎ |
Installation/Update
- for MacOS/Linux(run the command below in terminal)
curl --proto '=https' --tlsv1.2 -sSf https://gvc.1710717.xyz/proxy/https://raw.githubusercontent.com/gvcgo/version-manager/main/scripts/install.sh | sh
- for Windows(run the command below in powershell)
powershell -nop -c "iex(New-Object Net.WebClient).DownloadString('https://gvc.1710717.xyz/proxy/https://raw.githubusercontent.com/gvcgo/version-manager/main/scripts/install.ps1')"
- Manual installation
1. Download zip file from release.
2. Unzip it, run command "vm is".
How to set a proxy?
Choose either proxy or reverse-proxy.
- proxy
vm set-proxy <http://localhost:port or socks5://localhost:port>
- reverse-proxy
# reverse proxy <https://gvc.1710717.xyz/proxy/> is available for free.
vm set-reverse-proxy https://gvc.1710717.xyz/proxy/
- enable downloading from mirror sites in China.
vm use -mirror-in-china go@1.22.1
Subcommands
| subcommand | args | desc |
|---|---|---|
| list | - | Shows what's supported. |
| search | sdk-name | Shows available versions for a sdk. |
| use | sdk-name@version | Installs/Swithes to the specific version of a sdk. |
| local | sdk-name | Shows installed versions of a sdk. |
| uninstall | sdk-name@version or sdk-name@all | Uninstalls versions for a sdk. |
| clear-cache | sdk-name | Clears the cached files for a sdk. |
| set-reverse-proxy | https://gvc.1710717.xyz/proxy/ | Sets a reverse-proxy for vm. |
| set-proxy | http or socks5( scheme://host:port ) | Sets a local proxy for vm. |
| env | --remove=false/true | Sets/Removes env manually. |
| install-self | - | Installs vm. |
| version | - | Shows version info of vm. |
| completion | - | Generate the autocompletion script for for the specified shell.(bash, zsh, fish, or powershell) |
demo for MacOS
demo for Windows
demo for linux
Related dirs
- vm installation dir
$HOME/.vm/
- application installation dir
Specified during installation of vm.
~ % ./vm install-self
Enter App Installation Dir["$Home/.vm/" by default]:
/Users/moqsien/.vm
For Windows
Note: If you are using vm on Windows11, you need to enable the Developer Mode as vm requires to create symbolic links. If you're on Windows10, and any creating-symbolic-links-failure occurrs, you can try vm with Admin Privilege. To get envs take effect for windows, you may need to close the current powershell terminal and open a new one. Note that extFAT and FAT32 are not supported.
Contributors
Thanks to the following people who have contributed to this project.
Supplementary
vm is created to be a cross-platform command line tool. We will not try to include everything just like asdf-vm or its imitator vfox did, as that will greatly increase the complexity and also reduce the possibility of cross-platform. And most of the time, frequently used SDKs and tools have already been covered by vm. vm will not try to include SDKs that need to be compiled under a certain platform. Because each developer's development environment is different, it is impossible to ensure the completion of a compilation. So vm will only use pre-built binaries for installations. If you have any SDKs or tools to recommand for version management, please raise an issue in Issues.
So, vm is going to keep as lightweight, stable, and user-friendly as possible.
Todo-List
- To manage package repo mirror sites in China.
Documentation
¶
There is no documentation for this package.
Source Files
Directories