withr
‹3.0.3
- 3.0.319 Jun 2026, current
- 3.0.228 Oct 2024
- 3.0.131 Jul 2024
- 3.0.016 Jan 2024
- 2.5.230 Oct 2023
- 2.5.126 Sep 2023
- 2.5.03 Mar 2022
- 2.4.330 Nov 2021
- 2.4.218 Apr 2021
- 2.4.126 Jan 2021
- 2.4.016 Jan 2021
- 2.3.022 Sep 2020
- 2.2.021 Apr 2020
- 2.1.215 Mar 2018
- 2.1.119 Dec 2017
- 2.1.01 Nov 2017
- 2.0.029 Jul 2017
- 1.0.220 Jun 2016
- 1.0.14 Feb 2016
- 1.0.023 Sep 2015
Run Code 'With' Temporarily Modified Global State
- CRAN checks, method
Method
Checks and health
CRAN runs every current package through
R CMD checkon a set of machines and publishes a result for each one. The health shown on a package page comes from these results alone.- Problems
- Notes alone never count against a package, but a warning, an error or a failure on any platform is a problem. Open CRAN deadlines are a fact of their own, shown as a clock after the mark, so the mark always says what the checks found.
- Checks only
- Health reflects CRAN's check results and nothing else. Even a package with no tests, no coverage or no recent release can have every platform OK.
- Once a day
- Results are collected once a day from files CRAN publishes. Each platform is one machine set-up, named by its R version, operating system, architecture and compiler, such as r-devel-linux-x86_64-fedora-clang.
- Platforms counted
- The 13 in 3 of 13 is the number of platform rows CRAN published for that package on the day of collection. The set of machines changes over time, so the number is not fixed, and a package missing from a platform counts as neither passing nor failing there.
- All OK13 platforms
- CRAN 30-day downloads, method
- 1.7M−6.2% down on the 30 days before, the worse direction
- Dependent packages, method
Method
Reverse dependencies
Dependent packages are other packages that list this one under
Depends,ImportsorLinkingToin theirDESCRIPTIONfile. Those fields list the packages a package needs to install, so dependents break if this one is archived or broken.- As declared
- The counts follow the declarations as written, not whether a package uses the other one when it runs.
- Suggests apart
- Packages that list this one only under
Suggestsinstall and run without it, and use it for tests, examples or an optional feature. They are counted as Suggested by, never among the dependents, and a package that also lists it under one of the three fields is a dependent and is not counted again. - Zero
- Zero dependents means no current CRAN package declares a need for this one, though some may suggest it. On 29 Oct 2026, 19,585 of the 25,593 current CRAN packages had no dependent package.
- 4021,260 more suggest it
- Test coverage, method
Method
Test coverage
Test coverage is measured by downloading each CRAN package's current source file, installing its dependencies, building it and running its tests under covr.
- Almost half of CRAN has no tests to run
- Only CRAN packages are measured. Many have no percentage, most often because the package has no tests, and that blank is a recorded outcome, not missing data.
- NOT_CRAN
- Tests run with NOT_CRAN=true, so tests that skip themselves on CRAN run here, and the figure can differ from what CRAN's own checks see.
- Current version only
- Only the current version is measured, and a new version on CRAN is measured again. Older rows are kept but never filled in later. This is one package's run.
- Never 0%
- On a package page three states stay apart: measured, no tests, and not measured. Neither of the last two is ever shown as 0%.
- 86%of lines run by tests
- Advisories, method
Method
Security advisories
Advisories come from the R Consortium advisory database, a community record of security problems in R packages, as OSV publishes it.
- The copy
- The record is read once a day. The data is published under the Apache License 2.0 and is credited on the advisories list.
- Box under the name
- Under the package's name, a box names any advisory that affects the current release, with its fix or that there is none.
- Ranges
- Advisories state ranges, such as from 0.9.12 up to but not including 1.8.8. Each range is checked against every version CRAN has published, using the version rules R itself uses, so a release that came out after the advisory was written is still caught by its range.
- Not the package
- The rating is for the library flaw itself, not for how exposed the R package is, and it is never added up into a figure for the package.
- None known
About
Method, About Method Licence figures come from the Licences
License field of each package's DESCRIPTION file, read the way R itself reads it. No licence file is opened.tools::analyze_license() and R's own licence database, as CRAN's checks read it.| is read, so one string can offer two families.
A set of functions to run code 'with' safely and temporarily modified global state. Many of these functions were originally a part of the 'devtools' package, this provides a simple package with limited dependencies to provide access to these functions.
- Maintainer
- Lionel Henry
- Licence
- MIT + file LICENSE
- Latest release
- 19 Jun 2026
- First release
- 23 Sep 2015
More details
- Releases
- 20
- Needs compilation
- No
- Needs R
- >= 3.6.0
- Config/Needs/website
- tidyverse/tidytemplate
- Config/testthat/edition
- 3
- RoxygenNote
- 7.3.2
Task views (1)
Cite
Package
Run in R for the authors' preferred citation:
citation("withr")Henry, L., Posit Software, PBC, Bryan, J., Chang, W., Cotton, R., Hester, J., Müller, K., Ushey, K., & Wickham, H. (2026). withr: Run Code 'With' Temporarily Modified Global State (Version 3.0.3) [Computer software]. https://doi.org/10.32614/CRAN.package.withr
About
This package has no citation file, so citation() returns this entry built from DESCRIPTION.
R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
Balamuta, J. J. (2026). R Observatory: Metrics for withr version 3.0.3 [Data set]. HJJB, LLC. Data release v2026-10-29. https://doi.org/10.5281/zenodo.21843040
About
From data release v2026-10-29, which the citation names so these numbers can be found later.
Health
All 13 check platforms pass.
r-devel-linux-x86_64-debian-clangThe unreleased R on Linux, x86_64, debian-clang
OK
- Version checked
- 3.0.3
- Time taken
- 54 s
r-devel-linux-x86_64-debian-gccThe unreleased R on Linux, x86_64, debian-gcc
OK
- Version checked
- 3.0.3
- Time taken
- 42 s
r-devel-linux-x86_64-fedora-clangThe unreleased R on Linux, x86_64, fedora-clang
OK
- Version checked
- 3.0.3
- Time taken
- 36 s
r-devel-linux-x86_64-fedora-gccThe unreleased R on Linux, x86_64, fedora-gcc
OK
- Version checked
- 3.0.3
- Time taken
- 41 s
r-devel-windows-x86_64The unreleased R on Windows, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 116 s
r-oldrel-macos-arm64The previous release of R on macOS, arm64
OK
- Version checked
- 3.0.3
- Time taken
- 68 s
r-oldrel-macos-x86_64The previous release of R on macOS, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 172 s
r-oldrel-windows-x86_64The previous release of R on Windows, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 102 s
r-patched-linux-x86_64The patched release of R on Linux, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 48 s
r-release-linux-x86_64The current release of R on Linux, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 46 s
r-release-macos-arm64The current release of R on macOS, arm64
OK
- Version checked
- 3.0.3
- Time taken
- 59 s
r-release-macos-x86_64The current release of R on macOS, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 170 s
r-release-windows-x86_64The current release of R on Windows, x86_64
OK
- Version checked
- 3.0.3
- Time taken
- 88 s
- 13 OK
Over time
No change since 4 Aug 2026
As a list (4)
| Changed | Worst status | OK | Notes | Warnings | Errors |
|---|---|---|---|---|---|
| 4 Aug 2026 | OK | 13 | 0 | 0 | 0 |
| 1 Aug 2026 | Note | 12 | 1 | 0 | 0 |
| 22 Jun 2026 | OK | 13 | 0 | 0 | 0 |
| 10 Mar 2026 | Error | 13 | 0 | 0 | 1 |
Since March 2026
Downloads
Method, Downloads Method Download figures count requests logged by each distribution channel. They are not counts of installs or of users, because each channel publishes its own totals and this site reads them.Downloads
- Total downloads in the last 30 days
- 2,117,286+0.47% up on the 30 days before, the better directionIt is the sum of 4 channels: CRAN, r2u, conda-forge and c2d4u. autoCRAN is switched off.
CRAN rank
10 of 26,553
CRAN
1,678,637 downloads in the last 30 days
- Rank
- 10 of 26,553
- Change
- −6.2% down on the 30 days before, the worse direction
It is in the total. Take it out
r2u
65,667 downloads in the last 30 days
- Rank
- 5 of 30,526
- Change
- +97.8% up on the 30 days before, the better direction
It is in the total. Take it out
autoCRAN
177 downloads in the last 30 days
- Rank
- 322 of 29,233
- Change
- +20.4% up on the 30 days before, the better direction
It is switched off. Put it back
conda-forge
371,496 downloads in the last 30 days
- Rank
- 7 of 3,828
- Change
- +31.4% up on the 30 days before, the better direction
It is in the total. Take it out
c2d4u, no longer updated
1,486 downloads in the last 30 days
- Rank
- 7 of 7,575
- Change
- −11.3% down on the 30 days before, the worse direction
It is in the total. Take it out
The total is 2,117,286 downloads in the last 30 days. It is the sum of 4 channels: CRAN, r2u, conda-forge and c2d4u. autoCRAN is switched off.
Over time
Dependencies
- Needs
- 2
- Dependent packages
- 402
- Suggested by
- 1,260
Needs (2)
- graphics
- grDevices
- Installing it adds
- 0 packages, 0 KB of source
- Of those, need compilation
- 0
Dependent packages (50 of 402)
| Package | Title | Downloads in 30 days |
|---|---|---|
| ggplot2 | Create Elegant Data Visualisations Using the Grammar of Graphics | 2,048,054 |
| tidyselect | Select from a Set of Strings | 1,080,980 |
| shiny | Web Application Framework for R | 809,005 |
| readr | Read Rectangular Text Data | 748,961 |
| testthat | Unit Testing for R | 703,527 |
| vroom | Read and Write Rectangular Text Data Quickly | 651,646 |
| gargle | Utilities for Working with Google APIs | 433,152 |
| googledrive | An Interface to Google Drive | 427,205 |
| googlesheets4 | Access Google Sheets using the Sheets API V4 | 423,558 |
| dbplyr | A 'dplyr' Back End for Databases | 418,441 |
| reprex | Prepare Reproducible Example Code via the Clipboard | 406,396 |
| forecast | Forecasting Functions for Time Series and Linear Models | 395,190 |
| ggrepel | Automatically Position Non-Overlapping Text Labels with 'ggplot2' | 392,310 |
| httr2 | Perform HTTP Requests and Process the Responses | 365,017 |
| devtools | Tools to Make Developing R Packages Easier | 301,743 |
| ggridges | Ridgeline Plots in 'ggplot2' | 282,041 |
| roxygen2 | In-Line Documentation for R | 278,149 |
| ggdist | Visualizations of Distributions and Uncertainty | 224,766 |
| usethis | Automate Package and Project Setup | 219,494 |
| rex | Friendly Regular Expressions | 214,771 |
| pkgdown | Make Static HTML Documentation for a Package | 201,920 |
| reticulate | Interface to 'Python' | 172,982 |
| covr | Test Coverage for Packages | 159,854 |
| rcmdcheck | Run 'R CMD check' from 'R' and Capture Results | 127,871 |
| recipes | Preprocessing and Feature Engineering Steps for Modeling | 126,902 |
| downlit | Syntax Highlighting and Automatic Linking | 125,188 |
| caret | Classification and Regression Training | 118,208 |
| ggforce | Accelerating 'ggplot2' | 92,750 |
| DescTools | Tools for Descriptive Statistics | 64,067 |
| ggraph | An Implementation of Grammar of Graphics for Graphs and Networks | 62,758 |
| styler | Non-Invasive Pretty Printing of R Code | 52,971 |
| chromote | Headless Chrome Web Browser Interface | 47,823 |
| RPostgres | C++ Interface to PostgreSQL | 47,600 |
| torch | Tensors and Neural Networks with 'GPU' Acceleration | 43,580 |
| yardstick | Tidy Characterizations of Model Performance | 30,778 |
| cyclocomp | Cyclomatic Complexity of R Code | 29,975 |
| workflows | Modeling Workflows | 28,605 |
| infer | Tidy Statistical Inference | 25,877 |
| dials | Tools for Creating Tuning Parameter Values | 25,757 |
| tune | Tidy Tuning Tools | 24,212 |
| sparklyr | R Interface to Apache Spark | 23,733 |
| learnr | Interactive Tutorials for R | 22,128 |
| workflowsets | Create a Collection of 'tidymodels' Workflows | 20,039 |
| shinytest2 | Testing for Shiny Applications | 18,297 |
| mockr | Mocking in R | 16,959 |
| FSA | Simple Fisheries Stock Assessment Methods | 16,181 |
| themis | Extra Recipes Steps for Dealing with Unbalanced Data | 11,485 |
| readODS | Read and Write ODS Files | 10,553 |
| fmesher | Triangle Meshes and Related Geometry Tools | 9,858 |
| statsExpressions | Tidy Dataframes and Expressions with Statistical Details | 8,329 |
Code
Method, Code Method Code metrics come from reading the released source of each package version. The package is never installed, loaded or run.Code metrics
README, vignettes, a NEWS file and the shares read from its help pages. Files kept only in the repository, such as a pkgdown configuration or CI files, are read by the repository scan instead.
- Functions
- 119
- Public exports
- 79
- Lines of R code
- 2,548
- Median complexity
- 1
Functions (119)
Size and composition
Lines by kind (6,575)
| Kind | Lines | Share |
|---|---|---|
| R code | 2,548 | 39% |
| Tests | 2,076 | 32% |
| Documentation | 1,608 | 24% |
| Guides | 343 | 5% |
Lines by language
| Language | Lines | Share |
|---|---|---|
| R | 4,520 | 69% |
| Rd | 1,608 | 25% |
| Vignettes | 343 | 5% |
| Markdown | 104 | 2% |
Languages are counted from file extensions.
- Files
- 110
- R functions
- 119
- Deprecated functions
- 2
Complexity
- Median
- 1
- Mean
- 2.09
- Highest
- 13
- Median lines per function
- 7
About complexity
Cyclomatic complexity counts the independent paths through a function: 1 is a straight line, higher is harder to test. R functions only.
Call graph figures
- R functions
- 119
- Calls
- 129
- Unconnected
- 14
- Groups
- 3
Growth (20 releases)
Release changes
Tests
The tests ran and coverage was measured.
- Lines run by tests
- 85.7%
- Expressions run by tests
- 85.7%
- Test cases
- 140
- Exports named in tests
- 88.6%
Coverage by file (27)
Coverage run
- Lines counted
- 750
- Lines the tests ran
- 643
- Tests passed
- Yes
- Measured with
- covr 3.6.5 on R 4.6.1
Test suite
- Has tests
- Yes
- Test frameworks
- testthat, tinytest
- Test cases
- 140
- Snapshot tests
- 10
- Lines of tests
- 2,076
- Test lines per line of code
- 0.81
Documentation
- Exports documented
- 100%
- Arguments documented
- 85.1%
- Return value documented
- 80.8%
- Help pages with examples
- 75%
- Examples run in checks
- 95.2%
Guides (1)
Other documentation
- README
- Yes, 597 words
- Release notes file
- Yes
- Help pages
- 28
- Lines of documentation
- 1,608
People
Method, People Method People on the site are the names packages give them in their Author and maintainer identity
DESCRIPTION files: authors from the author list, and the maintainer from the Maintainer field. Spellings of one name become one person only where the rules below allow it, and when in doubt the rules keep people apart.
Maintainer since 2.4.3 (2021), previously Jim Hester (1.0.0 to 2.4.2), author
Posit Software, PBC, an organisation
Copyright holder
Contributor
Author
Contributor
Author
Author
Author
Author
Funded by Posit Software, PBC
Earlier names (1)
- RStudio
Repository
Method, figures by host Method Repository signals are the figures read from the source repository a package links to: stars, forks, issues, commits, releases and the time issues take to close. They are read from GitHub, GitLab, Codeberg and Bitbucket.Repository signals
URL and BugReports fields of its DESCRIPTION file. Read-only mirrors, the cran and bioc accounts on GitHub and git.bioconductor.org, are left out.
- Stars
- 181+0.56% up on 30 days ago, the better direction
- Forks
- 47
- Open issues
- 28
- Last commit
- 12 Oct 2026
Activity
- Commits
- 610
- Open pull requests
- 4
- Tagged releases
- 17
- Latest tagged release
- v3.0.3, 22 Jun 2026
- In development
- Default branch at 3.0.3.9000, ahead of CRAN 3.0.3 (checked 2026-10-25)
- Issues closed in
- 84 days (median)
- Pull requests closed in
- 1 day (median)
- Pull requests merged
- 90%
- Created
- 21 Apr 2015
- Licence file reads as
- –
Development practices (12)
| Kind | Found |
|---|---|
| Continuous integration | GitHub Actions, R CMD check workflow The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel |
| Docs source | README.Rmd, pkgdown GitHub Pages site last deployed 2026-10-12 The repository has a site deploy workflow pkgdown site last built 2026-06-22 |
| Coverage | Coverage reporting (Codecov), .covrignore |
| CRAN release process | cran-comments.md, revdep/ |
| Lint, format, editor | lintr, RStudio project |
Method, repository practices Method Beta Each week a scan of the public source repository a package links to looks for the tools a maintainer has set up, and the Repository section lists the findings. Repositories on GitHub and GitLab are scanned.Repository practices
R CMD build reads .Rbuildignore and leaves out files used only in development, such as .github/, .lintr, renv/, a Dockerfile and cran-comments.md, so the released source file holds almost none of them. The repository is the one place these files stay visible.
History
Method, History Method Archived is built from CRAN's archive records, its list of check deadlines and Bioconductor's package records. Every figure is counted to 29 Oct 2026, the day the data was read.Packages leaving
| Version | Released | R | Events |
|---|---|---|---|
| 3.0.3 current | 19 Jun 2026 | 4.6.0 | |
| 3.0.2 | 28 Oct 2024 | 4.4.1 | |
| 3.0.1 | 31 Jul 2024 | 4.4.1 | |
| 3.0.0 | 16 Jan 2024 | 4.3.2 | |
| 2.5.2 | 30 Oct 2023 | 4.3.1 | |
| 2.5.1 | 26 Sep 2023 | 4.3.1 | |
| 2.5.0 | 3 Mar 2022 | 4.1.2 | |
| 2.4.3 | 30 Nov 2021 | 4.1.2 | Maintainer: Lionel Henry |
Earlier versions (12)
Relicensed from GPL (>= 2) in version 2.4.0.
Release notes (3.0.3)
- Fixes for CRAN checks.
- Fixed issue that prevented
local_seed()from preserving the seed (#286, @BjarkeHautop). Note: If you had before: ``r test_that("A", { withr::local_seed(1) # Seeds locally runif(...) }) test_that("B", { runif(...) # NO seed of its own })`` Before the fix, the test "B" was accidentally seeded by "A". Now it needs to be seeded on its own.