fixturebot-rails 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69f408df6cb364c659b025d97fd71b406257c0070ff766b3cf3da918ee0202c8
-  data.tar.gz: 977217381d7a79a9764ff658976c93cd95c24dac603b07cd52c9e8c0f8c148e7
+  metadata.gz: 8c83c05f009409eb651e9e464fcc70bad3b3abeb377943eef42bfff31b29f9ac
+  data.tar.gz: 79973f2828cb2dcb83c4f238ad1023681c0a241d0f7ca1daab13ad1627685f64
 SHA512:
-  metadata.gz: 7a9f672b0cf194ab3b5523fb3b96a6ba284f06b19cfc29a60b2d11c92109b0c13aa2cc39e2588f26c8f27b2114675ad257fda1085e0588bc5de9a67d3ea3bd93
-  data.tar.gz: c7bc233c2d13a9790348fcb9944da073b0340f50f21b9c83da4dcc5c02a35d1526b26dbff4a3b39041cbf985d7d12411c30869bf7c793d4376f5cfa7b25cec9a
+  metadata.gz: b3c5cfd9eeb975bb9209a2a3e37ca98d7a00225b6c63f638c3f4bdc2a44ff2782eebfcc4616a327d1134d3bcf3dcbbc0a5a661918ab1f4b6fefdffc4ebefed96
+  data.tar.gz: 3ea33f5090363d4ee7c8be75720e7fa1a8364c7665304824071d08fd2e5912be7f0d293f9255c7c69f61a0bafc9c06d9ca600954e33d6adb321dba1a748b10eb

data/README.md

@@ -346,6 +346,40 @@ end
 
 In Rails, this is auto-detected from the database.
 
+### Multiple files
+
+For larger apps, split fixtures across multiple files using `FixtureBot.require`:
+
+```ruby
+# spec/fixtures.rb
+FixtureBot.require "spec/fixtures/**/*.rb"
+
+FixtureBot.define do
+  user.email { |fixture| "#{fixture.key}@example.com" }
+end
+```
+
+```ruby
+# spec/fixtures/users.rb
+FixtureBot.define do
+  user :brad do
+    name "Brad"
+  end
+end
+```
+
+```ruby
+# spec/fixtures/posts.rb
+FixtureBot.define do
+  post :hello do
+    title "Hello"
+    author :brad
+  end
+end
+```
+
+Each file calls `FixtureBot.define` with its own block. Files are loaded in alphabetical order. References across files work because everything is resolved after all files are loaded.
+
 ### Implicit vs explicit style
 
 By default, the block is evaluated implicitly. Table methods like `user` and `post` are available directly:
@@ -388,6 +422,40 @@ FixtureBot::Schema.define do
 end
 ```
 
+## Migrating from FactoryBot
+
+FixtureBot provides `build`, `create`, `attributes_for`, and related methods that mirror FactoryBot's API. The key difference is that you pass both a table name and a fixture name instead of just a factory name:
+
+```ruby
+# FactoryBot                    # FixtureBot
+build(:user)                    # build(:user, :brad)
+create(:user)                   # create(:user, :brad)
+build(:user, name: "X")        # build(:user, :brad, name: "X")
+attributes_for(:user)           # attributes_for(:user, :brad)
+build_list(:user, 3)            # build_list(:user, :brad, :alice, :bob)
+create_list(:user, 3)           # create_list(:user, :brad, :alice, :bob)
+build_pair(:user)               # build_pair(:user, :brad, :alice)
+create_pair(:user)              # create_pair(:user, :brad, :alice)
+build_stubbed(:user)            # build_stubbed(:user, :brad)
+```
+
+### Method reference
+
+| Method | Behavior |
+|---|---|
+| `build(:user, :brad, **attrs)` | Duplicates the fixture, applies overrides. Returns unpersisted. |
+| `create(:user, :brad, **attrs)` | Without overrides: returns the fixture (already persisted). With overrides: `build` + `save!`. |
+| `build_stubbed(:user, :brad, **attrs)` | Like `build` but retains `id`. Looks persisted without touching DB. |
+| `attributes_for(:user, :brad, **attrs)` | Returns attributes hash, strips `id`/`created_at`/`updated_at`. |
+| `build_list(:user, :brad, :alice, **attrs)` | Maps each name through `build`. |
+| `create_list(:user, :brad, :alice, **attrs)` | Maps each name through `create`. |
+| `build_pair(:user, :brad, :alice, **attrs)` | Alias for `build_list` with 2 names. |
+| `create_pair(:user, :brad, :alice, **attrs)` | Alias for `create_list` with 2 names. |
+| `build_stubbed_list(:user, :brad, :alice, **attrs)` | Maps each name through `build_stubbed`. |
+| `build_stubbed_pair(:user, :brad, :alice, **attrs)` | Alias for `build_stubbed_list` with 2 names. |
+
+These methods are automatically available in your tests when you require `fixturebot/rspec` or `fixturebot/minitest`. They call the standard Rails fixture accessors under the hood, so `build(:user, :brad)` is equivalent to `users(:brad).dup`.
+
 ## Prior art
 
 ### [Rails fixtures](https://guides.rubyonrails.org/testing.html#the-low-down-on-fixtures)

data/lib/fixturebot/minitest.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
 require "fixturebot/rails"
+require "fixturebot/syntax"
 
 FixtureBot::Rails.compile
+
+ActiveSupport::TestCase.include FixtureBot::Syntax::Methods

data/lib/fixturebot/rspec.rb

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
 require "fixturebot/rails"
+require "fixturebot/syntax"
 
 RSpec.configure do |config|
   config.before(:suite) do
     FixtureBot::Rails.compile
   end
+
+  config.include FixtureBot::Syntax::Methods
 end

data/lib/fixturebot/syntax.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/string/inflections"
+require "active_support/core_ext/hash/keys"
+
+module FixtureBot
+  module Syntax
+    module Methods
+      def build(table_name, fixture_name, **attributes)
+        record = send(table_name.to_s.pluralize, fixture_name).dup
+        record.assign_attributes(attributes) if attributes.any?
+        record
+      end
+
+      def create(table_name, fixture_name, **attributes)
+        if attributes.any?
+          build(table_name, fixture_name, **attributes).tap(&:save!)
+        else
+          send(table_name.to_s.pluralize, fixture_name)
+        end
+      end
+
+      def build_stubbed(table_name, fixture_name, **attributes)
+        source = send(table_name.to_s.pluralize, fixture_name)
+        attrs = source.attributes
+        attrs.merge!(attributes.stringify_keys) if attributes.any?
+        source.class.instantiate(attrs)
+      end
+
+      def attributes_for(table_name, fixture_name, **attributes)
+        send(table_name.to_s.pluralize, fixture_name)
+          .attributes
+          .symbolize_keys
+          .except(:id, :created_at, :updated_at)
+          .merge(attributes)
+      end
+
+      def build_list(table_name, *fixture_names, **attributes)
+        fixture_names.map { |name| build(table_name, name, **attributes) }
+      end
+
+      def create_list(table_name, *fixture_names, **attributes)
+        fixture_names.map { |name| create(table_name, name, **attributes) }
+      end
+
+      def build_pair(table_name, *fixture_names, **attributes)
+        build_list(table_name, *fixture_names, **attributes)
+      end
+
+      def create_pair(table_name, *fixture_names, **attributes)
+        create_list(table_name, *fixture_names, **attributes)
+      end
+
+      def build_stubbed_list(table_name, *fixture_names, **attributes)
+        fixture_names.map { |name| build_stubbed(table_name, name, **attributes) }
+      end
+
+      def build_stubbed_pair(table_name, *fixture_names, **attributes)
+        build_stubbed_list(table_name, *fixture_names, **attributes)
+      end
+    end
+  end
+end

data/lib/fixturebot/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FixtureBot
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/fixturebot.rb

@@ -29,6 +29,10 @@ module FixtureBot
     end
   end
 
+  def self.require(glob)
+    Dir.glob(glob).sort.each { |f| load f }
+  end
+
   def self.define_from_file(schema, fixtures_path)
     definition = Definition.new(schema)
     Thread.current[:fixturebot_definition] = definition

data/lib/generators/fixturebot/templates/fixtures.rb.tt

@@ -1,3 +1,5 @@
+FixtureBot.require "<%= rspec? ? "spec" : "test" %>/fixtures/**/*.rb"
+
 FixtureBot.define do
   # Define your fixtures here. Example:
   #

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: fixturebot-rails
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Brad Gessler
 bindir: exe
 cert_chain: []
-date: 2026-03-08 00:00:00.000000000 Z
+date: 2026-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -85,6 +85,7 @@ files:
 - lib/fixturebot/row.rb
 - lib/fixturebot/rspec.rb
 - lib/fixturebot/schema.rb
+- lib/fixturebot/syntax.rb
 - lib/fixturebot/version.rb
 - lib/generators/fixturebot/install_generator.rb
 - lib/generators/fixturebot/templates/fixtures.rb.tt