Skip to contents

Information about currently running report

Source: R/context.R
orderly_run_info.Rd

Fetch information about the actively running report. This allows you to reflect information about your report back as part of the report, for example embedding the current report id, or information about computed dependencies. This information is in a slightly different format to orderly version 1.x and does not (currently) include information about dependencies when run outside of orderly_run(), but this was never reliable previously.

Usage

orderly_run_info()

Value

A list with elements

  • name: The name of the current report

  • id: The id of the current report, NA if running interactively

  • root: The orderly root path

  • depends: A data frame with information about the dependencies (not available interactively)

    • index: an integer sequence along calls to orderly_dependency()

    • name: the name of the dependency

    • query: the query used to find the dependency

    • id: the computed id of the included packet

    • filename: the file used from the packet

    • as: the filename used locally

Examples

# An example from the orderly examples
orderly_example_show("run_info")
#> 
#> ── src/run_info/run_info.R ─────────────────────────────────────────────────────
#> orderly_dependency("data", "latest", c("xy.rds" = "data.rds"))
#> xy <- readRDS("xy.rds")
#>  
#> info <- orderly_run_info()
#> print(info)
#>  
#> orderly_artefact("plot.png", description = "A plot of data")
#> png("plot.png")
#> plot(xy)
#> dev.off()

# Prepare to run
path <- orderly_example()
#> ✔ Created orderly root at '/tmp/RtmpczjPxW/orderly_ex_1ecd3087f2d3'
orderly_run("data", root = path, echo = FALSE)
#> ℹ Starting packet 'data' `20251027-152742-cf5b42e4` at 2025-10-27 15:27:42.814484
#> ✔ Finished running data.R
#> ℹ Finished 20251027-152742-cf5b42e4 at 2025-10-27 15:27:42.840181 (0.02569699 secs)
#> [1] "20251027-152742-cf5b42e4"

# Here, see the printed information from a real running report
orderly_run("run_info", root = path)
#> ℹ Starting packet 'run_info' `20251027-152742-dc50b251` at 2025-10-27 15:27:42.865181
#> > orderly_dependency("data", "latest", c("xy.rds" = "data.rds"))
#> ℹ Depending on data @ `20251027-152742-cf5b42e4` (via latest(name == "data"))
#> > xy <- readRDS("xy.rds")
#> > info <- orderly_run_info()
#> > print(info)
#> $name
#> [1] "run_info"
#> 
#> $id
#> [1] "20251027-152742-dc50b251"
#> 
#> $root
#> [1] "/tmp/RtmpczjPxW/orderly_ex_1ecd3087f2d3"
#> 
#> $depends
#>   index name                  query                       id    there   here
#> 1     1 data latest(name == "data") 20251027-152742-cf5b42e4 data.rds xy.rds
#> 
#> > orderly_artefact("plot.png", description = "A plot of data")
#> > png("plot.png")
#> > plot(xy)
#> > dev.off()
#> agg_record_1411383854 
#>                     2 
#> ✔ Finished running run_info.R
#> ℹ Finished 20251027-152742-dc50b251 at 2025-10-27 15:27:42.941291 (0.07610941 secs)
#> [1] "20251027-152742-dc50b251"