Specimen

A better (sane) default factory implementation

Installation

If available in Hex, the package can be installed by adding specimen to your list of dependencies in mix.exs:

def deps do
  [
    {:specimen, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/specimen.

Basic Usage

Define a factory file with configuration and optional states:

defmodule UserFactory do
  use Specimen.Factory, module: User

  def build(specimen) do
    Specimen.include(specimen, :name, "John")
  end

  def state(:surname, %User{} = user) do
    Map.put(user, :surname, "Doe")
  end

  def after_making(%User{} = user) do
    Map.put(user, :age, 42)
  end  
end

And then:

# Make just one user
{%User{}, _context} = UserFactory.make_one()

# Make the specified amount of users
{users, _contexts} = UserFactory.make_many(10)

# Make users by including specific states
{%User{surname: "Doe"}, _context} = UserFactory.make_one([:surname])

Call it directly from your struct/ schema modules:

defmodule User do
  use Specimen.HasFactory, UserFactory
  defstruct [:name, :surname, :age]
end

{user, _} = User.Factory.make_one()
{users, _} = User.Factory.make_many(10)

madili/specimen

Specimen

Installation

Basic Usage

TODO List