/dvm

🦕 Deno Version Manager - Easy way to manage multiple active deno versions.

Primary LanguageRustMIT LicenseMIT

dvm

English | 简体中文

Installation

You can install it using the installers below, or download a release binary from the releases page.

With Shell:

curl -fsSL https://dvm.deno.dev | sh

With PowerShell:

irm https://dvm.deno.dev | iex

Usage

➜  ~  dvm --help
Deno Version Manager - Easy way to manage multiple active deno versions.

Usage: dvm.exe <COMMAND>

Commands:
  completions  Generate shell completions
  info         Show dvm info.
  install      Install deno executable to the given version. [aliases: i, add]
  list         List all installed versions [aliases: ls, ll, la]
  list-remote  List all released versions [aliases: lr, ls-remote]
  uninstall    Uninstall a given version [aliases: un, unlink, rm, remove]
  use          Use a given version or a semver range or a alias to the range.
  alias        Set or unset an alias
  activate     Activate Dvm
  deactivate   Deactivate Dvm
  doctor       Fixing dvm specific environment variables and other issues
  upgrade      Upgrade aliases to the latest version, use `self` to upgrade dvm itself
  exec         Execute deno command with a specific deno version
  clean        Clean dvm cache
  registry     Change registry that dvm fetch from
  update       Update remove version list local cache to the latest
  help         Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help information
  -V, --version  Print version information

EXAMPLE:
  dvm install 1.3.2     Install v1.3.2 release
  dvm install           Install the latest available version
  dvm use 1.0.0         Use v1.0.0 release
  dvm use latest        Use the latest alias that comes with dvm, equivalent to *
  dvm use canary        Use the canary version of the Deno

NOTE:
  To remove, delete, or uninstall dvm - just remove the `$DVM_DIR` folder (usually `~/.dvm`)

Verify installation

To verify that dvm has been installed, do:

dvm -V

which should output dvm's version if the installation was successful.

Initialisation

Calling dvm will creates an ~/.dvm/ directory if it doesn't exist, and all installed versions of deno will put into ~/.dvm.

➜  ~  dvm
Creating /Users/justjavac/.dvm

.dvmrc

You can let dvm to writing config to current directery by add the --local flag to dvm use. Afterwards, dvm use, dvm install will use the version specified in the .dvmrc file if no version is supplied on the command line.

For example, to make dvm default to the 1.17.0 release for the current directory:

dvm use --local 1.17.0

Then when someone else with a copy of your project and run dvm:

$ dvm use
No version input detect, try to use version in .dvmrc file
Using semver range: 1.17.0
Writing to home folder config
Now using deno 1.17.0

Example

Listing versions

List all installed versions:

➜  ~  dvm list
 * 0.1.0
   0.1.1
   0.1.2

The version with a asterisk(*) means that this version is the version currently in use.

Switching version

➜  ~  dvm use 1.1.0
now use deno 1.1.0
➜  ~  dvm use 1.2.0
deno v1.2.0 is not installed. Use `dvm install 1.2.0` to install it first.

Compatibility

Caveats

unzip is required

The program unzip is a requirement for the Shell installer.

$ curl -fsSL https://deno.land/x/dvm/install.sh | sh
Error: unzip is required to install dvm (see: https://github.com/justjavac/dvm#unzip-is-required).

When does this issue occur?

During the install.sh process, unzip is used to extract the zip archive.

How can this issue be fixed?

You can install unzip via brew install unzip on MacOS or apt-get install unzip -y on Linux(Ubuntu,Debian,Deepin).

Powershell on Windows is required

Currently, we use PowerShell profile to set environment variables due to various reasons, so it's required.

License

Deno Version Manager(dvm) is released under the MIT License. See the bundled LICENSE file for details.