verman-plugin

README

Spin Version Manager Plugin

This is a plugin that makes it easy to switch between different versions of Spin.

Installation

Install the latest version of the plugin

The latest stable release of the OTel plugin can be installed like so:

spin plugins update
spin plugin install verman

Install the canary version of the plugin

The canary release of the command trigger plugin represents the most recent commits on main and may not be stable, with some features still in progress.

spin plugins install --url https://github.com/fermyon/verman-plugin/releases/download/canary/verman.json

Install from a local build

Alternatively, use the spin pluginify plugin to install from a fresh build. This will use the pluginify manifest (spin-pluginify.toml) to package the plugin and proceed to install it:

spin plugins install pluginify
go build -o verman main.go
spin pluginify --install

Usage

Once the plugin is installed, you'll need to prepend the verman current_version directory to your path, allowing the verman plugin to temporarily override your current version of Spin:

# To permanently prepend the "current_version" directory to your path, add this command to your .zshrc/.bashrc file.
export PATH="$HOME/.spin_verman/versions/current_version:$PATH"

Once the path is prepended, you can try the below commands:

Download a specific version of Spin

Specify the desired version:

# You can download multiple versions at once
spin verman get canary v2.5.0 2.7.0

Get the latest stable version:

spin verman get latest

Set a different version of Spin

Set a specific version:

# Adding the v prefix to the version is optional
spin verman set v2.5.0

Set the latest version:

spin verman set latest

Update a version of Spin in the ~/.spin_verman directory

# "canary" is currently the only subcommand supported by "update"
spin verman update canary

List the versions of Spin that are downloaded via the verman plugin

spin verman list

Remove a version of Spin downloaded via the verman plugin

Remove a single version:

# Adding the v prefix to the version is optional
spin verman remove v2.5.0

Remove all versions:

spin verman remove all

Remove the alternate Spin version, reverting back to the root version of Spin, but preserving all other versions of Spin downloaded locally:

spin verman remove current