Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thoughtbot/factory_bot
A library for setting up Ruby objects as test data.
https://github.com/thoughtbot/factory_bot
factories factory-bot factory-girl fixtures rails ruby rubygems testing thoughtbot
Last synced: 5 days ago
JSON representation
A library for setting up Ruby objects as test data.
- Host: GitHub
- URL: https://github.com/thoughtbot/factory_bot
- Owner: thoughtbot
- License: mit
- Created: 2008-06-03T13:55:37.000Z (over 16 years ago)
- Default Branch: main
- Last Pushed: 2024-11-06T05:34:10.000Z (2 months ago)
- Last Synced: 2025-01-02T20:47:11.493Z (9 days ago)
- Topics: factories, factory-bot, factory-girl, fixtures, rails, ruby, rubygems, testing, thoughtbot
- Language: Ruby
- Homepage: https://thoughtbot.com
- Size: 3.19 MB
- Stars: 7,929
- Watchers: 128
- Forks: 2,597
- Open Issues: 97
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- toolbox - factory-bot - I use `FactoryBot` to generate model instances or their attributes for my specs. (Libraries)
- awesome-rspec - factory_bot - A library for building database records. (Tools)
- awesome-rails-api-gems - factory_bot - A library for setting up Ruby objects as test data. (Testing)
- awesome-list - factory_bot
- awesome-hanami - Factory Bot - [Hanami with Factory Bot](https://gist.github.com/rafaels88/8437edababcf38ee193b2ba0265e78b9) (Vanilla Libraries and Hanami / Editors and IDE)
- awesome-starred - thoughtbot/factory_bot - A library for setting up Ruby objects as test data. (testing)
- awesome-rails-gem - factory_bot - Factory_bot is a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance. (Testing / Omniauth)
README
# factory_bot [![Build Status][ci-image]][ci] [![Code Climate][grade-image]][grade] [![Gem Version][version-image]][version]
factory_bot is a fixtures replacement with a straightforward definition syntax, support for multiple build strategies (saved instances, unsaved instances, attribute hashes, and stubbed objects), and support for multiple factories for the same class (user, admin_user, and so on), including factory inheritance.
If you want to use factory_bot with Rails, see
[factory_bot_rails](https://github.com/thoughtbot/factory_bot_rails).
_[Interested in the history of the project name?][NAME]_
### Transitioning from factory\_girl?
Check out the [guide](https://github.com/thoughtbot/factory_bot/blob/4-9-0-stable/UPGRADE_FROM_FACTORY_GIRL.md).
Documentation
-------------
See our extensive reference, guides, and cookbook in [the factory_bot book][].
For information on integrations with third party libraries, such as RSpec or
Rails, see [the factory_bot wiki][].
We also have [a detailed introductory video][], available for free on Upcase.
[a detailed introductory video]: https://upcase.com/videos/factory-bot?utm_source=github&utm_medium=open-source&utm_campaign=factory-girl
[the factory_bot book]: https://thoughtbot.github.io/factory_bot
[the factory_bot wiki]: https://github.com/thoughtbot/factory_bot/wiki
Install
--------
Run:
```ruby
bundle add factory_bot
```
To install the gem manually from your shell, run:
```shell
gem install factory_bot
```
Supported Ruby versions
-----------------------
Supported Ruby versions are listed in [`.github/workflows/build.yml`](https://github.com/thoughtbot/factory_bot/blob/main/.github/workflows/build.yml)
More Information
----------------
* [Rubygems](https://rubygems.org/gems/factory_bot)
* [Stack Overflow](https://stackoverflow.com/questions/tagged/factory-bot)
* [Issues](https://github.com/thoughtbot/factory_bot/issues)
* [GIANT ROBOTS SMASHING INTO OTHER GIANT ROBOTS](https://robots.thoughtbot.com/)
[GETTING_STARTED]: https://github.com/thoughtbot/factory_bot/blob/main/GETTING_STARTED.md
[NAME]: https://github.com/thoughtbot/factory_bot/blob/main/NAME.md
Useful Tools
------------
* [FactoryTrace](https://github.com/djezzzl/factory_trace) - helps to find unused factories and traits.
Contributing
------------
Please see [CONTRIBUTING.md](https://github.com/thoughtbot/factory_bot/blob/main/CONTRIBUTING.md).
factory_bot was originally written by Joe Ferris and is maintained by thoughtbot.
Many improvements and bugfixes were contributed by the [open source
community](https://github.com/thoughtbot/factory_bot/graphs/contributors).
License
-------
factory_bot is Copyright © 2008 Joe Ferris and thoughtbot. It is free
software, and may be redistributed under the terms specified in the
[LICENSE] file.
[LICENSE]: https://github.com/thoughtbot/factory_bot/blob/main/LICENSE
## About thoughtbot
This repo is maintained and funded by thoughtbot, inc.
The names and logos for thoughtbot are trademarks of thoughtbot, inc.
We love open source software!
See [our other projects][community].
We are [available for hire][hire].
[community]: https://thoughtbot.com/community?utm_source=github
[hire]: https://thoughtbot.com/hire-us?utm_source=github
[ci-image]: https://github.com/thoughtbot/factory_bot/actions/workflows/build.yml/badge.svg?branch=main
[ci]: https://github.com/thoughtbot/factory_bot/actions?query=workflow%3ABuild+branch%3Amain
[grade-image]: https://codeclimate.com/github/thoughtbot/factory_bot/badges/gpa.svg
[grade]: https://codeclimate.com/github/thoughtbot/factory_bot
[version-image]: https://badge.fury.io/rb/factory_bot.svg
[version]: https://badge.fury.io/rb/factory_bot
[hound-badge-image]: https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg
[hound]: https://houndci.com