sus 0.30.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1b91ed35726c8afcbc97fd2c73ea28d433874f7976958b26beebd9f4ed1dfe4
-  data.tar.gz: 2295e4817295a52265e94c4eadf708f15b4502ecd40e42b76a44570c3f7c5f2b
+  metadata.gz: c3ef71ae68fa2f1c55825c77c389370bd8903b6888bc1a4034126d945c0d0e0c
+  data.tar.gz: 4abbb662af110be31822445fbb76049a26df539630d68466231dd117bb4ef50b
 SHA512:
-  metadata.gz: 821e42e75cb7628974b6e10b036eb222aa35adfbafb25dc7b773b7b2ba8714c1a292c9ab539763567e1a1010f814aeada965b406eb77969a2f78c6dbf59c82e1
-  data.tar.gz: 44a648f339a1a947037bdfde3a5e84f875dc9fb5b018133b8e269c572f33ff90dd05c9bfe86f233df60b6ae7357b08ec62523841dddc1cd137327c445d13258e
+  metadata.gz: c7ccf1055d49fdb0dcb45b4c3cad14c91f325bc0e897018680354cc1a6ae83c5476f7a240370a98569eabb523603d7b2006e3bd028571e82ef8e0138c337cd13
+  data.tar.gz: 49c602c11a456c8eaefcf105e4c135efd18c8c62a3106fc475de03245ce99ace9281d2a246528b0bff96ff153983430748967e4ee7b530e6a91008bbf9044394

data/lib/sus/base.rb

@@ -16,18 +16,31 @@ module Sus
 			"\#<Sus::Base for #{self.class.description.inspect}>"
 		end
 		
+		# A hook which is called before the test is executed.
+		#
+		# If you override this method, you must call super.
 		def before
 		end
 		
-		def after
+		# A hook which is called after the test is executed.
+		#
+		# If you override this method, you must call super.
+		def after(error = nil)
 		end
 		
-		def around
+		# Wrap logic around the test being executed.
+		#
+		# Invokes the before hook, then the block, then the after hook.
+		#
+		# @yields {...} the block which should execute a test.
+		def around(&block)
 			self.before
 			
-			return yield
+			return block.call
+		rescue => error
+			raise
 		ensure
-			self.after
+			self.after(error)
 		end
 		
 		def assert(...)

data/lib/sus/context.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2024, by Samuel Williams.
 
 require_relative 'assertions'
 require_relative 'identity'
@@ -78,15 +78,16 @@ module Sus
 		
 		# 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.
+		# Before hooks are usually invoked in the order they are defined, i.e. the first defined hook is invoked first.
 		#
 		# @parameter hook [Proc] The block to execute before each test.
 		def before(&hook)
 			wrapper = Module.new
 			
-			wrapper.define_method(:around) do |&block|
+			wrapper.define_method(:before) do
+				super()
+				
 				instance_exec(&hook)
-				super(&block)
 			end
 			
 			self.include(wrapper)
@@ -94,20 +95,18 @@ module Sus
 		
 		# 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.
+		# After hooks are usually invoked in the reverse order they are defined, i.e. the last defined hook is invoked first.
 		#
 		# @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)
+			wrapper.define_method(:after) do |error|
+				instance_exec(error, &hook)
 			rescue => error
 				raise
 			ensure
-				instance_exec(error, &hook)
+				super(error)
 			end
 			
 			self.include(wrapper)

data/lib/sus/include_context.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2024, 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-2023, by Samuel Williams.
+# Copyright, 2021-2024, by Samuel Williams.
 
 require_relative 'context'
 

data/lib/sus/mock.rb

@@ -82,7 +82,7 @@ module Sus
 	end
 
 	module Mocks
-		def after
+		def after(error = nil)
 			super
 			
 			@mocks&.each_value(&:clear)

data/lib/sus/shared.rb

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

data/lib/sus/version.rb

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

data/readme.md

@@ -1,40 +1,33 @@
-# Sus(picious)
+# Sus
 
-An opinionated test framework designed with several goals:
+Sus is a testing framework for Ruby.
 
-  - As fast as possible, aiming for \~10,000 assertions per second per core.
-  - Isolated tests which parallelise easily (including `class` definitions).
-  - Native support for balanced (work-stealing) multi-core execution.
-  - Incredible test output with detailed failure logging (including nested assertions and predicates).
+- It's similar to RSpec but with less baggage and more parallelism.
+- It uses `expect` style syntax with first-class predicates.
+- It has direct [support for code coverage](https://github.com/socketry/covered).
+- It supports the [VSCode Test Runner interface](https://github.com/socketry/sus-vscode).
+- It's based on my experience writing thousands of tests.
+- It's easy to extend (see the `sus-fixtures-` gems for examples).
 
-Non-features:
+[![Development Status](https://github.com/socketry/sus/workflows/Test/badge.svg)](https://github.com/socketry/sus/actions?workflow=Test)
 
-  - Flexibility at the expense of performance.
-  - Backwards compatibility.
+## Lightning Talk: Testing with Sus (2023)
 
-[![Development Status](https://github.com/sus-rb/sus/workflows/Test/badge.svg)](https://github.com/sus-rb/sus/actions?workflow=Test)
+<div align="center">
+  <a href="https://www.youtube.com/watch?v=BDQHgb2rrwU">
+    <img src="https://img.youtube.com/vi/BDQHgb2rrwU/0.jpg" alt="Testing with Sus">
+  </a>
+</div>
 
-## Ideas
-
-I've been thinking about how this should grow long term. I see a separation between "defining tests" and "running tests". I think this gem should be split across those responsibilities. By doing so, defining tests remains relatively static, but can be extended independently of execution model. And execution models which include parallelism, code coverage, multi-server, etc can be implemented effectively.
-
-The key point is that we need a well defined interface between defining tests and running tests. This interface is provided by the test registry, which can load test files. The test registry provides a way to enumerate all tests where each test has an identity that uniquely identifies it.
-
-### Sequential vs Parallel
-
-`sus` has both sequential and multi-threaded (`sus-parallel`) execution models for tests. Parallel execution is potentially much faster. This is an experimental feature.
-
-![Sequential vs Parallel](https://user-images.githubusercontent.com/30030/144770080-092cf07b-b121-4754-96e0-8ff1d8ea0695.mov)
+## Usage
 
-## Installation
+Please see the [project documentation](https://socketry.github.io/sus/) for more details.
 
-``` shell
-bundle add sus
-```
+  - [Getting Started](https://socketry.github.io/sus/guides/getting-started/index) - This guide explains how to use the `sus` gem to write tests for your Ruby projects.
 
-## Usage
+## See Also
 
-Check `test` directory for examples.
+- [sus-vscode](https://github.com/socketry/sus-vscode) - Visual Studio Code extension for Sus.
 
 ## Contributing
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sus
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -38,7 +38,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-07-22 00:00:00.000000000 Z
+date: 2024-07-28 00:00:00.000000000 Z
 dependencies: []
 description:
 email:
@@ -101,13 +101,13 @@ files:
 - lib/sus/with.rb
 - license.md
 - readme.md
-homepage: https://github.com/sus-rb/sus
+homepage: https://github.com/socketry/sus
 licenses:
 - MIT
 metadata:
-  documentation_uri: https://sus-rb.github.io/sus/
+  documentation_uri: https://socketry.github.io/sus/
   funding_uri: https://github.com/sponsors/ioquatix/
-  source_code_uri: https://github.com/sus-rb/sus.git
+  source_code_uri: https://github.com/socketry/sus.git
 post_install_message:
 rdoc_options: []
 require_paths: