Automating the Upgrade of Factory Bot Legacy Syntax

By USEO Engineering Team March 20, 2026

BLUF (Bottom Line Up Front): When upgrading legacy Rails testing suites, renaming factory_girl to factory_bot is only the first step. The critical issue is the deprecation of static attributes in favor of dynamic blocks. Manually updating thousands of factory definitions is prone to error. You must automate this refactoring using static analysis tools like rubocop-factory_bot.

Phase 1: The Deprecation Warning

Glossary entry: Factory Bloat.

In older versions of Factory Girl, attributes were defined statically. When the file loaded, the Ruby interpreter evaluated the attribute immediately. In modern Factory Bot, all attributes must be defined inside dynamic blocks to prevent state leakage between tests.

Synthetic Engineering Context: Static String Deprecation

When you bump the gem version and run the test suite, your console is flooded with deprecation warnings.

# The Bad Code: Legacy Syntax (spec/factories/users.rb)
FactoryBot.define do
  factory :user do
    email "test@example.com" # Static string - DEPRECATED
    status :active           # Static symbol - DEPRECATED
    created_at Time.now      # Evaluated once at boot - DANGEROUS
  end
end

# Console Output
DEPRECATION WARNING: Static attributes will be removed in FactoryBot 5.0. Please use dynamic attributes instead by wrapping the attribute value in a block.

Phase 2: Automated Refactoring

Instead of running complex regex find-and-replace scripts, utilize RuboCop’s Abstract Syntax Tree (AST) parsing to safely autocorrect the files.

Execution: Using RuboCop

Add the specific extension to your Gemfile.

# Gemfile
group :development, :test do
  gem 'rubocop'
  gem 'rubocop-factory_bot', require: false
end

Configure your .rubocop.yml to require the extension and enable the specific cop.

# .rubocop.yml
require:
  - rubocop-factory_bot

FactoryBot/AttributeDefinedStatically:
  Enabled: true

Run the autocorrect command targeting only the factories directory:

$ bundle exec rubocop --require rubocop-factory_bot --only FactoryBot/AttributeDefinedStatically --auto-correct spec/factories/

Execution: The Result

RuboCop safely wraps all static definitions in blocks.

# The Optimized Code: Modern Syntax
FactoryBot.define do
  factory :user do
    email { "test@example.com" }
    status { :active }
    created_at { Time.now }
  end
end

Phase 3: Next Steps & Risk Mitigation

Automated refactoring tools are powerful but can occasionally misinterpret complex metaprogramming inside factories. You must run the entire RSpec suite after the autocorrect to ensure no logical changes were introduced during the syntax bump.

Need Help Stabilizing Your Legacy App? We automate the tedious parts of Rails version bumps. Our team at USEO executes comprehensive test suite upgrades, ensuring full compatibility with modern Ruby standards.