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(), locate_url_ann(), 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
)
#> 2026-04-01 03:50:16.552166 caching file sra.sra.SRP009615.MD.gz.
#> 2026-04-01 03:50:16.848153 caching file sra.recount_project.SRP009615.MD.gz.
#> 2026-04-01 03:50:17.127378 caching file sra.recount_qc.SRP009615.MD.gz.
#> 2026-04-01 03:50:17.429507 caching file sra.recount_seq_qc.SRP009615.MD.gz.
#> 2026-04-01 03:50:17.669767 caching file sra.recount_pred.SRP009615.MD.gz.
local_SRP009615_meta
#>                                                           sra.sra.SRP009615.MD.gz 
#>             "/github/home/.cache/R/recount3/1af1160771f1_sra.sra.SRP009615.MD.gz" 
#>                                               sra.recount_project.SRP009615.MD.gz 
#> "/github/home/.cache/R/recount3/1af177d9d436_sra.recount_project.SRP009615.MD.gz" 
#>                                                    sra.recount_qc.SRP009615.MD.gz 
#>      "/github/home/.cache/R/recount3/1af15e46f6b2_sra.recount_qc.SRP009615.MD.gz" 
#>                                                sra.recount_seq_qc.SRP009615.MD.gz 
#>  "/github/home/.cache/R/recount3/1af163e30205_sra.recount_seq_qc.SRP009615.MD.gz" 
#>                                                  sra.recount_pred.SRP009615.MD.gz 
#>    "/github/home/.cache/R/recount3/1af123906428_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
)
#> 2026-04-01 03:50:17.924033 caching file sra.gene_sums.SRP009615.G026.gz.
local_SRP009615_gene
#>                                               sra.gene_sums.SRP009615.G026.gz 
#> "/github/home/.cache/R/recount3/1af11132306b_sra.gene_sums.SRP009615.G026.gz"