rialoman 0.2.0

Rialo native toolchain manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# rialoman

Rialoman is the release and toolchain manager for the Rialo network. It installs Rialo releases and allows switching between them by keeping shims in the PATH in sync with the active release.

Rialoman uses the following directory layout to manage the installations:
```
$RIALO_HOME (default: $XDG_DATA_HOME/rialo or $HOME/.local/share/rialo)
  bin/         # shims added to PATH
  releases/    # channel/version directories
  toolchains/  # compiler toolchains
  downloads/   # cached tarballs + manifests (planned)
  tmp/         # staging for atomic installs
  current.json # currently active release pointer
```

## Installation

You can install `rialoman` via `cargo` or using the hosted installer script:

### Option A: `cargo install`
```bash
cargo install rialoman
```

### Option B: curl installer
```bash
curl -fsSL https://rialo-artifacts.s3.us-east-2.amazonaws.com/rialoman/stable/install.sh | bash
```

The installer downloads the prebuilt `rialoman` binary for Linux (amd64/arm64) or macOS (arm64), installs it into `$RIALO_HOME/bin`, and optionally appends the PATH snippet to existing shell profiles (supports Bash, Zsh).

## Examples

### Installing/Uninstalling the CLI

```bash
rialoman install stable@latest
rialoman uninstall stable@0.0.1

rialoman install commit@830b4ee6
```

### Switching versions

```bash
# Explicit version
rialoman use stable@0.1.0

# "commit" channel shorthand
rialoman use 830b4ee6
```

### Inspection

```bash
rialoman list         # shows installed releases, marks the current one
rialoman current      # prints channel@version
rialoman which rialo  # resolves a binary within the current release
```