README.rdoc in fixture_replacement-4.0.0 vs README.rdoc in fixture_replacement-4.0.1
- old
+ new
@@ -1,14 +1,18 @@
-= FixtureReplacement (version 3.0.1)
+= FixtureReplacement
-== What is FixtureReplacement
+== What is FixtureReplacement?
-FixtureReplacement is a Rails[http://rubyonrails.org/] plugin that provides a simple way to
+FixtureReplacement is a Rails gem that provides a simple way to
quickly populate your test database with model objects without having to manage multiple,
brittle fixture files. You can easily set up complex object graphs (with models which
reference other models) and add new objects on the fly.
+(If you've ever used FactoryGirl / FactoryBot, you're probably already quite familiar with
+fixture_replacement, as it proceeded FactoryGirl. Also, FR is much more opinionated, and
+much less PC!)
+
Not only can FixtureReplacement make your test data easier to maintain, it can also help
to make your tests and specs much more readable and intention-revealing by allowing you
to omit extraneous details and focus only on the attributes that are important for a
particular behaviour. It works well with both RSpec[http://rspec.rubyforge.org/] and
Test::Unit[http://www.ruby-doc.org/stdlib/libdoc/test/unit/rdoc/classes/Test/Unit.html].
@@ -20,13 +24,15 @@
See CHANGELOG.rdoc + test suite for further changes.
== Installation
-Install the plugin:
+Add it to your Gemfile:
- git://github.com/smtlaissezfaire/fixturereplacement.git
+ group :development, :test do
+ gem "fixture_replacement", "~> 4.0"
+ end
=== Using it with RSpec
Add the following to your <tt>spec/rails_helper.rb</tt> file, in the configuration section:
@@ -137,6 +143,6 @@
== License
This software is dual licensed under the MIT and the GPLv3 Licenses (it's your pick).
-Copyright 2007-2009 Scott Taylor / smtlaissezfaire[http://github.com/smtlaissezfaire] (scott@railsnewbie.com)
+Copyright 2007-2022 Scott Taylor / smtlaissezfaire[http://github.com/smtlaissezfaire] (scott@railsnewbie.com)