Skip to content

v0.22.0 — CLI binary renamed `rustio` → `rustio-admin`

Choose a tag to compare

View all tags
@abdulwahed-sweden abdulwahed-sweden released this 28 May 23:54
· 171 commits to main since this release
v0.22.0
This tag was signed with the committer’s verified signature.
abdulwahed-sweden Abdulwahed Mansour
SSH Key Fingerprint: VzkXFevDZuzHn9OOodWcNeZSjLdG1sfW8m4gQ+C/GhY
Verified
Learn about vigilant mode.
c346f5e
This commit was signed with the committer’s verified signature.
abdulwahed-sweden Abdulwahed Mansour
SSH Key Fingerprint: VzkXFevDZuzHn9OOodWcNeZSjLdG1sfW8m4gQ+C/GhY
Verified
Learn about vigilant mode.

The rustio-admin-cli crate now produces a binary named rustio-admin instead of rustio. crates.io package names are unchanged; only the emitted executable changes.

Why

The bare rustio name collided at the shell level with an earlier unrelated upstream RustIO project that also publishes a rustio binary. Back-to-back cargo install runs on the same machine silently overwrote each other with no diagnostic. Renaming the bin to match the crate (rustio-admin-cli → rustio-admin) clears the ambiguity.

What changed

  • [[bin]] name in crates/rustio-admin-cli/Cargo.toml, the clap name, the WELCOME_HELP banner shown by --help.
  • Every user-facing rustio <verb> example across README, ROADMAP, CLAUDE.md, active design docs, the bundled scaffold templates (newly-scaffolded projects' READMEs and main.rs comments reference rustio-admin), library doc comments, admin-template empty-state CTAs (/admin, /admin/health, /admin/db-browser), examples/.env, the CI scaffold-pin-guard comment, and CLI error / hint strings.

What is deliberately NOT renamed

These are on-disk / runtime contracts with already-deployed projects. Renaming them would silently break running deployments or diverge newly-generated files from previously-generated ones for any project that scaffolds across the version bump.

  • The @generated by rustio <ver> codegen sentinel in builder/codegen.rs (the SchemaHash header in _generated/ files).
  • The .rustio/ state directory (draft.toml, history.jsonl, builder.lock).
  • The // rustio: insertion markers in scaffolded src/main.rs files.
  • The rustio_admin_actions audit table name.
  • The RUSTIO_TEMPLATE_DIR / RUSTIO_SECRET_KEY environment variables.

Migration

After upgrading, cargo install rustio-admin-cli lands ~/.cargo/bin/rustio-admin. The previous ~/.cargo/bin/rustio from older installs is left as-is — cargo uninstall rustio-admin-cli from an earlier install removes it, or delete it by hand.

Shell scripts, CI steps, Dockerfiles, and project docs that invoke the binary directly need a one-token find-and-replace:

```sh

before

rustio startproject myapp
rustio migrate apply

after

rustio-admin startproject myapp
rustio-admin migrate apply
```

No library API change; the rustio-admin crate is byte-identical except for the version bump.

Full notes: CHANGELOG.md

Assets 2
Loading