chore: support python and nodejs in clock::now()

Author: Chemaclass

src/clock.sh

@@ -2,8 +2,10 @@
 
 function clock::now() {
   local shell_time
+  local attempts=()
 
   # 1. Try using native shell EPOCHREALTIME (if available)
+  attempts+=("EPOCHREALTIME")
   if shell_time="$(clock::shell_time)"; then
     local seconds="${shell_time%%.*}"
     local microseconds="${shell_time#*.}"
@@ -12,11 +14,28 @@ function clock::now() {
   fi
 
   # 2. Try Perl with Time::HiRes
+  attempts+=("Perl")
   if dependencies::has_perl && perl -MTime::HiRes -e "" &>/dev/null; then
     perl -MTime::HiRes -e 'printf("%.0f\n", Time::HiRes::time() * 1000000000)' && return 0
   fi
 
-  # 3. Windows fallback with PowerShell
+  # 3. Try Python 3 with time module
+  attempts+=("Python")
+  if dependencies::has_python; then
+    python - <<'EOF'
+import time, sys
+sys.stdout.write(str(int(time.time() * 1_000_000_000)))
+EOF
+    return 0
+  fi
+
+  # 4. Try Node.js
+  attempts+=("Node")
+  if dependencies::has_node; then
+    node -e 'process.stdout.write((BigInt(Date.now()) * 1000000n).toString())' && return 0
+  fi
+  # 5. Windows fallback with PowerShell
+  attempts+=("PowerShell")
   if check_os::is_windows && dependencies::has_powershell; then
     powershell -Command "
       \$unixEpoch = [DateTime]'1970-01-01 00:00:00';
@@ -27,7 +46,8 @@ function clock::now() {
     " && return 0
   fi
 
-  # 4. Unix fallback using `date +%s%N` (if not macOS or Alpine)
+  # 6. Unix fallback using `date +%s%N` (if not macOS or Alpine)
+  attempts+=("date")
   if ! check_os::is_macos && ! check_os::is_alpine; then
     local result
     result=$(date +%s%N 2>/dev/null)
@@ -37,7 +57,8 @@ function clock::now() {
     fi
   fi
 
-  # 5. All methods failed
+  # 7. All methods failed
+  printf "clock::now implementations tried: %s\n" "${attempts[*]}" >&2
   echo ""
   return 1
 }

src/dependencies.sh

@@ -32,3 +32,11 @@ function dependencies::has_curl() {
 function dependencies::has_wget() {
   command -v wget >/dev/null 2>&1
 }
+
+function dependencies::has_python() {
+  command -v python >/dev/null 2>&1
+}
+
+function dependencies::has_node() {
+  command -v node >/dev/null 2>&1
+}

tests/unit/clock_test.sh

@@ -17,6 +17,8 @@ function mock_non_existing_fn() {
 function test_now_with_perl() {
   mock clock::shell_time mock_non_existing_fn
   mock perl echo "1720705883457"
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1720705883457" "$(clock::now)"
 }
@@ -26,6 +28,8 @@ function test_now_on_linux_unknown() {
   mock clock::shell_time mock_non_existing_fn
   mock perl mock_non_existing_fn
   mock date echo "1720705883457"
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1720705883457" "$(clock::now)"
 }
@@ -34,6 +38,8 @@ function test_now_on_linux_alpine() {
   mock_alpine_os
   mock clock::shell_time mock_non_existing_fn
   mock perl echo "1720705883457"
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1720705883457" "$(clock::now)"
 }
@@ -44,6 +50,8 @@ function test_now_on_windows_without_with_powershell() {
   mock dependencies::has_powershell mock_true
   mock powershell echo "1727768183281580800"
   mock clock::shell_time mock_non_existing_fn
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1727768183281580800" "$(clock::now)"
 }
@@ -54,6 +62,8 @@ function test_now_on_windows_without_without_powershell() {
   mock dependencies::has_powershell mock_false
   mock date echo "1727768951"
   mock clock::shell_time mock_non_existing_fn
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1727768951" "$(clock::now)"
 }
@@ -67,12 +77,16 @@ function test_now_on_osx_without_perl() {
   mock_macos
   mock dependencies::has_perl mock_false
   mock clock::shell_time echo "1727708708.326957"
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_same "1727708708326957000" "$(clock::now)"
 }
 
 function test_runtime_in_milliseconds_when_not_empty_time() {
   mock perl echo "1720705883457"
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_not_empty "$(clock::total_runtime_in_milliseconds)"
 }
@@ -81,6 +95,8 @@ function test_runtime_in_milliseconds_when_empty_time() {
   mock_macos
   mock perl mock_non_existing_fn
   mock clock::shell_time mock_non_existing_fn
+  mock dependencies::has_python mock_false
+  mock dependencies::has_node mock_false
 
   assert_empty "$(clock::total_runtime_in_milliseconds)"
 }

tests/unit/dependencies_test.sh

@@ -35,3 +35,17 @@ function test_has_git() {
 
   assert_have_been_called_with "-v git" command
 }
+
+function test_has_python() {
+  spy command
+  dependencies::has_python
+
+  assert_have_been_called_with "-v python" command
+}
+
+function test_has_node() {
+  spy command
+  dependencies::has_node
+
+  assert_have_been_called_with "-v node" command
+}