Add a script for generating many roxygen-examples-complete tests, apply it

[MichaelChirico]

Closes #1105. Note that this includes #1110 so the diff is too large for now. I couldn't figure out a way to specify that commit as the diffbase while still creating this PR on r-lib/styler (since that commit is on my fork). Sorry for the visual noise.

[IndrajeetPatil]

Can we avoid magic string here? What's special about "15"?

[MichaelChirico]

PTAL

[lorenzwalthert]

#1110 is merged, so I am going to drop this from the title. Feel free to rebase.

[lorenzwalthert]

@IndrajeetPatil since you started to review, I leave this to you.

[lorenzwalthert]

@MichaelChirico due to #1119, we need to release a new version of {styler} soon (mid next week), just if you want this PR to be included. I don't think we'll have another release soon after that.

[MichaelChirico]

Thanks for the ping, feedback handled.

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (2218546) 92.31% compared to head (5ab3a30) 92.31%.
Report is 3 commits behind head on main.

❗ Current head 5ab3a30 differs from pull request most recent head 05c76f4. Consider uploading reports for the commit 05c76f4 to get more accurate results

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1111   +/-   ##
=======================================
  Coverage   92.31%   92.31%           
=======================================
  Files          46       46           
  Lines        2655     2655           
=======================================
  Hits         2451     2451           
  Misses        204      204           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[lorenzwalthert]

Thanks. @IndrajeetPatil I leave the review to you, only thing I would add is that I am not a big fan of adding a top level directory (albeit hidden) to the repo. Or do we expect future scripts to live in .dev? Can't we just place this script in testthat/? IIRC, files that don't start with test- or helper- are not executed when {testthat} tests are run.

[IndrajeetPatil]

Thanks, @MichaelChirico! I like the idea of automating the generation of these test files.

But I agree with Lorenz that it does feel a bit awkward to store the relevant scripts at the top-level of the package directory. I use and see the value of /.dev, but I would use it only for tasks that relate to the entire package (e.g. benchmarking, revdep, etc.). I would instead store the relevant scripts in tests/dev folder.

Does that sound reasonable?

[IndrajeetPatil]

Thanks!

[IndrajeetPatil]

The precommit workflow is going to fail until #1158 is merged, and so need to wait for that PR to be merged.

[lorenzwalthert]

Since we moved the script to generate the tests, some code comments still point to old directory…