feat(sdk): expect module with assertions for testing

[skorfmann]

After some back and forth we settled on using expect as the module name. Mostly for the reason that assert is a builtin function already and would cause naming conflicts. The pull request discussions for more details.

Checklist

• Title matches Winglang's style guide
• Description explains motivation and solution
• Tests added (always)
• Docs updated (only required for features)
• Added pr/e2e-full label if this feature requires end-to-end testing

By submitting this pull request, I confirm that my contribution is made under the terms of the Wing Cloud Contribution License.

[monadabot]

Console preview environment is available at https://wing-console-pr-3976.fly.dev 🚀

Last Updated (UTC) 2023-11-02 19:39

[skorfmann]

Since generic function overloading is not working at the moment, I'm curious in which direction assertions should go. Thoughts?

1. Pure Functions

All possible matchers at the same level, no scoping.

assertStrEqual("a", "a")
assertStrIncludes("asflkasf", "asflkasfasflkasf")
...
assertNumEqual(1,1)
...
assertFnThrows(fn, new Error())

2. Chained Objects

Type specific high level "entry point" functions (e.g. expectStr) which return an object with all possible matchers for that specific type.

expectStr("a").toEqual("a")
expectStr("asflkasfasflkasf").toInclude("asflkasf")
...
expectNum(1).toEqual(1)
...
expectFn(fn).toThrow(new Error())

[eladb]

This is looking great.

[eladb]

SHIP IT

[mergify]

Thanks for contributing, @skorfmann! This PR will now be added to the merge queue, or immediately merged if 3918-testing-module is up-to-date with main and the queue is empty.

[monadabot]

Congrats! 🚀 This was released in Wing 0.44.0.