Skip to contents

List previous successful installations of this hipercow root.

Usage

hipercow_provision_list(driver = NULL, root = NULL)

hipercow_provision_check(
  method = NULL,
  ...,
  driver = NULL,
  environment = "default",
  root = NULL
)

Arguments

driver

The name of the driver to use, or you can leave blank if only one is configured (this will be typical).

root

The hipercow root

method

The provisioning method to use, defaulting to NULL, which indicates we should try and detect the best provisioning mechanism for you; this should typically work well unless you are manually adding packages into your library (see Details). If given, must be one of auto, pkgdepends, script or renv; each of these are described in the Details and in vignette("packages").

...

Arguments passed through to conan. See Details.

environment

The name of the environment to provision (see hipercow_environment_create for details).

Value

A data.frame with columns:

  • name: the name of the installation. This might be useful with conan_compare

  • time: the time the installation was started

  • hash: the installation hash

  • method: the method used for the installation

  • args: the arguments to the installation (as a list column)

  • current: if using hipercow_provision_check, does this installation match the arguments provided?

This object also has class conan_list so that it prints nicely, but you can drop this with as.data.frame.

Examples

cleanup <- hipercow_example_helper()
#>  This example uses a special helper
writeLines("data.table", "pkgdepends.txt")

# Before any installation has happened:
hipercow_provision_list()
#> ! No conan installations recorded
hipercow_provision_check()
#>  Selected provisioning method 'pkgdepends'
#> ! No conan installations recorded

# After installation:
hipercow_provision()
#>  Selected provisioning method 'pkgdepends'
#> /`-'\  _______  ___  ___ ____
#> \,T./ / __/ _ \/ _ \/ _ `/ _ \
#>   |   \__/\___/_//_/\_,_/_//_/
#>   |   ---- THE  LIBRARIAN ----
#> 
#> Bootstrapping from: /home/runner/work/_temp/Library
#> Installing into library: hipercow/lib
#> Using method pkgdepends
#> Running in path: /tmp/RtmpUN1Cun/file194c5b18debf
#> Library paths:
#>   - /tmp/RtmpUN1Cun/file194c5b18debf/hipercow/lib
#>   - /opt/R/4.4.1/lib/R/site-library
#>   - /opt/R/4.4.1/lib/R/library
#> id: 20240816202157
#> Logs from pkgdepends follow:
#> 
#> -------------------------------------------------------------------------------
#> 
#> 
#> ── repos 
#> • https://cloud.r-project.org
#> 
#> ── refs 
#> • data.table
#> 
#>  Updated metadata database: 4.35 MB in 9 files.
#> 
#>  Updating metadata database
#>  Updating metadata database ... done
#> 
#> + data.table   1.15.4 [bld][cmp][dl]
#>  Getting 1 pkg with unknown size
#>  Got data.table 1.15.4 (source) (5.39 MB)
#>  Building data.table 1.15.4
#>  Built data.table 1.15.4 (17.6s)
#>  Installed data.table 1.15.4  (54ms)
#>  Summary:   1 new  in 17.6s
#> 
#> -------------------------------------------------------------------------------
#> Writing library description to 'hipercow/lib/.conan/20240816202157'
#> Done!
hipercow_provision_list()
#>  1 conan installation recorded
#> • 1: 20240816202157 (moments ago) [0]
hipercow_provision_check()
#>  Selected provisioning method 'pkgdepends'
#>  1 conan installation recorded
#> • 1: 20240816202157 (moments ago) [0] (*)
#>  The entry marked with '*' matches the provided installation hash

# After a different installation:
hipercow_provision("pkgdepends", refs = "knitr")
#> /`-'\  _______  ___  ___ ____
#> \,T./ / __/ _ \/ _ \/ _ `/ _ \
#>   |   \__/\___/_//_/\_,_/_//_/
#>   |   ---- THE  LIBRARIAN ----
#> 
#> Bootstrapping from: /home/runner/work/_temp/Library
#> Installing into library: hipercow/lib
#> Using method pkgdepends
#> Running in path: /tmp/RtmpUN1Cun/file194c5b18debf
#> Library paths:
#>   - /tmp/RtmpUN1Cun/file194c5b18debf/hipercow/lib
#>   - /opt/R/4.4.1/lib/R/site-library
#>   - /opt/R/4.4.1/lib/R/library
#> id: 20240816202224
#> Logs from pkgdepends follow:
#> 
#> -------------------------------------------------------------------------------
#> 
#> 
#> ── repos 
#> • https://cloud.r-project.org
#> 
#> ── refs 
#> • knitr
#>  Loading metadata database
#>  Loading metadata database ... done
#> 
#> + evaluate   0.24.0 [bld]
#> + highr      0.11   [bld]
#> + knitr      1.48   [bld]
#> + xfun       0.46   [bld][cmp]
#> + yaml       2.3.10 [bld][cmp]
#>  No downloads are needed, 5 pkgs are cached
#>  Got evaluate 0.24.0 (source) (28.68 kB)
#>  Got highr 0.11 (source) (13.85 kB)
#>  Got yaml 2.3.10 (source) (94.56 kB)
#>  Got xfun 0.46 (source) (158.39 kB)
#>  Got knitr 1.48 (source) (583.01 kB)
#>  Building evaluate 0.24.0
#>  Building xfun 0.46
#>  Building yaml 2.3.10
#>  Built evaluate 0.24.0 (1.9s)
#>  Installed evaluate 0.24.0  (69ms)
#>  Built xfun 0.46 (3.6s)
#>  Installed xfun 0.46  (1.1s)
#>  Building highr 0.11
#>  Built yaml 2.3.10 (4.9s)
#>  Installed yaml 2.3.10  (1s)
#>  Built highr 0.11 (1.4s)
#>  Installed highr 0.11  (1s)
#>  Building knitr 1.48
#>  Built knitr 1.48 (4.6s)
#>  Installed knitr 1.48  (1s)
#>  Summary:   5 new  in 20.6s
#> 
#> -------------------------------------------------------------------------------
#> Writing library description to 'hipercow/lib/.conan/20240816202224'
#> Done!
hipercow_provision_list()
#>  2 conan installations recorded
#> • 1: 20240816202157 (less than a minute ago) [-1]
#> • 2: 20240816202224 (moments ago) [0]
hipercow_provision_check()
#>  Selected provisioning method 'pkgdepends'
#>  2 conan installations recorded
#> • 1: 20240816202157 (less than a minute ago) [-1] (*)
#> • 2: 20240816202224 (moments ago) [0]
#>  The entry marked with '*' matches the provided installation hash

cleanup()
#>  Cleaning up example