Ruby Implementation

Ruby Implementation (v1, legacy)

This page is about wip v1, which was a Ruby gem. From v2, wip ships as a self-contained C# Native AOT binary (wip.exe) — no Ruby, no runtime to install. See Getting Started for the current install path.

The Ruby implementation has no further updates planned. It still works and remains available, frozen, at v1.1.4 and as the wslc-wip gem on RubyGems — but bug fixes, new features, and WSLC compatibility updates only land in the C# implementation from here on. Its source has also been removed from the main branch of the repository (recoverable from git history).

Installing v1

gem install wslc-wip

Requires Ruby 3.2+. The gem is named wslc-wip; the command it installs is wip.

What's documented here

The v1 Ruby internals are kept on their own pages, unchanged, for anyone still running or referencing v1:

• Architecture — how the v1 Ruby codebase was laid out
• Development — v1 dev setup, tests, and contributing
• Testing and Linting — v1's RSpec/RuboCop suite
• Release Process — how a v1 gem release was cut

Everything else in this wiki — modes, wip.yml keys, commands, guides, troubleshooting — describes user-facing behavior that applies to both v1 and v2 unless a page says otherwise. Only wip's own implementation language and install method changed at v2.

Related

• README: v2 switched from Ruby to a C# Native AOT binary
• v1.1.4 release
• wslc-wip on RubyGems