BiocMaintainerQueries: R functions to query Bioconductor Maintainer Validation App

Background

This package is an accompaniment to the Bioconductor Maintainer Validation App. It displays a list of the currently active Bioconductor packages and their maintainers. The Bioconductor Maintainer Validation App sends a reminder email to maintainers of Bioconductor policies and procedures. Maintainers are required to opt-in to the Bioconductor policies once a year. This vignette demonstrates convenient wrappers to the application api for common queries against the database. See also the BiocMaintainerShiny vignette for how to launch the accompanied shiny app.

Installation

if (!requireNamespace("BiocManager", quietly = TRUE))
    install.packages("BiocManager")

BiocManager::install("BiocMaintainerApp")

Loading the package

library(BiocMaintainerApp)

Helper functions for common queries

This package provides convenient R functions that wrap around the Bioconductor Maintainer Validation App API.

Retrieve Maintainer and Package Information

There are three functions that return data.frames of maintainer information that include: name, package, email, consent_date, email_status, is_email_valid. These functions take either the package name, maintainer email, or maintainer name as argument:

  • getInfoByPackage
  • getInfoByEmail
  • getInfoByName

## By package name
getInfoByPackage("BiocFileCache")
#>         package          name                         email consent_date
#> 1 BiocFileCache Lori Shepherd [email protected]   2025-12-01
#>   email_status is_email_valid
#> 1        valid              1

## By maintainer email
tbl <- getInfoByEmail("[email protected]")
head(tbl)
#>                         email                            name           package
#> 1 [email protected] Bioconductor Package Maintainer          annotate
#> 2 [email protected] Bioconductor Package Maintainer     AnnotationDbi
#> 3 [email protected] Bioconductor Package Maintainer  AnnotationFilter
#> 4 [email protected] Bioconductor Package Maintainer   AnnotationForge
#> 5 [email protected] Bioconductor Package Maintainer     AnnotationHub
#> 6 [email protected] Bioconductor Package Maintainer AnnotationHubData
#>   consent_date email_status is_email_valid
#> 1   2025-12-01        valid              1
#> 2   2025-12-01        valid              1
#> 3   2025-12-01        valid              1
#> 4   2025-12-01        valid              1
#> 5   2025-12-01        valid              1
#> 6   2025-12-01        valid              1

## By maintainer name
## Then list packages associated
tbl <- getInfoByName("Hervé Pagès")
head(tbl$package)
#> [1] "BiocGenerics"  "Biostrings"    "BSgenome"      "BSgenomeForge"
#> [5] "DelayedArray"  "GenomeInfoDb"

There is also a function that takes an email and returns if it is valid or not. If it is not valid, it will also return a data.frame of additional information collected to try to indicate the resason for the failed delivery. The return value of this function is a list with argument ‘valid’ and optionally ‘data’.

  • isEmailValid
isEmailValid("[email protected]")
#> $valid
#> [1] TRUE

List Maintainer Emails

There are four list functions to help retrieve emails that are not necessarily valid either because emails cannot be delivered to the email or the maintainer has not consented to Bioconductor policies in the last year.

  • listInvalid
  • listNeedsConsent
  • listAllBadEmails
  • listEmailsOnSuppressionList
## list invalid
## maintainers that emails cannot be delivered and any information on failure
## this is a data.frame
tbl <- listInvalid()
head(tbl)
#>                        email               name     package email_status
#> 1 [email protected]        Wentao Yang      ABSSeq   suppressed
#> 2 [email protected]     Peter Dimitrov        aCGH   suppressed
#> 3      [email protected]    Cuilan lani Gao       AGDEX      bounced
#> 4             [email protected] Pedro Lopez-Romero AgiMicroRna   suppressed
#> 5        [email protected]          Wancen Mu     airpart   suppressed
#> 6       [email protected]            Dong Li   AMOUNTAIN   suppressed
#>   bounce_type bounce_subtype smtp_status
#> 1      BOUNCE           <NA>        <NA>
#> 2      BOUNCE           <NA>        <NA>
#> 3   Permanent        General      5.1.10
#> 4      BOUNCE           <NA>        <NA>
#> 5      BOUNCE           <NA>        <NA>
#> 6      BOUNCE           <NA>        <NA>
#>                                                                              diagnostic_code
#> 1                                                                  2026-01-11 03:07:31 +0000
#> 2                                                                  2026-01-11 03:00:20 +0000
#> 3 smtp;550 5.1.10 RESOLVER.ADR.RecipientNotFound; Recipient not found by SMTP address lookup
#> 4                                                                  2025-02-25 17:00:05 +0000
#> 5                                                                  2026-01-11 03:00:29 +0000
#> 6                                                                  2023-03-06 17:00:07 +0000

## list needs consent
## maintainers have not consented to policies in the last year
tbl <- listNeedsConsent()    
head(tbl)
#> [1] "[email protected]"         "[email protected]"
#> [3] "[email protected]"      "[email protected]"
#> [5] "[email protected]"      "[email protected]"

## list bad emails
## combo: invalid and needs consent
tbl <- listAllBadEmails()
head(tbl)
#> [1] "[email protected]"         "[email protected]"
#> [3] "[email protected]"      "[email protected]"
#> [5] "[email protected]"      "[email protected]"

## list suppression list
## emails that appear on aws suppression list and would not try to send
## this is list. 'data' element contains a data.frame of name and email
tbl <- listEmailsOnSuppressionList()
head(tbl$data)
#>                        email               name
#> 1 [email protected]        Wentao Yang
#> 2 [email protected]     Peter Dimitrov
#> 3             [email protected] Pedro Lopez-Romero
#> 4        [email protected]          Wancen Mu
#> 5       [email protected]            Dong Li
#> 6    [email protected]  Christian Oertlin

Retreive Database

If the prebuilt functions are not sufficient and you would like to perform your own analysis, there is a function to download the current version of the database.

  • get_maintainer_data

all_data <- get_maintainer_data()
tail(all_data)
#>        package                  name                                     email
#> 3968     CLAMP  Marc Subirana-Granes                         [email protected]
#> 3969     gesel             Aaron Lun [email protected]
#> 3970 CLAMPData  Marc Subirana-Granés                         [email protected]
#> 3971 CGRphylo2 Amarinder Singh Thind                 [email protected]
#> 3972 scBatchQC         Subhadip Jana                [email protected]
#> 3973  scFastDE         Subhadip Jana                [email protected]
#>      consent_date email_status is_email_valid last_verification_sent
#> 3968   2026-06-22          new           TRUE                   <NA>
#> 3969   2026-06-24          new           TRUE                   <NA>
#> 3970   2026-06-24          new           TRUE                   <NA>
#> 3971   2026-06-29          new           TRUE                   <NA>
#> 3972   2026-06-29          new           TRUE                   <NA>
#> 3973   2026-06-29          new           TRUE                   <NA>
#>      bounce_type bounce_subtype smtp_status diagnostic_code needs_consent
#> 3968        <NA>           <NA>        <NA>            <NA>         FALSE
#> 3969        <NA>           <NA>        <NA>            <NA>         FALSE
#> 3970        <NA>           <NA>        <NA>            <NA>         FALSE
#> 3971        <NA>           <NA>        <NA>            <NA>         FALSE
#> 3972        <NA>           <NA>        <NA>            <NA>         FALSE
#> 3973        <NA>           <NA>        <NA>            <NA>         FALSE

The following provide brief descriptions of columns:

  • package: name of Bioconductor package
  • name: maintainers name
  • email: maintainers provided email in package DESCRIPTION
  • consent_date: last known consent date to Bioconductor policies
  • email_status: (Initialized, valid, suppressed, bounce, new)
  • is_email_valid: true/false if the email could be delivered
  • last_verification_sent: when was the last verification email sent

The remaining columns are utilized if additional information when an email is bounced can be retrieved. This is used as potential diagnostic and resolution.

  • bounce_type
  • bounce_subtype
  • smtp_status
  • diagnostic_code

Session Info

sessionInfo()
#> R version 4.6.1 (2026-06-24)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 26.04 LTS
#> 
#> Matrix products: default
#> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3 
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.32.so;  LAPACK version 3.12.0
#> 
#> locale:
#>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C              
#>  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=en_US.UTF-8    
#>  [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: Etc/UTC
#> tzcode source: system (glibc)
#> 
#> attached base packages:
#> [1] stats     graphics  grDevices utils     datasets  methods   base     
#> 
#> other attached packages:
#> [1] BiocMaintainerApp_1.1.0 BiocStyle_2.41.0       
#> 
#> loaded via a namespace (and not attached):
#>  [1] cli_3.6.6           knitr_1.51          rlang_1.2.0        
#>  [4] xfun_0.59           otel_0.2.0          promises_1.5.0     
#>  [7] shiny_1.14.0        xtable_1.8-8        jsonlite_2.0.0     
#> [10] DT_0.34.0           buildtools_1.0.0    htmltools_0.5.9    
#> [13] maketools_1.3.2     httpuv_1.6.17       sys_3.4.3          
#> [16] sass_0.4.10         rmarkdown_2.31      evaluate_1.0.5     
#> [19] jquerylib_0.1.4     shinyjs_2.1.1       fastmap_1.2.0      
#> [22] yaml_2.3.12         lifecycle_1.0.5     BiocManager_1.30.27
#> [25] compiler_4.6.1      codetools_0.2-20    Rcpp_1.1.1-1.1     
#> [28] htmlwidgets_1.6.4   later_1.4.8         digest_0.6.39      
#> [31] R6_2.6.1            magrittr_2.0.5      bslib_0.11.0       
#> [34] tools_4.6.1         mime_0.13           shinythemes_1.2.0  
#> [37] cachem_1.1.0