Contents

1 Who is this package for?

This document and package is strictly for the developers of basilisk. If you are a developer of a client package, you probably want to read the basilisk vignette instead. If you are an end-user of some client package, you are better off reading the documentation for that client instead.

2 Why does this package exist?

This package centralizes various R functions that are required for installing basilisk. By default, these functions are (potentially) called in basiliskStart() during client run-time. However, under certain conditions, they are called via the configure file during basilisk installation.

Ideally, we would put these functions inside basilisk for use in all situations. However, this is not possible as configure runs before installation, i.e., before any functions are actually available! The naive option is to simply duplicate the code in both the package and configure; this is unappealing as it requires us to maintain twice as much code and circumvents R CMD check’s code quality checks.

The basilisk.utils package provides R functions that can be called in both configure and basiliskStart(). This allows us to avoid code duplication and enjoy the safety of R CMD check. The consequence of this approach is that basilisk.utils has no direct relevance to other packages or end-users, and thus should never be explicitly loaded into a package namespace or R session.

3 Session information

sessionInfo()
## R Under development (unstable) (2024-10-21 r87258)
## Platform: x86_64-pc-linux-gnu
## Running under: Ubuntu 24.04.1 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.21-bioc/R/lib/libRblas.so 
## LAPACK: /usr/lib/x86_64-linux-gnu/lapack/liblapack.so.3.12.0
## 
## locale:
##  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
##  [3] LC_TIME=en_GB              LC_COLLATE=C              
##  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8   
##  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C                 
##  [9] LC_ADDRESS=C               LC_TELEPHONE=C            
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C       
## 
## time zone: America/New_York
## tzcode source: system (glibc)
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
## [1] basilisk.utils_1.19.0 BiocStyle_2.35.0     
## 
## loaded via a namespace (and not attached):
##  [1] digest_0.6.37       R6_2.5.1            bookdown_0.41      
##  [4] fastmap_1.2.0       xfun_0.48           dir.expiry_1.15.0  
##  [7] cachem_1.1.0        filelock_1.0.3      knitr_1.48         
## [10] htmltools_0.5.8.1   rmarkdown_2.28      lifecycle_1.0.4    
## [13] cli_3.6.3           sass_0.4.9          jquerylib_0.1.4    
## [16] compiler_4.5.0      tools_4.5.0         evaluate_1.0.1     
## [19] bslib_0.8.0         yaml_2.3.10         BiocManager_1.30.25
## [22] jsonlite_1.8.9      rlang_1.1.4