Tansu Homebrew Tap 🍺

The tap for Tansu 🗃️ a stateless Kafka-compatible broker with pluggable storage (PostgreSQL, SQLite, S3, memory)

QUICKSTART
Overview
Release Process

Overview

How to install

brew install tansu-io/tap/tansu

What is Homebrew?

Package manager for macOS (or Linux), see more at https://brew.sh

What is a Tap?

A third-party (in relation to Homebrew) repository providing installable packages (formulae) on macOS and Linux.

See more at https://docs.brew.sh/Taps

How do I install packages from here?

brew install tansu-io/tap/{PACKAGE}

You can also only add the tap which makes formulae within it available in search results (brew search output):

brew tap tansu-io/tap

Note: to clone the tap via SSH you will need to use:

brew tap tansu-io/tap https://github.com/tansu-io/homebrew-tap

While you may search across taps, it is necessary to always use fully qualified name (incl. the tansu-io/tap/ prefix) when referring to formulae in external taps such as this one outside of search.

What packages are available?

With the following command, you can install the latest version of each product:

brew install tansu-io/tap/tansu

Prereleases (including as alpha's, beta's, and release candidates) will not be available in this tap.

Why doesn't Tansu maintain formulae in the homebrew-core (main tap)?

Homebrew's core team prefers to keep homebrew-core built from source to maintain consistency across vendors in terms of expectations around contents and updates. Tansu builds take minutes and we want to optimize for starting as quickly and as frictionlessly as possible.

For production deployments, we recommend you use the official docker image.

In the future, we may add Tansu into the main tap (as well as other distribution channels). For now, treat this tap as a quickstart option.

Release Process

1. Update formula

Formula/tansu.rb is generated from Formula/tansu.rb.jinja.

python3 util/update_formula.py 0.5.12

This renders Formula/tansu.rb from Formula/tansu.rb.jinja and replaces all version and SHA values.

2. Open a PR

Open a PR against main and merge. Example PR: TODO

3. Maintainer sanity checks

# local install from tap
brew tap tansu-io/tap
brew install tansu
tansu --version

# strict lint + unit test
brew audit --strict tansu
brew test tansu

Conventions

• Release tags are vX.Y.Z, following semantic versioning.
• Release assets are named tansu_<os>_<arch>.tar.gz where <os> is darwin or linux and <arch> is amd64 or arm64.