Cross-compile Rust CLI tools, publish binaries to Gitea releases, and make them installable with cargo binstall.
Go to file
Dandaedre 8c360318aa Update README.md 2026-09-13 12:22:31 +02:00
worker First draft to be agent finished 2026-09-13 12:07:27 +02:00
.gitignore Initial commit 2026-09-13 11:52:35 +02:00
AGENTS.md First draft to be agent finished 2026-09-13 12:07:27 +02:00
AGENT_TASKS.md First draft to be agent finished 2026-09-13 12:07:27 +02:00
LICENSE Initial commit 2026-09-13 11:52:35 +02:00
README.md Update README.md 2026-09-13 12:22:31 +02:00
config.toml First draft to be agent finished 2026-09-13 12:07:27 +02:00
release.sh First draft to be agent finished 2026-09-13 12:07:27 +02:00
requirements.txt First draft to be agent finished 2026-09-13 12:07:27 +02:00

README.md

Rust Binstall Publisher 🦀📦

A small release tool for cross-compiling Rust CLI projects, publishing their binaries to Gitea releases, and making them available through cargo binstall.

What it does

Rust Binstall Publisher automates the boring parts of releasing small Rust tools:

  • Pulls a Rust project from Git or works from a local checkout.
  • Checks and optionally fixes cargo-binstall metadata.
  • Verifies Cargo version and Git tag consistency.
  • Cross-compiles binaries for multiple architectures.
  • Packages release artifacts and generates checksums.
  • Creates or updates a Gitea release.
  • Uploads the compiled binaries.
  • Verifies that the resulting artifacts can be consumed by cargo binstall.

Default targets

x86_64-unknown-linux-musl
aarch64-unknown-linux-musl
x86_64-pc-windows-gnu

Setup

The tool requires a Python virtual environment.

On first run:

./release.sh --help

The wrapper will offer to create and configure .venv if necessary.

Then activate it:

source .venv/bin/activate

For publishing, provide a Gitea API token:

export GITEA_TOKEN="..."

Usage

Inspect a local project without changing anything:

./release.sh ./my-project --dry-run

Inspect a remote project:

./release.sh \
    https://gitea.example.org/user/my-project.git \
    --tag v0.1.0 \
    --dry-run

Build and publish a release:

./release.sh \
    https://gitea.example.org/user/my-project.git \
    --tag v0.1.0 \
    --fix-metadata

The resulting release artifacts are intended to be installable with:

cargo binstall my-project

Status

🚧 Work in progress / proof of concept.

The initial focus is intentionally narrow: single-package, single-binary Rust CLI projects hosted on Gitea.

See AGENT.md and AGENT_TASKS.md for the current design and implementation plan.