sus-fixtures-benchmark 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63078795b33d87a934f27e4b1a3499b67a5a1dbc3d4fb9c50cc83a3014dc9916
-  data.tar.gz: c2c82e5e602dfd1f3a2e9f27609cbd518fc8822b70da8bb226a606bd9f6de06a
+  metadata.gz: 91585211a64e9c0976bfb3df369a629697cc777f7fdbf542a4465e20aa546f12
+  data.tar.gz: 2198dc293faa26db8c3e7d200f825debb60c317851185f020e95f743422e034c
 SHA512:
-  metadata.gz: a7fb2ab5b00ab5061b5fee54bb1bdfe0587ec6e95f811eca1b49e914a3511c0f7da13dbabe861b30c797c476c65577d3eb4200243cd2557ce19083b25269ab0a
-  data.tar.gz: 96a95d1c1e20585ff56e82035b0819f0c40cb967436ef32837bc389e67524b318e7e04b2ac863f55d172f8e108151e2850de2d169d4b36b10e796514ddb626a4
+  metadata.gz: 88b568301dda12a68ddab43ef83a53bce07506ef050ae1d9649bdbe76a377dc4b847d8543e76355bea556ced03c22d98e2898f36bfeae488844d459125c62f10
+  data.tar.gz: daad4662ef40498501e446211544d931e7af0dc6d9823d2a496292af2659928af96cbe16e74f8a4bc94c07a4c4aa74dcf3e675b28a5bda94947a0500e6b01143

data/lib/sus/fixtures/benchmark/repeats.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-#
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
@@ -12,27 +11,71 @@ module Sus
 			# Represents a benchmarking helper that executes a block multiple times, collecting timing samples until statistical convergence is reached.
 			class Repeats
 				# Initializes a new {Repeats} object with a sampler to collect timing data.
-				# @parameter samples [Sampler] The sampler object to collect timing data.
-				def initialize(samples)
-					@samples = samples
+				# @parameter sampler [Sampler] The sampler object to collect timing data.
+				def initialize(sampler)
+					@sampler = sampler
 				end
 				
+				# @attribute [Sampler] The sampler that collects timing data.
+				attr :sampler
+				
 				# Samples the execution time of the given block and adds the result to the sampler.
 				# @parameter block [Proc] The block to benchmark.
 				private def sample!(block)
 					time = Benchmark::Time.measure do
 						block.call
 					end
-					@samples.add(time.real)
+					@sampler.add(time.real)
 				end
 				
 				# Repeatedly executes the block until the sampler reports convergence.
 				# @parameter block [Proc] The block to benchmark.
 				def times(&block)
-					until @samples.converged?
+					until @sampler.converged?
 						sample!(block)
 					end
 				end
+				
+				# Represents a benchmarking helper that executes a block a fixed number of times.
+				class Exactly
+					# Initializes a new {Exactly} object with a sampler and a fixed count.
+					# @parameter sampler [Sampler] The sampler object to collect timing data.
+					# @parameter count [Integer] The exact number of times to execute the block.
+					def initialize(sampler, count)
+						@sampler = sampler
+						@count = count
+					end
+					
+					# @attribute [Sampler] The sampler that collects timing data.
+					attr :sampler
+					
+					# @attribute [Integer] The number of times to execute the block.
+					attr :count
+					
+					# Samples the execution time of the given block and adds the result to the sampler.
+					# @parameter block [Proc] The block to benchmark.
+					private def sample!(block)
+						time = Benchmark::Time.measure do
+							block.call
+						end
+						@sampler.add(time.real)
+					end
+					
+					# Executes the block exactly the specified number of times.
+					# @parameter block [Proc] The block to benchmark.
+					def times(&block)
+						@count.times do
+							sample!(block)
+						end
+					end
+				end
+				
+				# Sets a fixed number of times to execute the block, returning a new {Exactly} instance.
+				# @parameter count [Integer] The exact number of times to execute the block.
+				# @returns [Exactly] A new instance that will execute the block exactly the specified number of times.
+				def exactly(count)
+					Exactly.new(@sampler, count)
+				end
 			end
 		end
 	end

data/lib/sus/fixtures/benchmark/time.rb

@@ -41,7 +41,7 @@ module Sus
 				# The real (wall clock) time in seconds.
 				# @returns [Float]
 				attr :real
-
+				
 				# Returns a string representation of the real time in seconds.
 				# @returns [String]
 				def to_s

data/lib/sus/fixtures/benchmark/version.rb

@@ -6,7 +6,7 @@
 module Sus
 	module Fixtures
 		module Benchmark
-			VERSION = "0.1.0"
+			VERSION = "0.2.0"
 		end
 	end
 end

data/lib/sus/fixtures/benchmark.rb

@@ -26,15 +26,19 @@ module Sus
 				# @parameter parent [Class] The parent test context class.
 				# @parameter description [String] The description of the measure.
 				# @parameter unique [Boolean] Whether the measure should have a unique identity.
+				# @parameter **options [Hash] Options to pass to the Sampler constructor.
 				# @parameter block [Proc] The block to execute for the measure.
 				# @returns [Class] The new measure class.
-				def self.build(parent, description, unique: true, &block)
+				def self.build(parent, description, unique: true, **options, &block)
 					base = Class.new(parent)
 					base.extend(self)
 					base.description = description
 					base.identity = Identity.nested(parent.identity, base.description, unique: unique)
 					base.set_temporary_name("#{self}[#{description}]")
 					
+					# Store sampler options for later use
+					base.define_singleton_method(:sampler_options) {options}
+					
 					if block_given?
 						base.define_method(:run, &block)
 					end
@@ -67,7 +71,8 @@ module Sus
 					assertions.nested(self, identity: self.identity, isolated: true, measure: true) do |assertions|
 						instance = self.new(assertions)
 						
-						samples = Sampler.new
+						# Create sampler with options
+						samples = Sampler.new(**self.sampler_options)
 						repeats = Repeats.new(samples)
 						
 						instance.around do

data/readme.md

@@ -18,6 +18,10 @@ Please see the [project documentation](https://suspecting.github.io/sus-fixtures
 
 Please see the [project releases](https://suspecting.github.io/sus-fixtures-benchmark/releases/index) for all releases.
 
+### v0.2.0
+
+  - Added `exactly(count)` method to `Sus::Fixtures::Benchmark::Repeats` which returns an `Exactly` instance for fixed-count benchmarking.
+
 ### v0.1.0
 
   - Added `Sus::Fixtures::Benchmark::Repeats` which is not an integer, but an instance that allows the block to be executed multiple times until the benchmark converges.

data/releases.md

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.2.0
+
+  - Added `exactly(count)` method to `Sus::Fixtures::Benchmark::Repeats` which returns an `Exactly` instance for fixed-count benchmarking.
+
 ## v0.1.0
 
   - Added `Sus::Fixtures::Benchmark::Repeats` which is not an integer, but an instance that allows the block to be executed multiple times until the benchmark converges.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sus-fixtures-benchmark
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Samuel Williams

metadata.gz.sig

@@ -1,3 +1,5 @@
-	/��kb@^�
-�6�~�Z����I'�	O��%�c�dP@*�Q���{W�+L?����T��N�P�tZ,8jH��;�@��k��S���g���J����n�[Ž��\z��,�m����-W�(J���&�6�x���;n�� �%�C��M+�R��9���Qp>E�!�<,-�L�^�l�z��
-2�(gg	o�DN$�-%@p#0,�O+)�M���I��
+AH�pb�D��J�%wg��(�^�ܜ�S>԰u����M���9�䋈�� ��O�;�r�wcgf9������vԨ��݅R�0�IJ���8_A�5.���g�0�$�ꈍ�̠�:|��T7�l�YQީ��o����a���9�5۝3IWJ�X��8�T�
wP���x|x0�Z.vp�3��c����i7�Ք��rrc�\�̶N��
+oɷ5�k@I
+��
+7���M�
ߨ��r����0�!0]:Iv��`W�zq�
+