On 2024-02-26, at 8:37 AM, Jakob Reschke <jakres+squeak@gmail.com> wrote: Renaming unfortunately doesn't help with keeping compatible with existing code out there. So it doesn't free up #assert:equals: to the more common order of arguments.OK, so a monotonically improving possibility would be to add @assertResultOf:is: and comment that it is a readability-improved version of assert:equals:. Combined with changing all the plausibly reachable code to use that, it should make things a little clearer.
It might be simpler to fix the existing tests so that the assertions are written correctly. Presumably you would want to do that anyway, and I suspect that if the existing test suites were all written correctly in a consistent style then the perceived readability problem would go away.
I'll confess that my perspective is twisted by exposure to a vast
swamp of unit test enhancements in various Java frameworks. There
are as many variations on the JUnit frameworks as there are
developer opinions, which turns out to be quite a lot. To my eyes,
the result is a big mess.
Dave