Get Stats About Databrary.

get_db_stats returns basic summary information about the institutions, people, and data hosted on 'Databrary.org'.

Usage

get_db_stats(type = "stats", vb = options::opt("vb"), rq = NULL)

Arguments

type

Type of Databrary report to run "institutions", "people", "data"

vb

Show verbose messages. (Defaults to FALSE, overwritable using option 'databraryr.vb' or environment variable 'R_DATABRARYR_VB')

rq

An httr2 request object.

Value

A data frame with the requested data or NULL if there is no new information.

Examples

# \donttest{
get_db_stats()
#> # A tibble: 1 × 9
#>   date                investigators affiliates institutions datasets_total
#>   <dttm>                      <int>      <int>        <int>          <int>
#> 1 2024-07-19 15:18:39          1777        639          795           1731
#> # ℹ 4 more variables: datasets_shared <int>, n_files <int>, hours <dbl>,
#> #   TB <dbl>
get_db_stats("stats")
#> # A tibble: 1 × 9
#>   date                investigators affiliates institutions datasets_total
#>   <dttm>                      <int>      <int>        <int>          <int>
#> 1 2024-07-19 15:18:39          1777        639          795           1731
#> # ℹ 4 more variables: datasets_shared <int>, n_files <int>, hours <dbl>,
#> #   TB <dbl>
get_db_stats("people") # Information about the newest authorized investigators.
#> # A tibble: 7 × 5
#>      id sortname prename      affiliation                          time         
#>   <int> <chr>    <chr>        <chr>                                <chr>        
#> 1 12088 Benton   Deon         Vanderbilt University                2024-07-18T1…
#> 2 12707 Mavrides Maria        Hunter College, CUNY                 2024-07-18T1…
#> 3  6104 Heck     Isobel Azani University of Rochester              2024-07-10T1…
#> 4 20597 Stacey   Paula        Nottingham Trent University          2024-07-09T2…
#> 5 12635 McDonald Kristina     University of Alabama                2024-07-09T2…
#> 6 21666 Gard     Arianna      University of Maryland, College Park 2024-07-09T2…
#> 7 12640 Zamani   Hamed        University of Massachusetts Amherst  2024-06-28T2…
get_db_stats("places") # Information about the newest institutions.
#> data frame with 0 columns and 0 rows
# }