provide run_at_most_every function

diff --git a/.zsh/util b/.zsh/util
index 422dba954987362ffc25837f6cdd024e62e6752a..9b865362716ae16afd785e56e8ef91bc55bbbbc4 100644 (file)
--- a/.zsh/util
+++ b/.zsh/util
@@ -30,4 +30,24 @@ array_append() {
 
 function trace() { ( eval "set -x; $@"; ) }
 
+function run_at_most_every() {
+  local timespec=
+  case "$1" in
+    ((#b)([0-9]##)([smhd])) timespec="${match[2]}-${match[1]}";;
+    (*)
+      zerror "missing timespec: $@"
+      return
+  esac
+  shift
+
+  local sentinel_dir="${XDG_RUNTIME_DIR:-${TMPDIR:-/tmp}}/run_at_most_once_per"
+  mkdir --parent "${sentinel_dir}"
+  local sentinel="${sentinel_dir}/${*//[^[:alnum:]]##/_}_${timespec}"
+  if test -z ${sentinel}(#qNm${timespec}); then
+    touch "${sentinel}"
+    $@
+    return $?
+  fi
+}
+
 # vim:ft=zsh