fluent_fixtures 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 07f6689a16026531fbafd50aac6b959bbeca39b6
-  data.tar.gz: 3a5b862efb2397f83a02ddc039f2cd4bf1dd5d78
+SHA256:
+  metadata.gz: 9362a90cd4e65b2c35636321a6e11f45192c027237df3dd725a8943b822a6919
+  data.tar.gz: c7120ddce3a119586469c0cc6406559f11e6ebb48e621522c89a1706de5370b3
 SHA512:
-  metadata.gz: f72b30550bb8a415ae07b31f35716bad26989f9f4b3282431beb934dace6f70d907a50e5cd5314715438f161dced90184bfd4fa77e6f505069b07a8e37413302
-  data.tar.gz: e56f947ee9cca817753af3e260221556db7c9b26fa1bc1eeddeb460f3b5fe3acda0d841c0fd40fefd29ba501fe6f3f346ada32c3b9c041f404819af56f827231
+  metadata.gz: 69f588557bea0c2721916b24024d36dcf906e434963b517e2ba345fd439fc8bf883e57f22a1fef5b2f85503bbf4a24129de127393c5b5e41c38c60ad6450052f
+  data.tar.gz: 16e8f3ef9a17c3adf522836c8b9776bd86ce6c282d66ff506f3a34b3e0f83b9fd89abd4a39e84a369eb01cd4a0ce23b0d96bb317201b43f44b8a3a23c4da9bf3

data/ChangeLog

@@ -1,8 +1,15 @@
+2017-06-26  Michael Granger  <ged@FaerieMUD.org>
+
+	* README.md, lib/fluent_fixtures.rb,
+	lib/fluent_fixtures/collection.rb:
+	Start work on better docs
+	[9f00baf84bb2] [tip]
+
 2017-05-15  Michael Granger  <ged@FaerieMUD.org>
 
 	* .hgtags:
 	Added tag v0.5.0 for changeset a6a7c1070f6d
-	[b8576e389b5e] [tip]
+	[b8576e389b5e]
 
 	* .hgsigs:
 	Added signature for changeset ed67198925b5
@@ -20,7 +27,7 @@
 	spec/fluent_fixtures/dsl_spec.rb,
 	spec/fluent_fixtures/factory_spec.rb:
 	Add a `presave` option for decorators that need a saved instance.
-	[d4160c6c04e0]
+	[d4160c6c04e0] [github/master]
 
 2016-12-13  Michael Granger  <ged@FaerieMUD.org>
 
@@ -49,7 +56,7 @@
 
 	* .hgtags:
 	Added tag v0.3.0 for changeset e544333544cd
-	[85277035e13e] [github/master]
+	[85277035e13e]
 
 	* .hgsigs:
 	Added signature for changeset 5b362f519048

data/History.md

@@ -1,3 +1,14 @@
+##  v0.6.0 [2017-06-26] Michael Granger <ged@FaerieMUD.org>
+
+Enhancements:
+
+- Add support for mutator blocks to factory generators.
+
+Documentation:
+
+- Added the beginnings of API docs.
+
+
 ##  v0.5.0 [2017-05-12] Michael Granger <ged@FaerieMUD.org>
 
 Enhancements:

data/README.md

@@ -36,8 +36,8 @@ If you're already on your way and just want some API docs, [we got those, too](F
 ## Contributing
 
 You can check out the current development source with Mercurial via its
-{project page}[http://bitbucket.org/ged/fluent_fixtures]. Or if you prefer Git, via 
-{its Github mirror}[https://github.com/ged/fluent_fixtures].
+[project page][bitbucket]. Or if you prefer Git, via [its Github
+mirror][github].
 
 After checking out the source, run:
 
@@ -78,3 +78,6 @@ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
+[bitbucket]: http://bitbucket.org/ged/fluent_fixtures
+[github]: https://github.com/ged/fluent_fixtures
+

data/lib/fluent_fixtures/collection.rb

@@ -7,7 +7,11 @@ require 'loggability'
 require 'fluent_fixtures' unless defined?( FluentFixtures )
 
 
-# Extension module for fixture collection modules
+# The extension module for declaring a collection of fixtures. It has three
+# responsibilities: it makes the Module an extension itself for setting up
+# individual fixture modules, it adds the methods for loading fixtures by name
+# (or loading them all), and it adds data structures to the extended module so
+# it can serve as a repository for loaded fixtures.
 module FluentFixtures::Collection
 	extend Loggability
 

data/lib/fluent_fixtures/factory.rb

@@ -129,15 +129,17 @@ class FluentFixtures::Factory
 
 
 	### Return an infinite generator for unsaved instances of the fixtured object.
-	def generator( create: false, limit: DEFAULT_GENERATOR_LIMIT )
+	def generator( create: false, limit: DEFAULT_GENERATOR_LIMIT, &block )
 		return Enumerator.new( limit || Float::INFINITY ) do |yielder|
 			count = 0
+			constructor = create ? :create : :instance
 			loop do
 				break if limit && count >= limit
-				obj = if create
-						self.create
+
+				obj = if block
+						self.send( constructor, &block.curry(2)[count] )
 					else
-						self.instance
+						self.send( constructor )
 					end
 
 				yielder.yield( obj )

data/lib/fluent_fixtures.rb

@@ -5,16 +5,29 @@
 require 'loggability'
 
 
-# Fluent fixtures
+# A toolkit for building testing objects with a fluent interface.
+#
+# The three main parts of fluent_fixtures are the Collection extension module,
+# the DSL module, and the Factory class.
+#
+# The Collection is what you extend a Module with when you're setting up a
+# collection of fixtures for a particular codebase.
+#
+# The DSL module contains methods for declaring individual fixtures for a
+# Collection.
+#
+# Factories are the objects that provide the fluent interface set up by the
+# decorators that evetually create the fixtured objects.
+#
 module FluentFixtures
 	extend Loggability
 
 
 	# Package version
-	VERSION = '0.5.0'
+	VERSION = '0.6.0'
 
 	# Version control revision
-	REVISION = %q$Revision: ed67198925b5 $
+	REVISION = %q$Revision: 3d6408efbde6 $
 
 
 	# Loggability API -- set up a named logger

data/spec/fluent_fixtures/factory_spec.rb

@@ -386,6 +386,21 @@ describe FluentFixtures::Factory do
 			expect( enum.size ).to eq( Float::INFINITY )
 		end
 
+
+		it "yields each new object and the index to a block passed to the generator" do
+			enum = factory.generator do |i, obj|
+				obj.email = "user#{i}@example.com"
+			end
+
+			instances = enum.take( 5 )
+
+			expect( instances[0].email ).to eq( 'user0@example.com' )
+			expect( instances[1].email ).to eq( 'user1@example.com' )
+			expect( instances[2].email ).to eq( 'user2@example.com' )
+			expect( instances[3].email ).to eq( 'user3@example.com' )
+			expect( instances[4].email ).to eq( 'user4@example.com' )
+		end
+
 	end
 
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fluent_fixtures
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Michael Granger
@@ -35,7 +35,7 @@ cert_chain:
   w8aNA5re5+Rt/Vvjxj5AcEnZnZiz5x959NaddQocX32Z1unHw44pzRNUur1GInfW
   p4vpx2kUSFSAGjtCbDGTNV2AH8w9OU4xEmNz8c5lyoA=
   -----END CERTIFICATE-----
-date: 2017-05-16 00:00:00.000000000 Z
+date: 2017-06-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: loggability
@@ -85,14 +85,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: hoe-highline
   requirement: !ruby/object:Gem::Requirement
@@ -169,14 +169,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.15'
+        version: '3.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.15'
+        version: '3.16'
 description: |-
   FluentFixtures is a toolkit for building testing objects with a fluent interface.
 
@@ -237,7 +237,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 2.6.12
 signing_key: 
 specification_version: 4
 summary: FluentFixtures is a toolkit for building testing objects with a fluent interface