Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/justjavac/dvm
๐ฆ Deno Version Manager - Easy way to manage multiple active deno versions.
https://github.com/justjavac/dvm
deno dvm package-manager runtime typescript v8 version
Last synced: about 2 months ago
JSON representation
๐ฆ Deno Version Manager - Easy way to manage multiple active deno versions.
- Host: GitHub
- URL: https://github.com/justjavac/dvm
- Owner: justjavac
- License: mit
- Created: 2018-09-04T15:40:06.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2024-07-24T00:18:51.000Z (about 2 months ago)
- Last Synced: 2024-07-24T02:52:09.168Z (about 2 months ago)
- Topics: deno, dvm, package-manager, runtime, typescript, v8, version
- Language: Rust
- Homepage: https://dvm.deno.dev
- Size: 775 KB
- Stars: 625
- Watchers: 9
- Forks: 35
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-star - dvm - Easy way to manage multiple active deno versions. | justjavac | 601 | (Rust)
- awesome-deno - justjavac/dvm - Deno็ๆฌ็ฎก็ๅจ๏ผ็ฎก็ๅคไธชDeno็ๆฌใ (Uncategorized / Uncategorized)
- awesome-deno-cn - @justjavac/dvm
- awesome-deno - dvm - Deno Version Manager - Easy way to manage multiple active deno versions. (Tools)
- awesome-deno - justjavac/dvm - Deno Version Manager: manage multiple active Deno versions. (Tools / Online Playgrounds)
- awesome-deno - justjavac/dvm - Deno Version Manager: manage multiple active Deno versions. (Tools / XML)
README
English | [็ฎไฝไธญๆ](./README_zh-cn.md)
## Installation
You can install it using the installers below, or download a release binary from
the [releases page](https://github.com/justjavac/dvm/releases).
**With Shell:**
```sh
curl -fsSL https://dvm.deno.dev | sh
```
**With PowerShell:**
```powershell
irm https://dvm.deno.dev | iex
```
## Usage
```console
โ ~ dvm --help
Deno Version Manager - Easy way to manage multiple active deno versions.
Usage: dvm.exe
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:
```bash
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:
```bash
dvm use --local 1.17.0
```
Then when someone else with a copy of your project and run dvm:
```plain
$ 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
- The Shell installer can be used on Windows with
[Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about),
[MSYS](https://www.msys2.org) or equivalent set of tools.
## Caveats
### unzip is **required**
The program [`unzip`](https://linux.die.net/man/1/unzip) is a requirement for
the Shell installer.
```sh
$ 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](./LICENSE) file for details.