sus 0.21.1 → 0.21.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8653cb936d27d9e33250698daac7861a3235699ae90e6263a6d79d33dd24b4bd
-  data.tar.gz: '0516931df8c4f34c61ab56cd75d65e29adc414e8d39797d79e8ba273af356e6e'
+  metadata.gz: 9c9d5cda23334b97833ed1a604e83b02e40082a954090b534c40308d6bd311c3
+  data.tar.gz: 758aff4bbafb00ed7587d281f26a7c0ee8922f5a8e24156c1e5647da7268d6f1
 SHA512:
-  metadata.gz: 8c8a8fd1d650280a873af340909fc55bfe3a3fa6fc510fb55dfc42a696a58beee78450d88d11340785d084e94c9a5bfedb85751f9f13cc0d61697cb7bfb2738c
-  data.tar.gz: ebb26520158d23db914fc931afd6e001e2839fcaeff3f20b6734ab2f0a0c7d644a61f1f74f84ccf3af2f7e302954aa1244d792320e25dcc5f30e7e866b3e38a6
+  metadata.gz: 27c8d2c7e7547f69799e7d078076abc6a629c2e8c7c29d7c37bc40bbcaff207ef253477de12818429f6543db07be95738c39371d7f6b1329179a6eca0b4cc190
+  data.tar.gz: 5e6746be0bbe69a8698903cb7a95a4ce5e61598b1744bf0b85095c3de6e47a3523855ba8d82f07071f0bfd5fba4463800b510107b4ed9534c8c88f7f629c56b1

data/lib/sus/assertions.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'output'
 require_relative 'clock'
@@ -42,9 +42,16 @@ module Sus
 			@count = 0
 		end
 		
+		# The identity that is used to identify this set of assertions.
 		attr :identity
+		
+		# The specific target of the assertions, e.g. the test case or nested test assertions.
 		attr :target
+		
+		# The output buffer used to capture output from the assertions.
 		attr :output
+		
+		# The nesting level of this set of assertions.
 		attr :level
 		
 		# Whether this aset of assertions is inverted, i.e. the assertions are expected to fail relative to the parent. Used for grouping assertions and ensuring they are added to the parent passed/failed array correctly.
@@ -288,7 +295,7 @@ module Sus
 			@output.error(error, @identity)
 		end
 		
-		def nested(target, identity: nil, isolated: false, distinct: false, inverted: false, **options)
+		def nested(target, identity: @identity, isolated: false, distinct: false, inverted: false, **options)
 			result = nil
 			
 			# Isolated assertions need to have buffered output so they can be replayed if they fail:
@@ -387,6 +394,8 @@ module Sus
 				# self.print(@output, verbose: false)
 				# @output.puts
 			end
+			
+			@skipped.concat(assertions.skipped)
 		end
 		
 		# Concatenate the child assertions into this instance.

data/lib/sus/base.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 
@@ -45,6 +45,7 @@ module Sus
 		base.extend(Context)
 		base.identity = Identity.new(root) if root
 		base.description = description
+		base.set_temporary_name("#{self}[#{description}]")
 		
 		return base
 	end

data/lib/sus/be_truthy.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022, by Samuel Williams.
+# Copyright, 2022-2023, by Samuel Williams.
 
 module Sus
 	module BeTruthy

data/lib/sus/clock.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022, by Samuel Williams.
+# Copyright, 2022-2023, by Samuel Williams.
 
 module Sus
 	class Clock

data/lib/sus/config.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022, by Samuel Williams.
+# Copyright, 2022-2023, by Samuel Williams.
 
 require_relative 'clock'
 require_relative 'registry'

data/lib/sus/context.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'assertions'
 require_relative 'identity'
@@ -16,15 +16,21 @@ module Sus
 			base.children = Hash.new
 		end
 		
-		def to_s
-			self.description || self.name
-		end
-		
-		def inspect
-			if description = self.description
-				"\#<#{self.name || "Context"} #{self.description}>"
-			else
-				self.name
+		unless respond_to?(:set_temporary_name)
+			def set_temporary_name(name)
+				# No-op.
+			end
+			
+			def to_s
+				(self.description || self.name).to_s
+			end
+			
+			def inspect
+				if description = self.description
+					"\#<#{self.name || "Context"} #{self.description}>"
+				else
+					self.name
+				end
 			end
 		end
 		

data/lib/sus/describe.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 
@@ -18,6 +18,8 @@ module Sus
 			base.subject = subject
 			base.description = subject.to_s
 			base.identity = Identity.nested(parent.identity, base.description, unique: unique)
+			base.set_temporary_name("#{self}[#{base.description}]")
+			
 			base.define_method(:subject, ->{subject})
 			
 			if block_given?

data/lib/sus/expect.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Sus
 	class Expect

data/lib/sus/file.rb

@@ -24,6 +24,10 @@ module Sus
 	module File
 		extend Context
 		
+		def self.[] path
+			self.build(Sus.base, path)
+		end
+		
 		def self.extended(base)
 			base.children = Hash.new
 		end
@@ -34,6 +38,7 @@ module Sus
 			base.extend(File)
 			base.description = path
 			base.identity = Identity.file(parent.identity, path)
+			base.set_temporary_name("#{self}[#{path}]")
 			
 			begin
 				TOPLEVEL_CLASS_EVAL.call(base, path)

data/lib/sus/filter.rb

@@ -1,9 +1,16 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Sus
+	# Provides a way to filter the registry according to the suffix on loaded paths.
+	#
+	# A test has an identity, e.g. the file and line number on which it's defined.
+	#
+	# A filter takes an identity, decomposes it into a file and suffix, loads the file, and registers the filter suffix.
+	#
+	# When the filter is used to enumerate the registry, it will only return the tests that match the suffix.
 	class Filter
 		class Index
 			def initialize

data/lib/sus/identity.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Sus
 	class Identity

data/lib/sus/include_context.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 

data/lib/sus/it.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 
@@ -12,6 +12,7 @@ module Sus
 			base.extend(It)
 			base.description = description
 			base.identity = Identity.nested(parent.identity, base.description, unique: unique)
+			base.set_temporary_name("#{self}[#{description}]")
 			
 			if block_given?
 				base.define_method(:call, &block)
@@ -64,5 +65,17 @@ module Sus
 			@__assertions__.skip(reason)
 			throw :skip, reason
 		end
+		
+		def skip_unless_method_defined(method, target)
+			unless target.method_defined?(method)
+				skip "Method #{method} is not defined in #{target}!"
+			end
+		end
+		
+		def skip_unless_constant_defined(constant, target = Object)
+			unless target.const_defined?(constant)
+				skip "Constant #{constant} is not defined in #{target}!"
+			end
+		end
 	end
 end

data/lib/sus/it_behaves_like.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 
@@ -17,6 +17,7 @@ module Sus
 			base.children = Hash.new
 			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?

data/lib/sus/output/buffered.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require 'io/console'
 require 'stringio'

data/lib/sus/output/null.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'messages'
 

data/lib/sus/output/text.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'messages'
 require_relative 'buffered'

data/lib/sus/raise_exception.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Sus
 	class RaiseException

data/lib/sus/registry.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 # Copyright, 2022, by Brad Schrag.
 
 require_relative 'base'
@@ -35,7 +35,7 @@ module Sus
 		end
 		
 		def to_s
-			@base.identity.to_s
+			@base&.identity&.to_s || self.class.name
 		end
 		
 		def load(path)

data/lib/sus/tree.rb

@@ -1,3 +1,8 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023, by Samuel Williams.
+
 module Sus
 	class Tree
 		def initialize(context)

data/lib/sus/version.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 module Sus
-	VERSION = "0.21.1"
+	VERSION = "0.21.2"
 end

data/lib/sus/with.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'context'
 
@@ -19,6 +19,8 @@ module Sus
 			base.subject = subject
 			base.description = subject
 			base.identity = Identity.nested(parent.identity, base.description, unique: unique)
+			base.set_temporary_name("#{self}[#{base.description}]")
+			
 			base.variables = variables
 			
 			base.define_method(:description, ->{subject})

data/lib/sus.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2022, by Samuel Williams.
+# Copyright, 2021-2023, by Samuel Williams.
 
 require_relative 'sus/version'
 require_relative 'sus/config'

data/readme.md

@@ -1,4 +1,4 @@
-# Sus(picious) \[working name\]
+# Sus(picious)
 
 An opinionated test framework designed with several goals:
 
@@ -38,8 +38,18 @@ Check `test` directory for examples.
 
 ## Contributing
 
+We welcome contributions to this project.
+
 1.  Fork it.
 2.  Create your feature branch (`git checkout -b my-new-feature`).
 3.  Commit your changes (`git commit -am 'Add some feature'`).
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
+
+### Developer Certificate of Origin
+
+This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+
+### Contributor Covenant
+
+This project is governed by [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sus
 version: !ruby/object:Gem::Version
-  version: 0.21.1
+  version: 0.21.2
 platform: ruby
 authors:
 - Samuel Williams
@@ -38,50 +38,8 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2023-06-14 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: bake-test
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: bake-test-external
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.1'
-- !ruby/object:Gem::Dependency
-  name: covered
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.18'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.18'
+date: 2023-07-21 00:00:00.000000000 Z
+dependencies: []
 description:
 email:
 executables:
@@ -155,14 +113,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.7
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: A fast and scalable test runner.