4.1 KiB
4.1 KiB
HEAD
1.2.0
Improvements:
- Added
BeSent
which attempts to send a value down a channel and fails if the attempt blocks. Can be paired withEventually
to safely send a value down a channel with a timeout. Ω
,Expect
,Eventually
, andConsistently
now immediatelypanic
if there is no registered fail handler. This is always a mistake that can hide failing tests.Receive()
no longer errors when passed a closed channel, it's perfectly fine to attempt to read from a closed channel so Ω(c).Should(Receive()) always fails and Ω(c).ShoudlNot(Receive()) always passes with a closed channel.- Added
HavePrefix
andHaveSuffix
matchers. ghttp
can now handle concurrent requests.- Added
Succeed
which allows one to writeΩ(MyFunction()).Should(Succeed())
. - Improved
ghttp
's behavior around failing assertions and panics:- If a registered handler makes a failing assertion
ghttp
will return500
. - If a registered handler panics,
ghttp
will return500
and fail the test. This is new behavior that may cause existing code to break. This code is almost certainly incorrect and creating a false positive.
- If a registered handler makes a failing assertion
ghttp
servers can take anio.Writer
.ghttp
will write a line to the writer when each request arrives.- Added
WithTransform
matcher to allow munging input data before feeding into the relevant matcher - Added boolean
And
,Or
, andNot
matchers to allow creating composite matchers - Added
gbytes.TimeoutCloser
,gbytes.TimeoutReader
, andgbytes.TimeoutWriter
- these are convenience wrappers that timeout if the underlying Closer/Reader/Writer does not return within the alloted time. - Added
gbytes.BufferReader
- this constructs agbytes.Buffer
that asynchronously reads the passed-inio.Reader
into its buffer.
Bug Fixes:
- gexec:
session.Wait
now usesEventuallyWithOffset
to get the right line number in the failure. ContainElement
no longer bails if a passed-in matcher errors.
1.0 (8/2/2014)
No changes. Dropping "beta" from the version number.
1.0.0-beta (7/8/2014)
Breaking Changes:
- Changed OmegaMatcher interface. Instead of having
Match
return failure messages, two new methodsFailureMessage
andNegatedFailureMessage
are called instead. - Moved and renamed OmegaFailHandler to types.GomegaFailHandler and OmegaMatcher to types.GomegaMatcher. Any references to OmegaMatcher in any custom matchers will need to be changed to point to types.GomegaMatcher
New Test-Support Features:
ghttp
: supports testing http clients- Provides a flexible fake http server
- Provides a collection of chainable http handlers that perform assertions.
gbytes
: supports making ordered assertions against streams of data- Provides a
gbytes.Buffer
- Provides a
Say
matcher to perform ordered assertions against output data
- Provides a
gexec
: supports testing external processes- Provides support for building Go binaries
- Wraps and starts
exec.Cmd
commands - Makes it easy to assert against stdout and stderr
- Makes it easy to send signals and wait for processes to exit
- Provides an
Exit
matcher to assert against exit code.
DSL Changes:
Eventually
andConsistently
can accepttime.Duration
interval and polling inputs.- The default timeouts for
Eventually
andConsistently
are now configurable.
New Matchers:
ConsistOf
: order-independent assertion against the elements of an array/slice or keys of a map.BeTemporally
: likeBeNumerically
but fortime.Time
HaveKeyWithValue
: asserts a map has a given key with the given value.
Updated Matchers:
Receive
matcher can take a matcher as an argument and passes only if the channel under test receives an objet that satisfies the passed-in matcher.- Matchers that implement
MatchMayChangeInTheFuture(actual interface{}) bool
can informEventually
and/orConsistently
when a match has no chance of changing status in the future. For example,Receive
returnsfalse
when a channel is closed.
Misc:
- Start using semantic versioning
- Start maintaining changelog
Major refactor:
- Pull out Gomega's internal to
internal