RomFactory

FactoryGirl is an awesome and ROM is awesome, hence RomFactory is born.

Installation

Add this line to your application's Gemfile:

gem 'rom_factory'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rom_factory

Configuration

First, you have to define ROM container:

container = ROM.container(:sql, 'sqlite::memory') do |conf|
  conf.default.create_table(:users) do
    primary_key :id
    column :last_name, String, null: false
    column :first_name, String, null: false
    column :email, String, null: false
    column :created_at, Time, null: false
    column :updated_at, Time, null: false
  end
end

Once that is done, you will have to specify which container RomFactory will use:

RomFactory::Config.configure do |config|
  config.container = container
end

This library works in conjunction with "rom-repository" so you will need to define repository with create command:

UsersRepo < ROM::Repository[:users] do
  commands :create
end

Simple use case

After configuration is done, you can define the factory as follows:

RomFactory::Builder.define do |b|
  b.factory(repo: UsersRepo, name: :user) do |f|
    f.first_name "Janis"
    f.last_name "Miezitis"
    f.email "janjiss@gmail.com"
  end
end

When everything is configured, you can use it in your tests as follows:

user = RomFactory::Builder.create(:user)
user.email #=> "janjiss@gmail.com"

Mapping of records

To follow ROM conventions, you can pass any object that responds to .call method with as: key in following way:

class User
  def self.call(attrs)
    self.new(attrs)
  end

  attr_reader :first_name, :last_name, :email

  def initialize(first_name:, last_name:, email:)
    @first_name, @last_name, @email = first_name, last_name, email
  end
end

RomFactory::Builder.define do |b|
  b.factory(repo: UsersRepo, name: :user, as: User) do |f|
    f.first_name "Janis"
    f.last_name "Miezitis"
    f.email "janjiss@gmail.com"
  end
end

user = RomFactory::Builder.create(:user)
user.class #=> User

I would recommend using dry-types library or similar for creating your domain objects.

Callable properties

You can easily define dynamic (callbale) properties if value needs to change every time it needs to be called. Anything that responds to .call can be dynamic property.

RomFactory::Builder.define do |b|
  b.factory(repo: UsersRepo, name: :user) do |f|
    f.first_name "Janis"
    f.last_name "Miezitis"
    f.email "janjiss@gmail.com"
    f.created_at {Time.now}
  end
end
user = RomFactory::Builder.create(:user)
user.created_at #=> 2016-08-27 18:17:08 -0500

License

The gem is available as open source under the terms of the MIT License.