v1.8.0

New features:

• add new JSONPointer operator following RFC 6901;
• when 2 types differ but have the same short name, use full pkg name in error report;
• add Cmp and Smuggle hooks feature;
• new td.Tuple type added and its td.TupleFrom() builder. Useful to quickly test functions returning several values as in:

  price := func(p float64) (float64, string, error) {
    if p < 0 {
      return 0, "", errors.New("negative price not supported")
    }
    return p * 1.2, "€", nil
  }
  
  td.Cmp(t,
    td.TupleFrom(price(10)),
    td.TupleFrom(float64(12), "€", nil),
  )
  
  td.Cmp(t,
    td.TupleFrom(price(-10)),
    td.TupleFrom(float64(0), "", td.Not(nil)),
  )

• when calling tdhttp.NewRequest() (and all other request builder methods) headers can be flattened with td.Flatten().

Fixes:

• missing lock when resolving anchors;
• BeLax flag (set by Lax and JSON operators) was not taken into account for operators Any, Bag, Code, Contains, None, NotAny, Set, SubBagOf, SubSetOf, SuperBagOf and SuperSetOf.

Enjoy!

v1.7.0

New features:

• new (*td.T).RunAssertRequire function. Useful to avoid boilerplate code:

  t.RunAssertRequire("GetAge", func (assert *td.T, require *td.T) {
    age, err := GetAge("Bob")
    require.CmpNoError(err)
    assert.Cmp(age, 42)
  })

• new tdhttp.TestAPI method Or(), useful to debug a test failure:

  ta.Get("/person/42", "Accept", "application/json").
    CmpJSONBody(td.JSON(`{"id": $1, "name": "Bob"}`, td.NotZero())).
    Or(func (body string) { t.Logf("received unexpected body: <%s>", body) })

  see the Or() documentation as the passed function can have a much more complex signature. It is inspired by Test::Mojo or() method and allows to easily inspect the response of the requested API when the checks fail.

Fixes:

• #101 → some data recursion cases were not correctly handled (reported and tested by @stewi1014);
• some panics due to the user misbehavior were not properly red-colored;
• (*td.T).Run: t.Config is now copied instead of shared before using it in sub-func;
• typos in doc.

Enjoy!

v1.6.0

Changes:

• td.TestingFT interface is deprecated (but still usable) and superseded by testing.TB standard one: it allows to work with *testing.B instances as well (or any other type implementing testing.TB);
• (*td.T).RunT() is deprecated (but still usable) and superseded by (*td.T).Run() which now delegates to td.T.TB if it implements a Run() method with the following signature:

  (X) Run(string, func(X)) bool
  

Breaking changes:

• as td.TestingFT interface is now an alias on testing.TB, it does not contain Run(string, func (*testing.T)) bool anymore;
• it is quite unlikely that (*td.T).Run(string, func (*testing.T)) method is used, but if it is, all calls have to be replaced by (*td.T).Run(string, func (*td.T)) like in:

  tt.Run("my_test", func (tt *td.T) {
      t := tt.TB.(testing.T)
      ...
  })

  note that even though (*td.T).RunT() is deprecated, it still works as expected.

v1.5.0

New features:

• new Flatten function: useful to flatten non interface{} slices in Set, Bag arguments (but not only, read the doc);
• panic messages due to user misuse of go-testdeep functions/methods are now red colored to help her/him to focus on her/his mistake and not think go-testdeep failed shamefully;
• delay colors initialization to the first use. So colors can now be disabled in golang playgroung. See the corresponding FAQ point;
• optimize some type retrievals.

Fix:

• forbid Isa(nil) because it is a nonsense and so avoid a deep panic.

New FAQ entries:

• Why nil is handled so specifically?
• play.golang.org does not handle colors, error output is nasty

Enjoy and do not forget to star!

v1.4.0

New features:

• tdhttp package (aka HTTP API tester) enhanced and fully documented;
• new Delay operator;
• Contains operator reworked, smarter and []byte specifically handled;
• String, HasPrefix and HasSuffix operators now operate on []byte too.

Fixes:

• anchor feature on 32 bits platforms;
• missing comments + typos.

Enjoy, but at home! ;)

v1.3.0

Package github.com/maxatome/go-testdeep is deprecated, it is recommended to use github.com/maxatome/go-testdeep/td in new code.

github.com/maxatome/go-testdeep is still usable so the compatibility is preserved.

The only breaking change is the disappearance of testdeep.DefaultContextConfig. It should be replaced by td.DefaultContextConfig and so the go-testdeep import line should be changed (at least "github.com/maxatome/go-testdeep/td" should be added).

To summarize: migration to github.com/maxatome/go-testdeep/td is not needed, only recommended, except if testdeep.DefaultContextConfig is used.

To migrate:

import "github.com/maxatome/go-testdeep"
…
testdeep.DefaultContextConfig = testdeep.ContextConfig{…}
testdeep.Cmp(…)

or with "td" package alias:

import td "github.com/maxatome/go-testdeep"
…
td.DefaultContextConfig = td.ContextConfig{…}
td.Cmp(…)

simply do (see import line changes):

import "github.com/maxatome/go-testdeep/td"
…
td.DefaultContextConfig = td.ContextConfig{…}
td.Cmp(…)

See the FAQ point for details about this migration.

And still, do not forget to visit https://go-testdeep.zetta.rocks/ and open an issue if something seems to be missing or not clear.

Happy testing!

v1.2.0

New features:

• new operator anchoring feature, see the corresponding FAQ section and the new anchoring methods;
• new SStruct operator (and its friends CmpSStruct & T.SStruct),

Synopsis revisited (again)!

Enjoy powerful testing!

v1.1.2

New features:

• JSON expected by JSON, SubJSONOf and SuperJSONOf operators can now contain comments (/* … */ or // …) and some simple operators can directly be embedded in JSON, as $^NotEmpty for example;
• New SubJSONOf & SuperJSONOf operators;
• In case of error, JSON operator no longer truncates its JSON expected parameter in error message, but dumps all the operators involved using beautiful indented comments;
• Add Assert() *T, Require() *T and AssertRequire() (*T, *T).

Synopsis revisited!

Enjoy powerful API testing!

v1.1.1

News:

• New web site go-testdeep.zetta.rocks;
• FAQ grew a little.

New features:

• Add some tdhttp request builders shortcuts, see tdhttp.Get, tdhttp.Post, tdhttp.PostJSON, tdhttp.PostXML, etc.
• New Catch operator;
• New JSON and Tag operators;
• New BeLax feature with its Lax operator counterpart (+ CmpLax func)
• Ptr et PPtr operators gain some TypeBehind() capabilities.

v1.1.0

New features:

• introducing UseEqual feature to allow an objet to handle its comparison. See T.UseEqual and ContextConfig.UseEqual for details;
• tdhttp.NewRequest(), tdhttp.NewJSONRequest() and tdhttp.NewXMLRequest() now accept headers definition;
• Test name now colored in error reports;
• Missing/Extra summaries show the number of involved items/keys;
• Extra & missing maps items are now sorted;
• Cmp function/method now replaces CmpDeeply (still available for backward compatibility);
• Add new Keys and Values operators;
• Code & Smuggle operators explicitly refuse variadic functions (and so avoid uncontrolled runtime panic).

Breaking changes:

• *testdeep.T now implements testdeep.TestingFT:
  • previous Run() method renamed to RunT(),
  • un-shadow Run(string, func(t*testing.T)) → if you used T.Run just rename occurrences to T.RunT,
  • NewT() handles *testdeep.T as argument,
• Do not export testdeep.Base and testdeep.BaseOKNil anymore. Should not be a problem. If it is, raise an issue.

Bugs fixes:

• Fix a bug when compared slices have the same backend array.

Misc:

• Switch from gometalinter to GolangCI-Lint + enable more linters;
• pre-go1.12 t.Helper() bug workaround removed as corrected upstream;
• map iterations done with reflect.MapIter if go≥1.12;
• logo changed a little :)