Module: FactoryGirl::Syntax::Methods

Included in:
Default, FactoryGirl::SyntaxRunner
Defined in:
lib/factory_girl/syntax/methods.rb

Overview

This module is a container for all strategy methods provided by FactoryGirl. This includes all the default strategies provided (#build, #create, #build_stubbed, and #attributes_for), as well as the complementary *_list methods.

Examples:

singular factory execution

# basic use case
build(:completed_order)

# factory yielding its result to a block
create(:post) do |post|
  create(:comment, post: post)
end

# factory with attribute override
attributes_for(:post, title: "I love Ruby!")

# factory with traits and attribute override
build_stubbed(:user, :admin, :male, name: "John Doe")

multiple factory execution

# basic use case
build_list(:completed_order, 2)
create_list(:completed_order, 2)

# factory with attribute override
attributes_for_list(:post, 4, title: "I love Ruby!")

# factory with traits and attribute override
build_stubbed_list(:user, 15, :admin, :male, name: "John Doe")

Instance Method Summary (collapse)

Instance Method Details

- (Hash) attributes_for(name, *traits_and_overrides, &block)

(see #strategy_method) Generates a hash of attributes for a registered factory by name.

Returns:

  • (Hash)

    hash of attributes for the factory



# File 'lib/factory_girl/syntax/methods.rb', line 49

- (Array<Hash>) attributes_for_list(name, amount, *traits_and_overrides)

(see #strategy_method_list)

Returns:

  • (Array<Hash>)

    array of attribute hashes for the factory



# File 'lib/factory_girl/syntax/methods.rb', line 66

- (Object) build(name, *traits_and_overrides, &block)

(see #strategy_method) Builds a registered factory by name.

Returns:

  • (Object)

    instantiated object defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 33

- (Array) build_list(name, amount, *traits_and_overrides)

(see #strategy_method_list)

Returns:

  • (Array)

    array of built objects defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 54

- (Object) build_stubbed(name, *traits_and_overrides, &block)

(see #strategy_method) Builds a stubbed registered factory by name.

Returns:

  • (Object)

    instantiated object defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 44

- (Array) build_stubbed_list(name, amount, *traits_and_overrides)

(see #strategy_method_list)

Returns:

  • (Array)

    array of stubbed objects defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 62

- (Object) create(name, *traits_and_overrides, &block)

(see #strategy_method) Creates a registered factory by name.

Returns:

  • (Object)

    instantiated object defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 39

- (Array) create_list(name, amount, *traits_and_overrides)

(see #strategy_method_list)

Returns:

  • (Array)

    array of created objects defined by the factory



# File 'lib/factory_girl/syntax/methods.rb', line 58