Skip to content
/ dvm Public

Deno Version Manager (DVM) - A lightweight, and powerful Deno Version Manager for MacOS, Linux, WSL, and Windows with Bash.

License

Notifications You must be signed in to change notification settings

ghosind/dvm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DVM - Deno Version Manager

test lint Codacy Badge Version Badge License Badge

English | 简体中文

Dvm is a lightweight, and powerful Deno version manager for MacOS, Linux, WSL, and Windows with Bash.

For Windows users, you must install DVM v0.7.0 or later versions, and also need to install a bash shell if you want to use this tool. For example, you can install WSL and execute bash command in PowerShell.

Please do not use deno upgrade command to upgrade Deno after you had installed Deno with DVM.

Installing and Updating

Installation

There are two ways to install DVM.

  1. Install dvm from network by the following command:
curl -o- "https://raw.githubusercontent.com/ghosind/dvm/master/install.sh" | bash

For Chinese user, you can also install it from Gitee by the following command:

curl -o- "https://gitee.com/ghosind/dvm/raw/master/install.sh" | DVM_SOURCE=gitee bash
  1. Clone this project and execute install.sh script:
git clone "https://github.com/ghosind/dvm.git"
# you can also clone it from gitee
# git clone "https://gitee.com/ghosind/dvm.git"
cd dvm
./install.sh

After installed dvm, please restart your terminal or use source <your_rc_file> to apply changes.

The default install location is ~/.dvm, you can use -d <dir> option (for local install only) or $DVM_DIR environment variable to specify an inexistent directory as the install location.

curl -o- "https://raw.githubusercontent.com/ghosind/dvm/master/install.sh" | DVM_DIR=~/deno/dvm bash
./install.sh -d ~/deno/dvm

Upgrade DVM

Since DVM v0.3.0, we provided upgrade command to update your DVM to the latest version.

dvm upgrade

If you want to update the DVM that less than v0.3.0, you may need to uninstall the current version and re-install the latest version. You can get the uninstall steps from Manual uninstall section.

Prerequirement

Please make sure you have required dependencies installed:

  • curl
  • git
  • unzip (for Deno v0.36.0 and newer versions)
  • gunzip (for Deno v0.35.0 and lower versions)

For installing Deno from source, please make sure you have required dependencies installed:

  • rustc
  • cargo
  • cc
  • cmake

Getting Started

After installed dvm, you can use it to manage multiple version Deno environments.

List available versions

Use dvm list-remote or dvm ls-remote to list all available versions from remote.

# list all available versions
dvm list-remote
# ls-remote is an alias for list-remote command
dvm ls-remote

List installed versions

Use dvm list or dvm ls to list all installed versions.

# list all installed versions
dvm list
# ls command is an alias for list command
dvm ls

Install Deno

Use dvm install <version> command to download and install a specified version from the source.

dvm install v1.0.0
# deno v1.0.0 has installed.
# Using deno v1.0.0 now.

dvm install v0.42.0
# deno v0.42.0 has installed.
# Using deno v1.0.0 now.

Install Deno from source

Since DVM v0.8.0, you can install Deno from source with --from-source option.

dvm install --from-source v1.35.0

Uninstall Deno

Use dvm uninstall <version|alias-name> command to uninstall a specified version.

dvm uninstall v0.39.0
# uninstalled deno v0.39.0.

# default is an alias name
dvm uninstall default
# uninstalled deno default.

Set active version

Use dvm use [version] command to link deno to the specified installed version by parameter or .dvmrc file.

# use v1.0.0
dvm use v1.0.0
# Using deno v1.0.0 now.

If you do not specify the active version, DVM will try to read .dvmrc file from the current working directory.

# cat .dvmrc
# # v1.4.0
dvm use
# Found './dvmrc' with version v1.4.0
# Using deno v1.4.0 now.

Set active version by use command is for a single terminal session only. If you want to set an active version for all terminal sessions, please set a default alias to a version. See Set an alias section for more details.

Get current version

Use dvm current command to display the current version of Deno.

dvm current
# v1.0.0

Set an alias

Use dvm alias command to set alias name for a installed version of Deno.

dvm ls
#    v1.0.0

# Set an alias
dvm alias default v1.0.0
# default -> v1.0.0

dvm ls
#    v1.0.0
# default -> v1.0.0

Run with a version

Use dvm run command to run Deno on the specified version with arguments.

dvm run v1.0.0
# Running with deno v1.0.0
# Deno 1.0.0
# exit using ctrl+d or close()
# >

You can also run a script file with the specified version.

# Run app.ts with Deno v1.0.0
dvm run v1.0.0 app.ts

Commands

DVM supported the following commands:

Command Usage Description
install dvm install Download and install the latest version or the version reading from .dvmrc file.
dvm install <version | prefix> Download and install the specified version, or the latest version with the specified prefix.
dvm install <version> --registry=<registry> Download and install deno with the specified registry.
dvm install <version> --skip-validation Do not validate deno version before trying to download it.
dvm install <version> --from-source Build and install Deno from source code.
dvm install <version> --skip-download-cache Download and install Deno without using downloaded cache.
uninstall dvm uninstall <version> Uninstall the specified version.
use dvm use Use the specified version read from .dvmrc.
dvm use <version> Use the specified version that passed by argument.
dvm use <name> Use the specified version of the alias name that passed by argument.
run dvm run <version> [args] Run deno on the specified version with arguments.
alias dvm alias <name> <version> Set an alias name to specified version.
unalias dvm unalias <name> Delete the specified alias name.
current dvm current Display the current version of Deno.
ls dvm ls List all installed versions.
list dvm list Same as ls command.
ls-remote dvm ls-remote List all remote versions.
list-remote dvm list-remote Same as ls-remote command.
which dvm which Display the path of the version that specified in .dvmrc.
dvm which current Display the path of the current version.
dvm which <version> Display the path of specified version.
clean dvm clean Remove all downloaded packages and the cached versions.
deactivate dvm deactivate Deactivate Deno on current shell.
doctor dvm doctor Find invalid / corrupted versions.
dvm doctor --fix Find and fix invalid / corrupted versions.
upgrade dvm upgrade Update dvm itself.
purge dvm purge Remove dvm from your computer.
help dvm help Show dvm help message.

Please visit dvm wiki for more details.

Options

Option Description
-q, --quiet Run DVM with quiet mode, it'll hide most of the outputs.
--color Print messages with color mode.
--no-color Print messages with no color mode.
--verbose Print debug messages.

Uninstalling DVM

There are two ways to remove DVM from your computer.

Use purge command

You can execute dvm purge to remove dvm from your computer if your dvm version is v0.3.2 and above. It will remove the $DVM_DIR and dvm configurations in shell config file.

If your dvm is less than v0.3.2, please following the next section (Manual uninstall) to remove DVM.

Manual uninstall

You can also execute following command to uninstall dvm:

rm -rf "$DVM_DIR"

Edit shell config file (like .bashrc or .zshrc), and remove the following lines:

# Deno Version Manager
export DVM_DIR="$HOME/.dvm"
[ -f "$DVM_DIR/dvm.sh" ] && . "$DVM_DIR/dvm.sh"
[ -f "$DVM_DIR/bash_completion" ] && . "$DVM_DIR/bash_completion"

License

Distributed under the MIT License. See LICENSE file for more information.

About

Deno Version Manager (DVM) - A lightweight, and powerful Deno Version Manager for MacOS, Linux, WSL, and Windows with Bash.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages