NEWS

---

sysreqr 0.1.0 (2026-06-11)

First public release.

Preflight checks

• check_packages() resolves the system packages an R package needs on a given Linux platform. Four backends are available: "auto" (default), "bundled", "ppm", and "pak".
• check_library() audits installed packages in an R library path.
• check_project() and detect_project_packages() scan a project directory, preferring renv.lock, then DESCRIPTION, then source files.

Platform handling

• detect_platform() reads /etc/os-release on Linux, sw_vers on macOS, and parses fixture files for tests.
• detect_package_manager() returns the package manager for a platform (apt, dnf, yum, zypper, apk, brew).
• resolve_platform() accepts NULL, an existing platform object, <distro>-<version> shorthand, or a codename alias (jammy, noble, resolute, bookworm, trixie).

Commands and outputs

• install_command() generates platform-appropriate install commands.
• dockerfile() and write_dockerfile_snippet() produce Dockerfile snippets.
• github_actions() (alias gha()) produces a GitHub Actions YAML step.
• admin_request() drafts a plain-text request for system administrators.
• write_install_script() writes a POSIX shell script.
• write_report() and write_json() persist a plan to disk.
• as_install_plan() returns a structured list suitable for downstream tooling.

Diagnostics

• diagnose_log() (alias diagnose_install_log()) matches common compiler and linker error patterns and resolves failed package names back to system requirements.
• check_error() is a convenience wrapper that reads geterrmessage().
• diagnose_failed_packages() resolves a known list of failed R packages.

Posit Package Manager

• ppm_platforms(), check_ppm(), ppm_repo(), ppm_sysreqs(), and use_ppm() integrate with the Posit Package Manager API and binary repository URLs.

Setup guidance

• setup_advice() produces a practical, beginner-friendly Linux setup checklist with optional shell-script output.
• explain() prints a friendly per-package explanation.

Documentation

• Five HTML vignettes: preflight setup, diagnosing failures, GNU/Linux fundamentals (for newcomers to Linux), Docker and CI workflows, and an FAQ.
• Every exported function has a runnable example.
• Reference index grouped by topic on the pkgdown site.

Correctness and portability

• Bundled system-package names are now portable across Debian and Ubuntu: default-libmysqlclient-dev (was libmysqlclient-dev, which does not exist on Debian), libgsl-dev (was libgsl0-dev), and libfreetype-dev (was libfreetype6-dev).
• detect_project_packages() now detects requireNamespace() calls and ignores package names that appear only in line comments.
• setup_advice() generates Debian repository setup using the modern deb822 Signed-By keyring format (matching CRAN's current Debian instructions), drops a no-op Fedora repoquery line, and presents the Fedora COPR step as optional.
• Added AlmaLinux 9 and 10 as known platforms so ppm_repo() and check_ppm() work for them.
• The internal JSON parser now rejects unescaped control characters, per the JSON specification.

Design notes

• sysreqr has zero required dependencies: no Imports, no Depends beyond base R. The Suggests field lists testthat, knitr, rmarkdown, and withr, used only for tests and vignette building; none of them are loaded at run time.
• Optional live backends can use Posit Package Manager (over HTTPS) and pak::pkg_sysreqs(), both of which are detected at run time and never required.
• The package ships a static bundled database of system requirements for common CRAN packages. The database is refreshed with each release. Use backend = "ppm" or backend = "pak" when newer live metadata is needed.