fluent_fixtures 0.0.2 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d33bbaa00f8e53051894c6cdfa9696965a1fb73
-  data.tar.gz: 1cf3f1e78b8ae7532782df1b657ae5b0ef365d88
+  metadata.gz: c70fba1d0e0cb81714a74684bc8906bfd363a707
+  data.tar.gz: 0cb6b28e3e362e2f86e6b2a2543fa8974a5b1309
 SHA512:
-  metadata.gz: da3d7e7e75da53dccd23a834f6eeeec0a531203b51c5385b4dda469eb4a39eb60040df7d0244465a3e24d7f455a53c4c3b76f7288686e035edf38141f40bb9ac
-  data.tar.gz: 4def254094af54a2f4f4c72f1425a7d124717d552e588226c5c6f8ba48e40e4634dc3067287ae2f7b0216a96a3f7a40e45b835f0378f6aa52956a3c65b0575f1
+  metadata.gz: aea30395e953f18e878fc54cfb97da5e9fa05b937a220a5cccb641182adc311bf0dbff0579a5f0ea7acb2afb7c9952f9b59937dd5cbd2ac36fa30da20e939575
+  data.tar.gz: e4a83d0c50b788dc98d52284f5ef7fb4d7ecb28d863c54b51eb87df5a40be4775852feb0b9a231b3303d6d1b6f40553badfe7528edcf80f69ffe89fda2bfa491

data/ChangeLog

@@ -1,8 +1,53 @@
+2016-10-28  Michael Granger  <ged@FaerieMUD.org>
+
+	* certs/ged.pem:
+	Update gem cert to the latest one
+	[f3b80f1dca30] [tip]
+
+	* GettingStarted.md, README.md, TheSetup.md:
+	Add some more documentation work
+	[9428d297d024]
+
+2016-10-20  Michael Granger  <ged@FaerieMUD.org>
+
+	* examples/acme_fixtures.rb, examples/lib/acme.rb,
+	examples/lib/acme/base.rb, examples/lib/acme/fixtures.rb,
+	examples/lib/acme/fixtures/groups.rb,
+	examples/lib/acme/fixtures/users.rb, examples/lib/acme/group.rb,
+	examples/lib/acme/user.rb, examples/nodb/acme_fixtures.rb,
+	examples/nodb/lib/acme.rb, examples/nodb/lib/acme/base.rb,
+	examples/nodb/lib/acme/fixtures.rb,
+	examples/nodb/lib/acme/fixtures/groups.rb,
+	examples/nodb/lib/acme/fixtures/users.rb,
+	examples/nodb/lib/acme/group.rb, examples/nodb/lib/acme/user.rb,
+	examples/sequel_model/.pryrc, examples/sequel_model/Gemfile,
+	examples/sequel_model/Gemfile.lock,
+	examples/sequel_model/acme_fixtures.rb,
+	examples/sequel_model/lib/acme.rb,
+	examples/sequel_model/lib/acme/customer.rb,
+	examples/sequel_model/lib/acme/fixtures.rb,
+	examples/sequel_model/lib/acme/fixtures/customers.rb,
+	examples/sequel_model/lib/acme/fixtures/order_items.rb,
+	examples/sequel_model/lib/acme/fixtures/orders.rb,
+	examples/sequel_model/lib/acme/order.rb,
+	examples/sequel_model/lib/acme/order_item.rb,
+	examples/sequel_model/migrations/1_schema.rb:
+	Split examples into per-backend directories
+	[49d76036d758]
+
 2016-06-01  Michael Granger  <ged@FaerieMUD.org>
 
+	* .hgtags:
+	Added tag v0.0.2 for changeset f13e6d1aa624
+	[9c56821be4a9]
+
+	* .hgsigs:
+	Added signature for changeset e500071dd9c0
+	[f13e6d1aa624] [v0.0.2]
+
 	* History.md, lib/fluent_fixtures.rb:
 	Bump the patch version, update history.
-	[e500071dd9c0] [tip]
+	[e500071dd9c0]
 
 	* Rakefile, fluent_fixtures.gemspec:
 	Remove the release failsafe from the Rakefile

data/History.md

@@ -1,3 +1,9 @@
+## v0.1.0 [2016-10-28] Michael Granger <ged@FaerieMUD.org>
+
+New feature:
+- Add an after-save hook and a declaration for it.
+
+
 ## v0.0.2 [2016-06-01] Michael Granger <ged@FaerieMUD.org>
 
 Remove the release failsafe from the Rakefile

data/Manifest.txt

@@ -2,12 +2,12 @@
 .rdoc_options
 .simplecov
 ChangeLog
-GettingStarted.md
 History.md
 LICENSE.txt
 Manifest.txt
 README.md
 Rakefile
+TheSetup.md
 lib/fluent_fixtures.rb
 lib/fluent_fixtures/collection.rb
 lib/fluent_fixtures/dsl.rb

data/README.md

@@ -15,10 +15,13 @@ docs
 
 ## Description
 
-A toolkit for building a collection of composable testing fixtures with a fluent interface.
+FluentFixtures is a toolkit for building testing objects with a fluent interface.
 
-To get started using the library, check out the [Getting Started](GettingStarted_md.html) guide.
+It allows testers to describe test data via composition rather than setting up fragile monolithic datasets.
 
+To see a walkthrough of how you might set your own fixtures up, check out the [The Setup](TheSetup_md.html).
+
+If you're already on your way and just want some API docs, [we got those, too](FluentFixtures.html).
 
 ## Prerequisites
 

data/TheSetup.md

@@ -0,0 +1,171 @@
+# The Setup
+
+To make use of FluentFixtures, you'll need to first set up a module to contain them. Each base fixture you declare will show up in this module.
+
+For example, say I'm adding fixtures to a hypothetical codebase for acme-warehouse.com's website. It has a set of Sequel::Model classes that are backed by a PostgreSQL database. with a schema like:
+
+    CREATE SCHEMA acme;
+    CREATE TABLE acme.customers (
+        id serial primary key,
+        first_name text NOT NULL,
+        last_name text NOT NULL
+    );
+    CREATE TABLE acme.orders (
+        id serial primary key,
+        ordered_at timestamp with time zone DEFAULT now(),
+        updated_at timestamp with time zone,
+        customer_id integer REFERENCES acme.customers NOT NULL
+    );
+    CREATE TABLE acme.order_items (
+        id serial primary key,
+        sku text NOT NULL,
+        order_id integer REFERENCES acme.orders NOT NULL
+    );
+  
+
+ The codebase has three classes: Customers, Orders, and OrderItems, all in the `Acme` namespace:
+
+    # lib/acme.rb
+    
+    require 'sequel'
+    
+    module Acme
+    
+    	DB = Sequel.postgres( 'acme' )
+    
+    	Sequel::Model.plugin :validation_helpers
+    	Sequel::Model.plugin :auto_validations, not_null: :presence
+    
+    	autoload :Customer, 'acme/customer'
+    	autoload :Order, 'acme/order'
+    	autoload :OrderItem, 'acme/order_item'
+    
+    end
+
+And the model classes look something like this:
+
+    # lib/acme/customer.rb
+    
+    require 'sequel/model'
+    require 'acme' unless defined?( Acme )
+    
+    class Acme::Customer < Sequel::Model( :acme__customers )
+    
+    	one_to_many :orders
+    
+    end
+
+    # lib/acme/order.rb
+    
+    require 'sequel/model'
+    require 'acme' unless defined?( Acme )
+    
+    class Acme::Order < Sequel::Model( :acme__orders )
+    
+    	many_to_one :customer, class: 'Acme::User'
+    	one_to_many :order_items
+    
+    end
+    
+    # lib/acme/order_item.rb
+    
+    require 'sequel/model'
+    require 'acme' unless defined?( Acme )
+    
+    class Acme::OrderItem < Sequel::Model( :acme__order_items )
+    
+    	many_to_one :order
+    
+    end
+
+
+## Collections
+
+To start the fixture library, I'll create a new `lib/acme/fixtures.rb` that looks like:
+
+    # lib/acme/fixtures.rb
+    
+    require 'fluent_fixtures'
+    require 'acme' unless defined?( Acme )
+    
+    module Acme::Fixtures
+    	extend FluentFixtures::Collection
+    
+    	fixture_path_prefix 'acme/fixtures'
+    
+    end
+
+The `extend` line tell FluentFixtures that the extended module is a collection of related fixtures, and the `fixture_path_prefix` line tells FluentFixtures where to find the files that contain the individual fixture declarations themselves.
+
+This module will act as the main interface to all of ACME's fixtures.
+
+
+## Fixtures
+
+First, we'll add a bare-bones `customer` fixture for creating instances of `Acme::Customer`:
+
+    # lib/acme/fixtures/customers.rb
+
+    require 'acme/fixtures'
+    require 'acme/customer
+
+    module Acme::Fixtures::Customers
+        extend Acme::Fixtures
+        fixtured_class Acme::Customer
+    end
+
+This time, the `extend` line tells the fixture collection we just created that any fixtures declared in this module belong to it. The `fixtured_class` declaration tells FluentFixtures what kinds of objects these fixtures will create.
+
+This by itself sets up some defaults based on convention. The first is the "base" fixture, which is the name of the method you'll call on the collection to get a factory that can create `Acme::Customer` objects:
+
+    customer = Acme::Fixtures.customer
+    # => #<FluentFixtures::Factory:0x007fede4113210 for Acme::Fixtures::Customers>
+
+    customer.instance
+    # => #<Acme::Customer @values={}>
+
+### The `base` Declaration
+
+If I wanted the base fixture to be called something else, I could also override the conventional one using the `base` declaration:
+
+    module Acme::Fixtures::Customers
+      # ...
+      base :user
+    end
+
+    customer = Acme::Fixtures.user
+    # => #<FluentFixtures::Factory:0x007fc15992a370 for Acme::Fixtures::Customers>
+
+Obviously this is a little unintuitive, so I won't actually do that, but the `base` declaration can also take a block to provide reasonable defaults. I'll use the `Faker` gem to generate a default first and last name if one hasn't already been set when the object is created:
+
+    require 'faker'
+
+    module Acme::Fixtures::Customers
+      # ...
+      base :customer do
+        self.first_name ||= Faker::Name.first_name
+        self.last_name ||= Faker::Name.last_name
+      end
+    end
+
+    customer = Acme::Fixtures.customer
+    # => #<FluentFixtures::Factory:0x007fdb492cd4c8 for Acme::Fixtures::Customers>
+    customer.instance
+    # => #<Acme::Customer @values={:first_name=>"Polly", :last_name=>"Larson"}>
+
+
+The block executes in the context of the new object if the `base` block doesn't take an argument; you can also declare a block that accepts the new object as an argument if you prefer that.
+
+
+### Decorators
+
+
+
+### Hooks
+
+
+
+## RSpec
+
+
+

data/lib/fluent_fixtures.rb

@@ -11,10 +11,10 @@ module FluentFixtures
 
 
 	# Package version
-	VERSION = '0.0.2'
+	VERSION = '0.1.0'
 
 	# Version control revision
-	REVISION = %q$Revision: e500071dd9c0 $
+	REVISION = %q$Revision: c6eb79628953 $
 
 
 	# Loggability API -- set up a named logger

data/lib/fluent_fixtures/dsl.rb

@@ -62,7 +62,7 @@ module FluentFixtures::DSL
 	alias_method :has_decorator?, :decorator?
 
 
-	### Declare a +new_name+ for the decorator declarted with with +original_name+.
+	### Declare a +new_name+ for the decorator declared with with +original_name+.
 	def alias_decorator( new_name, original_name )
 		block = self.decorators[ original_name.to_sym ] or
 			raise ScriptError, "undefined decorator %p" % [ original_name ]
@@ -70,15 +70,21 @@ module FluentFixtures::DSL
 	end
 
 
-	### Add a callback to the fixture that will passed new instances after all
+	### Add a callback to the fixture that will be passed new instances after all
 	### decorators have been applied and immediately before it's saved. The results of
-	### the block will be used as the fixtured instance. This can be
-	### used for tables with fixed rows to use `find_or_create` or similar.
+	### the block will be used as the fixtured instance.
 	def before_saving( &block )
 		define_singleton_method( :call_before_saving, &block )
 	end
 
 
+	### Add a callback to the fixture that will be passed new instances after it's
+	### saved. The results of the block will be used as the fixtured instance.
+	def after_saving( &block )
+		define_singleton_method( :call_after_saving, &block )
+	end
+
+
 	### Return an instance of Cozy::FluentFixtures::FluentFactory for the base fixture
 	### of the receiving module.
 	def factory( *args, &block )

data/lib/fluent_fixtures/factory.rb

@@ -101,6 +101,8 @@ class FluentFixtures::Factory
 
 			self.try_to_save( obj )
 
+			obj = self.fixture_module.call_after_saving( obj ) if
+				self.fixture_module.respond_to?( :call_after_saving )
 			obj
 		end
 

data/spec/fluent_fixtures/collection_spec.rb

@@ -115,9 +115,9 @@ describe FluentFixtures::Collection do
 
 
 	it "allows the loading prefix to be customized" do
-		collection.fixture_path_prefix( 'acme/fixtures' )
+		collection.fixture_path_prefix( 'example/fixtures' )
 		expect( collection ).to receive( :require ).
-			with( "acme/fixtures/foo" ).and_return( false )
+			with( "example/fixtures/foo" ).and_return( false )
 
 		collection.load( :foo )
 	end

data/spec/fluent_fixtures/dsl_spec.rb

@@ -60,7 +60,7 @@ describe FluentFixtures::DSL do
 	end
 
 
-	it "can register a creation hook to allow for unusual models" do
+	it "can register a before-creation hook to allow for unusual models" do
 		expect {
 			fixture_module.before_saving do |obj|
 				obj
@@ -70,6 +70,16 @@ describe FluentFixtures::DSL do
 	end
 
 
+	it "can register an after-creation hook to allow for unusual models" do
+		expect {
+			fixture_module.after_saving do |obj|
+				obj
+			end
+		}.to change { fixture_module.respond_to?(:call_after_saving) }.
+			from( false ).to( true )
+	end
+
+
 	it "can declare an alias for an already-declared decorator" do
 		fixture_module.decorator( :with_no_email ) { self.email = nil }
 		fixture_module.alias_decorator( :emailless, :with_no_email )

data/spec/fluent_fixtures/factory_spec.rb

@@ -14,6 +14,7 @@ describe FluentFixtures::Factory do
 		Class.new do
 			def initialize( params={} )
 				@saved = false
+				@deleted = false
 				params.each do |name, value|
 					self.send( "#{name}=", value )
 				end
@@ -28,6 +29,8 @@ describe FluentFixtures::Factory do
 				self.login = "__#{self.login}__"
 				self
 			end
+			def delete; @deleted = true; end
+			def deleted?; @deleted; end
 		end
 	end
 
@@ -202,6 +205,19 @@ describe FluentFixtures::Factory do
 	end
 
 
+	it "calls its fixture module's #call_after_saving method after creating if it implements it" do
+		def fixture_module.call_after_saving( instance )
+			instance.delete
+			instance
+		end
+
+		result = factory.create
+
+		expect( result ).to be_an_instance_of( fixtured_class )
+		expect( result ).to be_deleted
+	end
+
+
 	it "allows ad-hoc decorators declared as inline blocks" do
 		counter = 0
 		result = factory.decorated_with do |obj|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fluent_fixtures
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.1.0
 platform: ruby
 authors:
 - Michael Granger
@@ -10,26 +10,32 @@ bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
-  MIIDMDCCAhigAwIBAgIBAjANBgkqhkiG9w0BAQUFADA+MQwwCgYDVQQDDANnZWQx
+  MIIEbDCCAtSgAwIBAgIBATANBgkqhkiG9w0BAQsFADA+MQwwCgYDVQQDDANnZWQx
   GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
-  HhcNMTYwNjAyMDE1NTQ2WhcNMTcwNjAyMDE1NTQ2WjA+MQwwCgYDVQQDDANnZWQx
+  HhcNMTYwODIwMTgxNzQyWhcNMTcwODIwMTgxNzQyWjA+MQwwCgYDVQQDDANnZWQx
   GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
-  ggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDb92mkyYwuGBg1oRxt2tkH
-  +Uo3LAsaL/APBfSLzy8o3+B3AUHKCjMUaVeBoZdWtMHB75X3VQlvXfZMyBxj59Vo
-  cDthr3zdao4HnyrzAIQf7BO5Y8KBwVD+yyXCD/N65TTwqsQnO3ie7U5/9ut1rnNr
-  OkOzAscMwkfQxBkXDzjvAWa6UF4c5c9kR/T79iA21kDx9+bUMentU59aCJtUcbxa
-  7kcKJhPEYsk4OdxR9q2dphNMFDQsIdRO8rywX5FRHvcb+qnXC17RvxLHtOjysPtp
-  EWsYoZMxyCDJpUqbwoeiM+tAHoz2ABMv3Ahie3Qeb6+MZNAtMmaWfBx3dg2u+/WN
-  AgMBAAGjOTA3MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBSZ0hCV
-  qoHr122fGKelqffzEQBhszANBgkqhkiG9w0BAQUFAAOCAQEAF2XCzjfTFxkcVvuj
-  hhBezFkZnMDYtWezg4QCkR0RHg4sl1LdXjpvvI59SIgD/evD1hOteGKsXqD8t0E4
-  OPAWWv/z+JRma72zeYsBZLSDRPIUvBoul6qCpvY0MiWTh496mFwOxT5lvSAUoh+U
-  pQ/MQeH/yC6hbGp7IYska6J8T4z5XkYqafYZ3eKQ8H+xPd/z+gYx+jd0PfkWf1Wk
-  QQdziL01SKBHf33OAH/p/puCpwS+ZDfgnNx5oMijWbc671UXkrt7zjD0kGakq+9I
-  hnfm736z8j1wvWddqf45++gwPpDr1E4zoAq2PgRl/WBNyR0hfoZLpi3TnHu3eC0x
-  uALKNA==
+  ggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC/JWGRHO+USzR97vXjkFgt
+  83qeNf2KHkcvrRTSnR64i6um/ziin0I0oX23H7VYrDJC9A/uoUa5nGRJS5Zw/+wW
+  ENcvWVZS4iUzi4dsYJGY6yEOsXh2CcF46+QevV8iE+UmbkU75V7Dy1JCaUOyizEt
+  TH5UHsOtUU7k9TYARt/TgYZKuaoAMZZd5qyVqhF1vV+7/Qzmp89NGflXf2xYP26a
+  4MAX2qqKX/FKXqmFO+AGsbwYTEds1mksBF3fGsFgsQWxftG8GfZQ9+Cyu2+l1eOw
+  cZ+lPcg834G9DrqW2zhqUoLr1MTly4pqxYGb7XoDhoR7dd1kFE2a067+DzWC/ADt
+  +QkcqWUm5oh1fN0eqr7NsZlVJDulFgdiiYPQiIN7UNsii4Wc9aZqBoGcYfBeQNPZ
+  soo/6za/bWajOKUmDhpqvaiRv9EDpVLzuj53uDoukMMwxCMfgb04+ckQ0t2G7wqc
+  /D+K9JW9DDs3Yjgv9k4h7YMhW5gftosd+NkNC/+Y2CkCAwEAAaN1MHMwCQYDVR0T
+  BAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFHKN/nkRusdqCJEuq3lgB3fJvyTg
+  MBwGA1UdEQQVMBOBEWdlZEBGYWVyaWVNVUQub3JnMBwGA1UdEgQVMBOBEWdlZEBG
+  YWVyaWVNVUQub3JnMA0GCSqGSIb3DQEBCwUAA4IBgQAPJzKiT0zBU7kpqe0aS2qb
+  FI0PJ4y5I8buU4IZGUD5NEt/N7pZNfOyBxkrZkXhS44Fp+xwBH5ebLbq/WY78Bqd
+  db0z6ZgW4LMYMpWFfbXsRbd9TU2f52L8oMAhxOvF7Of5qJMVWuFQ8FPagk2iHrdH
+  inYLQagqAF6goWTXgAJCdPd6SNeeSNqA6vlY7CV1Jh5kfNJJ6xu/CVij1GzCLu/5
+  DMOr26DBv+qLJRRC/2h34uX71q5QgeOyxvMg+7V3u/Q06DXyQ2VgeeqiwDFFpEH0
+  PFkdPO6ZqbTRcLfNH7mFgCBJjsfSjJrn0sPBlYyOXgCoByfZnZyrIMH/UY+lgQqS
+  6Von1VDsfQm0eJh5zYZD64ZF86phSR7mUX3mXItwH04HrZwkWpvgd871DZVR3i1n
+  w8aNA5re5+Rt/Vvjxj5AcEnZnZiz5x959NaddQocX32Z1unHw44pzRNUur1GInfW
+  p4vpx2kUSFSAGjtCbDGTNV2AH8w9OU4xEmNz8c5lyoA=
   -----END CERTIFICATE-----
-date: 2016-06-02 00:00:00.000000000 Z
+date: 2016-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: loggability
@@ -102,61 +108,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.2'
 - !ruby/object:Gem::Dependency
-  name: rdoc
+  name: faker
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
-  name: faker
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rdoc-generator-fivefish
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: rdoc-generator-fivefish
+  name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: hoe
   requirement: !ruby/object:Gem::Requirement
@@ -172,30 +178,34 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.15'
 description: |-
-  A toolkit for building a collection of composable testing fixtures with a fluent interface.
+  FluentFixtures is a toolkit for building testing objects with a fluent interface.
+
+  It allows testers to describe test data via composition rather than setting up fragile monolithic datasets.
+
+  To see a walkthrough of how you might set your own fixtures up, check out the [The Setup](TheSetup_md.html).
 
-  To get started using the library, check out the [Getting Started](GettingStarted_md.html) guide.
+  If you're already on your way and just want some API docs, [we got those, too](FluentFixtures.html).
 email:
 - ged@FaerieMUD.org
 executables: []
 extensions: []
 extra_rdoc_files:
-- GettingStarted.md
 - History.md
 - LICENSE.txt
 - Manifest.txt
 - README.md
+- TheSetup.md
 files:
 - ".document"
 - ".rdoc_options"
 - ".simplecov"
 - ChangeLog
-- GettingStarted.md
 - History.md
 - LICENSE.txt
 - Manifest.txt
 - README.md
 - Rakefile
+- TheSetup.md
 - lib/fluent_fixtures.rb
 - lib/fluent_fixtures/collection.rb
 - lib/fluent_fixtures/dsl.rb
@@ -227,9 +237,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.2
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
-summary: A toolkit for building a collection of composable testing fixtures with a
-  fluent interface
+summary: FluentFixtures is a toolkit for building testing objects with a fluent interface
 test_files: []

data/GettingStarted.md

@@ -1,26 +0,0 @@
-# Getting Started With Fluent Fixtures
-
-Declare a module that will act as a collection of fixtures:
-
-    # lib/acme/fixtures.rb
-    require 'fluent_fixtures'
-    module Acme::Fixtures
-        extend FluentFixtures::Collection
-        fixture_path_prefix 'acme/fixtures'
-    end
-
-This module will act as the main interface to all of ACME's fixtures.
-
-First, we'll add a bare-bones `user` fixture for creating instances of a hypothetical `Acme::User` class:
-
-    # lib/acme/fixtures/users.rb
-    require 'acme/fixtures'
-    require 'acme/user
-    module Acme::Fixtures::Users
-        extend Acme::Fixtures
-        fixtured_class Acme::User 
-    end
-
-[...more soon]
-
-