https://github.com/r-hub/cranlike

Manage files in a CRAN-like repository
https://github.com/r-hub/cranlike

cran package-management repository

Last synced: 8 days ago
JSON representation

Manage files in a CRAN-like repository

• Host: GitHub
• URL: https://github.com/r-hub/cranlike
• Owner: r-hub
• Created: 2016-12-20T11:17:44.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-04-25T07:45:30.000Z (8 months ago)
• Last Synced: 2024-10-13T13:40:01.739Z (about 2 months ago)
• Topics: cran, package-management, repository
• Language: R
• Homepage:
• Size: 129 KB
• Stars: 25
• Watchers: 4
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS.md

Awesome Lists containing this project

• jimsghstars - r-hub/cranlike - Manage files in a CRAN-like repository (R)

README

        

# cranlike

> Tools for CRAN-like Repositories

[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)

[![](https://www.r-pkg.org/badges/version/cranlike)](https://www.r-pkg.org/pkg/cranlike)

[![CRAN RStudio mirror downloads](https://cranlogs.r-pkg.org/badges/cranlike)](https://www.r-pkg.org/pkg/cranlike)

[![R-CMD-check](https://github.com/r-hub/cranlike/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/r-hub/cranlike/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/r-hub/cranlike/branch/main/graph/badge.svg)](https://app.codecov.io/gh/r-hub/cranlike?branch=main)

A set of functions to manage CRAN-like repositories efficiently.

This package is an alternative to `tools::write_PACKAGES`.

The goal is to make updates to the repository easier and faster,

without the need of scanning all the package files.

`cranlike` keeps the package data in a SQLite database, in addition

to the `PACKAGES*` files. This database is the canonical source of the

package data. It can be updated quickly, to add and remove packages.

The `PACKAGES*` files are generated from the database.

## Installation

```r

install.packages("cranlike")

```

## Usage

```r

library(cranlike)

```

### Setting up a repository

`create_empty_PACKAGES` creates an empty CRAN-like repository in the

specified directory. It creates the SQLite database (if it does not exist),

and also the `PACKAGES*` files.

`update_PACKAGES` is similar, but it also scans the directory for package

files, and adds them to the database. Use this function on an existing

CRAN-like repository. It creates and updates the database, and then

the `PACKAGES*` files.

### Adding and removing packages

`add_PACKAGES` adds one or more package files to the repository.

The files must already exist in the directory. The database is created

if needed, and then updated with the new packages. Then the `PACKAGES*`

files will be re-generated.

`remove_PACKAGES` removes one or more package files from the repository.

It first removes them from the database, and then removes the files from

the directory. Finally, it re-generates the `PACKAGES*` files.

### Listing packages

`package_versions` lists all packages in the repository. It uses the

SQLite database instead of parsing the `PACKAGES*` files, so it is much

faster.

## License

GPL Version 2 or higher © R Consortium