% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/fetch.R
\name{fetch_ls}
\alias{fetch_ls}
\title{List files and folders at a remote RAP path}
\usage{
fetch_ls(path = ".", type = "all", pattern = NULL)
}
\arguments{
\item{path}{(character) Remote path to list. Default: \code{"."} (project
root). Both \code{"Bulk/"} and \code{"/Bulk/"} are accepted.}

\item{type}{(character) Filter results by entry type: \code{"all"}
(default), \code{"file"}, or \code{"folder"}.}

\item{pattern}{(character) Optional regex to filter by name, e.g.
\code{"\\.bed$"}. Default: \code{NULL}.}
}
\value{
A data.frame with columns:
\describe{
\item{name}{Entry name (no trailing slash for folders).}
\item{type}{\code{"file"} or \code{"folder"}.}
\item{size}{File size string (e.g. \code{"120.94 GB"}), \code{NA} for
folders or non-file objects.}
\item{modified}{Last modified time (\code{POSIXct}), \code{NA} for
folders.}
}
}
\description{
Returns a structured data.frame describing the contents of a remote
DNAnexus Research Analysis Platform (RAP) directory. Analogous to
\code{file_info()} but for remote project storage.
}
\examples{
\dontrun{
fetch_ls()
fetch_ls("Showcase metadata/", type = "file")
fetch_ls("results/", pattern = "\\\\.csv$")
}
}
