projects: Discover R package projects

In saber: Context Engineering for Large Language Model Agents

Discover R package projects

Description

Scans a directory for subdirectories containing a DESCRIPTION file and returns their metadata. Symbolic-link aliases of the same directory are reported once, preferring its non-alias path when present. Separate checkouts remain separate even when they declare the same package name.

Usage

projects(scan_dir = path.expand("~"), exclude = default_exclude())

Arguments

scan_dir	Directory to scan for project directories.
exclude	Character vector of directory basenames to skip.

Value

A data.frame with columns: package, title, version, path, depends, imports.

Examples

d <- file.path(tempdir(), "scandir")
dir.create(d, showWarnings = FALSE)
pkg <- file.path(d, "mypkg")
dir.create(pkg, showWarnings = FALSE)
writeLines(c("Package: mypkg", "Title: Demo", "Version: 0.1.0"),
           file.path(pkg, "DESCRIPTION"))
projects(scan_dir = d)

saber documentation built on Nov. 10, 2026, 9:06 a.m.