List Available Packages at CRAN-like Repositories
available.packages returns a matrix of details corresponding to
packages currently available at one or more repositories. The
current list of packages is downloaded over the internet (or copied
from a local mirror).
available.packages(contriburl = contrib.url(repos, type), method, fields = NULL, type = getOption("pkgType"), filters = NULL, repos = getOption("repos"))
URL(s) of the
contribsections of the repositories. Specify this argument only if your repository mirror is incomplete, e.g., because you burned only the
contribsection on a CD.
download method, see
character string, indicate which type of packages: see
type = "both"this will use the source repository.
a character vector giving the fields to extract from
PACKAGESfile(s) in addition to the default ones, or
NULL(default). Unavailable fields result in
a character vector or list or
NULL(default). See ‘Details’.
- character vector, the base URL(s) of the repositories to use.
The list of packages is either copied from a local mirror (specified by a
file:// URI) or downloaded. If downloaded, the list is cached
for the R session in a per-repository file in
with a name like
repos_http%3a%2f%2fcran.r-project.org%2fsrc%2fcontrib.rdsBy default, the return value includes only packages whose version and OS requirements are met by the running version of R, and only gives information on the latest versions of packages. Argument
filterscan be used to select which of the packages on the repositories are reported. It is called with its default value (
NULL) by functions such as
install.packages: this value corresponds to
c("R_version", "OS_type", "subarch", "duplicates")if that is unset or set to
NULL. The built-in filters are
- Exclude packages whose R version requirements are not met.
- Exclude packages whose OS requirement is incompatible with this version of R: that is exclude Windows-only packages on a Unix-alike platform and vice versa.
- For binary packages, exclude those with compiled code that is not available for the current sub-architecture, e.g. exclude packages only compiled for 32-bit Windows on a 64-bit Windows R.
- Only report the latest version where more
than one version is available, and only report the first-named
contriburl) with the latest version if that is in more than one repository.
- Include only packages for which installation can proceed solely based on packages which can be verified as Free or Open Source Software (FOSS, e.g., https://en.wikipedia.org/wiki/FOSS) employing the available license specifications. Thus both the package and any packages that it depends on to load need to be known to be FOSS. Note that this does depend on the repository supplying license information.
- Include only packages for which installation can proceed solely based on packages which are known not to restrict use.
- Use CRAN versions in preference to versions
from other repositories (even if these have a higher version
number). This needs to be applied before the default
"duplicates"filter, so cannot be used with
add = TRUE.
filtersshould be a list with elements which are character strings, user-defined functions or
add = TRUE(see below). User-defined filters are functions which take a single argument, a matrix of the form returned by
available.packages, and return a matrix consisting of a subset of the rows of the argument. The special ‘filter’
add = TRUEappends the other elements of the filter list to the default filters.
A matrix with one row per package, row names the package names and
column names including
"Repository". Additional columns can be
specified using the
fields argument. Where provided by the repository, fields
"NeedsCompilation" are reported for use by the filters and
package management tools, including