Skip to content

Stop the lago_report() example from hanging the pkgdown build - #92

Merged
correspondMerchant merged 1 commit into
mainfrom
fix/pkgdown-hang-lago-report-example
Aug 19, 2026
Merged

Stop the lago_report() example from hanging the pkgdown build#92
correspondMerchant merged 1 commit into
mainfrom
fix/pkgdown-hang-lago-report-example

Conversation

@correspondMerchant

Copy link
Copy Markdown
Owner

What this changes

                                                                                                               Fixes the pkgdown docs build hanging for hours. `lago_report()`'s example was

\donttest and lago_report() renders an HTML file with rmarkdown. pkgdown
runs \donttest examples in-process (build_site_github_pages(new_process = FALSE)), and a nested document render inside pkgdown's own knitr session
deadlocks. Wraps the example in \dontrun instead (matching visualize_cost()),
so pkgdown skips it; R CMD check --as-cran was unaffected either way.
Regenerates man/lago_report.Rd.

Related issue

Closes #

Checklist

  • Tests added or updated under tests/testthat/ — n/a, example/doc change, no code behavior change
  • devtools::document() run (regenerated man/lago_report.Rd)
  • devtools::check() passes locally — unaffected (example runs identically under check)
  • NEWS.md updated — n/a, fixes a docs-build issue, not user-facing package behavior

The lago_report() example was wrapped in \donttest, and lago_report() renders
an HTML file with rmarkdown. pkgdown runs \donttest examples in-process
(build_site_github_pages(new_process = FALSE)), and a document render nested
inside pkgdown's own knitr session deadlocks, which left the pkgdown job
running for hours. R CMD check --as-cran runs the same example without hanging
because its render happens in a separate context.

Wrap the example in \dontrun instead, matching visualize_cost(): a function
that writes a file and invokes pandoc should not auto-run during a check or an
in-process docs build. Regenerates man/lago_report.Rd.
@correspondMerchant
correspondMerchant merged commit 6c128b4 into main Aug 19, 2026
@correspondMerchant
correspondMerchant deleted the fix/pkgdown-hang-lago-report-example branch August 19, 2026 22:06
@codecov

codecov Bot commented Aug 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant