sus 0.35.2 → 0.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38873e75813a38f0b6a1d95006cf285ad40deabf372ea4dd6014e0ab41d994a9
-  data.tar.gz: 9d9bb3cbf3dc3eaba78d5ebe4880f3cef862cffbbb50f7760e27a994776c2ed4
+  metadata.gz: 13490197ec8a1933e204be63306d7073dc91031f91014540d2fb32f28a5a9fe8
+  data.tar.gz: d95be355e8ee973b7c6873024dea1aca229ead1ca07ac32ee758c1c200cffa2c
 SHA512:
-  metadata.gz: 3e6bc26c14aaf3be9b3232eda519a47fa05b659ff4baf501da3c830548ead2e4125ab0e37c7a28693fd5fce93fd0aa122ea09ce3843a939170de4f1726f6decd
-  data.tar.gz: 100146d5119b3bdff4cfb924173385338dfba86ea1d65f11bd5270422d872185532c59857971e14afeeea2d0212e02d44b7449b1dedd1318030d1e5e41524a04
+  metadata.gz: e7282096b713bbaf9b6e08839ccc8436c4660c4e2b913c08a9af6867b84ea518f0ba2366db46a67d30e81d20ce845a32dcfb4f13e1712fdc6aabe01e7f67b4af
+  data.tar.gz: be1584808b3db0e3ef6bfc1c9d06c928ad0ca292244dd8a53633cc619107ac74604240d5fb916329654ac68df5033456e1802db28f9af308528341b17bf899c4

data/lib/sus/base.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/be.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents a predicate matcher that can be used with `expect(...).to be(...)`.
@@ -146,7 +146,10 @@ module Sus
 			output.write("be ", :be, operation.to_s, :reset)
 			
 			if arguments.any?
-				output.write(" ", :variable, arguments.map(&:inspect).join, :reset)
+				output.write(" ")
+				arguments.each do |argument|
+					output.variable(argument)
+				end
 			end
 		end
 		

data/lib/sus/be_truthy.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2023, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
 
 module Sus
 	# Represents a predicate that checks if the subject is truthy.

data/lib/sus/be_within.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents a predicate that checks if the subject is within a tolerance of a value.

data/lib/sus/clock.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2023, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
 
 module Sus
 	# Represents a clock for measuring elapsed time during test execution.

data/lib/sus/config.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2025, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
+# Copyright, 2026, by William T. Nelson.
 
 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-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "assertions"
 require_relative "identity"

data/lib/sus/describe.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/expect.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents an expectation that can be used with predicates to make assertions.
@@ -15,8 +15,8 @@ module Sus
 			@assertions = assertions
 			@subject = subject
 			
-			# We capture this here, as changes to state may cause the inspect output to change, affecting the output produced by #print.
-			@inspect = @subject.inspect
+			# We capture this here, as changes to state may cause the inspect output to change, affecting the output produced by #print. The representation is buffered (as a stream of styled tokens) and truncated to avoid excessively noisy output for large subjects; colours are resolved later when the buffer is replayed into the output.
+			@inspect = Output::Variable.buffer(@subject)
 			
 			@inverted = inverted
 			@distinct = true
@@ -39,7 +39,9 @@ module Sus
 		# Print a representation of this expectation.
 		# @parameter output [Output] The output target.
 		def print(output)
-			output.write("expect ", :variable, @inspect, :reset, " ")
+			output.write("expect ")
+			output.append(@inspect)
+			output.write(" ")
 			
 			if @inverted
 				output.write("not to", :reset)

data/lib/sus/file.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 # Copyright, 2022, by Brad Schrag.
 
 require_relative "context"

data/lib/sus/filter.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Provides a way to filter the registry according to the suffix on loaded paths.

data/lib/sus/fixtures/temporary_directory_context.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2024, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require "tmpdir"
 

data/lib/sus/fixtures.rb

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

data/lib/sus/have/all.rb

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

data/lib/sus/have/any.rb

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

data/lib/sus/have.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2024, by Samuel Williams.
+# Copyright, 2022-2026, by Samuel Williams.
 
 require_relative "have/all"
 require_relative "have/any"
+require_relative "output/variable"
 
 module Sus
 	# Represents predicates for checking collections and object attributes.
@@ -22,7 +23,9 @@ module Sus
 			# Print a representation of this predicate.
 			# @parameter output [Output] The output target.
 			def print(output)
-				output.write("key ", :variable, @name.inspect, :reset, " ", @predicate, :reset)
+				output.write("key ")
+				output.variable(@name)
+				output.write(" ", @predicate, :reset)
 			end
 			
 			# Evaluate this predicate against a subject.
@@ -89,7 +92,13 @@ module Sus
 				index = 0
 				
 				subject.each do |value|
-					assertions.nested("[#{index}] = #{value.inspect}", distinct: true) do |assertions|
+					# Capture the label (index and value) as a buffer of formatting
+					# instructions, so the value is truncated/styled consistently:
+					label = Output::Buffered.new
+					label.write("[#{index}] = ")
+					label.variable(value)
+					
+					assertions.nested(label, distinct: true) do |assertions|
 						@predicate&.call(assertions, value)
 					end
 					

data/lib/sus/have_duration.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents a predicate that measures the duration of a block execution.

data/lib/sus/identity.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents a unique identity for a test or context, used for identification and location tracking.

data/lib/sus/integrations.rb

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

data/lib/sus/it.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/it_behaves_like.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/let.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/output/backtrace.rb

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

data/lib/sus/output/bar.rb

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

data/lib/sus/output/buffered.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require "io/console"
 require "stringio"
 
+require_relative "text"
+
 module Sus
 	module Output
 		# Represents a buffered output handler that stores output operations for later replay.
@@ -51,6 +53,14 @@ module Sus
 				@tee&.append(buffer)
 			end
 			
+			# Replay this buffer into the given output. This allows a buffer (a captured
+			# stream of formatting instructions) to be used anywhere a printable target
+			# is expected, e.g. as a nested assertion label.
+			# @parameter output [Output] The output target.
+			def print(output)
+				output.append(self)
+			end
+			
 			# @returns [String] The buffered output as a string.
 			def string
 				io = StringIO.new
@@ -99,6 +109,14 @@ module Sus
 				@tee&.puts(*arguments)
 			end
 			
+			# Write a value in the variable style: a compact, truncated representation
+			# (handling large values, recursion and styling internally).
+			# @parameter value [Object] The value to represent.
+			# @parameter limit [Integer] The maximum length of the representation.
+			def variable(value, limit: Variable::TRUNCATION_LIMIT)
+				Variable.format(self, value, limit: limit)
+			end
+			
 			# Record an assertion.
 			# @parameter arguments [Array] The assertion arguments.
 			def assert(*arguments)

data/lib/sus/output/lines.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require "io/console"
 

data/lib/sus/output/progress.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "bar"
 require_relative "status"

data/lib/sus/output/status.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	module Output
@@ -10,8 +10,8 @@ module Sus
 			# Register status styling with an output handler.
 			# @parameter output [Output] The output handler to register with.
 			def self.register(output)
-				output[:free] ||= output.style(:blue)
-				output[:busy] ||= output.style(:orange)
+				output[:free] ||= output.style(:green)
+				output[:busy] ||= output.style(:blue)
 			end
 			
 			# Initialize a new Status indicator.

data/lib/sus/output/structured.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2024, by Samuel Williams.
+# Copyright, 2023-2026, by Samuel Williams.
 
 require_relative "null"
 

data/lib/sus/output/text.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "messages"
 require_relative "buffered"
@@ -139,6 +139,14 @@ module Sus
 				write(*arguments)
 				@io.puts(self.reset)
 			end
+			
+			# Write a value in the variable style: a compact, truncated representation
+			# (handling large values, recursion and styling internally).
+			# @parameter value [Object] The value to represent.
+			# @parameter limit [Integer] The maximum length of the representation.
+			def variable(value, limit: Variable::TRUNCATION_LIMIT)
+				Variable.format(self, value, limit: limit)
+			end
 		end
 	end
 end

data/lib/sus/output/variable.rb

@@ -0,0 +1,178 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require_relative "buffered"
+
+module Sus
+	module Output
+		# Provides a compact, truncated representation of values for output.
+		#
+		# Rather than building a full `inspect` string and then truncating it, we walk
+		# the value and stream tokens directly into an output, aborting as soon as a
+		# character budget is exhausted. This means we never materialize the full
+		# representation of a large subject (e.g. a big array or richly inspected
+		# instance).
+		#
+		# Containers (arrays and hashes) are formatted directly so we can recurse with
+		# the budget; leaf values delegate to native `inspect` so their formatting
+		# exactly matches Ruby. The value itself is emitted in a single style (matching
+		# the rest of sus's output), and only the truncation ellipsis is highlighted
+		# distinctly so it's clear where output was cut.
+		module Variable
+			# The maximum length of an inspected value before it is truncated. Override
+			# it with the `SUS_OUTPUT_VARIABLE_TRUNCATION_LIMIT` environment variable; a
+			# value of `0` (or `nil`) disables truncation entirely.
+			TRUNCATION_LIMIT = ENV.fetch("SUS_OUTPUT_VARIABLE_TRUNCATION_LIMIT", 100).then do |value|
+				value = Integer(value)
+				value.zero? ? nil : value
+			end
+			
+			# The string appended to a truncated value.
+			ELLIPSIS = "…"
+			
+			# Walks a value and emits styled tokens to an output, aborting once the
+			# character budget is exhausted.
+			class Formatter
+				# Raised internally to abort formatting once the limit is reached.
+				class Truncated < StandardError
+				end
+				
+				# @parameter output [Output] The output target to write tokens to.
+				# @parameter limit [Integer] The maximum number of characters to emit.
+				def initialize(output, limit:)
+					@output = output
+					@remaining = limit
+					@seen = nil
+				end
+				
+				# Emit a token in the variable style, truncating and aborting once the
+				# budget is exceeded.
+				# @parameter text [String] The token text to emit.
+				def emit(text)
+					truncated = false
+					
+					if text.length > @remaining
+						text = text[0, @remaining]
+						truncated = true
+					end
+					
+					@remaining -= text.length
+					
+					@output.write(:variable, text, :reset)
+					
+					raise Truncated if truncated
+				end
+				
+				# Format a value, emitting styled tokens to the output.
+				# @parameter value [Object] The value to format.
+				def format(value)
+					case value
+					when String
+						# Inspect only a prefix so we never escape a huge string:
+						slice = value.length > @remaining ? value[0, @remaining] : value
+						emit(slice.inspect)
+					when Array
+						format_array(value)
+					when Hash
+						format_hash(value)
+					else
+						format_object(value)
+					end
+				end
+				
+				private
+				
+				def format_array(array)
+					if @seen&.key?(array.object_id)
+						return emit("[...]")
+					end
+					
+					(@seen ||= {})[array.object_id] = true
+					
+					begin
+						emit("[")
+						array.each_with_index do |element, index|
+							emit(", ") if index > 0
+							format(element)
+						end
+						emit("]")
+					ensure
+						@seen.delete(array.object_id)
+					end
+				end
+				
+				def format_hash(hash)
+					if @seen&.key?(hash.object_id)
+						return emit("{...}")
+					end
+					
+					(@seen ||= {})[hash.object_id] = true
+					
+					begin
+						emit("{")
+						first = true
+						hash.each do |key, value|
+							emit(", ") unless first
+							first = false
+							
+							if key.is_a?(Symbol)
+								# Label form for symbol keys, e.g. `key: value`:
+								emit("#{key.inspect.delete_prefix(":")}: ")
+							else
+								format(key)
+								emit(" => ")
+							end
+							
+							format(value)
+						end
+						emit("}")
+					ensure
+						@seen.delete(hash.object_id)
+					end
+				end
+				
+				def format_object(value)
+					emit(value.inspect)
+				rescue Truncated
+					raise
+				rescue => error
+					emit("#<#{value.class} (inspect failed: #{error.class})>")
+				end
+			end
+			
+			# Format a value into the given output, truncating at the limit.
+			# @parameter output [Output] The output target.
+			# @parameter value [Object] The value to format.
+			# @parameter limit [Integer] The maximum length of the representation.
+			def self.format(output, value, limit: TRUNCATION_LIMIT)
+				# With no limit, the formatter would produce exactly `value.inspect`, so
+				# we can skip walking the value and emit it directly:
+				unless limit
+					return output.write(:variable, value.inspect, :reset)
+				end
+				
+				formatter = Formatter.new(output, limit: limit)
+				
+				begin
+					formatter.format(value)
+				rescue Formatter::Truncated
+					output.write(:ellipsis, ELLIPSIS, :reset)
+				end
+			end
+			
+			# Capture a value's representation into a buffer, resolving the value
+			# immediately, but deferring colour resolution until the buffer is replayed
+			# into a real output.
+			# @parameter value [Object] The value to capture.
+			# @parameter limit [Integer] The maximum length of the representation.
+			# @returns [Buffered] A buffer containing the captured representation.
+			def self.buffer(value, limit: TRUNCATION_LIMIT)
+				buffer = Buffered.new
+				self.format(buffer, value, limit: limit)
+				return buffer
+			end
+		end
+	end
+end

data/lib/sus/output/xterm.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require "io/console"
 

data/lib/sus/output.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "output/bar"
 require_relative "output/text"
@@ -13,11 +13,19 @@ require_relative "output/progress"
 module Sus
 	# Represents output handlers for test results and messages.
 	module Output
+		# Detect if we're running in GitHub Actions, where human-readable output is preferred.
+		# GitHub Actions sets the GITHUB_ACTIONS environment variable to "true".
+		# @parameter env [Hash] The environment variables to check.
+		def self.github_actions?(env)
+			env["GITHUB_ACTIONS"] == "true"
+		end
+		
 		# Create an appropriate output handler for the given IO.
 		# @parameter io [IO] The IO object to write to.
-		# @returns [XTerm, Text] An XTerm handler if the IO is a TTY, otherwise a Text handler.
-		def self.for(io)
-			if io.isatty
+		# @parameter env [Hash] The environment variables to consider (defaults to ENV).
+		# @returns [XTerm, Text] An XTerm handler if the IO is a TTY or running in GitHub Actions, otherwise a Text handler.
+		def self.for(io, env = ENV)
+			if io.isatty or self.github_actions?(env)
 				XTerm.new(io)
 			else
 				Text.new(io)
@@ -26,9 +34,10 @@ module Sus
 		
 		# Create a default output handler with styling configured.
 		# @parameter io [IO] The IO object to write to (defaults to $stderr).
+		# @parameter env [Hash] The environment variables to consider (defaults to ENV).
 		# @returns [XTerm, Text] A configured output handler.
-		def self.default(io = $stderr)
-			output = self.for(io)
+		def self.default(io = $stderr, env = ENV)
+			output = self.for(io, env)
 			
 			Output::Bar.register(output)
 			
@@ -40,6 +49,10 @@ module Sus
 			
 			output[:variable] = output.style(:blue, nil, :bold)
 			
+			# The ellipsis marks where an inspected value was truncated; it is shown
+			# faintly so it reads as "trailing off" without competing with the value.
+			output[:ellipsis] = output.style(nil, nil, :faint)
+			
 			output[:path] = output.style(:yellow)
 			output[:line] = output.style(:yellow)
 			output[:identity] = output.style(:yellow)

data/lib/sus/raise_exception.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 module Sus
 	# Represents a predicate that checks if a block raises an exception.
 	class RaiseException
 		# Initialize a new RaiseException predicate.
 		# @parameter exception_class [Class] The exception class to expect.
-		# @parameter message [String, Regexp, Object | Nil] Optional message matcher.
+		# @parameter message [String | Regexp | Object | Nil] Optional message matcher.
 		def initialize(exception_class = Exception, message: nil)
 			@exception_class = exception_class
 			@message = message
@@ -68,7 +68,7 @@ module Sus
 	class Base
 		# Create a predicate that checks if a block raises an exception.
 		# @parameter exception_class [Class] The exception class to expect.
-		# @parameter message [String, Regexp, Object | Nil] Optional message matcher.
+		# @parameter message [String | Regexp | Object | Nil] Optional message matcher.
 		# @returns [RaiseException] A new RaiseException predicate.
 		def raise_exception(...)
 			RaiseException.new(...)

data/lib/sus/registry.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 # Copyright, 2022, by Brad Schrag.
 
 require_relative "base"

data/lib/sus/respond_to.rb

@@ -49,7 +49,8 @@ module Sus
 			# Print a representation of this constraint.
 			# @parameter output [Output] The output target.
 			def print(output)
-				output.write("with options ", :variable, @options.inspect)
+				output.write("with options ")
+				output.variable(@options)
 			end
 			
 			# Evaluate this constraint against method parameters.

data/lib/sus/shared.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus/tree.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2026, by Samuel Williams.
 
 module Sus
 	# Represents a tree structure of test contexts.

data/lib/sus/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2025, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 # @namespace
 module Sus
-	VERSION = "0.35.2"
+	VERSION = "0.37.0"
 end

data/lib/sus/with.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2024, by Samuel Williams.
+# Copyright, 2021-2026, by Samuel Williams.
 
 require_relative "context"
 

data/lib/sus.rb

@@ -6,6 +6,7 @@
 require_relative "sus/version"
 require_relative "sus/config"
 require_relative "sus/registry"
+require_relative "sus/output/variable"
 require_relative "sus/assertions"
 require_relative "sus/tree"
 

data/license.md

@@ -1,7 +1,8 @@
 # MIT License
 
-Copyright, 2021-2025, by Samuel Williams.  
+Copyright, 2021-2026, by Samuel Williams.  
 Copyright, 2022, by Brad Schrag.  
+Copyright, 2026, by William T. Nelson.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -33,6 +33,14 @@ Please see the [project documentation](https://socketry.github.io/sus/) for more
 
 Please see the [project releases](https://socketry.github.io/sus/releases/index) for all releases.
 
+### v0.37.0
+
+  - Long values in verbose (and failure) output are now truncated to a configurable length (default 100 characters), preventing huge objects from flooding the output. Set the `SUS_OUTPUT_VARIABLE_TRUNCATION_LIMIT` environment variable to change the limit, or `0` to disable truncation.
+
+### v0.36.0
+
+  - Hard code `XTerm` output for GitHub Actions, as it supports ANSI escape codes.
+
 ### v0.35.0
 
   - Add `Sus::Fixtures::TemporaryDirectoryContext`.
@@ -53,6 +61,7 @@ Please see the [project releases](https://socketry.github.io/sus/releases/index)
 ## See Also
 
   - [sus-vscode](https://github.com/socketry/sus-vscode) - Visual Studio Code extension for Sus.
+  - [minitest-sus](https://github.com/socketry/minitest-sus) - Use Sus fixtures within Minitest tests.
 
 ## Contributing
 
@@ -64,6 +73,22 @@ We welcome contributions to this project.
 4.  Push to the branch (`git push origin my-new-feature`).
 5.  Create new Pull Request.
 
+### Running Tests
+
+To run the test suite:
+
+``` shell
+bundle exec sus
+```
+
+### Making Releases
+
+To make a new release:
+
+``` shell
+bundle exec bake gem:release:patch # or minor or major
+```
+
 ### Developer Certificate of Origin
 
 In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.37.0
+
+  - Long values in verbose (and failure) output are now truncated to a configurable length (default 100 characters), preventing huge objects from flooding the output. Set the `SUS_OUTPUT_VARIABLE_TRUNCATION_LIMIT` environment variable to change the limit, or `0` to disable truncation.
+
+## v0.36.0
+
+  - Hard code `XTerm` output for GitHub Actions, as it supports ANSI escape codes.
+
 ## v0.35.0
 
   - Add `Sus::Fixtures::TemporaryDirectoryContext`.

metadata

@@ -1,11 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: sus
 version: !ruby/object:Gem::Version
-  version: 0.35.2
+  version: 0.37.0
 platform: ruby
 authors:
 - Samuel Williams
 - Brad Schrag
+- William T. Nelson
 bindir: bin
 cert_chain:
 - |
@@ -92,6 +93,7 @@ files:
 - lib/sus/output/status.rb
 - lib/sus/output/structured.rb
 - lib/sus/output/text.rb
+- lib/sus/output/variable.rb
 - lib/sus/output/xterm.rb
 - lib/sus/raise_exception.rb
 - lib/sus/receive.rb
@@ -118,14 +120,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A fast and scalable test runner.
 test_files: []