Help for package reptiledb.data

Title:

Reptile Database Data

Version:

0.0.0.2

Description:

Provides easy access to 'The Reptile Database', a comprehensive catalogue of all living reptile species and their classification. This package includes taxonomic data for over 10,000 reptile species, approximately 2,800 of which are subspecies, covering all extant reptiles. The dataset features taxonomic names, synonyms, distribution data, type specimens, and literature references, making it ready for research and analysis. Data is sourced from 'The Reptile Database' http://www.reptile-database.org/.

License:

MIT + file LICENSE

Depends:

R (≥ 4.1.0)

Suggests:

testthat (≥ 3.0.0), knitr, rmarkdown

Config/testthat/edition:

Encoding:

UTF-8

RoxygenNote:

7.3.3

LazyData:

true

URL:

https://github.com/PaulESantos/reptiledb.data

BugReports:

https://github.com/PaulESantos/reptiledb.data/issues

Imports:

cli, httr, rvest, stringr

Maintainer:

Paul Efren Santos Andrade <paulefrens@gmail.com>

NeedsCompilation:

Packaged:

2026-01-07 03:24:35 UTC; PC

Author:

Paul Efren Santos Andrade

[aut, cre]

Repository:

CRAN

Date/Publication:

2026-01-08 23:30:02 UTC

Check if reptile database data needs updating

Description

Compares the local reptile database version with the latest available version on The Reptile Database website and provides user-friendly feedback.

Usage

check_data_update(
  version_date = "2025-09-01",
  silent = FALSE,
  check_connection = TRUE
)

Arguments

version_date

Character string indicating the most recent date of the data source.

silent

Logical. If TRUE, suppresses all messages and returns only the result object. Default is FALSE.

check_connection

Logical. If TRUE, verifies internet connection before attempting to check for updates. Default is TRUE.

Value

An S3 object of class "reptile_update_check" with the following components:

needs_update: Logical. TRUE if update is available
local_date: Date. Version date of local data
remote_date: Date. Version date of remote data (if available)
days_behind: Integer. Days between local and remote versions
download_url: Character. URL to download latest data
status: Character. One of "current", "outdated", "newer", "unknown", "no_connection"

Examples


# Check with user-friendly messages
check_data_update()

# Silent check for programmatic use
result <- check_data_update(silent = TRUE)
if (result$needs_update) {
  message("Update available!")
}

Check Internet Connection

Description

Check Internet Connection

Usage

check_internet_connection()

Value

Logical. TRUE if internet is available

Extract date from dataset name or filename

Description

Extract date from dataset name or filename

Usage

extract_date_from_name(name, type = "local")

Arguments

name

Character. Dataset name or filename

type

Character. Type of name ("local" or "remote")

Value

A Date object or NULL if extraction fails

Get Latest Reptile Database Download Information

Description

Retrieves information about the most recent reptile database file available for download from the official website.

Usage

get_latest_reptile_download(
  base_url = "http://www.reptile-database.org/data/",
  current_year = as.integer(format(Sys.Date(), "%Y")),
  file_types = c("xlsx", "xls", "zip"),
  return_info = FALSE
)

Arguments

base_url

Character. The base URL of the data page. Default: "http://www.reptile-database.org/data/"

current_year

Numeric. Year to prioritize in search. Default: current system year

file_types

Character vector. File extensions to search for. Default: c("xlsx", "xls", "zip")

return_info

Logical. If TRUE, returns detailed information list. If FALSE, returns only the URL string. Default: FALSE

Value

If return_info = FALSE: Character string with the download URL, or NULL

If return_info = TRUE: A list with:

url: Complete download URL
filename: File name
file_type: File extension
checked_at: Timestamp of check
source_page: Source webpage URL

Examples


# Get download URL
url <- get_latest_reptile_download()

# Get detailed information
info <- get_latest_reptile_download(return_info = TRUE)

Print method for reptile_update_check objects

Description

Print method for reptile_update_check objects

Usage

## S3 method for class 'reptile_update_check'
print(x, ...)

Arguments

x

An object of class "reptile_update_check"

...

Additional arguments (not used)

Reptile Checklist with Subspecies Information - January 2025

Description

A comprehensive dataset extracted from The Reptile Database containing taxonomic and nomenclatural information for reptile species and their subspecies. Each row corresponds to a species–subspecies combination (or a species without subspecies), with fields for authorship, year of description, and identifiers used by The Reptile Database.

Usage

reptiledb_012025

Format

A tibble with 14,539 rows and 13 columns:

order: Taxonomic order of the reptile (factor; e.g., "Sauria").
family: Taxonomic family (factor; e.g., "Scincidae").
genus: Genus name (factor).
epithet: Species epithet (second part of the species name; factor).
species: Full species name (genus + epithet; character).
species_author: Primary author(s) of the species name (factor).
species_name_year: Year in which the species was described (character).
subspecies_name: Epithet of the subspecies, when available (character; NA if no subspecies).
subspecie_author_info: Full author citation of the subspecies (character; NA if no subspecies).
subspecies_name_author: Author(s) of the subspecies name (character; NA if no subspecies).
subspecies_year: Year in which the subspecies was described (character; NA if no subspecies).
change: Optional free-text description of taxonomic or nomenclatural changes (factor; NA when no change is recorded).
rdb_sp_id: Numeric identifier assigned to the species by The Reptile Database (double).

Details

The dataset is a structured export of reptile taxonomy information from The Reptile Database. Species with multiple subspecies appear in multiple rows (one per subspecies), sharing the same species and rdb_sp_id values. Species without recognized subspecies appear in a single row with all subspecies-related fields set to NA.

This object is part of the reptiledb.data package and is intended to support filtering, analysis, and visualization of reptile diversity and nomenclatural history across orders, families, genera, and species.

Source

http://www.reptile-database.org/

Reptile Checklist with Subspecies Information - September 2025

Description

Usage

reptiledb_092025

Format

A tibble with 14,585 rows and 13 columns:

order: Taxonomic order of the reptile (factor; e.g., "Sauria").
family: Taxonomic family (factor; e.g., "Scincidae").
genus: Genus name (factor).
epithet: Species epithet (second part of the species name; factor).
species: Full species name (genus + epithet; character).
species_author: Primary author(s) of the species name (factor).
species_name_year: Year in which the species was described (character).
subspecies_name: Epithet of the subspecies, when available (character; NA if no subspecies).
subspecie_author_info: Full author citation of the subspecies (character; NA if no subspecies).
subspecies_name_author: Author(s) of the subspecies name (character; NA if no subspecies).
subspecies_year: Year in which the subspecies was described (character; NA if no subspecies).
change: Optional free-text description of taxonomic or nomenclatural changes (factor; NA when no change is recorded).
rdb_sp_id: Numeric identifier assigned to the species by The Reptile Database (double).

Details

This object corresponds to the September 2025 snapshot of the checklist.

Source

http://www.reptile-database.org/