ruby-to-wheel

Package pre-built Ruby binaries into Python wheels.

ruby-to-wheel takes compiled Ruby binaries and wraps them into platform-specific Python wheels with proper entry points, so they can be installed via pip and run as CLI commands.

Installation

pip install ruby-to-wheel

Usage

There are three modes of operation:

1. From pre-built binaries (explicit)

Provide binaries for each platform explicitly:

ruby-to-wheel \
  --name my-tool \
  --version 1.0.0 \
  --binary linux-amd64=/path/to/my-tool-linux-amd64 \
  --binary darwin-arm64=/path/to/my-tool-darwin-arm64

2. From a directory of binaries (auto-detect)

Point to a directory containing binaries with platform suffixes in their filenames:

ruby-to-wheel \
  --name my-tool \
  --version 1.0.0 \
  --binary-dir ./binaries/

Binaries are matched by filename patterns like my-tool-linux-amd64, my-tool-darwin-arm64, etc.

3. From Ruby source (via Tebako)

Build a standalone binary from Ruby source using Tebako and package it into a wheel:

ruby-to-wheel \
  --name my-tool \
  --version 1.0.0 \
  --source ./my-ruby-project/

Supported Platforms

Options

--name              Python package name (required)
--version           Package version (default: 0.1.0)
--output-dir        Directory for built wheels (default: ./dist)
--entry-point       CLI command name (defaults to package name)
--description       Package description
--requires-python   Python version requirement (default: >=3.10)
--author            Author name
--author-email      Author email
--license           License identifier
--url               Project URL
--readme            Path to README for PyPI long description
--extra-lib         Shared library to bundle (repeatable)
--ruby-version      Ruby version for Tebako (default: 3.3.7)
--source-entry-point  Ruby entry point for Tebako (default: bin/{entry-point})
--platform          Override platform detection (for --source mode)

How It Works

Each generated wheel contains:

• A Python package with __init__.py and __main__.py
• The compiled binary in a bin/ subdirectory
• Optional shared libraries in a lib/ subdirectory
• A console script entry point that delegates to the binary

When installed, pip creates a wrapper script so the binary can be invoked directly by name from the command line.

License

Apache-2.0