add --date argument

src/pycalver/__main__.py

@@ -12,6 +12,7 @@ Enables use as module: $ python -m pycalver --version
 import sys
 import typing as typ
 import logging
+import datetime as dt
 import subprocess as sp
 
 import click
@@ -62,7 +63,31 @@ def _configure_logging(verbose: int = 0) -> None:
 VALID_RELEASE_VALUES = ("alpha", "beta", "dev", "rc", "post", "final")
 
 
-def _validate_release_tag(release: str) -> None:
+_current_date = dt.date.today().isoformat()
+
+
+def _validate_date(date: typ.Optional[str], pin_date: bool) -> dt.date:
+    if date and pin_date:
+        logger.error(f"Can only use either --pin-date or --date='{date}', not both.")
+        sys.exit(1)
+
+    if date is None:
+        return
+
+    try:
+        dt_val = dt.datetime.strptime(date, "%Y-%m-%d")
+        return dt_val.date()
+    except ValueError:
+        logger.error(
+            f"Invalid parameter --date='{date}', must match format YYYY-0M-0D.", exc_info=True
+        )
+        sys.exit(1)
+
+
+def _validate_release_tag(release: typ.Optional[str]) -> None:
+    if release is None:
+        return
+
     if release in VALID_RELEASE_VALUES:
         return
 
@@ -100,6 +125,13 @@ def cli(verbose: int = 0) -> None:
 @click.option("-p"        , "--patch", is_flag=True, default=False, help="Increment patch component.")
 @click.option("-r"        , "--release-num", is_flag=True, default=False, help="Increment release number.")
 @click.option("--pin-date", is_flag=True, default=False, help="Leave date components unchanged.")
+@click.option(
+    "-d",
+    "--date",
+    default=None,
+    metavar="<date>",
+    help=f"Set explicit date in format YYYY-0M-0D (eg. {_current_date}).",
+)
 def test(
     old_version: str,
     pattern    : str = "{pycalver}",
@@ -109,14 +141,15 @@ def test(
     minor      : bool = False,
     patch      : bool = False,
     release_num: bool = False,
+    date       : typ.Optional[str] = None,
     pin_date   : bool = False,
 ) -> None:
     """Increment a version number for demo purposes."""
     _configure_logging(verbose=max(_VERBOSE, verbose))
     raw_pattern = pattern
 
-    if release:
     _validate_release_tag(release)
+    _date = _validate_date(date, pin_date)
 
     new_version = _incr(
         old_version,
@@ -127,6 +160,7 @@ def test(
         patch=patch,
         release_num=release_num,
         pin_date=pin_date,
+        date=_date,
     )
     if new_version is None:
         logger.error(f"Invalid version '{old_version}' and/or pattern '{raw_pattern}'.")
@@ -203,6 +237,7 @@ def _incr(
     patch      : bool = False,
     release_num: bool = False,
     pin_date   : bool = False,
+    date       : typ.Optional[dt.date] = None,
 ) -> typ.Optional[str]:
     v1_parts    = list(v1patterns.PART_PATTERNS) + list(v1patterns.FULL_PART_FORMATS)
     has_v1_part = any("{" + part + "}" in raw_pattern for part in v1_parts)
@@ -216,6 +251,7 @@ def _incr(
             patch=patch,
             release_num=release_num,
             pin_date=pin_date,
+            date=date,
         )
     else:
         return v2version.incr(
@@ -227,6 +263,7 @@ def _incr(
             patch=patch,
             release_num=release_num,
             pin_date=pin_date,
+            date=date,
         )
 
 
@@ -362,6 +399,13 @@ def _update_cfg_from_vcs(cfg: config.Config, fetch: bool) -> config.Config:
 @click.option("-p", "--patch", is_flag=True, default=False, help="Increment patch component.")
 @click.option("-r", "--release-num", is_flag=True, default=False, help="Increment release number.")
 @click.option("--pin-date", is_flag=True, default=False, help="Leave date components unchanged.")
+@click.option(
+    "-d",
+    "--date",
+    default=None,
+    metavar="<date>",
+    help=f"Set explicit date in format YYYY-0M-0D (eg. {_current_date}).",
+)
 def bump(
     release    : typ.Optional[str] = None,
     verbose    : int = 0,
@@ -373,13 +417,14 @@ def bump(
     patch      : bool = False,
     release_num: bool = False,
     pin_date   : bool = False,
+    date       : typ.Optional[str] = None,
 ) -> None:
     """Increment the current version string and update project files."""
     verbose = max(_VERBOSE, verbose)
     _configure_logging(verbose)
 
-    if release:
     _validate_release_tag(release)
+    _date = _validate_date(date, pin_date)
 
     _, cfg = config.init(project_path=".")
 
@@ -399,6 +444,7 @@ def bump(
         patch=patch,
         release_num=release_num,
         pin_date=pin_date,
+        date=_date,
     )
 
     if new_version is None:

src/pycalver/v1version.py

@@ -380,6 +380,7 @@ def incr(
     patch      : bool = False,
     release_num: bool = False,
     pin_date   : bool = False,
+    date       : typ.Optional[dt.date] = None,
 ) -> typ.Optional[str]:
     """Increment version string.
 
@@ -391,7 +392,7 @@ def incr(
         logger.error(str(ex))
         return None
 
-    cur_cinfo = _ver_to_cal_info(old_vinfo) if pin_date else cal_info()
+    cur_cinfo = _ver_to_cal_info(old_vinfo) if pin_date else cal_info(date)
 
     if _is_cal_gt(old_vinfo, cur_cinfo):
         logger.warning(f"Old version appears to be from the future '{old_version}'")

src/pycalver/v2version.py

@@ -585,6 +585,7 @@ def incr(
     patch      : bool = False,
     release_num: bool = False,
     pin_date   : bool = False,
+    date       : typ.Optional[dt.date] = None,
 ) -> typ.Optional[str]:
     """Increment version string.
 
@@ -596,7 +597,7 @@ def incr(
         logger.error(str(ex))
         return None
 
-    cur_cinfo = _ver_to_cal_info(old_vinfo) if pin_date else cal_info()
+    cur_cinfo = _ver_to_cal_info(old_vinfo) if pin_date else cal_info(date)
 
     if _is_cal_gt(old_vinfo, cur_cinfo):
         logger.warning(f"Old version appears to be from the future '{old_version}'")

test/test_patterns.py

@@ -11,8 +11,6 @@ import pytest
 from pycalver import v1patterns
 from pycalver import v2patterns
 
-# TODO (mb 2020-09-06): test for v2patterns
-
 V2_PART_PATTERN_CASES = [
     (['YYYY', 'GGGG'], "2020" , "2020"),
     (['YYYY', 'GGGG'], ""     , None),