Gemfile Organize

Gemfile Organize

Input

• TARGET = first arg or Gemfile in cwd
• Read TARGET, parse: source, ruby, gem declarations, groups, inline comments

Categories (assignment table)

Group-only categories (kept inside group blocks, not top-level):

Output Format

source "https://rubygems.org"
git_source(:github) { |repo| "https://github.com/#{repo}.git" }

ruby file: '.ruby-version'

gem 'rails', '~> 7.x'

# Server
#########################
gem 'puma'

# Databases
#########################
gem 'pg'
gem 'redis'

# [Continue for each non-empty category, in table order]

group :production do
  # ...
end

group :development, :test do
  # ...
end

group :development do
  # ...
end

group :test do
  # ...
end

group :tools do
  # ...
end

Preservation Rules

• Keep gem options intact: github:, source:, require:, branch:, path:
• Preserve version constraints: '~> 1.0', '>= 2.0'
• Keep inline comments: gem 'foo' # comment
• Preserve special blocks like git_source
• Sort gems alphabetically within each section
• Only emit category headers for non-empty sections
• Uncategorized gems → "Rails Extensions & Tools"

Workflow

1. Read TARGET → parse declarations
2. For each gem: assign to category by pattern match (first match wins, table order)
3. Build organized output (top-level categories, then groups)
4. Compute diff vs current TARGET
5. Show summary:

   Organized N gems into M categories:
   - Category: K gems
   ...
   Uncategorized → Rails Extensions & Tools:
   - gem_a
   - gem_b
   

6. AskUserQuestion → options: Show diff | Apply changes | Cancel
7. If Apply → write TARGET.backup, then overwrite TARGET