Repo brief: thoughtbot/factory_bot

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T21:56:45.750Z · commit 5d399535578d

Verdict

Healthy — Strong maintenance signals

• Last commit 5d ago
• 35+ active contributors
• Distributed ownership (top contributor 16% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

factory_bot is a Ruby test data builder library that replaces fixtures with a declarative DSL for defining object factories. It supports multiple build strategies (persisted objects, unsaved instances, attribute hashes, stubbed objects) and enables factory inheritance, allowing developers to create consistent, reusable test data across RSpec, Cucumber, and other test frameworks without writing repetitive setup code. Monolithic gem structure: lib/factory_bot/ contains the core engine (likely DSL parser, build strategies, registry), features/ has Cucumber integration tests (Gherkin 2265 bytes), spec/ holds RSpec tests. Documentation lives in docs/src/ with separate sections for associations,…

Start here

• lib/factory_bot/factory.rb: Core Factory class that manages trait application, attribute sequences, and delegation…
• lib/factory_bot/dsl.rb: DSL parser and evaluation context enabling the FactoryBot.define { factory :user }…
• lib/factory_bot/registry.rb: Global factory registry storing all defined factories by name, enabling…
• lib/factory_bot/strategies/: Build strategy implementations (create.rb, build.rb, attributes_for.rb, stub.rb) that…
• .github/workflows/build.yml: CI matrix testing across Ruby versions, runs RSpec + Cucumber on every…

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/thoughtbot/factory_bot.git
cd factory_bot
bundle install
bundle exec rspec

Then explore bin/console for interactive REPL testing and review GETTING_STARTED.md for core concepts.

Daily commands:

bundle exec rspec              # Run full RSpec suite
bundle exec cucumber          # Run BDD Cucumber features
bundle exec rake               # Default Rakefile tasks
bin/console                    # Interactive REPL with factory_bot loaded

CI runs via workflows/build.yml matrix across Ruby 3.1–3.3 (inferred from supported versions note).

Key cautions & unknowns

• No significant hidden traps documented in file list. Notable non-obvious behaviors: (1) Factories use lazy evaluation—attributes are computed at call time, not definition time, so sequences increment per-call. (2)…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.