repurpose release_number to version to make it more useful

Author: tech3371

imap_data_access/cli.py

@@ -354,7 +354,7 @@ def _release_parser(args: argparse.Namespace):
         release_type=args.release_type,
         start_date=args.start_date,
         end_date=args.end_date,
-        release_number=getattr(args, "release_number", None),
+        release_version=args.version,
         table=getattr(args, "table", None),
         descriptor=getattr(args, "descriptor", None),
     )
@@ -726,11 +726,15 @@ def main():
         choices=[e.value for e in ReleaseType],
     )
     parser_release.add_argument(
-        "--release-number",
-        type=int,
+        "--version",
+        type=str,
         required=False,
-        metavar="NUMBER",
-        help="Release number (required only when --release-type is 'release'). ",
+        default="latest",
+        metavar="str",
+        help=(
+            "Data version on which the release operation will be applied. "
+            "E.g., 'v001.000' or 'latest' (default)"
+        ),
     )
     parser_release.add_argument(
         "--table",

imap_data_access/io.py

@@ -538,7 +538,7 @@ def release(
     release_type: str,
     start_date: str,
     end_date: str,
-    release_number: Optional[int] = None,
+    release_version: str = "latest",
     table: Optional[str] = None,
     descriptor: Optional[str] = None,
 ) -> None:
@@ -554,9 +554,10 @@ def release(
         Start date in YYYYMMDD format
     end_date : str
         End date in YYYYMMDD format
-    release_number : int, optional
-        Release number. Defaults to ``None``. Required if release_type is
-        'release' and should be an integer value
+    release_version : str, optional
+        Data version on which the release operation will be applied. For example,
+        release type 'release' will mark version 'v001.000' or 'latest' (default)
+        as released.
     table : str, optional
         Table for the release (``ancillary`` or ``science``). Optional.
     descriptor : str, optional
@@ -590,12 +591,6 @@ def release(
             f"Not a valid release type, please choose from {valid_release_types}"
         )
 
-    # Validate release_type == "release" requires release_number
-    if release_type == ReleaseType.RELEASE.value and release_number is None:
-        raise ValueError(
-            "The 'release_number' parameter is required for 'release' release type."
-        )
-
     # Validate start_date
     if not file_validation.ImapFilePath.is_valid_date(start_date):
         raise ValueError("Not a valid start date, use format 'YYYYMMDD'.")
@@ -618,9 +613,7 @@ def release(
         "start_date": start_date,
         "end_date": end_date,
     }
-    # Add release_number only if release_type is 'release'
-    if release_type == ReleaseType.RELEASE.value:
-        release_params["release_number"] = release_number
+    release_params["release_version"] = release_version
 
     # Add optional parameters if provided
     if table is not None: