Updated `expand()` and coercion from "messydt" functions to manage negative dates. Arithmetic functions for operations with "messydt" objects were also added.

[henriquesposito]

Description

These patch changes update how expand functions manage negative dates and how negative dates are coerced into dates. As well, arithmetic functions for working with "messydt" were added.

Package

• Added a vignette for working with the {messydates} package

Functions

• Closed #9 by adding arithmetic operations for working with "messydt" objects
  • Added S3 methods for "+" and "-" operators
  • Added add() and subtract() helper functions for arithmetic operations
• Updated expand() function
  • Closed #31 by updating how approximate dates are expanded to account for leap years
  • Closed #34 by updating expand() to manage negative dates
  • Added expand_negative_dates() helper function for expanding ranges of negative dates
• Updated functions that coerce from "messydt" objects to "Date" to manage negative dates
  • Added negative_dates() helper function to coerce negative "messydt" dates
• Closed #39 by updating how resolve mean methods work for negative dates
• Closed #40 by updating contract function to manage the contraction of negative dates
  • Added compact_negative_dates() helper function to compact negative date ranges
  • Added is.sequence() as a helper function to check if dates are a range
• Updated resequence script to export interleave() function

Checklist:

• [x] PR form
  • [x] I have given this pull request an informative title
  • [x] Description above itemizes changes under subtitles, e.g. "## Collection""
  • [x] Any closed, fixed, or related issues are referenced and explained in the description above, e.g. "Fixed #0 by adding A"
  • [x] Package builds on my OS without issues
• [x] PR checks all pass for latest commit
  • [x] Package builds on Mac
  • [x] Package builds on Windows
  • [x] Package builds on Linux
  • [x] CodeCov check: Package improves or maintains good test coverage
  • [x] CodeFactor check: Package improves or maintains good style
• [x] Documentation
  • [x] Any new or modified functions or data have roxygen style documentation in their .R scripts
  • [x] Any longer functions are commented inline so that it is easier to debug in the future
  • [x] PR description above and the NEWS.md file are aligned
  • [x] DESCRIPTION file version is bumped by the appropriate increment (major, minor, patch)

[codecov[bot]]

Codecov Report

Merging #42 (b950543) into main (d6bcebd) will increase coverage by 3.59%. The diff coverage is 98.95%.

@@            Coverage Diff             @@
##             main      #42      +/-   ##
==========================================
+ Coverage   89.82%   93.42%   +3.59%     
==========================================
  Files          12       13       +1     
  Lines         403      517     +114     
==========================================
+ Hits          362      483     +121     
+ Misses         41       34       -7     

Impacted Files	Coverage Δ
R/resequence.R	96.96% <ø> (ø)
R/coerce_from_messydate.R	91.66% <87.50%> (-8.34%)	:arrow_down:
R/coerce_to_messydate.R	97.46% <100.00%> (+0.13%)	:arrow_up:
R/contract.R	100.00% <100.00%> (ø)
R/expand.R	100.00% <100.00%> (ø)
R/operate.R	100.00% <100.00%> (ø)
R/resolve.R	93.47% <100.00%> (+20.75%)	:arrow_up:

---

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update 2576d15...b950543. Read the comment docs.