sus 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ec538e7cbf293f075dd262e212e705edc33d457e4791458d5d75a3179cfca2f
-  data.tar.gz: 6193fb56afb1124b67d5ecf44f646f71a97919c8924c7d6dbc586ed4e566c843
+  metadata.gz: c1b91ed35726c8afcbc97fd2c73ea28d433874f7976958b26beebd9f4ed1dfe4
+  data.tar.gz: 2295e4817295a52265e94c4eadf708f15b4502ecd40e42b76a44570c3f7c5f2b
 SHA512:
-  metadata.gz: 8b537a93be3bc1f008cee17659df931a04f9f1bcbc219d2813543ba4372c479d9f56b6de5d9aae1fca4179beab095450789fd7f046e89d1d6509921cb2eafab1
-  data.tar.gz: a4c27583848df35d4c40c95c73f128d7521b05856b14c50b80f094637d4f850ea44e32f0fd917f40a48603a1e6ede1bf83772a0bdeb4f5918da51d9fb8a1ac0d
+  metadata.gz: 821e42e75cb7628974b6e10b036eb222aa35adfbafb25dc7b773b7b2ba8714c1a292c9ab539763567e1a1010f814aeada965b406eb77969a2f78c6dbf59c82e1
+  data.tar.gz: 44a648f339a1a947037bdfde3a5e84f875dc9fb5b018133b8e269c572f33ff90dd05c9bfe86f233df60b6ae7357b08ec62523841dddc1cd137327c445d13258e

data/bin/sus

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 # require 'stackprof'
 # StackProf.start(mode: :wall, interval: 10)

data/bin/sus-host

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'json'
 

data/bin/sus-parallel

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require_relative '../lib/sus/config'
 config = Sus::Config.load

data/bin/sus-tree

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'json'
 

data/lib/sus/assertions.rb

@@ -60,7 +60,7 @@ module Sus
 		# The absolute orientation of this set of assertions, i.e. whether the assertions are expected to pass or fail regardless of the parent. Used for correctly formatting the output.
 		attr :orientation
 		
-		# Whether this set of assertions is isolated from the parent. This is used to ensure taht any deferred assertions are competed before the parent is completed. This is used by `receive` assertions which are deferred until the user code of the test has completed.
+		# Whether this set of assertions is isolated from the parent. This is used to ensure that any deferred assertions are competed before the parent is completed. This is used by `receive` assertions which are deferred until the user code of the test has completed.
 		attr :isolated
 		
 		# Distinct is used to identify a set of assertions as a single statement for the purpose of user feedback. It's used by top level ensure statements to ensure that error messages are captured and reported on those statements.

data/lib/sus/context.rb

@@ -75,5 +75,57 @@ module Sus
 				end
 			end
 		end
+		
+		# Include an around method to the context class, that invokes the given block before running the test.
+		#
+		# Before hooks are called in the reverse order they are defined, in other words the last defined before hook is called first.
+		#
+		# @parameter hook [Proc] The block to execute before each test.
+		def before(&hook)
+			wrapper = Module.new
+			
+			wrapper.define_method(:around) do |&block|
+				instance_exec(&hook)
+				super(&block)
+			end
+			
+			self.include(wrapper)
+		end
+		
+		# Include an around method to the context class, that invokes the given block after running the test.
+		#
+		# After hooks are called in the order they are defined, in other words the last defined after hook is called last.
+		#
+		# @parameter hook [Proc] The block to execute after each test. An `error` argument is passed if the test failed with an exception.
+		def after(&hook)
+			wrapper = Module.new
+			
+			wrapper.define_method(:around) do |&block|
+				error = nil
+				
+				super(&block)
+			rescue => error
+				raise
+			ensure
+				instance_exec(error, &hook)
+			end
+			
+			self.include(wrapper)
+		end
+		
+		# Add an around hook to the context class.
+		#
+		# Around hooks are called in the reverse order they are defined.
+		#
+		# The top level `around` implementation invokes before and after hooks.
+		#
+		# @paremeter block [Proc] The block to execute around each test.
+		def around(&block)
+			wrapper = Module.new
+			
+			wrapper.define_method(:around, &block)
+			
+			self.include(wrapper)
+		end
 	end
 end

data/lib/sus/have.rb

@@ -19,7 +19,8 @@ module Sus
 			end
 			
 			def call(assertions, subject)
-				assertions.nested(self) do |assertions|
+				# We want to group all the assertions in to a distinct group:
+				assertions.nested(self, distinct: true) do |assertions|
 					assertions.assert(subject.key?(@name), "has key")
 					if @predicate
 						Expect.new(assertions, subject[@name]).to(@predicate)
@@ -39,7 +40,7 @@ module Sus
 			end
 			
 			def call(assertions, subject)
-				assertions.nested(self) do |assertions|
+				assertions.nested(self, distinct: true) do |assertions|
 					assertions.assert(subject.respond_to?(@name), "has attribute")
 					if @predicate
 						Expect.new(assertions, subject.public_send(@name)).to(@predicate)
@@ -61,7 +62,7 @@ module Sus
 				index = 0
 				
 				subject.each do |value|
-					assertions.nested("[#{index}] = #{value.inspect}") do |assertions|
+					assertions.nested("[#{index}] = #{value.inspect}", distinct: true) do |assertions|
 						@predicate&.call(assertions, value)
 					end
 					

data/lib/sus/include_context.rb

@@ -7,6 +7,11 @@ require_relative 'context'
 
 module Sus
 	module Context
+		# Include a shared context into the current context, along with any arguments or options.
+		#
+		# @parameter shared [Sus::Shared] The shared context to include.
+		# @parameter arguments [Array] The arguments to pass to the shared context.
+		# @parameter options [Hash] The options to pass to the shared context.
 		def include_context(shared, *arguments, **options)
 			self.class_exec(*arguments, **options, &shared.block)
 		end

data/lib/sus/it_behaves_like.rb

@@ -18,12 +18,12 @@ module Sus
 			base.description = shared.name
 			base.identity = Identity.nested(parent.identity, base.description, unique: unique)
 			base.set_temporary_name("#{self}[#{base.description}]")
-
+			
 			# User provided block is evaluated first, so that it can provide default behaviour for the shared context:
 			if block_given?
 				base.class_exec(*arguments, &block)
 			end
-
+			
 			base.class_exec(*arguments, &shared.block)
 			return base
 		end

data/lib/sus/shared.rb

@@ -11,13 +11,21 @@ module Sus
 		attr_accessor :block
 		
 		def self.build(name, block)
-			base = Class.new
+			base = Module.new
 			base.extend(Shared)
 			base.name = name
 			base.block = block
 			
 			return base
 		end
+		
+		def included(base)
+			base.class_exec(&self.block)
+		end
+		
+		def prepended(base)
+			base.class_exec(&self.block)
+		end
 	end
 	
 	def self.Shared(name, &block)

data/lib/sus/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2021-2024, by Samuel Williams.
 
 module Sus
-	VERSION = "0.29.0"
+	VERSION = "0.30.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sus
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -38,7 +38,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-07-17 00:00:00.000000000 Z
+date: 2024-07-22 00:00:00.000000000 Z
 dependencies: []
 description:
 email: