# FactoryGirlElixir
[](https://travis-ci.org/sinetris/factory_girl_elixir)
Minimal implementation of Ruby's [factory_girl](http://github.com/thoughtbot/factory_girl) in Elixir.
This is a rewrite of the [factory_boy](https://github.com/inkr/factory_boy) project to make it work on Elixir v1.0.x.
## Usage
Add FactoryGirlElixir as a dependency in your `mix.exs` file.
```elixir
defp deps do
[
{:factory_girl_elixir, "~> 0.1.1"}
]
end
```
You should also update your applications list to include both projects:
```elixir
def application do
[applications: [:factory_girl_elixir]]
end
```
After you are done, run `mix deps.get` in your shell to fetch the dependencies.
## Defining a Factory
```elixir
defmodule Factory do
use FactoryGirlElixir.Factory
factory :user do
field :password, "secret"
# create a sequence using an anonymous functions
field :username, fn(n) ->
"username#{n}"
end
# or an anonymous functions shortcut
field :email, &("foo#{&1}@example.com")
end
factory :assets do
field :name, "bob"
end
end
```
Then query the module to get a list of attributes for your record
```elixir
user = Factory.attributes_for(:user) #=> %{password: "secret", username: "username1", email: "foo1@example.com"}
parametrized_user = user |> Factory.parametrize #=> %{"email" => "foo1@example.com", "password" => "secret", "username" => "username1"}
```
You can override attributes
```elixir
user = Factory.attributes_for(:user, email: "user@example.org") #=> %{password: "secret", username: "username1", email: "user@example.org"}
```
## Contributing
1. [Fork](https://help.github.com/articles/fork-a-repo) this repo
2. Create a topic branch - `git checkout -b my_branch`
3. Push to your branch - `git push origin my_branch`
4. Create a [Pull Request](http://help.github.com/pull-requests/) from your
branch
5. That's it!
## Copyright and license
Copyright (c) 2014 Duilio Ruggiero. Code released under [the MIT license](LICENSE).
