% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/read.R
\name{tidylearn-read}
\alias{tidylearn-read}
\title{Data Reading Functions for tidylearn}
\description{
Functions for reading data from diverse sources into tidy
\code{tidylearn_data} objects. The main dispatcher
\code{tl_read()} auto-detects the format from the file
extension and routes to the appropriate reader.
All readers return a \code{tidylearn_data} object,
which is a tibble subclass carrying metadata about
the data source.
}
\details{
Supported file formats:
\itemize{
\item \strong{CSV}: \code{.csv} files via \pkg{readr}
(with base R fallback)
\item \strong{TSV}: \code{.tsv} files via \pkg{readr}
(with base R fallback)
\item \strong{Excel}: \code{.xls}, \code{.xlsx},
\code{.xlsm} files via \pkg{readxl}
\item \strong{Parquet}: \code{.parquet} files via \pkg{nanoparquet}
\item \strong{JSON}: \code{.json} files via \pkg{jsonlite}
\item \strong{RDS}: \code{.rds} files via base \code{readRDS()}
\item \strong{RData}: \code{.rdata}, \code{.rda}
files via base \code{load()}
}

Supported databases (via \pkg{DBI}):
\itemize{
\item \strong{SQLite}: \code{.sqlite}, \code{.db} files via \pkg{RSQLite}
\item \strong{PostgreSQL}: via \pkg{RPostgres}
\item \strong{MySQL/MariaDB}: via \pkg{RMariaDB}
\item \strong{BigQuery}: via \pkg{bigrquery}
}

Supported cloud/API sources:
\itemize{
\item \strong{S3}: \code{s3://} URIs via \pkg{paws.storage}
\item \strong{GitHub}: raw file download from repositories
\item \strong{Kaggle}: dataset download via Kaggle CLI
}

Multi-file reading:
\itemize{
\item \strong{Multiple paths}: pass a character vector to \code{tl_read()}
\item \strong{Directories}: \code{tl_read_dir()} scans for data files with
optional pattern/format filtering and recursive scanning
\item \strong{Zip archives}: \code{tl_read_zip()} extracts and reads from
\code{.zip} files
}
When combining multiple files, a \code{source_file} column is added to
identify the origin of each row.
}
