[sammyapoex]

Replaces the options of flipside_entity with one macro each:

class User < ApplicationRecord
  include Flipside::Flippable

  flipside_search_by do |str|
    where("lower(first_name) = :name OR lower(last_name) = :name OR email LIKE :str",
          name: str.downcase, str: "#{str}%")
  end
  flipside_display_as { |user| "#{user.name} (#{user.email})" }
  flipside_identified_by :uuid
end

• flipside_search_by takes a block, run in the context of the class, or a column name to match exactly (flipside_search_by :name), as search_by: :name does.
• flipside_display_as takes a block or the name of an instance method.
• Each macro registers the class as an entity, so flipside_entity is only needed to register with the defaults. They can be called in any order.
• An STI subclass that calls a macro gets a registration of its own, starting from its parent's settings, and must be listed in Flipside.flippables. One that calls none is still displayed through its parent.
• The search_by:, display_as: and identified_by: options of flipside_entity still work but are deprecated, to be removed in 1.0. Each maps directly onto its macro with the same meaning, so there are no breaking changes.

Internals

RegisteredEntity is now the only place that interprets the Symbol or Proc settings. The macros set them on the class's registration, which is kept in an inherited class attribute, so a reloaded class starts over instead of keeping settings removed from its code.

Also fixes an order-dependent spec failure: SQLite's statement cache kept the old users columns when registered_entity_spec recreated the table.

Testing

bundle exec rspec: 87 examples, 0 failures, checked across several random seeds.

🤖 Generated with Claude Code

[Copilot]

🟡 Changes recommended

The public documentation omits a registration macro and inaccurately describes identifier configuration as setting a table primary key.

2 open findings

• Include flipside_identified_by in the entity macro list · New
• Clarify that the macro does not set the table primary key · New

What changed in this PR

Splits entity configuration into dedicated model macros while preserving deprecated options.

Changes:

• Adds search, display, and identifier macros with STI support.
• Centralizes entity setting interpretation.
• Updates tests, documentation, and changelog.

File	Description
app/​models/​flipside/​flippable.rb	Implements the new macros and inherited registration.
lib/​flipside/​config/​registered_entity.rb	Centralizes search and display behavior.
lib/​flipside/​config/​entities.rb	Preserves deprecated symbol-search semantics.
spec/​flipside/​flippable_spec.rb	Tests macros, STI, reloads, and deprecations.
spec/​flipside/​registered_entity_spec.rb	Tests revised entity configuration behavior.
README.md	Documents the new API and migration path.
CHANGELOG.md	Records additions and deprecations.

🧠 Review effort: Balanced

---

Give feedback about Copilot approvals in this survey to enter a drawing for a $150 gift card.