rails-presenter

name: rails-presenter description: Creates presenter objects for view formatting using SimpleDelegator pattern with TDD. Use when extracting view logic from models, formatting data for display, creating badges/labels, or when user mentions presenters, view models, formatting, or display helpers. allowed-tools: Read, Write, Edit, Bash, Glob, Grep

Rails Presenter Generator (TDD)

Creates presenters that wrap models for view-specific formatting with specs first.

Quick Start

1. Write failing test in test/presenters/
2. Run test to confirm RED
3. Implement presenter extending BasePresenter
4. Run test to confirm GREEN

Project Conventions

Presenters in this project:

• Extend BasePresenter < SimpleDelegator
• Include ActionView helpers for formatting
• Delegate model methods via SimpleDelegator
• Return HTML-safe strings for badges/formatted output
• Use I18n for all user-facing text

BasePresenter (Already Exists)

# app/presenters/base_presenter.rb
class BasePresenter < SimpleDelegator
  include ActionView::Helpers::NumberHelper
  include ActionView::Helpers::DateHelper
  include ActionView::Helpers::UrlHelper
  include ActionView::Helpers::TagHelper
  include ActionView::Helpers::TextHelper

  def initialize(model, view_context = nil)
    super(model)
    @view_context = view_context
  end

  def model
    __getobj__
  end

  alias_method :object, :model
end

TDD Workflow

Step 1: Create Presenter Test (RED)

# test/presenters/[resource]_presenter_test.rb
require "test_helper"

class [Resource]PresenterTest < ActiveSupport::TestCase
  setup do
    @resource = resources(:one) # name: "Test", status: :active
    @presenter = [Resource]Presenter.new(@resource)
  end

  test "delegates to the model" do
    assert_equal "Test", @presenter.name
  end

  test "responds to model methods" do
    assert_respond_to @presenter, :name
    assert_respond_to @presenter, :status
    assert_respond_to @presenter, :created_at
  end

  test "exposes the underlying model" do
    assert_equal @resource, @presenter.model
  end

  test "returns the formatted name" do
    assert_equal "Test", @presenter.display_name
  end

  test "returns formatted date when present" do
    @resource.update(event_date: Date.new(2026, 7, 15))
    I18n.with_locale(:fr) do
      assert_includes @presenter.formatted_date, "2026"
    end
  end

  test "returns placeholder span when date is nil" do
    @resource.update(event_date: nil)
    result = @presenter.formatted_date
    assert_includes result, "text-slate-400"
    assert_includes result, "italic"
  end

  test "status badge returns HTML-safe string" do
    assert_predicate @presenter.status_badge, :html_safe?
  end

  test "status badge includes status text" do
    assert_includes @presenter.status_badge, "Active"
  end

  test "uses correct color classes for active" do
    @resource.update(status: :active)
    assert_includes @presenter.status_badge, "bg-green-100"
  end

  test "uses correct color classes for inactive" do
    @resource.update(status: :inactive)
    assert_includes @presenter.status_badge, "bg-red-100"
  end

  test "formats cents as euros" do
    @resource.update(amount_cents: 15000)
    assert_equal "150,00 EUR", @presenter.formatted_amount
  end
end

Step 2: Run Test (Confirm RED)

bin/rails test test/presenters/[resource]_presenter_test.rb

Step 3: Implement Presenter (GREEN)

# app/presenters/[resource]_presenter.rb
class [Resource]Presenter < BasePresenter
  # Color mapping for Open/Closed Principle
  STATUS_COLORS = {
    active: "bg-green-100 text-green-800",
    inactive: "bg-red-100 text-red-800",
    pending: "bg-yellow-100 text-yellow-800"
  }.freeze

  DEFAULT_COLOR = "bg-slate-100 text-slate-800"

  def display_name
    name
  end

  def formatted_date
    return not_specified_span if event_date.nil?
    I18n.l(event_date, format: :long)
  end

  def status_badge
    tag.span(
      status_text,
      class: "inline-flex items-center px-2.5 py-0.5 rounded-full text-xs font-medium #{status_color}"
    )
  end

  def formatted_amount
    return "0,00 EUR" if amount_cents.nil? || amount_cents.zero?
    number_to_currency(
      amount_cents / 100.0,
      unit: "EUR",
      separator: ",",
      delimiter: " ",
      format: "%n %u"
    )
  end

  private

  def status_text
    I18n.t("activerecord.attributes.[resource].statuses.#{status}", default: status.to_s.humanize)
  end

  def status_color
    STATUS_COLORS.fetch(status.to_sym, DEFAULT_COLOR)
  end

  def not_specified_span
    tag.span(
      I18n.t("presenters.common.not_specified"),
      class: "text-slate-400 italic"
    )
  end
end

Step 4: Run Test (Confirm GREEN)

bin/rails test test/presenters/[resource]_presenter_test.rb

Common Presenter Methods

Date Formatting

def formatted_event_date
  return not_specified_span if event_date.nil?
  I18n.l(event_date, format: :long)
end

def short_date
  return "—" if event_date.nil?
  event_date.strftime("%d/%m/%Y")
end

def days_until
  return nil if event_date.nil?
  days = (event_date - Date.today).to_i
  case days
  when 0 then I18n.t("presenters.event.today")
  when 1 then I18n.t("presenters.event.tomorrow")
  when 2..7 then I18n.t("presenters.event.days_from_now", count: days)
  else distance_of_time_in_words_to_now(event_date)
  end
end

Currency Formatting

def formatted_budget
  return not_specified_span if budget_cents.nil?
  number_to_currency(
    budget_cents / 100.0,
    unit: "EUR",
    separator: ",",
    delimiter: " ",
    format: "%n %u",
    precision: 0
  )
end

Badge/Tag Generation

def type_badge
  tag.span(
    display_type,
    class: "inline-flex items-center px-2 py-1 rounded text-xs font-medium #{type_color}"
  )
end

def display_tags
  return not_specified_span if tags.blank?
  safe_join(
    tags.split(",").map(&:strip).map do |tag_text|
      tag.span(tag_text, class: "inline-block bg-slate-100 px-2 py-1 rounded text-xs mr-1")
    end
  )
end

Contact Links

def display_email
  return not_specified_span if email.blank?
  mail_to(email, email, class: "text-blue-600 hover:underline")
end

def display_phone
  return not_specified_span if phone.blank?
  link_to(phone, "tel:#{phone}", class: "text-blue-600 hover:underline")
end

Usage in Controllers

# Single resource
@event = EventPresenter.new(@event)

# Collection
@events = events.map { |e| EventPresenter.new(e) }

# With view context (for route helpers)
@event = EventPresenter.new(@event, view_context)

Checklist

• Test written first (RED)
• Extends BasePresenter
• Delegation tested
• HTML output is html_safe
• Uses I18n for all text
• Currency stored in cents, displayed in euros
• Color mappings use constants (Open/Closed)
• not_specified_span for nil values
• All tests GREEN

Additional Resources

• Domain Patterns — SimpleDelegator pattern, ApplicationPresenter base class, view context usage, number formatting, collection presenters, conditional logic, and testing strategies