% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/read-backends.R
\name{tl_read_s3}
\alias{tl_read_s3}
\title{Read from Amazon S3}
\usage{
tl_read_s3(source, format = NULL, region = NULL, ...)
}
\arguments{
\item{source}{An S3 URI (e.g., \code{"s3://bucket/path/to/file.csv"}).}

\item{format}{Optional format override for the downloaded file. If
\code{NULL}, auto-detected from the S3 key extension.}

\item{region}{AWS region. If \code{NULL}, uses the default from your AWS
configuration.}

\item{...}{Additional arguments passed to the format-specific reader.}
}
\value{
A \code{tidylearn_data} object containing the downloaded data.
}
\description{
Downloads a file from an S3 bucket and reads it into a \code{tidylearn_data}
object. The file format is auto-detected from the key's extension, or can be
specified explicitly. Requires the \pkg{paws.storage} package and valid AWS
credentials.
}
\examples{
\donttest{
# data <- tl_read_s3("s3://my-bucket/data/sales.csv")
# data <- tl_read_s3("s3://my-bucket/data/results.parquet")
}

}
