Match system requirement descriptions to the database

In the usual workflow pkgdepends matches the SystemRequirements fields of the DESCRIPTION files to the database.

sysreqs_db_match(specs, sysreqs_platform = NULL)

Arguments

specs

Character vector of system requirements descriptions.

sysreqs_platform

System requirements platform. If NULL, then the sysreqs_platform configuration option is used, which defaults to the current platform. Set this option if pkgdepends does not detect your platform correctly.

Value

Data frame with columns:

• spec: the input specs.

• sysreq: name of the system library or tool.

• packages: system packages, list column of character vectors. Rarely it can be an empty string, e.g. if a pre_install script performs the installation.

• pre_install: list column of character vectors. Shell script(s) to run before the installation.

• post_install: list column of character vectors. Shell script(s) to run after the installation.

Details

The sysreqs_db_match() function lets you match any string, and it is mainly useful for debugging.

See also

Other system requirements functions: sysreqs_check_installed(), sysreqs_db_list(), sysreqs_db_update(), sysreqs_install_plan(), sysreqs_is_supported(), sysreqs_list_system_packages(), sysreqs_platforms()

Examples

sysreqs_db_match(
  c("Needs libcurl", "Java, libssl"),
  sysreqs_platform = "ubuntu-22.04"
)
#> [[1]]
#> # A data frame: 1 × 5
#>   spec          sysreq  packages  pre_install post_install
#>   <chr>         <chr>   <list>    <list>      <list>      
#> 1 Needs libcurl libcurl <chr [1]> <NULL>      <NULL>      
#> 
#> [[2]]
#> # A data frame: 1 × 5
#>   spec         sysreq packages  pre_install post_install
#>   <chr>        <chr>  <list>    <list>      <list>      
#> 1 Java, libssl java   <chr [1]> <NULL>      <chr [1]>   
#>