Ruby Reforge

🚀 Automatically upgrade Ruby projects to newer versions and fix deprecated code.

Overview

ruby-reforge is a gem that scans a Ruby or Rails project, detects incompatible code for a target Ruby version (e.g., upgrading from 3.1 → 3.3), and automatically rewrites or suggests fixes.

Features

• ✅ Updates .ruby-version, Gemfile, and gemspec files
• ✅ Fixes deprecated Ruby syntax automatically
• ✅ Detects and fixes removed features
• ✅ Rewrites code for new Ruby syntax
• ✅ Generates detailed upgrade reports
• ✅ Interactive mode for reviewing changes
• ✅ Git integration (creates branches, commits changes)

Installation

gem install ruby-reforge

Or add it to your Gemfile:

gem 'ruby-reforge', group: :development

Usage

Upgrade to a new Ruby version

ruby-reforge upgrade 3.3

This will:

1. Update version files (.ruby-version, Gemfile, gemspec)
2. Scan your codebase for deprecated patterns
3. Automatically fix issues
4. Create a git branch and commit changes

Generate a report

ruby-reforge report

Shows what needs to be fixed without making changes.

Interactive mode

ruby-reforge upgrade 3.3 --interactive

Prompts before making each change.

Dry run

ruby-reforge upgrade 3.3 --dry-run

Shows what would be changed without making any changes.

What It Fixes

Deprecated Methods

• File.exists? → File.exist?
• Dir.exists? → Dir.exist?
• URI.escape → CGI.escape
• And more...

Version Files

• Updates .ruby-version
• Updates Gemfile ruby version
• Updates gemspec required_ruby_version

Ruby 3.0+ Keyword Arguments

Detects and suggests fixes for keyword argument changes.

Examples

# Upgrade to Ruby 3.3
ruby-reforge upgrade 3.3

# Generate report for Ruby 3.2
ruby-reforge report --target 3.2

# Interactive upgrade
ruby-reforge upgrade 3.3 --interactive

Roadmap

• Rails-specific deprecations
• Gem dependency compatibility checker
• AI-assisted fixes for complex code
• Test framework updates
• Performance improvement suggestions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

The gem is available as open source under the terms of the MIT License.