sastri 0.1.0

Scaffold multi-ecosystem packaging and CI/CD for Rust CLIs (Homebrew, Scoop, PyPI, npm, Hex, mise, asdf, …)
Documentation

Sastri

Named after C. V. Runganada Sastri (1819–1881) — interpreter, jurist, and polyglot who bridged many languages. Sastri does the same for install channels: one Rust binary, many front doors.

Scaffold multi-ecosystem packaging and CI/CD for Rust CLIs — the pattern from one binary, many front doors.

One native binary on GitHub Releases is the source of truth. Homebrew, Scoop, mise/asdf, and CI are thin wrappers around that artifact.

Docs: Quick start · Guide · Usage

Install

# Homebrew
brew install latentmeta/tap/sastri

# Scoop (Windows)
scoop bucket add latentmeta https://github.com/latentmeta/scoop-bucket
scoop install sastri

# mise
mise use -g github:latentmeta/sastri@0.1.0

# asdf
asdf plugin add sastri https://github.com/latentmeta/asdf-sastri.git
asdf install sastri 0.1.0

# curl
curl -fsSL https://raw.githubusercontent.com/latentmeta/sastri/main/scripts/install.sh | sh

# crates.io
cargo install sastri

Quick start

# In your Rust CLI repo
sastri init --generate
# or
sastri generate --config Sastri.toml --force

Commands

sastri init [--generate]          # wizard → Sastri.toml (+ optional generate)
sastri generate --force           # packaging + workflows from Sastri.toml
sastri mechanisms                 # list channels (stable + stubs)
sastri secrets                    # checklist of tokens / taps (never stored)

Config (Sastri.toml)

Holds names, repos, orgs, enabled mechanisms. No tokens.

[project]
name = "greet"
description = "Tiny example CLI"
github_owner = "latentmeta"
github_repo = "greet"
binary_name = "greet"
version = "0.1.0"
cargo_manifest = "Cargo.toml"
license = "MIT"

[org]
homebrew_tap = "latentmeta/homebrew-tap"
scoop_bucket = "latentmeta/scoop-bucket"
asdf_plugin_repo = "latentmeta/asdf-greet"

[mechanisms]
ci = true
github_releases = true
install_sh = true
homebrew = true
scoop = true
asdf = true
mise = true
setup_action = true
npm = false
pypi = false
hex = false

Full field reference: docs/usage.md.

What gets generated

Mechanism Output
ci .github/workflows/ci.yml (fmt, clippy, tests, llvm-cov)
github_releases .github/workflows/release.yml (+ crates.io)
install_sh scripts/install.sh
homebrew / scoop / asdf / mise under packaging/
setup_action .github/actions/setup-<bin>/

This repository dogfoods itself via the root Sastri.toml.

Extending (Ruby, Haskell, …)

  1. Add src/engine/my_eco.rs implementing Mechanism
  2. Register in registry::all
  3. Add a default key in SastriConfig::default_mechanisms
  4. Ship — wizard / TUI / CLI need no other changes

Stubs ruby_gem and haskell_cabal already exist as templates.

Architecture

GitHub Releases (+ SHA256SUMS)
        │
        ├─ CI · install.sh · setup Action · mise · asdf
        ├─ Homebrew tap · Scoop bucket
        └─ (optional) npm · PyPI · Hex · …

License

MIT