[feature request] a new `exclude` argument into `run_examples()`

[pawelru]

[feature request] a new `exclude` argument into `run_examples()`

[jennybc]

I'm not working on devtools at the moment, but made a quick visit while clearing notifications.

One high-level observation I have about this issue and #2545 is that it feels like the participants are sort of approaching examples as if they are tests. The tidyverse team maintains a lot (>200) packages and I'm pretty sure none of us make regular usage of run_examples(). Now that doesn't mean it's a bad function! Rather I think we approach examples differently. When tinkering with them, we execute them interactively. Then, if unexpected problems crop up, we're going to hear about it in CI, i.e. one of our R CMD check or pkdgown jobs is going to fail.

A lot of the features being requested are available already in the testing side of things and it just feels like the code where you need all of that control sounds more like test code than example code.

[orgadish]

@jennybc I have found that I use run_examples() / run_example() a lot when first developing my packages, i.e. when I'm still working out the kinks in new functionality. You're right that it's sort of like testing, but since the examples also need to be debugged at the beginning, having more control over what you run can be very helpful.

Having said that, I do think pkgload::run_example(path, ...) and pkgload::dev_example(topic, ...) cover what I need (and allow for the kind of functionality that @pawelru is referring). In #2545, I just hadn't realized those existed (I've since updated that request for clarity).