Download a remote file and cache it to re-use later

Download a remote file and cache it to re-use later

file_retrieve(
  url,
  bfc = recount3_cache(),
  verbose = getOption("recount3_verbose", TRUE)
)

Arguments

url

A character(1) with the file URL or the actual local path in which case, it won't be cached. If length(url) > 1 , this function will be used recursively.

bfc

A BiocFileCache-class object where the files will be cached to, typically created by recount3_cache().

verbose

A logical(1) indicating whether to show messages with updates.

Value

A character(1) with the path to the cached file.

See also

Other internal functions for accessing the recount3 data: annotation_ext(), create_rse_manual(), locate_url_ann(), locate_url(), project_homes(), read_counts(), read_metadata()

Examples

## Download the metadata file for project SRP009615
url_SRP009615_meta <- locate_url(
    "SRP009615",
    "data_sources/sra"
)
local_SRP009615_meta <- file_retrieve(
    url = url_SRP009615_meta
)
#> 2025-05-15 15:31:35.468596 caching file sra.sra.SRP009615.MD.gz.
#> 2025-05-15 15:31:35.985115 caching file sra.recount_project.SRP009615.MD.gz.
#> 2025-05-15 15:31:36.53404 caching file sra.recount_qc.SRP009615.MD.gz.
#> 2025-05-15 15:31:36.984151 caching file sra.recount_seq_qc.SRP009615.MD.gz.
#> 2025-05-15 15:31:37.399996 caching file sra.recount_pred.SRP009615.MD.gz.
local_SRP009615_meta
#>                                                           sra.sra.SRP009615.MD.gz 
#>             "/github/home/.cache/R/recount3/1eb13c967dad_sra.sra.SRP009615.MD.gz" 
#>                                               sra.recount_project.SRP009615.MD.gz 
#> "/github/home/.cache/R/recount3/1eb1490ff6d7_sra.recount_project.SRP009615.MD.gz" 
#>                                                    sra.recount_qc.SRP009615.MD.gz 
#>      "/github/home/.cache/R/recount3/1eb1270c66e7_sra.recount_qc.SRP009615.MD.gz" 
#>                                                sra.recount_seq_qc.SRP009615.MD.gz 
#>   "/github/home/.cache/R/recount3/1eb146cd8c8_sra.recount_seq_qc.SRP009615.MD.gz" 
#>                                                  sra.recount_pred.SRP009615.MD.gz 
#>    "/github/home/.cache/R/recount3/1eb15a0102a1_sra.recount_pred.SRP009615.MD.gz" 

## Download the gene counts file for project SRP009615
url_SRP009615_gene <- locate_url(
    "SRP009615",
    "data_sources/sra",
    type = "gene"
)
local_SRP009615_gene <- file_retrieve(
    url = url_SRP009615_gene
)
#> 2025-05-15 15:31:37.851518 caching file sra.gene_sums.SRP009615.G026.gz.
local_SRP009615_gene
#>                                               sra.gene_sums.SRP009615.G026.gz 
#> "/github/home/.cache/R/recount3/1eb1458a5cf0_sra.gene_sums.SRP009615.G026.gz"