fluent_fixtures 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fdc1f6ce5b49218750ef162d0f73ae7b9150be8b
-  data.tar.gz: 9c6edc393f5b5966ceeaf4ce91a32dbc1d92b5ed
+  metadata.gz: 4af7da2d10d611a8705da13607ced285f95c6220
+  data.tar.gz: 45b92115603fa459a00b1c2750735b5c5851731f
 SHA512:
-  metadata.gz: 10965916800b2b08931ffceff65b124de14e570d262851ba8d7c9e5942142cc8b9270a09dbbe22e90f037e036018486297e7902f7869217f720a37f1a3f0522b
-  data.tar.gz: dce961bbe9d5eaae9e2582bde164e9bc8d8c98dea9905fa270e9ee649237d4ae3e4d6258827f2c3d3109cd4c597a496b4f3d8e11d1547634b5fa484f1889c0da
+  metadata.gz: 740b6475a410d1bed9ae2aa58577a89558e80d91e97be222b8a4bb66cb34b61b948105b6ebb3526325a30e89b6350c261ffe7274e0e08e537b5236eedddc9efe
+  data.tar.gz: 98b968f86142ca86dc0ba0d5dad1c78ff86a61081b72323b17eb8751b07b858bfd5eafe782fabad683e14c9422de2477230c30f8c46639b6a9040b1daf78f976

checksums.yaml.gz.sig

@@ -1 +1,2 @@
-u(�I��F�;�Va-|1�������b�-L��h���#.CQ����7�۹vٚq�K?�2�%nT���u��ro
+��j�� B	�@�a�*iO2�A�Hs�t:���=CRn�]���2�>�8��Jֻ
+������r���X������ja���]��A�����'D��y�<

data/History.md

@@ -1,14 +1,23 @@
+## v0.3.0 [2016-11-26] Michael Granger <ged@FaerieMUD.org>
+
+Enhancements:
+
+- Make the factory Enumerable and add a #generator method.
+
+
 ## v0.2.0 [2016-10-28] Michael Granger <ged@FaerieMUD.org>
 
 Bugfixes:
+
 - Fix the way #create and #instance handle their arguments. Arguments are
   now iterated over and used to set attributes instead of just being
-	discarded.
+  discarded.
 
 
 ## v0.1.0 [2016-10-28] Michael Granger <ged@FaerieMUD.org>
 
 New feature:
+
 - Add an after-save hook and a declaration for it.
 
 

data/lib/fluent_fixtures/factory.rb

@@ -8,11 +8,15 @@ require 'fluent_fixtures' unless defined?( FluentFixtures )
 # The fluent fixture monadic factory class.
 class FluentFixtures::Factory
 	extend Loggability
+	include Enumerable
 
 
 	# The methods to look for to save new instances when #create is called
 	CREATE_METHODS = %i[ save_changes save ]
 
+	# The default limit for generators
+	DEFAULT_GENERATOR_LIMIT = 10_000
+
 
 	# Loggability API -- log to the FluentFixtures logger
 	log_to :fluent_fixtures
@@ -121,6 +125,35 @@ class FluentFixtures::Factory
 	end
 
 
+	### Iterate over DEFAULT_GENERATOR_LIMIT instances of the fixtured object, yielding
+	### each new instance if a block is provided. If no block is provided, returns an
+	### Enumerator.
+	def each( &block )
+		return self.generator unless block
+		return self.generator.each( &block )
+	end
+
+
+	### Return an infinite generator for unsaved instances of the fixtured object.
+	def generator( create: false, limit: DEFAULT_GENERATOR_LIMIT )
+		return Enumerator.new( limit || Float::INFINITY ) do |yielder|
+			count = 0
+			loop do
+				break if limit && count >= limit
+				obj = if create
+						self.create
+					else
+						self.instance
+					end
+
+				yielder.yield( obj )
+
+				count += 1
+			end
+		end
+	end
+
+
 	### Return a human-readable representation of the object suitable for debugging.
 	def inspect
 		decorator_description = self.decorators.map( &:first ).join( ' + ' )

data/lib/fluent_fixtures.rb

@@ -11,10 +11,10 @@ module FluentFixtures
 
 
 	# Package version
-	VERSION = '0.2.0'
+	VERSION = '0.3.0'
 
 	# Version control revision
-	REVISION = %q$Revision: bde330b02946 $
+	REVISION = %q$Revision: 5b362f519048 $
 
 
 	# Loggability API -- set up a named logger

data/spec/fluent_fixtures/factory_spec.rb

@@ -293,6 +293,57 @@ describe FluentFixtures::Factory do
 	end
 
 
+	describe "enumerator/generator" do
+
+		it "is Enumerable" do
+			expect( factory ).to be_an( Enumerable )
+			expect( factory.each ).to be_an( Enumerator )
+		end
+
+
+		it "can create an enumerator (generator) of unsaved instances" do
+			enum = factory.generator
+
+			expect( enum ).to be_a( Enumerator )
+
+			instance = enum.next
+
+			expect( instance ).to be_a( fixtured_class )
+			expect( instance ).to_not be_saved
+		end
+
+
+		it "can create an enumerator (generator) of saved instances" do
+			enum = factory.generator( create: true )
+
+			expect( enum ).to be_a( Enumerator )
+
+			instance = enum.next
+
+			expect( instance ).to be_a( fixtured_class )
+			expect( instance ).to be_saved
+		end
+
+
+		it "is a limited generator by default" do
+			enum = factory.generator
+			expect( enum.size ).to eq( described_class::DEFAULT_GENERATOR_LIMIT )
+		end
+
+
+		it "can be limited to a different size" do
+			enum = factory.generator( limit: 5 )
+			expect( enum.size ).to eq( 5 )
+			expect( enum.to_a ).to be_an( Array ).and( have_attributes(length: 5) )
+		end
+
+
+		it "can be created as an infinite generator" do
+			enum = factory.generator( limit: nil )
+			expect( enum.size ).to eq( Float::INFINITY )
+		end
+
+	end
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fluent_fixtures
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Michael Granger
@@ -35,7 +35,7 @@ cert_chain:
   w8aNA5re5+Rt/Vvjxj5AcEnZnZiz5x959NaddQocX32Z1unHw44pzRNUur1GInfW
   p4vpx2kUSFSAGjtCbDGTNV2AH8w9OU4xEmNz8c5lyoA=
   -----END CERTIFICATE-----
-date: 2016-10-28 00:00:00.000000000 Z
+date: 2016-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: loggability
@@ -237,7 +237,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: FluentFixtures is a toolkit for building testing objects with a fluent interface