knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)

ssdtools

Lifecycle: stable R-CMD-check Codecov test coverage License: MIT CRAN status CRAN downloads

hmstimer is an R package to track elapsed clock time using a hms::hms scalar.

hmstimer was originally developed to time Bayesian model runs. It should not be used to estimate how long extremely fast code takes to execute as the package code adds a small time cost.

Create and start a timer with tmr_timer(start = TRUE).

library(hmstimer)

tmr <- tmr_timer(start = TRUE)
Sys.sleep(0.1)
str(tmr)
hms::as_hms(tmr)

Get the elapsed time with tmr_elapsed(). The title is optional.

tmr <- tmr_timer(start = TRUE, title = "my timer")

Sys.sleep(0.1)
tmr_elapsed(tmr)

Sys.sleep(0.1)
tmr_elapsed(tmr)

Stop the timer with tmr_stop().

tmr <- tmr_stop(tmr)
tmr_elapsed(tmr)

Sys.sleep(1)
tmr_elapsed(tmr)

Restart the timer with tmr_start().

tmr <- tmr_start(tmr)
tmr_elapsed(tmr)
Sys.sleep(0.1)
tmr_elapsed(tmr)

There are several options for printing and formatting including coercing to a hms object.

tmr <- tmr_stop(tmr)
print(tmr)
tmr_print(tmr)
tmr_format(tmr, digits = 5)

If running tmr_print() behaves differently.

tmr <- tmr_start(tmr)
tmr_print(tmr)

The time for a block of code to complete can be printed using with_timer().

with_timer({
  Sys.sleep(0.1)
  Sys.sleep(0.1)
  1 + 1
})

Installation

To install the latest release version from CRAN.

install.packages("hmstimer")

To install the latest development version from r-universe.

install.packages("hmstimer", repos = c("https://poissonconsulting.r-universe.dev", "https://cloud.r-project.org"))

To install the latest development version from GitHub

# install.packages("pak", repos = sprintf("https://r-lib.github.io/p/pak/stable/%s/%s/%s", .Platform$pkgType, R.Version()$os, R.Version()$arch))
pak::pak("poissonconsulting/hmstimer")

Contribution

Please report any issues.

Pull requests are always welcome.

Code of Conduct

Please note that the hmstimer project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.



poissonconsulting/hmstimer documentation built on Nov. 20, 2024, 10:02 p.m.