v1.26.0

1.26.0

Features

• When a polled function returns an error, keep track of the actual and report on the matcher state of the last non-errored actual [21f3090]
• improve eventually failure message output [c530fb3]

Fixes

• fix several documentation spelling issues [e2eff1f]

v1.25.0

1.25.0

Features

• add MustPassRepeatedly(int) to asyncAssertion (#619) [4509f72]
• compare unwrapped errors using DeepEqual (#617) [aaeaa5d]

Maintenance

• Bump golang.org/x/net from 0.4.0 to 0.5.0 (#614) [c7cfea4]
• Bump github.com/onsi/ginkgo/v2 from 2.6.1 to 2.7.0 (#615) [71b8adb]
• Docs: Fix typo "MUltiple" -> "Multiple" (#616) [9351dda]
• clean up go.sum [cd1dc1d]

v1.24.2

1.24.2

Fixes

• Correctly handle assertion failure panics for eventually/consistnetly "g Gomega"s in a goroutine [78f1660]
• docs:Fix typo "you an" -> "you can" (#607) [3187c1f]
• fixes issue #600 (#606) [808d192]

Maintenance

• Bump golang.org/x/net from 0.2.0 to 0.4.0 (#611) [6ebc0bf]
• Bump nokogiri from 1.13.9 to 1.13.10 in /docs (#612) [258cfc8]
• Bump github.com/onsi/ginkgo/v2 from 2.5.0 to 2.5.1 (#609) [e6c3eb9]

v1.24.1

v1.24.1

v1.24.0

1.24.0

Features

Introducting gcustom - a convenient mechanism for building custom matchers.

This is an RC release for gcustom. The external API may be tweaked in response to feedback however it is expected to remain mostly stable.

Maintenance

• Update BeComparableTo documentation [756eaa0]

v1.23.0

1.23.0

Features

• Custom formatting on a per-type basis can be provided using format.RegisterCustomFormatter() -- see the docs here

• Substantial improvement have been made to StopTrying():

  • Users can now use StopTrying().Wrap(err) to wrap errors and StopTrying().Attach(description, object) to attach arbitrary objects to the StopTrying() error
  • StopTrying() is now always interpreted as a failure. If you are an early adopter of StopTrying() you may need to change your code as the prior version would match against the returned value even if StopTrying() was returned. Going forward the StopTrying() api should remain stable.
  • StopTrying() and StopTrying().Now() can both be used in matchers - not just polled functions.

• TryAgainAfter(duration) is used like StopTrying() but instructs Eventually and Consistently that the poll should be tried again after the specified duration. This allows you to dynamically adjust the polling duration.

• ctx can now be passed-in as the first argument to Eventually and Consistently.

Maintenance

• Bump github.com/onsi/ginkgo/v2 from 2.3.0 to 2.3.1 (#597) [afed901]
• Bump nokogiri from 1.13.8 to 1.13.9 in /docs (#599) [7c691b3]
• Bump github.com/google/go-cmp from 0.5.8 to 0.5.9 (#587) [ff22665]

v1.22.1

1.22.1

Fixes

• When passed a context and no explicit timeout, Eventually will only timeout when the context is cancelled [e5105cf]
• Allow StopTrying() to be wrapped [bf3cba9]

Maintenance

• bump to ginkgo v2.3.0 [c5d5c39]

v1.22.0

1.22.0

Features

Several improvements have been made to Eventually and Consistently in this and the most recent releases:

• Eventually and Consistently can take a context.Context [65c01bc]
  This enables integration with Ginkgo 2.3.0's interruptible nodes and node timeouts.
• Eventually and Consistently that are passed a SpecContext can provide reports when an interrupt occurs [0d063c9]
• Eventually/Consistently will forward an attached context to functions that ask for one [e2091c5]
• Eventually/Consistently supports passing arguments to functions via WithArguments() [a2dc7c3]
• Eventually and Consistently can now be stopped early with StopTrying(message) and StopTrying(message).Now() [52976bb]

These improvements are all documented in Gomega's docs

v1.21.1

v1.21.1

Features

• Eventually and Consistently that are passed a SpecContext can provide reports when an interrupt occurs [0d063c9]

v1.21.0

1.21.0

Features

• Eventually and Consistently can take a context.Context [65c01bc]
  This enables integration with Ginkgo 2.3.0's interruptible nodes and node timeouts.
• Introduces Eventually.Within.ProbeEvery with tests and documentation (#591) [f633800]
• New BeKeyOf matcher with documentation and unit tests (#590) [fb586b3]

Fixes

• Cover the entire gmeasure suite with leak detection [8c54344]
• Fix gmeasure leak [119d4ce]
• Ignore new Ginkgo ProgressSignal goroutine in gleak [ba548e2]

Maintenance

• Fixes crashes on newer Ruby 3 installations by upgrading github-pages gem dependency (#596) [12469a0]