1 files changed, 321 insertions, 0 deletions
diff --git a/tests/test-chime-timestamp-parse.el b/tests/test-chime-timestamp-parse.el
new file mode 100644
index 0000000..c97806b
--- /dev/null
+++ b/tests/test-chime-timestamp-parse.el
@@ -0,0 +1,321 @@
+;;; test-chime-timestamp-parse.el --- Tests for chime--timestamp-parse -*- lexical-binding: t; -*-
+
+;; Copyright (C) 2024 Craig Jennings
+
+;; Author: Craig Jennings <c@cjennings.net>
+
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; Unit tests for chime--timestamp-parse function.
+;; Tests cover normal cases, boundary cases, and error cases.
+
+;;; Code:
+
+;; Initialize package system for batch mode
+(when noninteractive
+  (package-initialize))
+
+(require 'ert)
+
+;; Load dependencies required by chime
+(require 'dash)
+(require 'alert)
+(require 'async)
+(require 'org-agenda)
+
+;; Load chime from parent directory
+(load (expand-file-name "../chime.el") nil t)
+
+;; Load test utilities
+(require 'testutil-general (expand-file-name "testutil-general.el"))
+
+;;; Setup and Teardown
+
+(defun test-chime-timestamp-parse-setup ()
+  "Setup function run before each test."
+  (chime-create-test-base-dir))
+
+(defun test-chime-timestamp-parse-teardown ()
+  "Teardown function run after each test."
+  (chime-delete-test-base-dir))
+
+;;; Normal Cases
+
+(ert-deftest test-chime-timestamp-parse-standard-timestamp-returns-time-list ()
+  "Test that a standard timestamp with time component returns a time list."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 14:30>")
+             (result (chime--timestamp-parse timestamp)))
+        ;; Should return a time list (list of integers)
+        (should (listp result))
+        (should (= (length result) 2))
+        (should (integerp (car result)))
+        (should (integerp (cadr result)))
+        ;; Result should not be nil
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-scheduled-timestamp-returns-time-list ()
+  "Test that a SCHEDULED timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 09:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-deadline-timestamp-returns-time-list ()
+  "Test that a DEADLINE timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 17:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-timestamp-with-weekly-repeater-returns-time-list ()
+  "Test that a timestamp with +1w repeater parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 14:00 +1w>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-timestamp-with-completion-repeater-returns-time-list ()
+  "Test that a timestamp with .+1d repeater parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 08:00 .+1d>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-timestamp-with-catchup-repeater-returns-time-list ()
+  "Test that a timestamp with ++1w repeater parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 10:30 ++1w>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-timestamp-with-time-range-returns-start-time ()
+  "Test that a timestamp with time range returns the start time."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 14:00-15:30>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-timestamp-with-date-range-returns-start-date ()
+  "Test that a timestamp with date range returns start date time."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 10:00>--<2025-10-25 Sat 10:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+;;; Boundary Cases
+
+(ert-deftest test-chime-timestamp-parse-midnight-timestamp-returns-time-list ()
+  "Test that midnight (00:00) timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 00:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-last-minute-of-day-returns-time-list ()
+  "Test that last minute of day (23:59) timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 23:59>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-year-boundary-new-years-eve-returns-time-list ()
+  "Test that New Year's Eve timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-12-31 Wed 23:30>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-year-boundary-new-years-day-returns-time-list ()
+  "Test that New Year's Day timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2026-01-01 Thu 00:30>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-single-digit-time-returns-time-list ()
+  "Test that single-digit hours and minutes parse correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 01:05>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-leap-year-feb-29-returns-time-list ()
+  "Test that Feb 29 in leap year parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2024-02-29 Thu 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-month-boundary-end-of-month-returns-time-list ()
+  "Test that end of month timestamp parses correctly."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-31 Fri 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (listp result))
+        (should (= (length result) 2))
+        (should result))
+    (test-chime-timestamp-parse-teardown)))
+
+;;; Error Cases
+
+(ert-deftest test-chime-timestamp-parse-empty-string-returns-nil ()
+  "Test that empty string returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-nil-input-returns-nil ()
+  "Test that nil input returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp nil)
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-missing-opening-bracket-returns-nil ()
+  "Test that timestamp missing opening bracket returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "2025-10-24 Fri 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-missing-closing-bracket-returns-nil ()
+  "Test that timestamp missing closing bracket returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 14:00")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-invalid-date-format-returns-nil ()
+  "Test that invalid date format returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<10-24-2025 Fri 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-invalid-month-returns-nil ()
+  "Test that invalid month value returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-13-24 Fri 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-invalid-day-returns-nil ()
+  "Test that invalid day value returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-32 Fri 14:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-invalid-time-hour-returns-nil ()
+  "Test that invalid hour value returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 25:00>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-invalid-time-minute-returns-nil ()
+  "Test that invalid minute value returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri 14:60>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(ert-deftest test-chime-timestamp-parse-date-only-no-time-returns-nil ()
+  "Test that day-wide timestamp without time returns nil."
+  (test-chime-timestamp-parse-setup)
+  (unwind-protect
+      (let* ((timestamp "<2025-10-24 Fri>")
+             (result (chime--timestamp-parse timestamp)))
+        (should (null result)))
+    (test-chime-timestamp-parse-teardown)))
+
+(provide 'test-chime-timestamp-parse)
+;;; test-chime-timestamp-parse.el ends here