% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/de_list_datasets.R
\name{de_list_datasets}
\alias{de_list_datasets}
\title{List available Delaware Open Data datasets}
\usage{
de_list_datasets()
}
\value{
A tibble containing available Delaware Open Data datasets. Important
  columns include:
  \describe{
    \item{key}{A human-readable dataset key generated from the dataset name.}
    \item{uid}{The official Socrata dataset identifier used by Delaware Open
      Data.}
    \item{name}{The dataset name from the Delaware Open Data catalog.}
  }
  Additional metadata columns from the Delaware Open Data catalog may also
  be returned.
}
\description{
Retrieves a live catalog of Delaware Open Data datasets from the Delaware
Open Data Portal catalog table (`q2kk-gcju`) and returns dataset
metadata that can be used with [de_pull_dataset()].
}
\details{
The returned tibble includes both the official Socrata dataset `uid` and a
human-readable `key`. The `uid` is the stable identifier used by the Delaware
Open Data Portal and Socrata API, while the `key` is generated from the
dataset name using [janitor::make_clean_names()] to make datasets easier to
reference in R code, especially in classroom and reproducible research
settings.

Most users will begin by calling `de_list_datasets()`, searching the
returned catalog for a dataset of interest, and then passing either the `key`
or `uid` to [de_pull_dataset()].
}
\examples{
if (interactive() && curl::has_internet()) {
  catalog <- de_list_datasets()

  # View available datasets
  catalog

  # Search for datasets containing a keyword
  catalog[
    grepl("bid", catalog$name, ignore.case = TRUE),
    c("key", "uid", "name")
  ]
}

}
