#version-manager #cardano #package-version #command-line-tool #blockchain #run-command #node-management

app hyper-jump

A generalist all-in-one command-line version manager toolset for Cardano-based projects

19 releases (7 breaking)

0.8.2 Oct 2, 2024
0.7.6 Jul 31, 2024

#6 in #cardano

Apache-2.0

110KB
1.5K SLoC

hyper-jump

The console lights up, keys clack rapidly and then... 🛸

hyper-jump is the Cardano aircraft action where the only thing faster than the transactions is the jump between versions ⚡ Skip through versions like a time traveler: but beware, type the wrong command and you might just end up installing cardano-node-0.0.1-alpha - and get stuck in the past 👀

Core Features

  • Version Management: Install and switch between different versions of Cardano ecosystem tools.
  • Environment Isolation: Create isolated environments for different projects, each with its own set of package versions.
  • Remote Listing: View available versions of packages from remote repositories.
  • Package Installation: Download and install specific versions of packages with ease.
  • Package Uninstallation: Remove installed versions of packages to declutter the environment.
  • Version Switching: Seamlessly switch between installed versions with a single command.
  • Version Cleanup: Erase all installed versions of packages to start fresh.
  • Proxy Handling: Hyper-Jump acts as a proxy, allowing users to run commands from the selected package version.

Potential Features

  • Updates notification: Notify users when new versions of packages are available.
  • Custom Package Sources: Allow users to add custom package sources or repositories for more flexibility.
  • Enhanced List Filtering: Provide options to filter the list of installed and remote versions based on criteria such as release date or stability.

Supported Packages

Package Name Alias Description
Cardano Submit Api cardano-submit-api Manage versions of the Cardano Submit Api software.
Cardano Node cardano-node Manage versions of the Cardano Node software.
Cardano CLI cardano-cli Manage versions of the Cardano CLI tool.
Partner Chains CLI partner-chains-cli Manage versions of the Partner Chains CLI tool.
Partner Chains Node partner-chains-node Manage versions of the Partner Chains Node software.
SideChain sidechain-cli Manage versions of the SideChain CLI tool.
Mithril mithril-client Manage versions of the Mithril client software.
Scrolls scrolls Manage versions of the Scrolls client software.
Oura oura Manage versions of the Oura client software.
Dolos dolos Manage versions of the Dolos client software.
Aiken aiken Manage versions of the Aiken client software.

Installation

cargo install hyper-jump

Configuration

On Linux and macOS:

Add the following line to your shell configuration file (e.g., ~/.bashrc, ~/.zshrc, etc.):

export PATH="$HOME/.local/share/hyper-jump/cardano-bin:$PATH"

Or add the hyper-jump binary path to your PATH by running:

sudo launchctl config user path "$(hyper-jump prefix):${PATH}"

Usage

To manage packages, use the following subcommands:

Help

Display help information:

hyper-jump --help

Use

Switch to a specific version of a package.

hyper-jump use cardano-node <version>

Install

Install a specific version of a package.

hyper-jump install cardano-node <version>

List

List installed versions of a package:

hyper-jump list cardano-node

List Remote

List remote versions available for a package.

hyper-jump list-remote cardano-node

Uninstall

Uninstall a specific version of a package.

hyper-jump uninstall cardano-node <version>

Erase

Remove all installed versions.

hyper-jump erase

Dependencies

~28–45MB
~713K SLoC