From b7ff8f89cea055e75881e716d8358ffa4d7779af Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Mon, 27 Sep 2021 11:09:51 +0300
Subject: Add support for soft and hard rebuilds

---
 mod/module.cli | 90 ++++++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 66 insertions(+), 24 deletions(-)

(limited to 'mod/module.cli')

diff --git a/mod/module.cli b/mod/module.cli
index c95c20c..c2dce5b 100644
--- a/mod/module.cli
+++ b/mod/module.cli
@@ -195,45 +195,87 @@ namespace brep
          be specified in seconds. Default is 10 minutes."
       }
 
-      size_t build-normal-rebuild-timeout = 86400
+      size_t build-soft-rebuild-timeout = 86400
       {
         "<seconds>",
-        "Time to wait before considering a package for a normal rebuild. Must
-         be specified in seconds. Default is 24 hours."
+        "Time to wait before considering a package for a soft rebuild (only to
+         be performed if the build environment or any of the package
+         dependencies have changed). Must be specified in seconds. The special
+         zero value disables soft rebuilds. Default is 24 hours"
       }
 
-      size_t build-alt-rebuild-timeout
+      size_t build-alt-soft-rebuild-timeout
       {
         "<seconds>",
-        "Alternative package rebuild timeout to use instead of the normal
-         rebuild timeout (see \cb{build-normal-rebuild-timeout} for details)
+        "Alternative package soft rebuild timeout to use instead of the soft
+         rebuild timeout (see \cb{build-soft-rebuild-timeout} for details)
          during the time interval specified with the
-         \cb{build-alt-rebuild-start} and \cb{build-alt-rebuild-stop} options.
-         Must be specified in seconds. Default is the time interval length."
+         \cb{build-alt-soft-rebuild-start} and
+         \cb{build-alt-soft-rebuild-stop} options. Must be specified in
+         seconds. Default is the time interval length plus
+         \c{(\b{build-soft-rebuild-timeout} - 24h)} if soft rebuild timeout is
+         greater than 24 hours (thus the rebuild is only triggered within the
+         last 24 hours of the \cb{build-soft-rebuild-timeout} expiration)."
       }
 
-      duration build-alt-rebuild-start
+      duration build-alt-soft-rebuild-start
       {
         "<hours>:<minutes>",
-        "The start time of the alternative package rebuild timeout (see
-         \cb{build-alt-rebuild-timeout} for details). Must be specified as
-         a time of day in the local timezone. The \cb{build-alt-rebuild-start}
-         and \cb{build-alt-rebuild-stop} options must be either both specified
-         or absent. If unspecified, then no alternative rebuild timeout will
-         be used."
+        "The start time of the alternative package soft rebuild timeout (see
+         \cb{build-alt-soft-rebuild-timeout} for details). Must be specified
+         as a time of day in the local timezone. The
+         \cb{build-alt-soft-rebuild-start} and
+         \cb{build-alt-soft-rebuild-stop} options must be either both
+         specified or absent. If unspecified, then no alternative rebuild
+         timeout will be used."
       }
 
-      duration build-alt-rebuild-stop
+      duration build-alt-soft-rebuild-stop
       {
         "<hours>:<minutes>",
-        "The end time of the alternative package rebuild timeout (see
-         \cb{build-alt-rebuild-timeout} for details). Must be specified as
-         a time of day in the local timezone. If it is less than the
-         \cb{build-alt-rebuild-start} option value, then the time interval
-         extends through midnight. The \cb{build-alt-rebuild-start} and
-         \cb{build-alt-rebuild-stop} options must be either both specified or
-         absent. If unspecified, then no alternative rebuild timeout will be
-         used."
+        "The end time of the alternative package soft rebuild timeout (see
+         \cb{build-alt-soft-rebuild-timeout} for details). Must be specified
+         as a time of day in the local timezone. If it is less than the
+         \cb{build-alt-soft-rebuild-start} option value, then the time
+         interval extends through midnight. The
+         \cb{build-alt-soft-rebuild-start} and
+         \cb{build-alt-soft-rebuild-stop} options must be either both
+         specified or absent. If unspecified, then no alternative rebuild
+         timeout will be used."
+      }
+
+      size_t build-hard-rebuild-timeout = 604800
+      {
+        "<seconds>",
+        "Time to wait before considering a package for a hard rebuild (to be
+         performed unconditionally). Must be specified in seconds. The special
+         zero value disables hard rebuilds. Default is 7 days."
+      }
+
+      size_t build-alt-hard-rebuild-timeout
+      {
+        "<seconds>",
+        "Alternative package hard rebuild timeout. The semantics is the
+         same as for the \cb{build-alt-soft-rebuild-timeout} option but
+         for the \cb{build-hard-rebuild-timeout} option."
+      }
+
+      duration build-alt-hard-rebuild-start
+      {
+        "<hours>:<minutes>",
+        "The start time of the alternative package hard rebuild timeout (see
+         \cb{build-alt-hard-rebuild-timeout} for details). The semantics is
+         the same as for the \cb{build-alt-soft-rebuild-start} option but
+         for the \cb{build-hard-rebuild-timeout} option."
+      }
+
+      duration build-alt-hard-rebuild-stop
+      {
+        "<hours>:<minutes>",
+        "The end time of the alternative package hard rebuild timeout (see
+         \cb{build-alt-hard-rebuild-timeout} for details). The semantics is
+         the same as for the \cb{build-alt-soft-rebuild-stop} option but
+         for the \cb{build-hard-rebuild-timeout} option."
       }
     };
 
-- 
cgit v1.1