R Observatory: Metrics for almanac version 1.0.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

This package was removed from CRAN on 2026-08-22. Its history is shown below.

Reason: issues were not corrected in time

Details below reflect version 1.0.0, its last release before removal.

almanac

1.0.0Package record

0packages dependsuggested by 1

4.5Kdownloads / year

95.5%test coverage

–flavors OK

Overview

About

Maintained by Davis VaughanCRAN page ↗GitHub ↗Declared funder: Posit Software, PBC

Changes in 1.0.0

New features

New holiday and calendar API and corresponding vignette vignette("holidays-calendars") (#96):
rholiday() creates a new holiday from a holiday name and a rschedule that defines when the holiday occurs. There are a number of pre-created holidays prefixed with hol_*(), such as hol_christmas() and hol_us_thanksgiving(). Holidays are rschedules, so you can use all of the alma_*() functions on them.
hol_observe(), hol_offset(), and hol_rename() are three helpers for the holiday API. In particular, hol_observe() tweaks a holiday's _observance date_ to align with when your business actually celebrated that holiday.

Show all changes in 1.0.0Hide the rest of the changes in 1.0.0

rcalendar() bundles multiple holidays together into a calendar. Calendars are similar to runion()s, so you can use all the alma_*() functions on these, but they also come with their own specialized API of functions that start with cal_*(), such as cal_match() to look up the holiday name a date corresponds to, and cal_events() to filter for all of the holidays within a particular year.
cal_us_federal() is an example calendar representing the federal holidays recognized in the United States.
New roffset() for creating an rschedule with events that are offset from an existing rschedule (#94).
New rcustom() for creating an rschedule from manually defined event dates (#90).
alma_events() has gained a year argument to limit the returned set of events to specific years.
runion(), rintersect(), and rsetdiff() have all gained ... which allows you to provide rschedules at creation time. This is now the preferred way to create these set-based rschedules (#91).
Steppers created with stepper() now work as .before and .after arguments of slider::slide_index() and friends (#80).

Lifecycle changes

The following functions have been deprecated in favor of more intuitively named alternatives (#83):
recur_on_mday() -> recur_on_day_of_month()
recur_on_wday() -> recur_on_day_of_week()
recur_on_yday() -> recur_on_day_of_year()
recur_on_yweek() -> recur_on_week_of_year()
recur_on_ymonth() -> recur_on_month_of_year()

These functions are being aggressively deprecated and will be removed in the

next minor version of almanac.

The family of add_*() functions has been deprecated (#92).
add_rschedule() has been deprecated in favor of using the ... argument of runion(), rintersect(), and rsetdiff() directly.
add_rdates() has been deprecated in favor of using a combination of runion() and rcustom().
add_exdates() has been deprecated in favor of using a combination of rsetdiff() and rcustom().

These functions are being aggressively deprecated and will be removed in the

next minor version of almanac.

The offset argument of recur_on_easter() is deprecated in favor of using roffset() (#94).

Breaking changes

All almanac class names are now prefixed with almanac_* to avoid potential clashes with other packages.
The recur_with_week_start() argument wday has been renamed to day.
The following developer facing functions have been removed because they are either no longer applicable or provided extension mechanisms that are not very useful in practice (#93):
new_rbundle()
new_runion()
new_rintersect()
new_rsetdiff()
rbundle_restore()

Bug fixes and minor improvements

recur_for_count() no longer overrides until (#95).
New almanac_since() and almanac_until() helpers to access the default since and until values used for all rules (#95).
Greatly improved the print methods of all almanac classes using cli (#86).
Updated internal JavaScript rrule library to version 2.7.2 (#82).
R >=3.5.0 is now required, which is in line with tidyverse standards.

From NEWS.md in the release

Install

R (source archive)pak (dev)

url <- "https://cran.r-project.org/src/contrib/Archive/almanac/almanac_1.0.0.tar.gz"
pkgFile <- "almanac_1.0.0.tar.gz"
download.file(url, pkgFile)
install.packages(pkgFile, type = "source", repos = NULL)

This package is no longer on CRAN, so install.packages() cannot fetch it by name. This downloads the last archived source (1.0.0) and builds it locally. Install its dependencies first, and note that building from source needs the usual compiler toolchain.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("DavisVaughan/almanac")

Development version from DavisVaughan/almanac. Installs pak first if it is not already available.

Health

CRAN checks

CRAN check results are not tracked yet.

Status changes

OK13 OK2026-08-05
NOTE12 OK, 1 NOTE2026-08-01
OK14 OK2026-03-10

Advisories

none known

How this is measured·How advisories are found

Documentation

In release 1.0.0

READMEYes · 588 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 1.0.0Citation fileNoWebsitenot declared in DESCRIPTION

Help pages: 40 (5 internal)includes a package overview page
Examples that run: 100%37 run in a plain check
Exported functions with examples: 95%
Documented parameters: 96%
Return-value docs: 84%
Help pages citing references: 0%

How these are measured

Downloads

4.5K

CRAN downloads in the past year

Rank #23,690 · ~12/day · ~371/mo

Releases R versions

Daily download trend is not available in this view yet.

030 days

54590 days

4.5K1 year

Compare downloads with other packages →

Also on400 r2u27 autocran53 c2d4u

How downloads are counted

Repository

davisvaughan/almanac ↗Historical

Last recorded for this package on 2026-08-16. The package was removed from CRAN on 2026-08-22, so this repository is no longer tracked.

How these are measured

PracticesHistoricalBeta

9 development-tooling and community-health practices detected across 5 families in the repository last recorded for this package

Checks last ran against github.com/davisvaughan/almanac on 2026-08-23. The package was removed from CRAN, so this is no longer updated.

Continuous integration (1)

GitHub Actions

Docs source (2)

README.Rmdpkgdown

Coverage (2)

Coverage reporting (Codecov).covrignore

CRAN release process (1)

cran-comments.md

Show all practicesHide 1 practice

Lint, format, editor (3)

AirVS CodeRStudio project

How this is detected·Detection ruleset v4 (2026-10-20)

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.5.0

Imports (9)

cli glue lifecycle lubridate magrittr R6 rlang V8 vctrs

LinkingTo (0)

none

Suggests (5)

covr knitr rmarkdown slider testthat (>= 3.0.0)

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

–indirect (not tracked)

Suggested by 1

Suggests, most downloaded first

tbl.now

How these are counted

Code & Tests

People & History

People (2)

Davis Vaughan

Author, Maintainer since 0.1.0 (2020)

Posit Software, PBC

Copyright holder, Funder · added in 1.0.0

Listed in earlier versions (1)

RStudio

no longer listed · 0.1.0 to 0.1.1

Releases (3)

Pick two releases to compare their code metrics.

archivedRemoved from CRAN
2026-08-22
issues were not corrected in time
R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
1.0.0
record
2023-04-14 · diff ↗ ·
removed 5 exports
new_rbundle, new_rintersect, new_rsetdiff, new_runion, rbundle_restore

added 43 exports
almanac_since, almanac_until, cal_add, cal_events, cal_match, cal_names, cal_next, cal_previous, cal_remove, cal_us_federal, hol_christmas, hol_christmas_eve, hol_easter, hol_good_friday, hol_halloween, hol_new_years_day, hol_new_years_eve, hol_observe, hol_offset, hol_rename, hol_st_patricks_day, hol_us_election_day, hol_us_fathers_day, hol_us_independence_day, hol_us_indigenous_peoples_day, hol_us_juneteenth, hol_us_labor_day, hol_us_martin_luther_king_junior_day, hol_us_memorial_day, hol_us_mothers_day and 13 more
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
0.1.1
record
2020-05-28 · diff ↗
0.1.0
record
2020-05-27
R
R 4.0.0 released · 2020-04-24

Package metadata

First published: 2020-05-27
Total releases: 3 / 6 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 3.5.0
Download size: 176 KB

Appears in task views

Time Series Analysis

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("almanac")

Format

Vaughan, D., & Posit Software, PBC. (n.d.). almanac (Version 1.0.0) [Computer software]. Retrieved October 25, 2026, from https://CRAN.R-project.org/package=almanac

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for almanac version 1.0.0 [Data set]. HJJB, LLC. Data release v2026-10-24. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →