Vignette on testing challenging functions

[maelle]

At the moment the only reference to mockery is via the deprecation message of former mocking functions.

Could there be a link to mockery maybe from the README?

[maelle]

https://blog.r-hub.io/2019/10/29/mocking/ was relatively popular (well for an R-hub post 🙂 ) so I think a vignette about such topics would be awesome.

[maelle]

Regarding plots, some guidance on testthat visual snapshots vs vdiffr (or how the two tools complement each other) would be nice.

[hadley]

• Use of expect_snapshot() for length-y text output
• Plus use of mocking and/or transform to eliminate spurious differences

[hadley]

I made this list for a recent workshop on testing:

• Output affected by RNG — withr::local_seed()
• Output affected by other external state — withr::local_options() / withr::local_envvar()
• Graphical output — https://vdiffr.r-lib.org/
• Errors & other user facing text — snapshots
• HTTP responses — httr2 mocking + httptest2
• Interactivity — mocking

Are there any other major classes of challenge that you can think of?

[maelle]

Regarding interactivity (and other examples like "code that should be run if there is no internet connection"), maybe also mention escape hatches? https://blog.r-hub.io/2023/01/23/code-switch-escape-hatch-test/

[hadley]

@maelle in that case (especially with local_mocked_bindings()), mocking feels like a clear win.