All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Changes in state strings or Unity Editor utilities are not considered breaking changes. Experimental features are also not under semantic versioning.
4.5.0 - 2024-05-25
- Added support for Unity 2022
- Added
RepeatUntil
extension on test instruction - Added documentation for experimental Godot support
- Never collapse responders in state strings (even when completed or not executed). More info is better here.
Responsible.Bdd
no longer considered experimental.
- Fix path trimming (start from "Assets") in failure messages on Windows
- Internal tests: Fix some tests that didn't work properly depending on platform and/or locale
- Dropped support for Unity 2019 and 2020
4.4.0 - 2023-03-23
RunAsLoop
andRunAsSimulatedUpdateLoop
operators, for running test instructions synchronously as a loop with a tick callback.Repeatedly
operator, which turns a test responder into an optional responder that executes repeatedly.
- Include hint in state strings about being able to provide extra context to wait conditions
- Improve exception message handling by not truncating long messages (I don't remember why I did this originally)
- Add a bit of padding to the Unity operation status window
- Fix some state strings on Windows, where
Environment.NewLine
is more than one character. - Fix some cancellation issues with Unity 2021 (where cancellation might happen asynchronously later in the same frame)
4.3.0 - 2022-04-17
- New
GroupedAs
operator to allow more control over the state strings of compound operations. - Experimental: New BDD-style keywords to build scenarios.
- Experimental:
responsible-gherkin
dotnet tool to convert Gherkin feature specifications into Responsible test stubs. This is a separate NuGet package, and will not have a changelog until there's a 1.0 release. Feel free to try it out by installing withdotnet tool install -g Beatwaves.ResponsibleGherkin
4.2.0 - 2021-10-13
- Allow passing a list of exceptions to be rethrown, instead of wrapped in
TestFailureException
. This allows e.g. NUnit'sIgnoreException
to function properly.
- Long descriptions in the operation state window no longer cause tests to fail because Unity spits out an error about too many vertices in a Label.
- Make NUnit's
Assert.Ignore
,Assert.Inconclusive
, andAssert.Pass
work properly on Unity (see Added section above for .NET).
4.1.2 - 2021-07-17
TestInstructionExecutor.Dispose
no longer throws an exception if called twice.Sequence
will no longer include duplicate entires in the test instruction stack section of error messages.
- Use
X s ≈ Y frames
instead ofX s and Y frames
in output to clarify the meaning. - Add stack trace to
UnhandledLogMessageException.Message
- Unity: Intercept errors logged from non-Unity threads also.
4.1.1 - 2021-05-20
- Fix error handling in
ContinueWith
andAndThen
to publish the correct exception. This was previously causing an internal exception to be published instead under certain conditions.
- Change responder state string from
EXPECTED WITHIN
toCONDITION EXPECTED WITHIN
to better reflect what it actually does.
4.1.0 - 2021-05-13
- Fix description of
Return
. - Handle source paths not under project gracefully when executing in Unity Editor.
- Fix state string if
ContinueWith
orAndThen
continuation function throws an exception.
- Handle aborting tests better in the Unity state window.
- Simplify unnecessarily complex timeout time formatting.
- Allow passing
IGlobalContextProvider
toUnityTestInstructionExecutor
.
4.0.0 - 2021-03-28
- Removed the UniRx dependency, now uses
async/await
internally instead. - Unity-specific functionality was moved to work through abstractions.
Unit
-typed operators now useobject
instead. This works better most of the time, due to covariance!- Operation state notifications use a callback instead of an observable.
- All observable-related functions (
ToObservable
,WaitForLast
). AsUnit...
operators: you can useBoxResult
or just implicit covariance instead.
- Support for .NET standard 2.0 (and NuGet publishing)
ToTask
methods, which replaceToObservable
. Note: If you were using these, you can use the UniRxToObservable
method to convert a task to an observable.UnityTestInstructionExecutor
, which should provide the same functionality asTestInstructionExecutor
did before.BoxResult
operators: replaceAsUnit...
operators when working with value types.WaitForTask
operator.- Support for adding extra global context into failure messages.
3.0.1 - 2021-03-14
- Fix inclusion of documentation in releases, no changes in the library itself.
3.0.0 - 2021-03-14
- HTML documentation generated with DocFX
- Test operation status window in Unity Editor, under
Window/Responsible/Operation State
- Some parameters renamed for better documentation.
- Classes and functionality which was intended to be internal were marked as internal.
2.0.0 - 2021-02-26
- Simplifies the public API by reducing the number of overloads used. This should make auto-completion and compiler errors more friendly.
- Removes
WaitForCondition
,WaitForConditionOn
andWaitForCoroutine
overrides, which make a result using a selector:Select
can be used instead. - Synchronous
ThenRespondWith
overrides renamed toThenRespondWithFunc
andThenRespondWithAction
- Splits
WaitForCoroutine
to two versions:WaitForCoroutine
andWaitForCoroutineMethod
.
1.2.0 - 2020-12-02
- Fix source context of
Responsible.Do
("DoAndReturn"
->"Do"
) - Show canceled wait conditions as canceled instead of running in output. A wait may get canceled e.g. as part of an optional test responder.
- Simplify output when
ExpectWithinSecond
is used, by showingEXPECTED WITHIN ...
on the same line as the expected operation, instead ofEXPECT WITHIN ...
with the operation nested below it. This is only applicable to simple wait conditions and responders.
1.1.0 - 2020-11-11
WaitForConditionOn
for a more streamlined syntax for waiting for a condition on some object, and then returning that object (or something derived from that object).WaitForFrames
, for those cases when you actually really need it- Allows executing
ITestOperationState
usingToYieldInstruction/Observable
, allowing you to log the state while executing it. - Sample project with sample tests.
- Add context to output when
ExpectWithinSeconds
times out. - Fix referential transparency of
WaitForConstraint
:IResolveConstraint.Resolve()
can mutate the condition and produce weird results when called multiple times.
- Makes
...Seconds
operators usedouble
instead ofint
(practically backwards compatible). - Improve documentation, especially about getting started.
- Move tests out of package, so that they don't get included in projects that use Responsible.
1.0.0 - 2020-09-23
- Initial public release with basic functionality.