Skip to contents

Fetch task information

Source: R/task.R
task_info.Rd

Fetch information about a task. This is much more detailed than the information in task_status. If a task is running we also fetch the true status via its driver, which can be slower.

Usage

task_info(id, follow = TRUE, root = NULL)

Arguments

id

A single task id to fetch information for

follow

Logical, indicating if we should follow any retried tasks.

root

A hipercow root, or path to it. If NULL we search up your directory tree.

Value

An object of class hipercow_task_info, which will print nicely. This is just a list with elements:

  • id: the task identifier

  • status: the retrieved status

  • driver: the driver used to run the task (or NA)

  • data: the task data (depends on the type of task)

  • times: a vector of times

  • retry_chain: the retry chain (or NULL)

You can see and access these elements more easily by running unclass() on the result of task_info().

Examples

cleanup <- hipercow_example_helper()
#> ℹ This example uses a special helper
id <- task_create_expr(runif(1))
#> ✔ Submitted task '21636cbba6811f7388db8733649f28ba' using 'example'
task_wait(id)
#> [1] TRUE

# Task information at completion includes times:
task_info(id)
#> 
#> ── task 21636cbba6811f7388db8733649f28ba (success) ─────────────────────────────
#> ℹ Submitted with 'example'
#> ℹ Task type: expression
#>   • Expression: runif(1)
#>   • Locals: (none)
#>   • Environment: default
#>     USER_KEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key
#>     USER_PUBKEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key.pub
#>     R_GC_MEM_GROW: 3
#> ℹ Created at 2025-10-13 16:47:36.447491 (moments ago)
#> ℹ Started at 2025-10-13 16:47:36.492423 (moments ago; waited 45ms)
#> ℹ Finished at 2025-10-13 16:47:36.579356 (moments ago; ran for 87ms)

# If you need to work with these times, use the "times" element:
task_info(id)$times
#>                   created                   started                  finished 
#> "2025-10-13 16:47:36 UTC" "2025-10-13 16:47:36 UTC" "2025-10-13 16:47:36 UTC" 

# If a task is retried, this information appears as a retry chain:
id2 <- task_retry(id)
#> ✔ Submitted task 'e547b642a9555fb96896c6c6e50b240c' using 'example'
task_info(id2, follow = FALSE)
#> 
#> ── task e547b642a9555fb96896c6c6e50b240c (submitted) ───────────────────────────
#> ℹ Submitted with 'example'
#> ℹ Task type: expression
#>   • Expression: runif(1)
#>   • Locals: (none)
#>   • Environment: default
#>     USER_KEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key
#>     USER_PUBKEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key.pub
#>     R_GC_MEM_GROW: 3
#> ℹ Created at 2025-10-13 16:47:36.447491 (moments ago)
#> ! Not started yet (waiting for 1.1s)
#> ! Not finished yet (waiting to start)
#> ℹ Last of a chain of a task retried 1 time
task_info(id2)
#> 
#> ── task e547b642a9555fb96896c6c6e50b240c (success) ─────────────────────────────
#> ℹ Submitted with 'example'
#> ℹ Task type: expression
#>   • Expression: runif(1)
#>   • Locals: (none)
#>   • Environment: default
#>     USER_KEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key
#>     USER_PUBKEY:
#>     /home/runner/work/_temp/hv-20251013-20772bb3c7c2/hipercow/example/key.pub
#>     R_GC_MEM_GROW: 3
#> ℹ Created at 2025-10-13 16:47:36.447491 (moments ago)
#> ℹ Started at 2025-10-13 16:47:37.583767 (moments ago; waited 1.1s)
#> ℹ Finished at 2025-10-13 16:47:37.584717 (moments ago; ran for 1ms)
#> ℹ Last of a chain of a task retried 1 time

cleanup()
#> ℹ Cleaning up example