comparing d7e8fd8410d50f87f1823eb3f00ad1142985d25e and main on ryan.freumh.org/caledonia

CHANGELOG.md

···

       1
       +
       

     

       2
       +
       ### 0.4.0

     

       3
       +
       

     

       4
       +
       - Emacs front end that communicates with a server mode via an S-expression protocol

     

       5
       +
       

     

       6
       +
       ### 0.3.1

     

       7
       +
       

     

       8
       +
       - various bugfixes and tweaks

     

       9
        
       

     

       10
        
       ### 0.3.0

     

       11

+43 -4

README.md

···

       1
       -
       # 📅 Caledonia 🏴󠁧󠁢󠁳󠁣󠁴󠁿

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       2
        
       

     

       3
       -
       Caledonia is a command-line calendar client.

     

       4
       -
       Currently, it operates on a [vdir](https://pimutils.org/specs/vdir/) directory of [`.ics`](https://datatracker.ietf.org/doc/html/rfc5545) files (as managed by tools like [vdirsyncer](https://github.com/pimutils/vdirsyncer)).

     

       5
       -
       It has the `list`, `search`, `show`, `add`, `delete`, and `edit` subcommands, and supports timezones.

     

       6
        
       See [TODO](./TODO.org) for future plans.

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       7
        
       

     

       8
        
       ## Configuration

     

       9

···

       1
       +
       # Caledonia

     

       2
       +
       

     

       3
       +
       Caledonia is a calendar client with command-line and Emacs front-ends.

     

       4
       +
       It operates on a [vdir](https://pimutils.org/specs/vdir/) directory of [`.ics`](https://datatracker.ietf.org/doc/html/rfc5545) files as managed by tools like [vdirsyncer](https://github.com/pimutils/vdirsyncer), which allows it to interact with CalDAV servers.

     

       5
       +
       

     

       6
       +
       The command-line has the `list`, `search`, `show`, `add`, `delete`, and `edit` subcommands, and has full timezone support.

     

       7
       +
       

     

       8
       +
       An example `list` invocation is,

     

       9
       +
       

     

       10
       +
       ```

     

       11
       +
       $ caled list

     

       12
       +
       personal   2025-04-04 Fri 13:00 - 14:00 (America/New_York) New York 8am meeting      054bb346-b24f-49f4-80ab-fcb6040c19a7

     

       13
       +
       family     2025-04-06 Sun 21:00 - 22:00 (UTC)              Family chat @Video call   3B84B125-6EFC-4E1C-B35A-97EFCA61110E

     

       14
       +
       work       2025-04-09 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting            4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d

     

       15
       +
       personal   2025-04-10 Thu 11:00 - 12:00 (UTC)              Dentist                   ccef66cd4d1e87ae7319097f027f8322de67f758

     

       16
       +
       family     2025-04-13 Sun 21:00 - 22:00 (UTC)              Family chat @Video call   3B84B125-6EFC-4E1C-B35A-97EFCA61110E

     

       17
       +
       personal   2025-04-15 Tue - 2025-04-17 Thu                 John Doe in town          33cf18ec-90d3-40f8-8335-f338fbdb395b

     

       18
       +
       personal   2025-04-15 Tue 21:00 - 21:30 (UTC)              Grandma call              8601c255-65fc-4bc9-baa9-465dd7b4cd7d

     

       19
       +
       work       2025-04-16 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting            4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d

     

       20
       +
       personal   2025-04-19 Sat                                  Jane Doe's birthday       7hm4laoadevr1ene8o876f2576@google.com

     

       21
       +
       family     2025-04-20 Sun 21:00 - 22:00 (UTC)              Family chat @Video call   3B84B125-6EFC-4E1C-B35A-97EFCA61110E

     

       22
       +
       personal   2025-04-22 Tue 21:00 - 21:30 (UTC)              Grandma call              8601c255-65fc-4bc9-baa9-465dd7b4cd7d

     

       23
       +
       work       2025-04-23 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting            4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d

     

       24
       +
       family     2025-04-27 Sun 21:00 - 22:00 (UTC)              Family chat @Video call   3B84B125-6EFC-4E1C-B35A-97EFCA61110E

     

       25
       +
       personal   2025-04-29 Tue 21:00 - 21:30 (UTC)              Grandma call              8601c255-65fc-4bc9-baa9-465dd7b4cd7d

     

       26
       +
       work       2025-04-30 Wed 15:00 - 16:00 (Europe/London)    Weekly Meeting            4adcb98dfc1848601e38c2ea55edf71fab786c674d7b72d4c263053b23560a8d

     

       27
       +
       ```

     

       28
        
       

     

       29
       +
       The Emacs client is defined in [./emacs](./emacs) and communicates with `caled server` using a [S-expression](https://en.wikipedia.org/wiki/S-expression) based protocol.

     

       30
       +
       

     

       0
        
       
     

       31
        
       See [TODO](./TODO.org) for future plans.

     

       32
       +
       

     

       33
       +
       ## Installation

     

       34
       +
       

     

       35
       +
       With [opam](https://opam.ocaml.org/),

     

       36
       +
       

     

       37
       +
       ```

     

       38
       +
       $ opam install .

     

       39
       +
       ```

     

       40
       +
       

     

       41
       +
       With [Nix](https://nixos.org/),

     

       42
       +
       

     

       43
       +
       ```

     

       44
       +
       $ nix shell 'git+https://tangled.sh/@ryan.freumh.org/caledonia?ref=main'

     

       45
       +
       ```

     

       46
        
       

     

       47
        
       ## Configuration

     

       48

+33 -28

TODO.org

···

       1
       -
       - [x] list/search events

     

       2
       -
       - [x] add/remove events

     

       3
       -
       - [x] edit events

     

       4
       -
       - [x] timezones

     

       5
       -
       - [x] remove collection module

     

       6
       -
         - ref [[https://github.com/ocaml-ppx/ppxlib/issues/481]] cc patrick

     

       7
       -
       - [ ] allow editting recurrence-ids

     

       8
       -
       - [ ] really stress test the timezone handling -- this is full of gotcha's

     

       9
       -
       - [ ] don't load all calendars into memory to show only one event

     

       10
       -
       - [ ] support specifying duration

     

       11
       -
       - [ ] diagnose events failing to parse

     

       12
       -
         - [[https://github.com/robur-coop/icalendar/issues/14]]

     

       13
       -
       - [ ] [[https://github.com/robur-coop/icalendar/pull/13][handle RECURRENCE-ID]]

     

       14
       -
       - [ ] [[https://github.com/robur-coop/icalendar/issues/15][RRULE with local datetime]]

     

       15
       -
       - [ ] CalDAV syncing

     

       16
       -
         - Currently, you can use [[https://github.com/pimutils/vdirsyncer][vdirsyncer]]

     

       17
       -
       - [ ] support querying times as well as dates

     

       18
       -
       - [ ] custom date/time formatting

     

       19
       -
       - [ ] support querying regex

     

       20
       -
       - [ ] support VTIMEZONE

     

       21
       -
       - [ ] support VALARMS

     

       22
       -
       - [ ] support VOTODS

     

       23
       -
       - [ ] support VCARDS

     

       24
       -
       - [ ] server mode

     

       25
       -
         - and maybe hold =Event='s in-memory instead of parsing them for every =Query=

     

       26
       -
       - [ ] implement TUI front end with something like [[https://github.com/leostera/minttea][minttea]]

     

       27
       -
       - [ ] implement an emacs client like mu4e

     

       28
       -
       - [ ] parallel queries

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       1
       +
       * DONE list/search events

     

       2
       +
       * DONE add/remove events

     

       3
       +
       * DONE edit events

     

       4
       +
       * DONE timezones

     

       5
       +
       * DONE diagnose events failing to parse [[https://github.com/robur-coop/icalendar/issues/14]]

     

       6
       +
       * DONE [[https://github.com/robur-coop/icalendar/pull/13][handle RECURRENCE-ID]]

     

       7
       +
       * DONE [[https://github.com/robur-coop/icalendar/issues/15][RRULE with local datetime]]

     

       8
       +
       * DONE server mode

     

       9
       +
       * DONE hold =Event='s in-memory instead of parsing them for every =Query=

     

       10
       +
       * TODO support vdir metadata

     

       11
       +
       * TODO add timezone all date functions

     

       12
       +
       * TODO allow editing recurrence-ids

     

       13
       +
       * TODO support specifying duration

     

       14
       +
       * TODO CalDAV syncing

     

       15
       +
       * TODO support complex datetime queries

     

       16
       +
       * TODO custom date/time formatting

     

       17
       +
       * TODO support querying text with regex

     

       18
       +
       * TODO support VTIMEZONE

     

       19
       +
       * TODO support VALARMS

     

       20
       +
       * TODO support VOTODS

     

       21
       +
       * TODO support VCARDS

     

       22
       +
       * TODO support VJOURNAL

     

       23
       +
       * TODO implement TUI front end with something like [[https://github.com/leostera/minttea][minttea]]

     

       24
       +
       * TODO implement an emacs front end, like mu4e to mu

     

       25
       +
       ** DONE listing, searching, querying

     

       26
       +
       ** DONE show details

     

       27
       +
       ** DONE show file

     

       28
       +
       ** DONE refresh

     

       29
       +
       ** DONE list possible calendars

     

       30
       +
       ** DONE add functions and bindings to change query parameters on the fly

     

       31
       +
       ** TODO timezone support

     

       32
       +
       ** TODO support adding, deleting, and editing events

     

       33
       +
       ** TODO add a org-agenda style view for caledonia-list

+52 -64

bin/add_cmd.ml

···

       12
        
           | Some s -> Ok s

     

       13
        
           | None -> Error (`Msg "Start date required")

     

       14
        
         in

     

       15
       -
         let* end_ = parse_end ~end_date ~end_time ~timezone ~end_timezone in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       16
        
         let* recurrence =

     

       17
        
           match recur with

     

       18
        
           | Some r ->

     
···

       21
        
           | None -> Ok None

     

       22
        
         in

     

       23
        
         let calendar_name = calendar_name in

     

       24
       -
         let event =

     

       25
        
           Event.create ~fs

     

       26
        
             ~calendar_dir_path:(Calendar_dir.get_path calendar_dir)

     

       27
        
             ~summary ~start ?end_ ?location ?description ?recurrence calendar_name

     

       28
        
         in

     

       29
       -
         let* _ = Calendar_dir.add_event ~fs calendar_dir event in

     

       0
        
       
     

       30
        
         Printf.printf "Event created with ID: %s\n" (Event.get_id event);

     

       31
        
         Ok ()

     

       32
        
       

     

       33
        
       let cmd ~fs calendar_dir =

     

       34
        
         let run summary start_date start_time end_date end_time location description

     

       35
       -
             recur calendar_name timezone end_timezone =

     

       36
        
           match

     

       37
        
             run ~summary ~start_date ~start_time ~end_date ~end_time ~location

     

       38
        
               ~description ~recur ~calendar_name ?timezone ?end_timezone ~fs

     
···

       47
        
           Term.(

     

       48
        
             const run $ required_summary_arg $ start_date_arg $ start_time_arg

     

       49
        
             $ end_date_arg $ end_time_arg $ location_arg $ description_arg $ recur_arg

     

       50
       -
             $ calendar_name_arg $ timezone_arg $ end_time_arg)

     

       51
        
         in

     

       52
        
         let doc = "Add a new calendar event" in

     

       53
        
         let man =

     
···

       57
        
             `P

     

       58
        
               "Specify the event summary (title) as the first argument, and use \

     

       59
        
                options to set other details.";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       60
        
             `S Manpage.s_options;

     

       61
        
           ]

     

       62
       -
           @ date_format_manpage_entries

     

       63
       -
           @ [

     

       64
       -
               `S Manpage.s_examples;

     

       65
       -
               `I

     

       66
       -
                 ( "Add a event for today:",

     

       67
       -
                   "caled add \"Meeting\" --date today --time 14:00" );

     

       68
       -
               `I

     

       69
       -
                 ( "Add an event with a specific date and time:",

     

       70
       -
                   "caled add \"Dentist Appointment\" --date 2025-04-15 --time 10:30"

     

       71
       -
                 );

     

       72
       -
               `I

     

       73
       -
                 ( "Add an event with an end time:",

     

       74
       -
                   "caled add \"Conference\" --date 2025-05-20 --time 09:00 \

     

       75
       -
                    --end-date 2025-05-22 --end-time 17:00" );

     

       76
       -
               `I

     

       77
       -
                 ( "Add an event with location and description:",

     

       78
       -
                   "caled add \"Lunch with Bob\" --date 2025-04-02 --time 12:30 \

     

       79
       -
                    --location \"Pasta Restaurant\" --description \"Discuss project \

     

       80
       -
                    plans\"" );

     

       81
       -
               `I

     

       82
       -
                 ( "Add an event to a specific calendar:",

     

       83
       -
                   "caled add \"Work Meeting\" --date 2025-04-03 --time 15:00 \

     

       84
       -
                    --calendar work" );

     

       85
       -
               `S "RECURRENCE";

     

       86
       -
               `P

     

       87
       -
                 "Recurrence rule in iCalendar RFC5545 format. The FREQ part is \

     

       88
       -
                  required.";

     

       89
       -
               `I ("FREQ=<frequency>", "DAILY, WEEKLY, MONTHLY, or YEARLY (required)");

     

       90
       -
               `I

     

       91
       -
                 ( "COUNT=<number>",

     

       92
       -
                   "Limit to this many occurrences (optional, cannot be used with \

     

       93
       -
                    UNTIL)" );

     

       94
       -
               `I

     

       95
       -
                 ( "UNTIL=<date>",

     

       96
       -
                   "Repeat until this date (optional, cannot be used with COUNT)" );

     

       97
       -
               `I

     

       98
       -
                 ( "INTERVAL=<number>",

     

       99
       -
                   "Interval between occurrences, e.g., 2 for every other (optional)"

     

       100
       -
                 );

     

       101
       -
               `I

     

       102
       -
                 ( "BYDAY=<dayspec>",

     

       103
       -
                   "Specific days, e.g., MO,WE,FR or 1MO (first Monday) (optional)" );

     

       104
       -
               `I

     

       105
       -
                 ( "BYMONTHDAY=<daynum>",

     

       106
       -
                   "Day of month, e.g., 1,15 or -1 (last day) (optional)" );

     

       107
       -
               `I

     

       108
       -
                 ( "BYMONTH=<monthnum>",

     

       109
       -
                   "Month number, e.g., 1,6,12 for Jan,Jun,Dec (optional)" );

     

       110
       -
               `P "Examples:";

     

       111
       -
               `I ("FREQ=DAILY;COUNT=5", "Daily for 5 occurrences");

     

       112
       -
               `I ("FREQ=WEEKLY;INTERVAL=2", "Every other week indefinitely");

     

       113
       -
               `I ("FREQ=WEEKLY;BYDAY=MO,WE,FR", "Every Monday, Wednesday, Friday");

     

       114
       -
               `I ("FREQ=MONTHLY;BYDAY=1MO", "First Monday of every month");

     

       115
       -
               `I

     

       116
       -
                 ( "FREQ=YEARLY;BYMONTH=1;BYMONTHDAY=1",

     

       117
       -
                   "Every January 1st (New Year's Day)" );

     

       118
       -
               `I ("FREQ=MONTHLY;BYMONTHDAY=-1", "Last day of every month");

     

       119
       -
             ]

     

       120
        
         in

     

       121
       -
         let info = Cmd.info "add" ~doc ~man in

     

       122
        
         Cmd.v info term

···

       12
        
           | Some s -> Ok s

     

       13
        
           | None -> Error (`Msg "Start date required")

     

       14
        
         in

     

       15
       +
         let* end_ =

     

       16
       +
           (* if we have an endtime and no end date default to start date *)

     

       17
       +
           let end_date =

     

       18
       +
             match (end_date, end_time) with

     

       19
       +
             | None, Some _ -> start_date

     

       20
       +
             | _ -> end_date

     

       21
       +
           in

     

       22
       +
           (* if we have a start date and no end date default to start date *)

     

       23
       +
           let end_date =

     

       24
       +
             match (start_date, end_date) with

     

       25
       +
             | Some _, None -> start_date

     

       26
       +
             | _ -> end_date

     

       27
       +
           in

     

       28
       +
           let end_timezone =

     

       29
       +
             (* if we specify and end date and time without a end timezone, default to the start timezone *)

     

       30
       +
             match (end_date, end_time, end_timezone) with

     

       31
       +
             | Some _, Some _, None -> timezone

     

       32
       +
             | _ -> end_timezone

     

       33
       +
           in

     

       34
       +
           parse_end ~end_date ~end_time ~end_timezone

     

       35
       +
         in

     

       36
        
         let* recurrence =

     

       37
        
           match recur with

     

       38
        
           | Some r ->

     
···

       41
        
           | None -> Ok None

     

       42
        
         in

     

       43
        
         let calendar_name = calendar_name in

     

       44
       +
         let* event =

     

       45
        
           Event.create ~fs

     

       46
        
             ~calendar_dir_path:(Calendar_dir.get_path calendar_dir)

     

       47
        
             ~summary ~start ?end_ ?location ?description ?recurrence calendar_name

     

       48
        
         in

     

       49
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       50
       +
         let* _ = Calendar_dir.add_event ~fs calendar_dir events event in

     

       51
        
         Printf.printf "Event created with ID: %s\n" (Event.get_id event);

     

       52
        
         Ok ()

     

       53
        
       

     

       54
        
       let cmd ~fs calendar_dir =

     

       55
        
         let run summary start_date start_time end_date end_time location description

     

       56
       +
             recur calendar_name timezone end_timezone () =

     

       57
        
           match

     

       58
        
             run ~summary ~start_date ~start_time ~end_date ~end_time ~location

     

       59
        
               ~description ~recur ~calendar_name ?timezone ?end_timezone ~fs

     
···

       68
        
           Term.(

     

       69
        
             const run $ required_summary_arg $ start_date_arg $ start_time_arg

     

       70
        
             $ end_date_arg $ end_time_arg $ location_arg $ description_arg $ recur_arg

     

       71
       +
             $ calendar_name_arg $ timezone_arg $ end_timezone_arg)

     

       72
        
         in

     

       73
        
         let doc = "Add a new calendar event" in

     

       74
        
         let man =

     
···

       78
        
             `P

     

       79
        
               "Specify the event summary (title) as the first argument, and use \

     

       80
        
                options to set other details.";

     

       81
       +
             `S Manpage.s_examples;

     

       82
       +
             `I

     

       83
       +
               ( "Add a event for today:",

     

       84
       +
                 "caled add \"Meeting\" --date today --time 14:00" );

     

       85
       +
             `I

     

       86
       +
               ( "Add an event with a specific date and time:",

     

       87
       +
                 "caled add \"Dentist Appointment\" --date 2025-04-15 --time 10:30" );

     

       88
       +
             `I

     

       89
       +
               ( "Add an event with an end time:",

     

       90
       +
                 "caled add \"Conference\" --date 2025-05-20 --time 09:00 --end-date \

     

       91
       +
                  2025-05-22 --end-time 17:00" );

     

       92
       +
             `I

     

       93
       +
               ( "Add an event with location and description:",

     

       94
       +
                 "caled add \"Lunch with Bob\" --date 2025-04-02 --time 12:30 \

     

       95
       +
                  --location \"Pasta Restaurant\" --description \"Discuss project \

     

       96
       +
                  plans\"" );

     

       97
       +
             `I

     

       98
       +
               ( "Add an event to a specific calendar:",

     

       99
       +
                 "caled add \"Work Meeting\" --date 2025-04-03 --time 15:00 \

     

       100
       +
                  --calendar work" );

     

       101
        
             `S Manpage.s_options;

     

       102
        
           ]

     

       103
       +
           @ date_format_manpage_entries @ recurrence_format_manpage_entries

     

       104
       +
           @ [ `S Manpage.s_see_also ]

     

       105
       +
         in

     

       106
       +
         let exit_info =

     

       107
       +
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       108
        
         in

     

       109
       +
         let info = Cmd.info "add" ~doc ~man ~exits:exit_info in

     

       110
        
         Cmd.v info term

+13 -7

bin/delete_cmd.ml

···

       3
        
       

     

       4
        
       let run ~event_id ~fs calendar_dir =

     

       5
        
         let ( let* ) = Result.bind in

     

       6
       -
         let filter = Query.with_id event_id in

     

       7
       -
         let* results = Query.query_without_recurrence ~fs calendar_dir ~filter () in

     

       0
        
       
     

       8
        
         let* event =

     

       9
       -
           match results with

     

       10
        
           | [ event ] -> Ok event

     

       11
        
           | [] -> Error (`Msg ("No events found found for id " ^ event_id))

     

       12
        
           | _ -> Error (`Msg ("More than one found for id " ^ event_id))

     

       13
        
         in

     

       14
       -
         let result = Calendar_dir.delete_event ~fs calendar_dir event in

     

       15
        
         match result with

     

       16
        
         | Error (`Msg msg) -> Error (`Msg msg)

     

       17
       -
         | Ok () ->

     

       18
        
             Printf.printf "Event %s successfully deleted.\n" event_id;

     

       19
        
             Ok ()

     

       20
        
       

     
···

       23
        
         Arg.(required & pos 0 (some string) None & info [] ~docv:"EVENT_ID" ~doc)

     

       24
        
       

     

       25
        
       let cmd ~fs calendar_dir =

     

       26
       -
         let run event_id =

     

       27
        
           match run ~event_id ~fs calendar_dir with

     

       28
        
           | Error (`Msg msg) ->

     

       29
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       40
        
             `S Manpage.s_examples;

     

       41
        
             `P "Delete an event:";

     

       42
        
             `P "  caled delete 12345678-1234-5678-1234-567812345678";

     

       0
        
       
     

       43
        
           ]

     

       0
        
       
     

       44
        
         in

     

       45
       -
         let info = Cmd.info "delete" ~doc ~man in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       46
        
         Cmd.v info term

···

       3
        
       

     

       4
        
       let run ~event_id ~fs calendar_dir =

     

       5
        
         let ( let* ) = Result.bind in

     

       6
       +
         let filter = Event.with_id event_id in

     

       7
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       8
       +
         let events = Event.query_without_recurrence events ~filter () in

     

       9
        
         let* event =

     

       10
       +
           match events with

     

       11
        
           | [ event ] -> Ok event

     

       12
        
           | [] -> Error (`Msg ("No events found found for id " ^ event_id))

     

       13
        
           | _ -> Error (`Msg ("More than one found for id " ^ event_id))

     

       14
        
         in

     

       15
       +
         let result = Calendar_dir.delete_event ~fs calendar_dir events event in

     

       16
        
         match result with

     

       17
        
         | Error (`Msg msg) -> Error (`Msg msg)

     

       18
       +
         | Ok _ ->

     

       19
        
             Printf.printf "Event %s successfully deleted.\n" event_id;

     

       20
        
             Ok ()

     

       21
        
       

     
···

       24
        
         Arg.(required & pos 0 (some string) None & info [] ~docv:"EVENT_ID" ~doc)

     

       25
        
       

     

       26
        
       let cmd ~fs calendar_dir =

     

       27
       +
         let run event_id () =

     

       28
        
           match run ~event_id ~fs calendar_dir with

     

       29
        
           | Error (`Msg msg) ->

     

       30
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       41
        
             `S Manpage.s_examples;

     

       42
        
             `P "Delete an event:";

     

       43
        
             `P "  caled delete 12345678-1234-5678-1234-567812345678";

     

       44
       +
             `S Manpage.s_options;

     

       45
        
           ]

     

       46
       +
           @ [ `S Manpage.s_see_also ]

     

       47
        
         in

     

       48
       +
         let exit_info =

     

       49
       +
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

     

       50
       +
         in

     

       51
       +
         let info = Cmd.info "delete" ~doc ~man ~exits:exit_info in

     

       52
        
         Cmd.v info term

+5 -2

bin/dune

···

       14
        
         ptime.clock.os

     

       15
        
         eio

     

       16
        
         eio_main

     

       17
       -
         timere)

     

       0
        
       
     

       0
        
       
     

       18
        
        (modules

     

       19
        
         main

     

       20
        
         query_args

     
···

       24
        
         show_cmd

     

       25
        
         add_cmd

     

       26
        
         delete_cmd

     

       27
       -
         edit_cmd))

     

       0

···

       14
        
         ptime.clock.os

     

       15
        
         eio

     

       16
        
         eio_main

     

       17
       +
         timere

     

       18
       +
         sexplib

     

       19
       +
         sexplib.unix)

     

       20
        
        (modules

     

       21
        
         main

     

       22
        
         query_args

     
···

       26
        
         show_cmd

     

       27
        
         add_cmd

     

       28
        
         delete_cmd

     

       29
       +
         edit_cmd

     

       30
       +
         server_cmd))

+44 -27

bin/edit_cmd.ml

···

       5
        
       let run ~event_id ~summary ~start_date ~start_time ~end_date ~end_time ~location

     

       6
        
           ~description ~recur ?timezone ?end_timezone ~fs calendar_dir =

     

       7
        
         let ( let* ) = Result.bind in

     

       8
       -
         let filter = Query.with_id event_id in

     

       9
       -
         let* results = Query.query_without_recurrence ~fs calendar_dir ~filter () in

     

       0
        
       
     

       10
        
         let* event =

     

       11
        
           match results with

     

       12
        
           | [ event ] -> Ok event

     
···

       14
        
           | _ -> Error (`Msg ("More than one found for id " ^ event_id))

     

       15
        
         in

     

       16
        
         let* start = parse_start ~start_date ~start_time ~timezone in

     

       17
       -
         let* end_ = parse_end ~end_date ~end_time ~timezone ~end_timezone in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       18
        
         let* recurrence =

     

       19
        
           match recur with

     

       20
        
           | Some r ->

     
···

       22
        
               Ok (Some p)

     

       23
        
           | None -> Ok None

     

       24
        
         in

     

       25
       -
         let modifed_event =

     

       26
        
           Event.edit ?summary ?start ?end_ ?location ?description ?recurrence event

     

       27
        
         in

     

       28
       -
         let* _ = Calendar_dir.edit_event ~fs calendar_dir modifed_event in

     

       29
        
         Printf.printf "Event %s updated.\n" event_id;

     

       30
        
         Ok ()

     

       31
        
       

     
···

       35
        
       

     

       36
        
       let cmd ~fs calendar_dir =

     

       37
        
         let run event_id summary start_date start_time end_date end_time location

     

       38
       -
             description recur timezone end_timezone =

     

       39
        
           match

     

       40
        
             run ~event_id ~summary ~start_date ~start_time ~end_date ~end_time

     

       41
        
               ~location ~description ~recur ?timezone ?end_timezone ~fs calendar_dir

     
···

       59
        
             `P

     

       60
        
               "Specify the event ID as the first argument, and use options to change \

     

       61
        
                event details.";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       62
        
             `S Manpage.s_options;

     

       63
        
           ]

     

       64
       -
           @ date_format_manpage_entries

     

       65
       -
           @ [

     

       66
       -
               `S Manpage.s_examples;

     

       67
       -
               `I

     

       68
       -
                 ( "Change the summary of an event:",

     

       69
       -
                   "caled edit 12345678-1234-5678-1234-567812345678 --summary \"New \

     

       70
       -
                    Title\"" );

     

       71
       -
               `I

     

       72
       -
                 ( "Change the date and time:",

     

       73
       -
                   "caled edit 12345678-1234-5678-1234-567812345678 --date 2025-05-01 \

     

       74
       -
                    --time 15:30" );

     

       75
       -
               `I

     

       76
       -
                 ( "Update the location:",

     

       77
       -
                   "caled edit 12345678-1234-5678-1234-567812345678 --location \

     

       78
       -
                    \"Conference Room B\"" );

     

       79
       -
               `I

     

       80
       -
                 ( "Change the description:",

     

       81
       -
                   "caled edit 12345678-1234-5678-1234-567812345678 --description \

     

       82
       -
                    \"Updated agenda for the meeting\"" );

     

       83
       -
             ]

     

       84
        
         in

     

       85
       -
         let info = Cmd.info "edit" ~doc ~man in

     

       86
        
         Cmd.v info term

···

       5
        
       let run ~event_id ~summary ~start_date ~start_time ~end_date ~end_time ~location

     

       6
        
           ~description ~recur ?timezone ?end_timezone ~fs calendar_dir =

     

       7
        
         let ( let* ) = Result.bind in

     

       8
       +
         let filter = Event.with_id event_id in

     

       9
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       10
       +
         let results = Event.query_without_recurrence events ~filter () in

     

       11
        
         let* event =

     

       12
        
           match results with

     

       13
        
           | [ event ] -> Ok event

     
···

       15
        
           | _ -> Error (`Msg ("More than one found for id " ^ event_id))

     

       16
        
         in

     

       17
        
         let* start = parse_start ~start_date ~start_time ~timezone in

     

       18
       +
         let* end_ =

     

       19
       +
           let end_date =

     

       20
       +
             (* if we have an endtime and no end date default to start date *)

     

       21
       +
             match (end_date, end_time) with

     

       22
       +
             | None, Some _ -> start_date

     

       23
       +
             | _ -> end_date

     

       24
       +
           in

     

       25
       +
           let end_timezone =

     

       26
       +
             (* if we specify and end date and time without a end timezone, default to the start timezone *)

     

       27
       +
             match (end_date, end_time, end_timezone) with

     

       28
       +
             | Some _, Some _, None -> timezone

     

       29
       +
             | _ -> end_timezone

     

       30
       +
           in

     

       31
       +
           parse_end ~end_date ~end_time ~end_timezone

     

       32
       +
         in

     

       33
        
         let* recurrence =

     

       34
        
           match recur with

     

       35
        
           | Some r ->

     
···

       37
        
               Ok (Some p)

     

       38
        
           | None -> Ok None

     

       39
        
         in

     

       40
       +
         let* modifed_event =

     

       41
        
           Event.edit ?summary ?start ?end_ ?location ?description ?recurrence event

     

       42
        
         in

     

       43
       +
         let* _ = Calendar_dir.edit_event ~fs calendar_dir events modifed_event in

     

       44
        
         Printf.printf "Event %s updated.\n" event_id;

     

       45
        
         Ok ()

     

       46
        
       

     
···

       50
        
       

     

       51
        
       let cmd ~fs calendar_dir =

     

       52
        
         let run event_id summary start_date start_time end_date end_time location

     

       53
       +
             description recur timezone end_timezone () =

     

       54
        
           match

     

       55
        
             run ~event_id ~summary ~start_date ~start_time ~end_date ~end_time

     

       56
        
               ~location ~description ~recur ?timezone ?end_timezone ~fs calendar_dir

     
···

       74
        
             `P

     

       75
        
               "Specify the event ID as the first argument, and use options to change \

     

       76
        
                event details.";

     

       77
       +
             `S Manpage.s_examples;

     

       78
       +
             `I

     

       79
       +
               ( "Change the summary of an event:",

     

       80
       +
                 "caled edit 12345678-1234-5678-1234-567812345678 --summary \"New \

     

       81
       +
                  Title\"" );

     

       82
       +
             `I

     

       83
       +
               ( "Change the date and time:",

     

       84
       +
                 "caled edit 12345678-1234-5678-1234-567812345678 --date 2025-05-01 \

     

       85
       +
                  --time 15:30" );

     

       86
       +
             `I

     

       87
       +
               ( "Update the location:",

     

       88
       +
                 "caled edit 12345678-1234-5678-1234-567812345678 --location \

     

       89
       +
                  \"Conference Room B\"" );

     

       90
       +
             `I

     

       91
       +
               ( "Change the description:",

     

       92
       +
                 "caled edit 12345678-1234-5678-1234-567812345678 --description \

     

       93
       +
                  \"Updated agenda for the meeting\"" );

     

       94
        
             `S Manpage.s_options;

     

       95
        
           ]

     

       96
       +
           @ date_format_manpage_entries @ recurrence_format_manpage_entries

     

       97
       +
           @ [ `S Manpage.s_see_also ]

     

       98
       +
         in

     

       99
       +
         let exit_info =

     

       100
       +
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       101
        
         in

     

       102
       +
         let info = Cmd.info "edit" ~doc ~man ~exits:exit_info in

     

       103
        
         Cmd.v info term

+124 -37

bin/event_args.ml

···

       28
        
         Arg.(value & opt (some string) None & info [ "time"; "t" ] ~docv:"TIME" ~doc)

     

       29
        
       

     

       30
        
       let end_date_arg =

     

       31
       -
         let doc = "Event end date (YYYY-MM-DD)" in

     

       32
        
         Arg.(

     

       33
        
           value

     

       34
        
           & opt (some string) None

     
···

       44
        
       let timezone_arg =

     

       45
        
         let doc =

     

       46
        
           "Timezone to add events to (e.g., 'America/New_York', 'UTC', \

     

       47
       -
            'Europe/London'). If not specified, will use the local timezone."

     

       0
        
       
     

       48
        
         in

     

       49
        
         Arg.(

     

       50
        
           value

     
···

       80
        
       let date_format_manpage_entries =

     

       81
        
         [

     

       82
        
           `S "DATE FORMATS";

     

       83
       -
           `P "Relative date formats for --date / -d and --end-date / -e:";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       84
        
           `I ("today", "Current day");

     

       85
        
           `I ("tomorrow", "Next day");

     

       86
        
           `I ("yesterday", "Previous day");

     

       87
       -
           `I ("this-week", "Start of current week");

     

       88
       -
           `I ("next-week", "Start of next week");

     

       89
       -
           `I ("this-month", "Start of current month");

     

       90
       -
           `I ("next-month", "Start of next month");

     

       91
        
           `I ("+Nd", "N days from today (e.g., +7d for a week from today)");

     

       92
        
           `I ("-Nd", "N days before today (e.g., -7d for a week ago)");

     

       93
        
           `I ("+Nw", "N weeks from today (e.g., +4w for 4 weeks from today)");

     
···

       96
        
       

     

       97
        
       let parse_start ~start_date ~start_time ~timezone =

     

       98
        
         let ( let* ) = Result.bind in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       99
        
         match start_date with

     

       100
        
         | None ->

     

       101
        
             let* _ =

     

       102
        
               match start_time with

     

       103
        
               | None -> Ok ()

     

       104
        
               | Some _ ->

     

       105
       -
                   Error (`Msg "Can't specify an start time without an end date")

     

       106
        
             in

     

       107
        
             let* _ =

     

       108
        
               match timezone with

     
···

       122
        
                   Date.parse_date ~tz:Timedesc.Time_zone.utc start_date `From

     

       123
        
                 in

     

       124
        
                 let date = Ptime.to_date ptime in

     

       125
       -
                 Ok (Some (`Date date))

     

       126
        
             | Some start_time -> (

     

       127
        
                 match timezone with

     

       128
        
                 | None ->

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       129
        
                     let* datetime =

     

       130
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       131
        
                         ~time:start_time `From

     

       132
        
                     in

     

       133
       -
                     Ok (Some (`Datetime (`Local datetime)))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       134
        
                 | Some "UTC" ->

     

       135
        
                     let* datetime =

     

       136
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       137
        
                         ~time:start_time `From

     

       138
        
                     in

     

       139
       -
                     Ok (Some (`Datetime (`Utc datetime)))

     

       140
        
                 | Some tzid ->

     

       141
       -
                     let* tz =

     

       142
       -
                       match Timedesc.Time_zone.make tzid with

     

       143
       -
                       | Some tz_obj -> Ok tz_obj

     

       144
       -
                       | None -> Error (`Msg ("Invalid timezone: " ^ tzid))

     

       145
       -
                     in

     

       146
        
                     let* datetime =

     

       147
       -
                       Date.parse_date_time ~tz ~date:start_date ~time:start_time `From

     

       0
        
       
     

       148
        
                     in

     

       149
       -
                     Ok (Some (`Datetime (`With_tzid (datetime, (false, tzid)))))))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       150
        
       

     

       151
       -
       let parse_end ~end_date ~end_time ~timezone ~end_timezone =

     

       152
        
         let ( let* ) = Result.bind in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       153
        
         match end_date with

     

       154
        
         | None ->

     

       155
        
             let* _ =

     
···

       160
        
             let* _ =

     

       161
        
               match end_timezone with

     

       162
        
               | None -> Ok ()

     

       163
       -
               | Some _ -> Error (`Msg "Can't specify a timezone without a end time")

     

       0
        
       
     

       164
        
             in

     

       165
        
             Ok None

     

       166
        
         | Some end_date -> (

     

       167
        
             match end_time with

     

       168
        
             | None ->

     

       169
        
                 let* _ =

     

       170
       -
                   match (timezone, end_timezone) with

     

       171
       -
                   | None, None -> Ok ()

     

       172
       -
                   | Some _, None ->

     

       173
       -
                       Error (`Msg "Can't specify a timezone without a end time")

     

       174
       -
                   | _ ->

     

       175
        
                       Error (`Msg "Can't specify an end timezone without a end time")

     

       0
        
       
     

       176
        
                 in

     

       177
        
                 let* ptime =

     

       178
        
                   Date.parse_date end_date ~tz:Timedesc.Time_zone.utc `From

     

       179
        
                 in

     

       0
        
       
     

       0
        
       
     

       180
        
                 let date = Ptime.to_date ptime in

     

       181
       -
                 Ok (Some (`Dtend (Icalendar.Params.empty, `Date date)))

     

       0
        
       
     

       0
        
       
     

       182
        
             | Some end_time -> (

     

       183
       -
                 match (timezone, end_timezone) with

     

       184
       -
                 | None, None ->

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       185
        
                     let* datetime =

     

       186
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       187
        
                         ~time:end_time `From

     
···

       189
        
                     Ok

     

       190
        
                       (Some

     

       191
        
                          (`Dtend (Icalendar.Params.empty, `Datetime (`Local datetime))))

     

       192
       -
                 | _, Some "UTC" | Some "UTC", None ->

     

       193
        
                     let* datetime =

     

       194
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       195
        
                         ~time:end_time `From

     
···

       197
        
                     Ok

     

       198
        
                       (Some

     

       199
        
                          (`Dtend (Icalendar.Params.empty, `Datetime (`Utc datetime))))

     

       200
       -
                 | _, Some tzid | Some tzid, _ ->

     

       201
       -
                     let* tz =

     

       202
       -
                       match Timedesc.Time_zone.make tzid with

     

       203
       -
                       | Some tz_obj -> Ok tz_obj

     

       204
       -
                       | None -> Error (`Msg ("Invalid timezone: " ^ tzid))

     

       205
       -
                     in

     

       206
        
                     let* datetime =

     

       207
       -
                       Date.parse_date_time ~tz ~date:end_date ~time:end_time `From

     

       0
        
       
     

       208
        
                     in

     

       209
       -
       

     

       210
        
                     Ok

     

       211
        
                       (Some

     

       212
        
                          (`Dtend

     
···

       345
        
             let recurrence = (f, limit, !interval, !by_parts) in

     

       346
        
             Ok recurrence

     

       347
        
         | None -> Error (`Msg "FREQ is required in recurrence rule")

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       28
        
         Arg.(value & opt (some string) None & info [ "time"; "t" ] ~docv:"TIME" ~doc)

     

       29
        
       

     

       30
        
       let end_date_arg =

     

       31
       +
         let doc = "Event end date (YYYY-MM-DD). Defaults to DATE." in

     

       32
        
         Arg.(

     

       33
        
           value

     

       34
        
           & opt (some string) None

     
···

       44
        
       let timezone_arg =

     

       45
        
         let doc =

     

       46
        
           "Timezone to add events to (e.g., 'America/New_York', 'UTC', \

     

       47
       +
            'Europe/London'). If not specified, will use the local timezone. For a \

     

       48
       +
            floating time (always at whatever the sytem time is), use 'FLOATING'."

     

       49
        
         in

     

       50
        
         Arg.(

     

       51
        
           value

     
···

       81
        
       let date_format_manpage_entries =

     

       82
        
         [

     

       83
        
           `S "DATE FORMATS";

     

       84
       +
           `P

     

       85
       +
             "The following are the possible date formats for the --date and \

     

       86
       +
              --end-date command line parameters. Note the value is dependent on \

     

       87
       +
              --date / --end-date, so --date 2025-03 --end-date 2025-03 will span the \

     

       88
       +
              month of March.";

     

       89
       +
           `I ("YYYY-MM-DD", "Specific date (e.g., 2025-3-27, zero-padding optional)");

     

       90
       +
           `I ("YYYY-MM", "Start/end of specific month (e.g., 2025-3 for March 2025)");

     

       91
       +
           `I ("YYYY", "Start/end of specific year (e.g., 2025)");

     

       92
        
           `I ("today", "Current day");

     

       93
        
           `I ("tomorrow", "Next day");

     

       94
        
           `I ("yesterday", "Previous day");

     

       95
       +
           `I ("this-week", "Start/end of current week");

     

       96
       +
           `I ("next-week", "Start/end of next week");

     

       97
       +
           `I ("this-month", "Start/end of current month");

     

       98
       +
           `I ("next-month", "Start/end of next month");

     

       99
        
           `I ("+Nd", "N days from today (e.g., +7d for a week from today)");

     

       100
        
           `I ("-Nd", "N days before today (e.g., -7d for a week ago)");

     

       101
        
           `I ("+Nw", "N weeks from today (e.g., +4w for 4 weeks from today)");

     
···

       104
        
       

     

       105
        
       let parse_start ~start_date ~start_time ~timezone =

     

       106
        
         let ( let* ) = Result.bind in

     

       107
       +
         let* _ =

     

       108
       +
           match timezone with

     

       109
       +
           | None -> Ok ()

     

       110
       +
           | Some tzid -> (

     

       111
       +
               match Timedesc.Time_zone.make tzid with

     

       112
       +
               | Some _ -> Ok ()

     

       113
       +
               | None ->

     

       114
       +
                   Error (`Msg (Printf.sprintf "Warning: Unknown timezone %s" tzid)))

     

       115
       +
         in

     

       116
        
         match start_date with

     

       117
        
         | None ->

     

       118
        
             let* _ =

     

       119
        
               match start_time with

     

       120
        
               | None -> Ok ()

     

       121
        
               | Some _ ->

     

       122
       +
                   Error (`Msg "Can't specify an start time without a start date")

     

       123
        
             in

     

       124
        
             let* _ =

     

       125
        
               match timezone with

     
···

       139
        
                   Date.parse_date ~tz:Timedesc.Time_zone.utc start_date `From

     

       140
        
                 in

     

       141
        
                 let date = Ptime.to_date ptime in

     

       142
       +
                 Ok (Some (Icalendar.Params.singleton Valuetype `Date, `Date date))

     

       143
        
             | Some start_time -> (

     

       144
        
                 match timezone with

     

       145
        
                 | None ->

     

       146
       +
                     let* tzid =

     

       147
       +
                       match Timedesc.Time_zone.local () with

     

       148
       +
                       | Some tz -> Ok (Timedesc.Time_zone.name tz)

     

       149
       +
                       | None -> Error (`Msg "Failed to get system timezone")

     

       150
       +
                     in

     

       151
        
                     let* datetime =

     

       152
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       153
        
                         ~time:start_time `From

     

       154
        
                     in

     

       155
       +
                     Ok

     

       156
       +
                       (Some

     

       157
       +
                          ( Icalendar.Params.empty,

     

       158
       +
                            `Datetime (`With_tzid (datetime, (false, tzid))) ))

     

       159
       +
                 | Some "FLOATING" ->

     

       160
       +
                     let* datetime =

     

       161
       +
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       162
       +
                         ~time:start_time `From

     

       163
       +
                     in

     

       164
       +
                     Ok (Some (Icalendar.Params.empty, `Datetime (`Local datetime)))

     

       165
        
                 | Some "UTC" ->

     

       166
        
                     let* datetime =

     

       167
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       168
        
                         ~time:start_time `From

     

       169
        
                     in

     

       170
       +
                     Ok (Some (Icalendar.Params.empty, `Datetime (`Utc datetime)))

     

       171
        
                 | Some tzid ->

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       172
        
                     let* datetime =

     

       173
       +
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:start_date

     

       174
       +
                         ~time:start_time `From

     

       175
        
                     in

     

       176
       +
                     Ok

     

       177
       +
                       (Some

     

       178
       +
                          ( Icalendar.Params.empty,

     

       179
       +
                            `Datetime (`With_tzid (datetime, (false, tzid))) ))))

     

       180
        
       

     

       181
       +
       let parse_end ~end_date ~end_time ~end_timezone =

     

       182
        
         let ( let* ) = Result.bind in

     

       183
       +
         let* _ =

     

       184
       +
           match end_timezone with

     

       185
       +
           | None -> Ok ()

     

       186
       +
           | Some tzid -> (

     

       187
       +
               match Timedesc.Time_zone.make tzid with

     

       188
       +
               | Some _ -> Ok ()

     

       189
       +
               | None ->

     

       190
       +
                   Error (`Msg (Printf.sprintf "Warning: Unknown timezone %s" tzid)))

     

       191
       +
         in

     

       192
        
         match end_date with

     

       193
        
         | None ->

     

       194
        
             let* _ =

     
···

       199
        
             let* _ =

     

       200
        
               match end_timezone with

     

       201
        
               | None -> Ok ()

     

       202
       +
               | Some _ ->

     

       203
       +
                   Error (`Msg "Can't specify an end timezone without an end date")

     

       204
        
             in

     

       205
        
             Ok None

     

       206
        
         | Some end_date -> (

     

       207
        
             match end_time with

     

       208
        
             | None ->

     

       209
        
                 let* _ =

     

       210
       +
                   match end_timezone with

     

       211
       +
                   | Some _ ->

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       212
        
                       Error (`Msg "Can't specify an end timezone without a end time")

     

       213
       +
                   | _ -> Ok ()

     

       214
        
                 in

     

       215
        
                 let* ptime =

     

       216
        
                   Date.parse_date end_date ~tz:Timedesc.Time_zone.utc `From

     

       217
        
                 in

     

       218
       +
                 (* DTEND;VALUE=DATE the event ends at the start of the specified date *)

     

       219
       +
                 let ptime = Date.add_days ptime 1 in

     

       220
        
                 let date = Ptime.to_date ptime in

     

       221
       +
                 Ok

     

       222
       +
                   (Some

     

       223
       +
                      (`Dtend (Icalendar.Params.singleton Valuetype `Date, `Date date)))

     

       224
        
             | Some end_time -> (

     

       225
       +
                 match end_timezone with

     

       226
       +
                 | None ->

     

       227
       +
                     let* tzid =

     

       228
       +
                       match Timedesc.Time_zone.local () with

     

       229
       +
                       | Some tz -> Ok (Timedesc.Time_zone.name tz)

     

       230
       +
                       | None -> Error (`Msg "Failed to get system timezone")

     

       231
       +
                     in

     

       232
       +
                     let* datetime =

     

       233
       +
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       234
       +
                         ~time:end_time `From

     

       235
       +
                     in

     

       236
       +
                     Ok

     

       237
       +
                       (Some

     

       238
       +
                          (`Dtend

     

       239
       +
                             ( Icalendar.Params.empty,

     

       240
       +
                               `Datetime (`With_tzid (datetime, (false, tzid))) )))

     

       241
       +
                 | Some "FLOATING" ->

     

       242
        
                     let* datetime =

     

       243
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       244
        
                         ~time:end_time `From

     
···

       246
        
                     Ok

     

       247
        
                       (Some

     

       248
        
                          (`Dtend (Icalendar.Params.empty, `Datetime (`Local datetime))))

     

       249
       +
                 | Some "UTC" ->

     

       250
        
                     let* datetime =

     

       251
        
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       252
        
                         ~time:end_time `From

     
···

       254
        
                     Ok

     

       255
        
                       (Some

     

       256
        
                          (`Dtend (Icalendar.Params.empty, `Datetime (`Utc datetime))))

     

       257
       +
                 | Some tzid ->

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       258
        
                     let* datetime =

     

       259
       +
                       Date.parse_date_time ~tz:Timedesc.Time_zone.utc ~date:end_date

     

       260
       +
                         ~time:end_time `From

     

       261
        
                     in

     

       0
        
       
     

       262
        
                     Ok

     

       263
        
                       (Some

     

       264
        
                          (`Dtend

     
···

       397
        
             let recurrence = (f, limit, !interval, !by_parts) in

     

       398
        
             Ok recurrence

     

       399
        
         | None -> Error (`Msg "FREQ is required in recurrence rule")

     

       400
       +
       

     

       401
       +
       let recurrence_format_manpage_entries =

     

       402
       +
         [

     

       403
       +
           `S "RECURRENCE";

     

       404
       +
           `P "Recurrence rule in iCalendar RFC5545 format. The FREQ part is required.";

     

       405
       +
           `I ("FREQ=<frequency>", "DAILY, WEEKLY, MONTHLY, or YEARLY (required)");

     

       406
       +
           `I

     

       407
       +
             ( "COUNT=<number>",

     

       408
       +
               "Limit to this many occurrences (optional, cannot be used with UNTIL)"

     

       409
       +
             );

     

       410
       +
           `I

     

       411
       +
             ( "UNTIL=<date>",

     

       412
       +
               "Repeat until this date (optional, cannot be used with COUNT)" );

     

       413
       +
           `I

     

       414
       +
             ( "INTERVAL=<number>",

     

       415
       +
               "Interval between occurrences, e.g., 2 for every other (optional)" );

     

       416
       +
           `I

     

       417
       +
             ( "BYDAY=<dayspec>",

     

       418
       +
               "Specific days, e.g., MO,WE,FR or 1MO (first Monday) (optional)" );

     

       419
       +
           `I

     

       420
       +
             ( "BYMONTHDAY=<daynum>",

     

       421
       +
               "Day of month, e.g., 1,15 or -1 (last day) (optional)" );

     

       422
       +
           `I

     

       423
       +
             ( "BYMONTH=<monthnum>",

     

       424
       +
               "Month number, e.g., 1,6,12 for Jan,Jun,Dec (optional)" );

     

       425
       +
           `P "Examples:";

     

       426
       +
           `I ("FREQ=DAILY;COUNT=5", "Daily for 5 occurrences");

     

       427
       +
           `I ("FREQ=WEEKLY;INTERVAL=2", "Every other week indefinitely");

     

       428
       +
           `I ("FREQ=WEEKLY;BYDAY=MO,WE,FR", "Every Monday, Wednesday, Friday");

     

       429
       +
           `I ("FREQ=MONTHLY;BYDAY=1MO", "First Monday of every month");

     

       430
       +
           `I

     

       431
       +
             ( "FREQ=YEARLY;BYMONTH=1;BYMONTHDAY=1",

     

       432
       +
               "Every January 1st (New Year's Day)" );

     

       433
       +
           `I ("FREQ=MONTHLY;BYMONTHDAY=-1", "Last day of every month");

     

       434
       +
         ]

+39 -42

bin/list_cmd.ml

···

       2
        
       open Caledonia_lib

     

       3
        
       open Query_args

     

       4
        
       

     

       5
       -
       let run ?from_str ?to_str ?calendar ?count ~format ~today ~tomorrow ~week ~month

     

       6
       -
           ?timezone ~sort ~fs calendar_dir =

     

       7
        
         let ( let* ) = Result.bind in

     

       8
        
         let tz = Query_args.parse_timezone ~timezone in

     

       9
        
         let* from, to_ =

     
···

       33
        
                 match to_str with

     

       34
        
                 | None -> Ok None

     

       35
        
                 | Some s ->

     

       36
       -
                     let* d = Date.parse_date ~tz s `From in

     

       37
        
                     Ok (Some d)

     

       38
        
               in

     

       39
        
               match (from, to_) with

     
···

       41
        
               | Some f, None ->

     

       42
        
                   let one_month_later = Date.add_months f 1 in

     

       43
        
                   Ok (Some f, one_month_later)

     

       44
       -
               | None, Some t ->

     

       45
       -
                   let today_date = !Date.get_today ~tz () in

     

       46
       -
                   Ok (Some today_date, Date.to_end_of_day t)

     

       47
        
               | None, None ->

     

       48
        
                   let today_date = !Date.get_today ~tz () in

     

       49
        
                   let one_month_later = Date.add_months today_date 1 in

     

       50
        
                   Ok (Some today_date, one_month_later))

     

       51
        
         in

     

       52
        
         let filter =

     

       53
       -
           match calendar with

     

       54
       -
           | Some calendar_name -> Some (Query.in_calendar_names [ calendar_name ])

     

       55
       -
           | None -> None

     

       56
        
         in

     

       57
        
         let comparator = Query_args.create_event_comparator sort in

     

       58
       -
         let* results =

     

       59
       -
           Query.query ~fs calendar_dir ?filter ~from ~to_ ~comparator ?limit:count ()

     

       0
        
       
     

       60
        
         in

     

       61
       -
         if results = [] then print_endline "No events found."

     

       62
       -
         else print_endline (Event.format_events ~format ~tz results);

     

       63
        
         Ok ()

     

       64
        
       

     

       65
        
       let cmd ~fs calendar_dir =

     

       66
       -
         let run from_str to_str calendar count format today tomorrow week month

     

       67
       -
             timezone sort =

     

       68
        
           match

     

       69
       -
             run ?from_str ?to_str ?calendar ?count ~format ~today ~tomorrow ~week

     

       70
       -
               ~month ?timezone ~sort ~fs calendar_dir

     

       71
        
           with

     

       72
        
           | Error (`Msg msg) ->

     

       73
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       84
        
         let man =

     

       85
        
           [

     

       86
        
             `S Manpage.s_description;

     

       87
       -
             `P "List calendar events within a specified date range.";

     

       88
       -
             `P "By default, events from today to one month from today are shown.";

     

       89
       -
             `P "You can use date flags to show events for a specific time period.";

     

       90
       -
             `P "You can also filter events by calendar using the --calendar flag.";

     

       91
       -
             `P "Use the --sort option to control the sorting of results.";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       92
        
             `S Manpage.s_options;

     

       93
        
           ]

     

       94
        
           @ date_format_manpage_entries

     

       95
       -
           @ [

     

       96
       -
               `S Manpage.s_examples;

     

       97
       -
               `I ("List all events for today:", "caled list --today");

     

       98
       -
               `I ("List all events for tomorrow:", "caled list --tomorrow");

     

       99
       -
               `I ("List all events for the current week:", "caled list --week");

     

       100
       -
               `I ("List all events for the current month:", "caled list --month");

     

       101
       -
               `I

     

       102
       -
                 ( "List events within a specific date range:",

     

       103
       -
                   "caled list --from 2025-03-27 --to 2025-04-01" );

     

       104
       -
               `I

     

       105
       -
                 ("List events from a specific calendar:", "caled list --calendar work");

     

       106
       -
               `I ("List events in JSON format:", "caled list --format json");

     

       107
       -
               `I ("Limit the number of events shown:", "caled list --count 5");

     

       108
       -
               `I

     

       109
       -
                 ( "Sort by multiple fields (start time and summary):",

     

       110
       -
                   "caled list --sort start --sort summary" );

     

       111
       -
               `I

     

       112
       -
                 ( "Sort by calendar name in descending order:",

     

       113
       -
                   "caled list --sort calendar:desc" );

     

       114
       -
             ]

     

       115
        
         in

     

       116
        
         let exit_info =

     

       117
        
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

···

       2
        
       open Caledonia_lib

     

       3
        
       open Query_args

     

       4
        
       

     

       5
       +
       let run ?from_str ?to_str ~calendar:calendars ?count ~format ~today ~tomorrow

     

       6
       +
           ~week ~month ?timezone ~sort ~fs calendar_dir =

     

       7
        
         let ( let* ) = Result.bind in

     

       8
        
         let tz = Query_args.parse_timezone ~timezone in

     

       9
        
         let* from, to_ =

     
···

       33
        
                 match to_str with

     

       34
        
                 | None -> Ok None

     

       35
        
                 | Some s ->

     

       36
       +
                     let* d = Date.parse_date ~tz s `To in

     

       37
        
                     Ok (Some d)

     

       38
        
               in

     

       39
        
               match (from, to_) with

     
···

       41
        
               | Some f, None ->

     

       42
        
                   let one_month_later = Date.add_months f 1 in

     

       43
        
                   Ok (Some f, one_month_later)

     

       44
       +
               | None, Some t -> Ok (None, Date.to_end_of_day t)

     

       0
        
       
     

       0
        
       
     

       45
        
               | None, None ->

     

       46
        
                   let today_date = !Date.get_today ~tz () in

     

       47
        
                   let one_month_later = Date.add_months today_date 1 in

     

       48
        
                   Ok (Some today_date, one_month_later))

     

       49
        
         in

     

       50
        
         let filter =

     

       51
       +
           match calendars with

     

       52
       +
           | [] -> None

     

       53
       +
           | calendar -> Some (Event.in_calendars calendar)

     

       54
        
         in

     

       55
        
         let comparator = Query_args.create_event_comparator sort in

     

       56
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       57
       +
         let events =

     

       58
       +
           Event.query events ?filter ~from ~to_ ~comparator ?limit:count ()

     

       59
        
         in

     

       60
       +
         if events = [] then print_endline "No events found."

     

       61
       +
         else print_endline (Event.format_events ~format ~tz events);

     

       62
        
         Ok ()

     

       63
        
       

     

       64
        
       let cmd ~fs calendar_dir =

     

       65
       +
         let run from_str to_str calendars count format today tomorrow week month

     

       66
       +
             timezone sort () =

     

       67
        
           match

     

       68
       +
             run ?from_str ?to_str ~calendar:calendars ?count ~format ~today ~tomorrow

     

       69
       +
               ~week ~month ?timezone ~sort ~fs calendar_dir

     

       70
        
           with

     

       71
        
           | Error (`Msg msg) ->

     

       72
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       83
        
         let man =

     

       84
        
           [

     

       85
        
             `S Manpage.s_description;

     

       86
       +
             `P

     

       87
       +
               "List calendar events within a specified date range. By default, \

     

       88
       +
                events from today to one month from today are shown. You can use date \

     

       89
       +
                flags to show events for a specific time period, and filter events \

     

       90
       +
                with the --sort option.";

     

       91
       +
             `S Manpage.s_examples;

     

       92
       +
             `I ("List all events for today:", "caled list --today");

     

       93
       +
             `I ("List all events for tomorrow:", "caled list --tomorrow");

     

       94
       +
             `I ("List all events for the current week:", "caled list --week");

     

       95
       +
             `I ("List all events for the current month:", "caled list --month");

     

       96
       +
             `I

     

       97
       +
               ( "List events within a specific date range:",

     

       98
       +
                 "caled list --from 2025-03-27 --to 2025-04-01" );

     

       99
       +
             `I ("List events from a specific calendar:", "caled list --calendar work");

     

       100
       +
             `I ("List events in JSON format:", "caled list --format json");

     

       101
       +
             `I ("Limit the number of events shown:", "caled list --count 5");

     

       102
       +
             `I

     

       103
       +
               ( "Sort by multiple fields (start time and summary):",

     

       104
       +
                 "caled list --sort start --sort summary" );

     

       105
       +
             `I

     

       106
       +
               ( "Sort by calendar name in descending order:",

     

       107
       +
                 "caled list --sort calendar:desc" );

     

       108
        
             `S Manpage.s_options;

     

       109
        
           ]

     

       110
        
           @ date_format_manpage_entries

     

       111
       +
           @ [ `S Manpage.s_see_also ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       112
        
         in

     

       113
        
         let exit_info =

     

       114
        
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

+4 -3

bin/main.ml

···

       1
       -
       (* Main entry point for the calendar CLI *)

     

       2
       -
       

     

       3
        
       open Cmdliner

     

       4
        
       

     

       5
        
       let list_cmd = List_cmd.cmd

     
···

       8
        
       let add_cmd = Add_cmd.cmd

     

       9
        
       let delete_cmd = Delete_cmd.cmd

     

       10
        
       let edit_cmd = Edit_cmd.cmd

     

       0
        
       
     

       11
        
       let doc = "Command-line calendar tool for managing local .ics files"

     

       12
        
       let version = "%%VERSION%%"

     

       13
        
       

     
···

       47
        
                      add_cmd ~fs calendar_dir;

     

       48
        
                      edit_cmd ~fs calendar_dir;

     

       49
        
                      delete_cmd ~fs calendar_dir;

     

       0
        
       
     

       0
        
       
     

       50
        
                    ])

     

       51
        
             with

     

       52
       -
             | Ok (`Ok n) -> n

     

       53
        
             | Ok _ -> 0

     

       54
        
             | Error _ -> 1)

     

       55

···

       0
        
       
     

       0
        
       
     

       1
        
       open Cmdliner

     

       2
        
       

     

       3
        
       let list_cmd = List_cmd.cmd

     
···

       6
        
       let add_cmd = Add_cmd.cmd

     

       7
        
       let delete_cmd = Delete_cmd.cmd

     

       8
        
       let edit_cmd = Edit_cmd.cmd

     

       9
       +
       let server_cmd = Server_cmd.cmd

     

       10
        
       let doc = "Command-line calendar tool for managing local .ics files"

     

       11
        
       let version = "%%VERSION%%"

     

       12
        
       

     
···

       46
        
                      add_cmd ~fs calendar_dir;

     

       47
        
                      edit_cmd ~fs calendar_dir;

     

       48
        
                      delete_cmd ~fs calendar_dir;

     

       49
       +
                      server_cmd ~stdin:(Eio.Stdenv.stdin env)

     

       50
       +
                        ~stdout:(Eio.Stdenv.stdout env) ~fs calendar_dir;

     

       51
        
                    ])

     

       52
        
             with

     

       53
       +
             | Ok (`Ok f) -> f ()

     

       54
        
             | Ok _ -> 0

     

       55
        
             | Error _ -> 1)

     

       56

+32 -32

bin/query_args.ml

···

       3
        
       

     

       4
        
       let from_arg =

     

       5
        
         let doc =

     

       6
       -
           "Start date in YYYY-MM-DD format or a relative expression (today, \

     

       7
       -
            tomorrow, this-week, next-week, this-month, next-month, +Nd, -Nd, +Nw, \

     

       8
       -
            +Nm)"

     

       9
        
         in

     

       10
        
         let i = Arg.info [ "from"; "f" ] ~docv:"DATE" ~doc in

     

       11
        
         Arg.(value @@ opt (some string) None i)

     

       12
        
       

     

       13
        
       let to_arg =

     

       14
        
         let doc =

     

       15
       -
           "End date in YYYY-MM-DD format or a relative expression (today, tomorrow, \

     

       16
       -
            this-week, next-week, this-month, next-month, +Nd, -Nd, +Nw, +Nm)"

     

       0
        
       
     

       17
        
         in

     

       18
        
         let i = Arg.info [ "to"; "t" ] ~docv:"DATE" ~doc in

     

       19
        
         Arg.(value @@ opt (some string) None i)

     

       20
        
       

     

       21
        
       let calendar_arg =

     

       22
       -
         let doc = "Calendar to filter by" in

     

       23
        
         Arg.(

     

       24
       -
           value

     

       25
       -
           & opt (some string) None

     

       26
       -
           & info [ "calendar"; "c" ] ~docv:"CALENDAR" ~doc)

     

       27
        
       

     

       28
        
       let format_enum =

     

       29
        
         [

     
···

       36
        
         ]

     

       37
        
       

     

       38
        
       let format_arg =

     

       39
       -
         let doc = "Output format (text, entries, json, csv, ics, sexp)" in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       40
        
         Arg.(

     

       41
        
           value

     

       42
        
           & opt (enum format_enum) `Text

     
···

       176
        
                in

     

       177
        
                if spec.descending then Event.descending comp else comp)

     

       178
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       179
        
       let date_format_manpage_entries =

     

       180
        
         [

     

       181
        
           `S "DATE FORMATS";

     

       182
       -
           `P "Date format flags:";

     

       183
       -
           `I ("--today, -d", "Show events for today only");

     

       184
       -
           `I ("--tomorrow", "Show events for tomorrow only");

     

       185
       -
           `I ("--week, -w", "Show events for the current week");

     

       186
       -
           `I ("--month, -m", "Show events for the current month");

     

       187
       -
           `I

     

       188
       -
             ( "--timezone, -z",

     

       189
       -
               "Timezone to use for date calculations (e.g., 'America/New_York', \

     

       190
       -
                'UTC')" );

     

       191
       -
           `P "Relative date formats for --from and --to:";

     

       192
        
           `I ("today", "Current day");

     

       193
        
           `I ("tomorrow", "Next day");

     

       194
        
           `I ("yesterday", "Previous day");

     

       195
       -
           `I ("this-week", "Start of current week");

     

       196
       -
           `I ("next-week", "Start of next week");

     

       197
       -
           `I ("this-month", "Start of current month");

     

       198
       -
           `I ("next-month", "Start of next month");

     

       199
        
           `I ("+Nd", "N days from today (e.g., +7d for a week from today)");

     

       200
        
           `I ("-Nd", "N days before today (e.g., -7d for a week ago)");

     

       201
        
           `I ("+Nw", "N weeks from today (e.g., +4w for 4 weeks from today)");

     

       202
        
           `I ("+Nm", "N months from today (e.g., +2m for 2 months from today)");

     

       203
        
         ]

     

       204
       -
       

     

       205
       -
       let parse_timezone ~timezone =

     

       206
       -
         match timezone with

     

       207
       -
         | Some tzid -> (

     

       208
       -
             match Timedesc.Time_zone.make tzid with

     

       209
       -
             | Some tz -> tz

     

       210
       -
             | None -> failwith ("Invalid timezone: " ^ tzid))

     

       211
       -
         | None -> !Date.default_timezone ()

···

       3
        
       

     

       4
        
       let from_arg =

     

       5
        
         let doc =

     

       6
       +
           "Start date in YYYY-MM-DD format, partial date format (YYYY-MM or YYYY), \

     

       7
       +
            or a relative expression (today, tomorrow, this-week, next-week, \

     

       8
       +
            this-month, next-month, +Nd, -Nd, +Nw, +Nm). See DATE FORMATS for more."

     

       9
        
         in

     

       10
        
         let i = Arg.info [ "from"; "f" ] ~docv:"DATE" ~doc in

     

       11
        
         Arg.(value @@ opt (some string) None i)

     

       12
        
       

     

       13
        
       let to_arg =

     

       14
        
         let doc =

     

       15
       +
           "End date in YYYY-MM-DD format, partial date format (YYYY-MM or YYYY), or \

     

       16
       +
            a relative expression (today, tomorrow, this-week, next-week, this-month, \

     

       17
       +
            next-month, +Nd, -Nd, +Nw, +Nm). See DATE FORMATS for more."

     

       18
        
         in

     

       19
        
         let i = Arg.info [ "to"; "t" ] ~docv:"DATE" ~doc in

     

       20
        
         Arg.(value @@ opt (some string) None i)

     

       21
        
       

     

       22
        
       let calendar_arg =

     

       23
       +
         let doc = "Filter by calendar" in

     

       24
        
         Arg.(

     

       25
       +
           value & opt_all string [] & info [ "calendar"; "c" ] ~docv:"CALENDAR" ~doc)

     

       0
        
       
     

       0
        
       
     

       26
        
       

     

       27
        
       let format_enum =

     

       28
        
         [

     
···

       35
        
         ]

     

       36
        
       

     

       37
        
       let format_arg =

     

       38
       +
         let doc =

     

       39
       +
           "Output format (text, entries, json, csv, ics, sexp). Note that dates are \

     

       40
       +
            localised to the TIMEZONE option but the timezone they're defined in is \

     

       41
       +
            displayed."

     

       42
       +
         in

     

       43
        
         Arg.(

     

       44
        
           value

     

       45
        
           & opt (enum format_enum) `Text

     
···

       179
        
                in

     

       180
        
                if spec.descending then Event.descending comp else comp)

     

       181
        
       

     

       182
       +
       let parse_timezone ~timezone =

     

       183
       +
         match timezone with

     

       184
       +
         | Some tzid -> (

     

       185
       +
             match Timedesc.Time_zone.make tzid with

     

       186
       +
             | Some tz -> tz

     

       187
       +
             | None -> failwith ("Invalid timezone: " ^ tzid))

     

       188
       +
         | None -> !Date.default_timezone ()

     

       189
       +
       

     

       190
        
       let date_format_manpage_entries =

     

       191
        
         [

     

       192
        
           `S "DATE FORMATS";

     

       193
       +
           `P

     

       194
       +
             "The following are the possible date formats for the --from and --to \

     

       195
       +
              command line parameters. Note the value is dependent on --from / --to, \

     

       196
       +
              so --from 2025 --to 2025 will include all the events in the year 2025";

     

       197
       +
           `I ("YYYY-MM-DD", "Specific date (e.g., 2025-3-27, zero-padding optional)");

     

       198
       +
           `I ("YYYY-MM", "Start/end of specific month (e.g., 2025-3 for March 2025)");

     

       199
       +
           `I ("YYYY", "Start/end of specific year (e.g., 2025)");

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       200
        
           `I ("today", "Current day");

     

       201
        
           `I ("tomorrow", "Next day");

     

       202
        
           `I ("yesterday", "Previous day");

     

       203
       +
           `I ("this-week", "Start/end of current week");

     

       204
       +
           `I ("next-week", "Start/end of next week");

     

       205
       +
           `I ("this-month", "Start/end of current month");

     

       206
       +
           `I ("next-month", "Start/end of next month");

     

       207
        
           `I ("+Nd", "N days from today (e.g., +7d for a week from today)");

     

       208
        
           `I ("-Nd", "N days before today (e.g., -7d for a week ago)");

     

       209
        
           `I ("+Nw", "N weeks from today (e.g., +4w for 4 weeks from today)");

     

       210
        
           `I ("+Nm", "N months from today (e.g., +2m for 2 months from today)");

     

       211
        
         ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

+69 -80

bin/search_cmd.ml

···

       2
        
       open Caledonia_lib

     

       3
        
       open Query_args

     

       4
        
       

     

       5
       -
       let run ?from_str ?to_str ?calendar ?count ?query_text ~summary ~description

     

       6
        
           ~location ~id ~format ~today ~tomorrow ~week ~month ~recurring

     

       7
        
           ~non_recurring ?timezone ~sort ~fs calendar_dir =

     

       8
        
         let ( let* ) = Result.bind in

     
···

       35
        
                 match to_str with

     

       36
        
                 | None -> Ok None

     

       37
        
                 | Some s ->

     

       38
       -
                     let* d = Date.parse_date s `From in

     

       39
        
                     Ok (Some d)

     

       40
        
               in

     

       41
        
               let max_date = Date.add_years (!Date.get_today ()) 75 in

     
···

       46
        
               | None, None -> Ok (None, Date.to_end_of_day max_date))

     

       47
        
         in

     

       48
        
         (match calendar with

     

       49
       -
         | Some calendar_name ->

     

       50
       -
             filters := Query.in_calendar_names [ calendar_name ] :: !filters

     

       51
       -
         | None -> ());

     

       52
        
         (match query_text with

     

       53
        
         | Some text ->

     

       54
       -
             if summary then filters := Query.summary_contains text :: !filters;

     

       55
       -
             if description then filters := Query.description_contains text :: !filters;

     

       56
       -
             if location then filters := Query.location_contains text :: !filters;

     

       57
        
             if not (summary || description || location) then

     

       58
        
               filters :=

     

       59
       -
                 Query.or_filter

     

       60
        
                   [

     

       61
       -
                     Query.summary_contains text;

     

       62
       -
                     Query.description_contains text;

     

       63
       -
                     Query.location_contains text;

     

       64
        
                   ]

     

       65
        
                 :: !filters

     

       66
        
         | None -> ());

     

       67
       -
         if recurring then filters := Query.recurring_only () :: !filters;

     

       68
       -
         if non_recurring then filters := Query.non_recurring_only () :: !filters;

     

       69
        
         (match id with

     

       70
       -
         | Some id -> filters := Query.with_id id :: !filters

     

       71
        
         | None -> ());

     

       72
       -
         let filter = Query.and_filter !filters in

     

       73
        
         let comparator = Query_args.create_event_comparator sort in

     

       74
       -
         let* results =

     

       75
       -
           Query.query ~fs calendar_dir ~filter ~from ~to_ ~comparator ?limit:count ()

     

       0
        
       
     

       76
        
         in

     

       77
       -
         if results = [] then print_endline "No events found."

     

       78
       -
         else print_endline (Event.format_events ~tz ~format results);

     

       79
        
         Ok ()

     

       80
        
       

     

       81
        
       let query_text_arg =

     

       82
       -
         let doc = "Text to search for in events (summary, description, location)" in

     

       0
        
       
     

       0
        
       
     

       83
        
         Arg.(value & pos 0 (some string) None & info [] ~docv:"TEXT" ~doc)

     

       84
        
       

     

       85
        
       let summary_arg =

     
···

       107
        
         Arg.(value & opt (some string) None & info [ "id"; "i" ] ~docv:"ID" ~doc)

     

       108
        
       

     

       109
        
       let cmd ~fs calendar_dir =

     

       110
       -
         let run query_text from_str to_str calendar count format summary description

     

       111
        
             location id today tomorrow week month recurring non_recurring timezone

     

       112
       -
             sort =

     

       113
        
           match

     

       114
       -
             run ?from_str ?to_str ?calendar ?count ?query_text ~summary ~description

     

       115
       -
               ~location ~id ~format ~today ~tomorrow ~week ~month ~recurring

     

       116
       -
               ~non_recurring ?timezone ~sort ~fs calendar_dir

     

       117
        
           with

     

       118
        
           | Error (`Msg msg) ->

     

       119
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       133
        
             `S Manpage.s_description;

     

       134
        
             `P

     

       135
        
               "Search calendar events for text in summary, description, or location \

     

       136
       -
                fields.";

     

       137
       -
             `P

     

       138
       -
               "By default, the search looks across all text fields in all events \

     

       139
       -
                regardless of date.";

     

       140
       -
             `P

     

       141
       -
               "You can narrow the search to a specific date range with date flags or \

     

       142
       -
                --from and --to.";

     

       143
       -
             `P

     

       144
       -
               "You can specify specific fields to search in using the --summary, \

     

       145
       -
                --description, or --location flags.";

     

       146
       -
             `P

     

       147
       -
               "You can limit results to only recurring or non-recurring events using \

     

       148
       -
                the --recurring or --non-recurring flags.";

     

       149
       -
             `P "Use the --sort option to control the sorting of results.";

     

       150
       -
             `P

     

       151
       -
               "The search text is optional if you're using other filters. For \

     

       152
       -
                example, you can find all recurring events without specifying any \

     

       153
       -
                search text.";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       154
        
             `S Manpage.s_options;

     

       155
        
           ]

     

       156
        
           @ date_format_manpage_entries

     

       157
       -
           @ [

     

       158
       -
               `S Manpage.s_examples;

     

       159
       -
               `I ("Search for 'meeting' in all events:", "caled search meeting");

     

       160
       -
               `I

     

       161
       -
                 ( "Search for 'interview' in event summaries only:",

     

       162
       -
                   "caled search --summary interview" );

     

       163
       -
               `I

     

       164
       -
                 ( "Search for 'conference' in a specific calendar:",

     

       165
       -
                   "caled search --calendar work conference" );

     

       166
       -
               `I

     

       167
       -
                 ( "Search for 'workshop' in event descriptions for today only:",

     

       168
       -
                   "caled search --description --today workshop" );

     

       169
       -
               `I

     

       170
       -
                 ( "Search for 'project' in events this month:",

     

       171
       -
                   "caled search --month project" );

     

       172
       -
               `I

     

       173
       -
                 ( "Search for 'workshop' in event descriptions within a date range:",

     

       174
       -
                   "caled search --description --from 2025-03-27 --to 2025-04-01 \

     

       175
       -
                    workshop" );

     

       176
       -
               `I

     

       177
       -
                 ( "Search for recurring events only:",

     

       178
       -
                   "caled search --recurring meeting" );

     

       179
       -
               `I

     

       180
       -
                 ( "Search for non-recurring events only:",

     

       181
       -
                   "caled search --non-recurring appointment" );

     

       182
       -
               `I ("Find all recurring events:", "caled search --recurring");

     

       183
       -
               `I

     

       184
       -
                 ( "Find all events in a specific calendar:",

     

       185
       -
                   "caled search --calendar work" );

     

       186
       -
               `I

     

       187
       -
                 ( "Sort results by location and then summary:",

     

       188
       -
                   "caled search --sort location --sort summary" );

     

       189
       -
               `I

     

       190
       -
                 ( "Sort results by end time in descending order:",

     

       191
       -
                   "caled search --sort end:desc" );

     

       192
       -
             ]

     

       193
        
         in

     

       194
        
         let exit_info =

     

       195
        
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

···

       2
        
       open Caledonia_lib

     

       3
        
       open Query_args

     

       4
        
       

     

       5
       +
       let run ?from_str ?to_str ~calendar ?count ?query_text ~summary ~description

     

       6
        
           ~location ~id ~format ~today ~tomorrow ~week ~month ~recurring

     

       7
        
           ~non_recurring ?timezone ~sort ~fs calendar_dir =

     

       8
        
         let ( let* ) = Result.bind in

     
···

       35
        
                 match to_str with

     

       36
        
                 | None -> Ok None

     

       37
        
                 | Some s ->

     

       38
       +
                     let* d = Date.parse_date s `To in

     

       39
        
                     Ok (Some d)

     

       40
        
               in

     

       41
        
               let max_date = Date.add_years (!Date.get_today ()) 75 in

     
···

       46
        
               | None, None -> Ok (None, Date.to_end_of_day max_date))

     

       47
        
         in

     

       48
        
         (match calendar with

     

       49
       +
         | [] -> ()

     

       50
       +
         | calendars -> filters := Event.in_calendars calendars :: !filters);

     

       0
        
       
     

       51
        
         (match query_text with

     

       52
        
         | Some text ->

     

       53
       +
             if summary then filters := Event.summary_contains text :: !filters;

     

       54
       +
             if description then filters := Event.description_contains text :: !filters;

     

       55
       +
             if location then filters := Event.location_contains text :: !filters;

     

       56
        
             if not (summary || description || location) then

     

       57
        
               filters :=

     

       58
       +
                 Event.or_filter

     

       59
        
                   [

     

       60
       +
                     Event.summary_contains text;

     

       61
       +
                     Event.description_contains text;

     

       62
       +
                     Event.location_contains text;

     

       63
        
                   ]

     

       64
        
                 :: !filters

     

       65
        
         | None -> ());

     

       66
       +
         if recurring then filters := Event.recurring_only () :: !filters;

     

       67
       +
         if non_recurring then filters := Event.non_recurring_only () :: !filters;

     

       68
        
         (match id with

     

       69
       +
         | Some id -> filters := Event.with_id id :: !filters

     

       70
        
         | None -> ());

     

       71
       +
         let filter = Event.and_filter !filters in

     

       72
        
         let comparator = Query_args.create_event_comparator sort in

     

       73
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       74
       +
         let events =

     

       75
       +
           Event.query events ~filter ~from ~to_ ~comparator ?limit:count ()

     

       76
        
         in

     

       77
       +
         if events = [] then print_endline "No events found."

     

       78
       +
         else print_endline (Event.format_events ~tz ~format events);

     

       79
        
         Ok ()

     

       80
        
       

     

       81
        
       let query_text_arg =

     

       82
       +
         let doc =

     

       83
       +
           "Text to search for in the fields summary, description, and/or location."

     

       84
       +
         in

     

       85
        
         Arg.(value & pos 0 (some string) None & info [] ~docv:"TEXT" ~doc)

     

       86
        
       

     

       87
        
       let summary_arg =

     
···

       109
        
         Arg.(value & opt (some string) None & info [ "id"; "i" ] ~docv:"ID" ~doc)

     

       110
        
       

     

       111
        
       let cmd ~fs calendar_dir =

     

       112
       +
         let run query_text from_str to_str calendars count format summary description

     

       113
        
             location id today tomorrow week month recurring non_recurring timezone

     

       114
       +
             sort () =

     

       115
        
           match

     

       116
       +
             run ?from_str ?to_str ~calendar:calendars ?count ?query_text ~summary

     

       117
       +
               ~description ~location ~id ~format ~today ~tomorrow ~week ~month

     

       118
       +
               ~recurring ~non_recurring ?timezone ~sort ~fs calendar_dir

     

       119
        
           with

     

       120
        
           | Error (`Msg msg) ->

     

       121
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       135
        
             `S Manpage.s_description;

     

       136
        
             `P

     

       137
        
               "Search calendar events for text in summary, description, or location \

     

       138
       +
                fields. By default, the search looks across all text fields in all \

     

       139
       +
                events regardless of date. You can specify specific fields to search \

     

       140
       +
                in using the --summary, --description, or --location flags. You can \

     

       141
       +
                use date flags to show events for a specific time period, and filter \

     

       142
       +
                events with the --sort option.\n\

     

       143
       +
               \        The search text is optional, so you search events according \

     

       144
       +
                to other query criteria.";

     

       145
       +
             `S Manpage.s_examples;

     

       146
       +
             `I ("Search for 'meeting' in all events:", "caled search meeting");

     

       147
       +
             `I

     

       148
       +
               ( "Search for 'interview' in event summaries only:",

     

       149
       +
                 "caled search --summary interview" );

     

       150
       +
             `I

     

       151
       +
               ( "Search for 'conference' in a specific calendar:",

     

       152
       +
                 "caled search --calendar work conference" );

     

       153
       +
             `I

     

       154
       +
               ( "Search for 'workshop' in event descriptions for today only:",

     

       155
       +
                 "caled search --description --today workshop" );

     

       156
       +
             `I

     

       157
       +
               ( "Search for 'project' in events this month:",

     

       158
       +
                 "caled search --month project" );

     

       159
       +
             `I

     

       160
       +
               ( "Search for 'workshop' in event descriptions within a date range:",

     

       161
       +
                 "caled search --description --from 2025-03-27 --to 2025-04-01 \

     

       162
       +
                  workshop" );

     

       163
       +
             `I

     

       164
       +
               ("Search for recurring events only:", "caled search --recurring meeting");

     

       165
       +
             `I

     

       166
       +
               ( "Search for non-recurring events only:",

     

       167
       +
                 "caled search --non-recurring appointment" );

     

       168
       +
             `I ("Find all recurring events:", "caled search --recurring");

     

       169
       +
             `I

     

       170
       +
               ( "Find all events in a specific calendar:",

     

       171
       +
                 "caled search --calendar work" );

     

       172
       +
             `I

     

       173
       +
               ( "Sort results by location and then summary:",

     

       174
       +
                 "caled search --sort location --sort summary" );

     

       175
       +
             `I

     

       176
       +
               ( "Sort results by end time in descending order:",

     

       177
       +
                 "caled search --sort end:desc" );

     

       178
        
             `S Manpage.s_options;

     

       179
        
           ]

     

       180
        
           @ date_format_manpage_entries

     

       181
       +
           @ [ `S Manpage.s_see_also ]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       182
        
         in

     

       183
        
         let exit_info =

     

       184
        
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

+85

bin/server_cmd.ml

···

       1
       +
       open Eio

     

       2
       +
       open Cmdliner

     

       3
       +
       open Caledonia_lib

     

       4
       +
       open Caledonia_lib.Sexp

     

       5
       +
       

     

       6
       +
       let run ~stdin ~stdout ~fs calendar_dir () =

     

       7
       +
         let reader = Buf_read.of_flow stdin ~max_size:1_000_000 in

     

       8
       +
         let ( let* ) = Result.bind in

     

       9
       +
         

     

       10
       +
         (* Initialize mutable events variable - will be updated on refresh *)

     

       11
       +
         let mutable_events = ref (Calendar_dir.get_events ~fs calendar_dir) in

     

       12
       +
         

     

       13
       +
         try

     

       14
       +
           while true do

     

       15
       +
             let line = Buf_read.line reader in

     

       16
       +
             let response =

     

       17
       +
               try

     

       18
       +
                 let sexp = Sexplib.Sexp.of_string line in

     

       19
       +
                 let request = Sexp.request_of_sexp sexp in

     

       20
       +
                 match request with

     

       21
       +
                 | ListCalendars ->

     

       22
       +
                     let* names = Calendar_dir.list_calendar_names ~fs calendar_dir in

     

       23
       +
                     Ok (sexp_of_response (Ok (Calendars names)))

     

       24
       +
                 | Refresh ->

     

       25
       +
                     (* Reload events from disk *)

     

       26
       +
                     mutable_events := Calendar_dir.get_events ~fs calendar_dir;

     

       27
       +
                     (* Return an empty response *)

     

       28
       +
                     Ok (sexp_of_response (Ok Empty))

     

       29
       +
                 | Query query_req ->

     

       30
       +
                     let* filter, from, to_, limit, _tz =

     

       31
       +
                       generate_query_params query_req

     

       32
       +
                     in

     

       33
       +
                     let* events = !mutable_events in

     

       34
       +
                     let events = Event.query events ~filter ~from ~to_ ?limit () in

     

       35
       +
                     Ok (sexp_of_response (Ok (Events events)))

     

       36
       +
               with

     

       37
       +
               | Sexplib.Conv.Of_sexp_error (_exn, bad_sexp) ->

     

       38
       +
                   let msg =

     

       39
       +
                     Printf.sprintf "Invalid request format for '%s': %s" line

     

       40
       +
                       (to_string bad_sexp)

     

       41
       +
                   in

     

       42
       +
                   Ok (sexp_of_response (Error msg))

     

       43
       +
               | Failure msg ->

     

       44
       +
                   Ok (sexp_of_response (Error ("Processing failed: " ^ msg)))

     

       45
       +
               | exn ->

     

       46
       +
                   let msg =

     

       47
       +
                     Printf.sprintf "Unexpected error: %s" (Printexc.to_string exn)

     

       48
       +
                   in

     

       49
       +
                   Ok (sexp_of_response (Error msg))

     

       50
       +
             in

     

       51
       +
             let response_line =

     

       52
       +
               to_string

     

       53
       +
                 (match response with

     

       54
       +
                 | Ok r -> r

     

       55
       +
                 | Error (`Msg msg) -> Sexp.sexp_of_response (Error msg))

     

       56
       +
             in

     

       57
       +
             Flow.copy_string (response_line ^ "\n") stdout

     

       58
       +
           done

     

       59
       +
         with End_of_file -> ()

     

       60
       +
       

     

       61
       +
       let cmd ~stdin ~stdout ~fs calendar_dir =

     

       62
       +
         let run () =

     

       63
       +
           let _ = run ~stdin ~stdout ~fs calendar_dir () in

     

       64
       +
           0

     

       65
       +
         in

     

       66
       +
         let term = Term.(const run) in

     

       67
       +
       

     

       68
       +
         let doc = "Process single-line S-expression requests from stdin to stdout." in

     

       69
       +
         let man =

     

       70
       +
           [

     

       71
       +
             `S Manpage.s_description;

     

       72
       +
             `P

     

       73
       +
               "$(mname) $(tname) reads S-expression requests (one per line) from \

     

       74
       +
                stdin, processes them, and writes S-expression responses (one per \

     

       75
       +
                line) to stdout.";

     

       76
       +
             `P "Example request: '(Query (()))'";

     

       77
       +
             `P

     

       78
       +
               "Example response: '(Ok (Events ((id ...) (summary ...) ...)))' or \

     

       79
       +
                '(Error \"...\")'";

     

       80
       +
             `S Manpage.s_examples;

     

       81
       +
             `Pre "echo '(Query ((text \\\"meeting\\\")))' | $(mname) $(tname)";

     

       82
       +
           ]

     

       83
       +
         in

     

       84
       +
         let info = Cmd.info "server" ~doc ~man in

     

       85
       +
         Cmd.v info term

+10 -8

bin/show_cmd.ml

···

       3
        
       

     

       4
        
       let run ~event_id ~format ~fs calendar_dir =

     

       5
        
         let ( let* ) = Result.bind in

     

       6
       -
         let filter = Query.with_id event_id in

     

       7
       -
         let* results = Query.query_without_recurrence ~fs calendar_dir ~filter () in

     

       0
        
       
     

       8
        
         if results = [] then print_endline "No events found."

     

       9
        
         else print_endline (Event.format_events ~format results);

     

       10
        
         Ok ()

     
···

       21
        
           & info [ "format"; "o" ] ~docv:"FORMAT" ~doc)

     

       22
        
       

     

       23
        
       let cmd ~fs calendar_dir =

     

       24
       -
         let run event_id format =

     

       25
        
           match run ~event_id ~format ~fs calendar_dir with

     

       26
        
           | Error (`Msg msg) ->

     

       27
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       34
        
           [

     

       35
        
             `S Manpage.s_description;

     

       36
        
             `P "Show detailed information about a specific event by its ID.";

     

       37
       -
             `P

     

       38
       -
               "You can find event IDs by using the `list` or `search` commands with \

     

       39
       -
                the `id` output using `-o id`.";

     

       40
       -
             `S Manpage.s_options;

     

       41
        
             `S Manpage.s_examples;

     

       42
        
             `P "Show event details:";

     

       43
        
             `P "  caled show 12345678-1234-5678-1234-567812345678";

     

       44
        
             `P "Show event details in JSON format:";

     

       45
        
             `P "  caled show 12345678-1234-5678-1234-567812345678 --format json";

     

       0
        
       
     

       46
        
           ]

     

       47
        
         in

     

       48
       -
         let info = Cmd.info "show" ~doc ~man in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       49
        
         Cmd.v info term

···

       3
        
       

     

       4
        
       let run ~event_id ~format ~fs calendar_dir =

     

       5
        
         let ( let* ) = Result.bind in

     

       6
       +
         let filter = Event.with_id event_id in

     

       7
       +
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       8
       +
         let results = Event.query_without_recurrence events ~filter () in

     

       9
        
         if results = [] then print_endline "No events found."

     

       10
        
         else print_endline (Event.format_events ~format results);

     

       11
        
         Ok ()

     
···

       22
        
           & info [ "format"; "o" ] ~docv:"FORMAT" ~doc)

     

       23
        
       

     

       24
        
       let cmd ~fs calendar_dir =

     

       25
       +
         let run event_id format () =

     

       26
        
           match run ~event_id ~format ~fs calendar_dir with

     

       27
        
           | Error (`Msg msg) ->

     

       28
        
               Printf.eprintf "Error: %s\n%!" msg;

     
···

       35
        
           [

     

       36
        
             `S Manpage.s_description;

     

       37
        
             `P "Show detailed information about a specific event by its ID.";

     

       38
       +
             `P "You can find event IDs by using the `list` or `search` commands.";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       39
        
             `S Manpage.s_examples;

     

       40
        
             `P "Show event details:";

     

       41
        
             `P "  caled show 12345678-1234-5678-1234-567812345678";

     

       42
        
             `P "Show event details in JSON format:";

     

       43
        
             `P "  caled show 12345678-1234-5678-1234-567812345678 --format json";

     

       44
       +
             `S Manpage.s_options;

     

       45
        
           ]

     

       46
        
         in

     

       47
       +
         let exit_info =

     

       48
       +
           [ Cmd.Exit.info ~doc:"on success." 0; Cmd.Exit.info ~doc:"on error." 1 ]

     

       49
       +
         in

     

       50
       +
         let info = Cmd.info "show" ~doc ~man ~exits:exit_info in

     

       51
        
         Cmd.v info term

+2 -1

caledonia.opam

···

       1
        
       opam-version: "2.0"

     

       2
       -
       version: "0.3.0"

     

       3
        
       maintainer: "Ryan Gibb <ryan@freumh.org"

     

       4
        
       authors: ["Ryan Gibb <ryan@freumh.org"]

     

       5
        
       homepage: "https://ryan.freumh.org/caledonia.html"

     
···

       26
        
         "eio_main" {>= "0.12"}

     

       27
        
         "timere" {>= "0.8.0"}

     

       28
        
         "timedesc" {>= "0.8.0"}

     

       0
        
       
     

       29
        
         "alcotest" {>= "1.8.0" & with-test}

     

       30
        
       ]

     

       31
        
       pin-depends: [

···

       1
        
       opam-version: "2.0"

     

       2
       +
       version: "0.4.0"

     

       3
        
       maintainer: "Ryan Gibb <ryan@freumh.org"

     

       4
        
       authors: ["Ryan Gibb <ryan@freumh.org"]

     

       5
        
       homepage: "https://ryan.freumh.org/caledonia.html"

     
···

       26
        
         "eio_main" {>= "0.12"}

     

       27
        
         "timere" {>= "0.8.0"}

     

       28
        
         "timedesc" {>= "0.8.0"}

     

       29
       +
         "ppx_sexp_conv" {>= "0.15.1"}

     

       30
        
         "alcotest" {>= "1.8.0" & with-test}

     

       31
        
       ]

     

       32
        
       pin-depends: [

+2 -2

dune-project

···

       1
        
       (lang dune 3.4)

     

       2
        
       (name caledonia)

     

       3
       -
       (version 0.3.0)

     

       4
       -
       (using directory-targets 0.1)

···

       1
        
       (lang dune 3.4)

     

       2
        
       (name caledonia)

     

       3
       +
       (version 0.4.0)

     

       4
       +
       (using directory-targets 0.1)

+56

emacs/caledonia-evil.el

···

       1
       +
       ;;; caledonia-evil.el --- Evil bindings for Caledonia -*- lexical-binding: t; -*-

     

       2
       +
       ;;

     

       3
       +
       ;; Copyright (C) 2025 Ryan Gibb

     

       4
       +
       ;;

     

       5
       +
       ;; Author: Ryan Gibb <ryan@freumh.org>

     

       6
       +
       ;; Maintainer: Ryan Gibb <ryan@freumh.org>

     

       7
       +
       ;; Version: 0.4.0

     

       8
       +
       ;; Keywords: calendar

     

       9
       +
       ;; Package-Requires: ((emacs "24.3"))

     

       10
       +
       ;; URL: https://ryan.freumh.org/caledonia.html

     

       11
       +
       ;;

     

       12
       +
       ;; This file is not part of GNU Emacs.

     

       13
       +
       ;;

     

       14
       +
       ;;; Commentary:

     

       15
       +
       ;;

     

       16
       +
       ;; This package provides Evil bindings for Caledonia.

     

       17
       +
       ;;

     

       18
       +
       ;;; Code:

     

       19
       +
       

     

       20
       +
       (require 'evil)

     

       21
       +
       (require 'caledonia)

     

       22
       +
       

     

       23
       +
       (defvar caledonia-evil-filter-map

     

       24
       +
         (let ((map (make-sparse-keymap)))

     

       25
       +
           (define-key map "d" 'caledonia-query-date-range)

     

       26
       +
           (define-key map "c" 'caledonia-query-calendars)

     

       27
       +
           (define-key map "t" 'caledonia-query-text)

     

       28
       +
           (define-key map "i" 'caledonia-query-id)

     

       29
       +
           (define-key map "r" 'caledonia-query-recurring)

     

       30
       +
           (define-key map "l" 'caledonia-query-limit)

     

       31
       +
           (define-key map "z" 'caledonia-query-timezone)

     

       32
       +
           map)

     

       33
       +
         "Evil mode keymap for filter commands in Caledonia mode.")

     

       34
       +
       

     

       35
       +
       (defun caledonia-evil--setup-evil-bindings ()

     

       36
       +
         "Set up Evil keybindings for `caledonia-mode`."

     

       37
       +
         (evil-define-key 'normal caledonia-mode-map

     

       38
       +
           (kbd "RET") 'caledonia-show-event

     

       39
       +
           (kbd "M-RET") 'caledonia-open-event-file

     

       40
       +
           "l" 'caledonia-list

     

       41
       +
           "s" 'caledonia-search

     

       42
       +
           "r" 'caledonia-refresh

     

       43
       +
           "q" 'quit-window

     

       44
       +
           "f" caledonia-evil-filter-map))

     

       45
       +
       

     

       46
       +
       (defun caledonia-evil--setup-evil-integration ()

     

       47
       +
         "Set up Evil integration for Caledonia mode."

     

       48
       +
         (when (bound-and-true-p evil-mode)

     

       49
       +
           (evil-make-overriding-map caledonia-mode-map 'normal)

     

       50
       +
           (evil-normalize-keymaps)

     

       51
       +
           (caledonia-evil--setup-evil-bindings)))

     

       52
       +
       

     

       53
       +
       (add-hook 'caledonia-mode-hook 'caledonia-evil--setup-evil-integration)

     

       54
       +
       

     

       55
       +
       (provide 'caledonia-evil)

     

       56
       +
       ;;; caledonia-evil.el ends here

+788

emacs/caledonia.el

···

       1
       +
       ;;; caledonia.el --- Emacs integration for Caledonia -*- lexical-binding: t -*-

     

       2
       +
       

     

       3
       +
       ;; Copyright (C) 2025 Ryan Gibb

     

       4
       +
       

     

       5
       +
       ;; Author: Ryan Gibb <ryan@freumh.org>

     

       6
       +
       ;; Maintainer: Ryan Gibb <ryan@freumh.org>

     

       7
       +
       ;; Version: 0.4.0

     

       8
       +
       ;; Keywords: calendar

     

       9
       +
       ;; Package-Requires: ((emacs "24.4"))

     

       10
       +
       ;; URL: https://ryan.freumh.org/caledonia.html

     

       11
       +
       

     

       12
       +
       ;; This file is not part of GNU Emacs.

     

       13
       +
       

     

       14
       +
       ;;; Commentary:

     

       15
       +
       

     

       16
       +
       ;; This package provides an Emacs interface to the Caledonia calendar CLI.

     

       17
       +
       ;; It communicates with Caledonia using S-expressions for data exchange.

     

       18
       +
       

     

       19
       +
       ;;; Code:

     

       20
       +
       

     

       21
       +
       (require 'cl-lib)

     

       22
       +
       (require 'calendar)

     

       23
       +
       (require 'pulse nil t)

     

       24
       +
       (require 'org)

     

       25
       +
       

     

       26
       +
       (defgroup caledonia nil

     

       27
       +
         "Interface to Caledonia calendar client."

     

       28
       +
         :group 'calendar

     

       29
       +
         :prefix "caledonia-")

     

       30
       +
       

     

       31
       +
       (defcustom caledonia-executable (executable-find "caled")

     

       32
       +
         "Path to the Caledonia executable."

     

       33
       +
         :type 'string

     

       34
       +
         :group 'caledonia)

     

       35
       +
       

     

       36
       +
       (defface caledonia-calendar-name-face

     

       37
       +
         '((t :inherit font-lock-function-name-face))

     

       38
       +
         "Face used for calendar names in the events view."

     

       39
       +
         :group 'caledonia)

     

       40
       +
       

     

       41
       +
       (defface caledonia-date-face

     

       42
       +
         '((t :inherit font-lock-string-face))

     

       43
       +
         "Face used for dates in the events view."

     

       44
       +
         :group 'caledonia)

     

       45
       +
       

     

       46
       +
       (defface caledonia-summary-face

     

       47
       +
         '((t :inherit default))

     

       48
       +
         "Face used for event summaries in the events view."

     

       49
       +
         :group 'caledonia)

     

       50
       +
       

     

       51
       +
       (defface caledonia-location-face

     

       52
       +
         '((t :inherit font-lock-comment-face))

     

       53
       +
         "Face used for event locations in the events view."

     

       54
       +
         :group 'caledonia)

     

       55
       +
       

     

       56
       +
       (defcustom caledonia-calendar-column-width 0

     

       57
       +
         "Column width for the Calendar entry."

     

       58
       +
         :type 'natnum)

     

       59
       +
       

     

       60
       +
       (defcustom caledonia-start-column-width 0

     

       61
       +
         "Column width for the Start entry."

     

       62
       +
         :type 'natnum)

     

       63
       +
       

     

       64
       +
       (defcustom caledonia-end-column-width 0

     

       65
       +
         "Column width for the End entry."

     

       66
       +
         :type 'natnum)

     

       67
       +
       

     

       68
       +
       (defcustom caledonia-list-from-date "today"

     

       69
       +
         "Default start date for calendar list view."

     

       70
       +
         :type 'string

     

       71
       +
         :group 'caledonia)

     

       72
       +
       

     

       73
       +
       (defcustom caledonia-list-to-date "+3m"

     

       74
       +
         "Default end date for calendar list view (3 months from today)."

     

       75
       +
         :type 'string

     

       76
       +
         :group 'caledonia)

     

       77
       +
       

     

       78
       +
       (defcustom caledonia-search-from-date nil

     

       79
       +
         "Default start date for calendar search; nil means no start date limit."

     

       80
       +
         :type 'string

     

       81
       +
         :group 'caledonia)

     

       82
       +
       

     

       83
       +
       (defcustom caledonia-search-to-date "+75y"

     

       84
       +
         "Default end date for calendar search (75 years from today)."

     

       85
       +
         :type 'string

     

       86
       +
         :group 'caledonia)

     

       87
       +
       

     

       88
       +
       ;; Define histories for input fields

     

       89
       +
       

     

       90
       +
       (defvar caledonia-from-history nil "History for from date inputs.")

     

       91
       +
       (defvar caledonia-to-history nil "History for to date inputs.")

     

       92
       +
       (defvar caledonia-timezone-history nil "History for timezone inputs.")

     

       93
       +
       (defvar caledonia-calendars-history nil "History for calendar inputs.")

     

       94
       +
       (defvar caledonia-text-history nil "History for search text inputs.")

     

       95
       +
       (defvar caledonia-search-fields-history nil "History for search fields inputs.")

     

       96
       +
       (defvar caledonia-id-history nil "History for event ID inputs.")

     

       97
       +
       (defvar caledonia-limit-history nil "History for limit inputs.")

     

       98
       +
       (defvar caledonia-search-prompt-history nil "History for search prompt inputs.")

     

       99
       +
       

     

       100
       +
       ;; Internal variables

     

       101
       +
       

     

       102
       +
       (defvar caledonia--events-buffer "*Caledonia Events*"

     

       103
       +
         "Buffer name for displaying Caledonia events.")

     

       104
       +
       (defvar caledonia--details-buffer "*Caledonia Event Details*"

     

       105
       +
         "Buffer name for displaying Caledonia event details.")

     

       106
       +
       (defvar caledonia--server-process nil

     

       107
       +
         "The persistent Caledonia server process.")

     

       108
       +
       (defvar caledonia--server-buffer-name "*caledonia-server-io*"

     

       109
       +
         "Buffer for server process I/O.")

     

       110
       +
       (defvar caledonia--response-line nil

     

       111
       +
         "Last response line received.")

     

       112
       +
       (defvar caledonia--response-flag nil

     

       113
       +
         "Non-nil means a responce has been recieved.")

     

       114
       +
       (defvar-local caledonia--current-query nil

     

       115
       +
         "The current query parameters being displayed in this buffer.")

     

       116
       +
       

     

       117
       +
       ;; API functions

     

       118
       +
       

     

       119
       +
       (defvar caledonia--server-line-buffer "")

     

       120
       +
       

     

       121
       +
       (defun caledonia--server-filter (process output)

     

       122
       +
         "Filter PROCESS OUTPUT."

     

       123
       +
         ;; Append to the ongoing buffer for logging/debugging

     

       124
       +
         (when (buffer-live-p (process-buffer process))

     

       125
       +
           (with-current-buffer (process-buffer process)

     

       126
       +
             (goto-char (point-max))

     

       127
       +
             (insert output)))

     

       128
       +
         ;; Append new output to line buffer

     

       129
       +
         (setq caledonia--server-line-buffer (concat caledonia--server-line-buffer output))

     

       130
       +
         ;; Extract full lines

     

       131
       +
         (let ((lines (split-string caledonia--server-line-buffer "\n")))

     

       132
       +
           ;; Keep the last line (possibly incomplete) for next round

     

       133
       +
           (setq caledonia--server-line-buffer (car (last lines)))

     

       134
       +
           ;; Process all complete lines

     

       135
       +
           (dolist (line (butlast lines))

     

       136
       +
             (when (and (not caledonia--response-flag)

     

       137
       +
                        (not (string-empty-p line)))

     

       138
       +
               (setq caledonia--response-line line)

     

       139
       +
               (setq caledonia--response-flag t)))))

     

       140
       +
       

     

       141
       +
       (defun caledonia--server-sentinel (process event)

     

       142
       +
         "Listen on PROCESS for an EVENT."

     

       143
       +
         (message "Caledonia Server process event: %s (%s)" process event)

     

       144
       +
         (setq caledonia--server-process nil))

     

       145
       +
       

     

       146
       +
       (defun caledonia--ensure-server-running ()

     

       147
       +
         "Run the caledonia binary in server mode."

     

       148
       +
         (unless (and caledonia--server-process (process-live-p caledonia--server-process))

     

       149
       +
           (message "Caledonia  Starting server...")

     

       150
       +
           (setq caledonia--server-process

     

       151
       +
                 (start-process "caledonia-server"

     

       152
       +
                                (get-buffer-create caledonia--server-buffer-name)

     

       153
       +
                                caledonia-executable

     

       154
       +
                                "server"))

     

       155
       +
           (unless (and caledonia--server-process (process-live-p caledonia--server-process))

     

       156
       +
             (error "Caledonia  Failed to start server process"))

     

       157
       +
           (set-process-filter caledonia--server-process #'caledonia--server-filter)

     

       158
       +
           (set-process-sentinel caledonia--server-process #'caledonia--server-sentinel)

     

       159
       +
           (message "Caledonia  Server started.")))

     

       160
       +
       

     

       161
       +
       (defun caledonia--send-request (request-str)

     

       162
       +
         "Send REQUEST-STR and get responce back."

     

       163
       +
         (caledonia--ensure-server-running)

     

       164
       +
         (setq caledonia--response-line nil)

     

       165
       +
         (setq caledonia--response-flag nil)

     

       166
       +
         (process-send-string caledonia--server-process (concat request-str "\n"))

     

       167
       +
         ;; Wait for response

     

       168
       +
         (let ((start-time (current-time)))

     

       169
       +
           (while (and (not caledonia--response-flag)

     

       170
       +
                       (< (time-to-seconds (time-since start-time)) 5) ; 5 sec timeout

     

       171
       +
                       (process-live-p caledonia--server-process))

     

       172
       +
             (accept-process-output caledonia--server-process 0 100000))) ; Wait 100ms

     

       173
       +
         (unless caledonia--response-flag

     

       174
       +
           (error "Caledonia  Timeout or server died waiting for response"))

     

       175
       +
         (condition-case err

     

       176
       +
             (let ((response-sexp (read caledonia--response-line)))

     

       177
       +
               (unless (and (listp response-sexp) (memq (car response-sexp) '(Ok Error)))

     

       178
       +
                 (error "Caledonia  Invalid response format: %S" response-sexp))

     

       179
       +
               (if (eq (car response-sexp) 'Error)

     

       180
       +
                   (error "Caledonia Server Error: %s" (cadr response-sexp))

     

       181
       +
                 ;; Return the (Ok ...) payload

     

       182
       +
                 (cadr response-sexp)))

     

       183
       +
           (error "Caledonia Failed to parse response line: %s"

     

       184
       +
                  caledonia--response-line (error-message-string err))))

     

       185
       +
       

     

       186
       +
       (defun caledonia--get-events (event-payload)

     

       187
       +
         "Parse EVENT-PAYLOAD of structure (Events (events...))."

     

       188
       +
         (if (and (listp event-payload) (eq (car event-payload) 'Events))

     

       189
       +
             (let ((event-list (cadr event-payload)))

     

       190
       +
               event-list)

     

       191
       +
           (error

     

       192
       +
            (message "Failed to parse Caledonia output: %s" (error-message-string err))

     

       193
       +
            nil)))

     

       194
       +
       

     

       195
       +
       ;; UI functions

     

       196
       +
       

     

       197
       +
       (defun caledonia--format-timestamp (iso-string &optional format)

     

       198
       +
         "Format ISO-8601 time string ISO-STRING to human-readable format.

     

       199
       +
       FORMAT defaults to \"%Y-%m-%d %H:%M\" if not specified."

     

       200
       +
         (let* ((parsed (parse-time-string iso-string))

     

       201
       +
                (time (apply #'encode-time

     

       202
       +
                             (append (cl-subseq parsed 0 6) (list nil -1)))))

     

       203
       +
           (format-time-string (or format "%Y-%m-%d %H:%M") time)))

     

       204
       +
       

     

       205
       +
       (defun caledonia--get-key (key event)

     

       206
       +
         "Get KEY from EVENT as a string."

     

       207
       +
         (let ((value (cadr (assoc key event))))

     

       208
       +
           (cond

     

       209
       +
            ((null value) nil)

     

       210
       +
            ((stringp value) value)

     

       211
       +
            ((symbolp value) (symbol-name value)))))

     

       212
       +
       

     

       213
       +
       (defun caledonia--tabulated-list-entries (events)

     

       214
       +
         "Convert EVENTS for a format suitable for showing via a tabulated-list-mode'."

     

       215
       +
         (let ((max-calendar-width 0)

     

       216
       +
               (max-start-width 0)

     

       217
       +
               (max-end-width 0)

     

       218
       +
               (tabulated-list-entries nil))

     

       219
       +
           ;; first pass: calculate maximum widths

     

       220
       +
           (dolist (event events)

     

       221
       +
             (let* ((calendar (caledonia--get-key 'calendar event))

     

       222
       +
                    (start (caledonia--get-key 'start event))

     

       223
       +
                    (end (caledonia--get-key 'end event))

     

       224
       +
                    (cal-str (if (not calendar) "unkown" calendar))

     

       225
       +
                    (start-str (caledonia--format-timestamp start))

     

       226
       +
                    (end-str (when end

     

       227
       +
                               (caledonia--format-timestamp (format "%s" end)))))

     

       228
       +
               (setq max-calendar-width (max max-calendar-width (length cal-str)))

     

       229
       +
               (setq max-start-width (max max-start-width (+ (length start-str) 2)))

     

       230
       +
               (setq max-end-width (max max-end-width (length end-str)))))

     

       231
       +
           (setq caledonia-calendar-column-width  (max max-calendar-width (length "Calendar")))

     

       232
       +
           (setq caledonia-start-column-width (max max-start-width (length "Start")))

     

       233
       +
           (setq caledonia-end-column-width  (max max-end-width (length "End")))

     

       234
       +
           ;; second pass: prepare tabulated-list entries with properties

     

       235
       +
           (setq tabulated-list-entries

     

       236
       +
                 (mapcar (lambda (event)

     

       237
       +
                           (let* (

     

       238
       +
                                  (id (caledonia--get-key 'id event))

     

       239
       +
                                  (summary (caledonia--get-key 'summary event))

     

       240
       +
                                  (start (caledonia--get-key 'start event))

     

       241
       +
                                  (end (caledonia--get-key 'end event))

     

       242
       +
                                  (location (caledonia--get-key 'location event))

     

       243
       +
                                  (calendar (caledonia--get-key 'calendar event))

     

       244
       +
                                  (start-str (caledonia--format-timestamp start))

     

       245
       +
                                  (end-str (if end (caledonia--format-timestamp (format "%s" end)) ""))

     

       246
       +
                                  (start-str (if end (format "%s -" start-str) start-str))

     

       247
       +
                                  (location-str (if location (concat " @ " location) ""))

     

       248
       +
                                  (cal-prop (propertize calendar 'face 'caledonia-calendar-name-face))

     

       249
       +
                                  (start-prop (propertize start-str 'face 'caledonia-date-face))

     

       250
       +
                                  (end-prop (propertize end-str 'face 'caledonia-date-face))

     

       251
       +
                                  (summary-prop (propertize (concat summary location-str)

     

       252
       +
                                                            'face 'caledonia-summary-face))

     

       253
       +
                                  ;; Store the full event data as a text property for retrieval

     

       254
       +
                                  (entry-id (propertize (format "%s" id) 'event-data event)))

     

       255
       +
                             (list entry-id (vector cal-prop start-prop end-prop summary-prop))))

     

       256
       +
                         events))

     

       257
       +
           tabulated-list-entries))

     

       258
       +
       

     

       259
       +
       (defun caledonia--sort-calendar (A B)

     

       260
       +
         "Sort function for calendar column between A and B."

     

       261
       +
         (let ((a (aref (cadr A) 0))

     

       262
       +
               (b (aref (cadr B) 0)))

     

       263
       +
           (string< a b)))

     

       264
       +
       

     

       265
       +
       (defun caledonia--sort-start (A B)

     

       266
       +
         "Sort function for date/time column between A and B."

     

       267
       +
         (let ((a (aref (cadr A) 1))

     

       268
       +
               (b (aref (cadr B) 1)))

     

       269
       +
           (time-less-p (date-to-time a) (date-to-time b))))

     

       270
       +
       

     

       271
       +
       (defun caledonia--sort-end (A B)

     

       272
       +
         "Sort function for date/time column between A and B."

     

       273
       +
         (let ((a (aref (cadr A) 2))

     

       274
       +
               (b (aref (cadr B) 2)))

     

       275
       +
           (time-less-p (date-to-time a) (date-to-time b))))

     

       276
       +
       

     

       277
       +
       (defun caledonia--make-query (&optional query)

     

       278
       +
         "Make a query with the QUERY S-expression.

     

       279
       +
       If QUERY is nil, use the current query stored in `caledonia--current-query`."

     

       280
       +
         (interactive)

     

       281
       +
         (let* ((query-to-use (or query caledonia--current-query '()))  ;; Use current query if available

     

       282
       +
                ;; Ensure to date is set if not present in query

     

       283
       +
                (query-to-use (if (assq 'to query-to-use)

     

       284
       +
                                  query-to-use

     

       285
       +
                                (cons `(to ,caledonia-list-to-date) query-to-use)))

     

       286
       +
                (request-str (format "(Query %s)" (prin1-to-string query-to-use)))

     

       287
       +
                (payload (caledonia--send-request request-str))

     

       288
       +
                (events (caledonia--get-events payload))

     

       289
       +
                (entries (caledonia--tabulated-list-entries events)))

     

       290
       +
           ;; Save this query for future refreshes if explicitly provided

     

       291
       +
           (when query

     

       292
       +
             (setq-local caledonia--current-query query-to-use))

     

       293
       +
           (setq tabulated-list-entries entries))

     

       294
       +
         (setq tabulated-list-format

     

       295
       +
               `[("Calendar" ,caledonia-calendar-column-width caledonia--sort-calendar)

     

       296
       +
                 ("Start" ,caledonia-start-column-width caledonia--sort-start)

     

       297
       +
                 ("End" ,caledonia-end-column-width caledonia--sort-end)

     

       298
       +
                 ("Summary" 0 t)])

     

       299
       +
         (setq tabulated-list-sort-key (cons "Start" nil))

     

       300
       +
         (tabulated-list-init-header)

     

       301
       +
         (tabulated-list-print t))

     

       302
       +
       

     

       303
       +
       (defun caledonia--find-and-highlight-event-in-file (file event-id)

     

       304
       +
         "Find EVENT-ID in FILE, position cursor, and highlight the event.

     

       305
       +
       Return non-nil if the event was found."

     

       306
       +
         (when (and file event-id)

     

       307
       +
           (let ((id-str (format "%s" event-id))

     

       308
       +
                 (found nil))

     

       309
       +
             ;; Try to find and highlight iCalendar VEVENT block

     

       310
       +
             (goto-char (point-min))

     

       311
       +
             (when (and (string-match-p "\\.ics$" file)

     

       312
       +
                        (search-forward (format "UID:%s" id-str) nil t))

     

       313
       +
               ;; Found the UID in an ICS file, try to highlight the VEVENT block

     

       314
       +
               (let ((uid-pos (match-beginning 0))

     

       315
       +
                     (vevent-start nil)

     

       316
       +
                     (vevent-end nil))

     

       317
       +
                 ;; Find start of the VEVENT block

     

       318
       +
                 (save-excursion

     

       319
       +
                   (goto-char uid-pos)

     

       320
       +
                   (if (search-backward "BEGIN:VEVENT" nil t)

     

       321
       +
                       (setq vevent-start (match-beginning 0))

     

       322
       +
                     (setq vevent-start uid-pos)))

     

       323
       +
                 ;; Find end of the VEVENT block

     

       324
       +
                 (save-excursion

     

       325
       +
                   (goto-char uid-pos)

     

       326
       +
                   (if (search-forward "END:VEVENT" nil t)

     

       327
       +
                       (setq vevent-end (match-end 0))

     

       328
       +
                     (setq vevent-end (line-end-position))))

     

       329
       +
                 ;; Highlight the whole VEVENT block if found

     

       330
       +
                 (when (and vevent-start vevent-end)

     

       331
       +
                   (goto-char vevent-start)

     

       332
       +
                   (caledonia--highlight-region vevent-start vevent-end)

     

       333
       +
                   (recenter)

     

       334
       +
                   (setq found t))))

     

       335
       +
             (unless found

     

       336
       +
               (message "Event ID not found in file"))

     

       337
       +
             found)))

     

       338
       +
       

     

       339
       +
       (defun caledonia--display-event-details (event)

     

       340
       +
         "Display details for EVENT in a separate buffer."

     

       341
       +
         (let ((buf (get-buffer-create caledonia--details-buffer)))

     

       342
       +
           (with-current-buffer buf

     

       343
       +
             (let ((inhibit-read-only t))

     

       344
       +
               (erase-buffer)

     

       345
       +
               (special-mode)

     

       346
       +
               (let* ((id (caledonia--get-key 'id event))

     

       347
       +
                      (summary (caledonia--get-key 'summary event))

     

       348
       +
                      (description (caledonia--get-key 'description event))

     

       349
       +
                      (start (caledonia--get-key 'start event))

     

       350
       +
                      (end (caledonia--get-key 'end event))

     

       351
       +
                      (location (caledonia--get-key 'location event))

     

       352
       +
                      (calendar (caledonia--get-key 'calendar event))

     

       353
       +
                      (file (caledonia--get-key 'file event))

     

       354
       +
                      (start-str (when start (caledonia--format-timestamp start)))

     

       355
       +
                      (end-str (when end (caledonia--format-timestamp end))))

     

       356
       +
                 (when id

     

       357
       +
                   (insert (propertize "Summary: " 'face 'bold) summary "\n"))

     

       358
       +
                 (when id

     

       359
       +
                   (insert (propertize "ID: " 'face 'bold) id "\n"))

     

       360
       +
                 (when calendar

     

       361
       +
                   (insert (propertize "Calendar: " 'face 'bold) calendar "\n"))

     

       362
       +
                 (when start-str

     

       363
       +
                   (insert (propertize "Start: " 'face 'bold) start-str "\n"))

     

       364
       +
                 (when end-str

     

       365
       +
                   (insert (propertize "End: " 'face 'bold) end-str "\n"))

     

       366
       +
                 (when location

     

       367
       +
                   (insert (propertize "Location: " 'face 'bold) location "\n"))

     

       368
       +
                 (when file

     

       369
       +
                   (insert (propertize "File: " 'face 'bold)

     

       370
       +
                           (propertize file 'face 'link

     

       371
       +
                                       'mouse-face 'highlight

     

       372
       +
                                       'help-echo "Click to open file with highlighting"

     

       373
       +
                                       'keymap (let ((map (make-sparse-keymap))

     

       374
       +
                                                     (event-copy event))

     

       375
       +
                                                 (define-key map [mouse-1]

     

       376
       +
                                                             (lambda ()

     

       377
       +
                                                               (interactive)

     

       378
       +
                                                               (let ((file-path file)

     

       379
       +
                                                                     (id-val (caledonia--get-key 'id event-copy)))

     

       380
       +
                                                                 (find-file file-path)

     

       381
       +
                                                                 (caledonia--find-and-highlight-event-in-file

     

       382
       +
                                                                  file-path id-val))))

     

       383
       +
                                                 (define-key map (kbd "RET")

     

       384
       +
                                                             (lambda ()

     

       385
       +
                                                               (interactive)

     

       386
       +
                                                               (let ((file-path file)

     

       387
       +
                                                                     (id-val (caledonia--get-key 'id event-copy)))

     

       388
       +
                                                                 (find-file file-path)

     

       389
       +
                                                                 (caledonia--find-and-highlight-event-in-file

     

       390
       +
                                                                  file-path id-val))))

     

       391
       +
                                                 map))

     

       392
       +
                           "\n"))

     

       393
       +
                 (when description

     

       394
       +
                   (insert "\n" (propertize "Description:" 'face 'bold) "\n"

     

       395
       +
                           (propertize "------------" 'face 'bold) "\n"

     

       396
       +
                           description "\n")))))

     

       397
       +
           (switch-to-buffer-other-window buf)))

     

       398
       +
       

     

       399
       +
       (defun caledonia--highlight-region (start end)

     

       400
       +
         "Highlight the region between START and END."

     

       401
       +
         (when (fboundp 'pulse-momentary-highlight-region)

     

       402
       +
           (pulse-momentary-highlight-region start end))

     

       403
       +
         ;; Fallback for when pulse is not available

     

       404
       +
         (unless (fboundp 'pulse-momentary-highlight-region)

     

       405
       +
           (let ((overlay (make-overlay start end)))

     

       406
       +
             (overlay-put overlay 'face 'highlight)

     

       407
       +
             (run-with-timer 0.5 nil (lambda () (delete-overlay overlay))))))

     

       408
       +
       

     

       409
       +
       (defun caledonia--read-date-range ()

     

       410
       +
         "Read a date range from the user with `org-mode' date picker integration.

     

       411
       +
       Returns a cons cell (from-date . to-date).

     

       412
       +
       The from-date can be nil to indicate no start date constraint."

     

       413
       +
         (let (from to)

     

       414
       +
           (setq from

     

       415
       +
                 (if (y-or-n-p "Set a start date? ")

     

       416
       +
                     (org-read-date nil nil nil "From date: " nil nil t)

     

       417
       +
                                               ; empty string differentiates from nil for optional args later on

     

       418
       +
                   ""))

     

       419
       +
           ;; Use org-mode's date picker for To date (must have a value)

     

       420
       +
           (setq to (org-read-date nil nil nil "To date: " nil nil t))

     

       421
       +
           (cons from to)))

     

       422
       +
       

     

       423
       +
       ;; Query parameter modification functions

     

       424
       +
       

     

       425
       +
       (defun caledonia-query-date-range ()

     

       426
       +
         "Set the date range for the current calendar view."

     

       427
       +
         (interactive)

     

       428
       +
         (when (eq major-mode 'caledonia-mode)

     

       429
       +
           (let* ((dates (caledonia--read-date-range))

     

       430
       +
                  (from (car dates))

     

       431
       +
                  (to (cdr dates))

     

       432
       +
                  (current-query caledonia--current-query)

     

       433
       +
                  (new-query (copy-tree current-query)))

     

       434
       +
             ;; Update the query with the new date range

     

       435
       +
             (setq new-query (assq-delete-all 'from new-query))

     

       436
       +
             (setq new-query (assq-delete-all 'to new-query))

     

       437
       +
             (when (and from (not (string-empty-p from)))

     

       438
       +
               (push `(from ,from) new-query))

     

       439
       +
             (when (and to (not (string-empty-p to)))

     

       440
       +
               (push `(to ,to) new-query))

     

       441
       +
             ;; Execute the updated query

     

       442
       +
             (caledonia--make-query new-query))))

     

       443
       +
       

     

       444
       +
       (defun caledonia-query-calendars ()

     

       445
       +
         "Set the calendars to filter by for the current calendar view.

     

       446
       +
       Fetches available calendars from server to allow selection from a list."

     

       447
       +
         (interactive)

     

       448
       +
         (when (eq major-mode 'caledonia-mode)

     

       449
       +
           (let* ((available-calendars

     

       450
       +
                   (caledonia--send-request "ListCalendars"))

     

       451
       +
                  (calendars-list

     

       452
       +
                   (if (and (listp available-calendars)

     

       453
       +
                            (eq (car available-calendars) 'Calendars))

     

       454
       +
                       (cadr available-calendars)

     

       455
       +
                     (progn

     

       456
       +
                       (message "Failed to get calendar list from server")

     

       457
       +
                       nil)))

     

       458
       +
                  ;; Use completing-read-multiple to select from available calendars

     

       459
       +
                  (selected-calendars

     

       460
       +
                   (completing-read-multiple

     

       461
       +
                    "Select calendars (comma-separated, empty for all): "

     

       462
       +
                    ;; Use empty list if no calendars found

     

       463
       +
                    (or calendars-list '())

     

       464
       +
                    nil nil

     

       465
       +
                    (let ((current-calendars (cdr (assq 'calendars caledonia--current-query))))

     

       466
       +
                      (when current-calendars

     

       467
       +
                        (mapconcat #'identity current-calendars ",")))

     

       468
       +
                    'caledonia-calendars-history))

     

       469
       +
                  (calendars (mapcar #'string-trim selected-calendars))

     

       470
       +
                  (current-query caledonia--current-query)

     

       471
       +
                  (new-query (copy-tree current-query)))

     

       472
       +
             ;; Update the query with the new calendars

     

       473
       +
             (setq new-query (assq-delete-all 'calendars new-query))

     

       474
       +
             (when (and calendars (not (null calendars)))

     

       475
       +
               (push `(calendars ,calendars) new-query))

     

       476
       +
             ;; Execute the updated query

     

       477
       +
             (caledonia--make-query new-query))))

     

       478
       +
       

     

       479
       +
       (defun caledonia-query-text ()

     

       480
       +
         "Set the search text for the current calendar view."

     

       481
       +
         (interactive)

     

       482
       +
         (when (eq major-mode 'caledonia-mode)

     

       483
       +
           (let* ((text (read-string "Search text (leave empty for no text search): "

     

       484
       +
                                     nil 'caledonia-text-history))

     

       485
       +
                  (search-in-str (when (and text (not (string-empty-p text)))

     

       486
       +
                                   (read-string "Search in (summary,description,location - leave empty for all): "

     

       487
       +
                                                nil 'caledonia-search-fields-history)))

     

       488
       +
                  (search-in (when (and search-in-str (not (string-empty-p search-in-str)))

     

       489
       +
                               (mapcar (lambda (field)

     

       490
       +
                                         (intern (string-trim field)))

     

       491
       +
                                       (split-string search-in-str "," t))))

     

       492
       +
                  (current-query caledonia--current-query)

     

       493
       +
                  (new-query (copy-tree current-query)))

     

       494
       +
             ;; Update the query with the new text search parameters

     

       495
       +
             (setq new-query (assq-delete-all 'text new-query))

     

       496
       +
             (setq new-query (assq-delete-all 'search_in new-query))

     

       497
       +
             (when (and text (not (string-empty-p text)))

     

       498
       +
               (push `(text ,text) new-query))

     

       499
       +
             (when search-in

     

       500
       +
               (push `(search_in ,search-in) new-query))

     

       501
       +
             ;; Execute the updated query

     

       502
       +
             (caledonia--make-query new-query))))

     

       503
       +
       

     

       504
       +
       (defun caledonia-query-id ()

     

       505
       +
         "Set the event ID to filter by for the current calendar view."

     

       506
       +
         (interactive)

     

       507
       +
         (when (eq major-mode 'caledonia-mode)

     

       508
       +
           (let* ((id (read-string "Event ID (leave empty for all events): "

     

       509
       +
                                   nil 'caledonia-id-history))

     

       510
       +
                  (current-query caledonia--current-query)

     

       511
       +
                  (new-query (copy-tree current-query)))

     

       512
       +
             ;; Update the query with the new ID

     

       513
       +
             (setq new-query (assq-delete-all 'id new-query))

     

       514
       +
             (when (and id (not (string-empty-p id)))

     

       515
       +
               (push `(id ,id) new-query))

     

       516
       +
             ;; Execute the updated query

     

       517
       +
             (caledonia--make-query new-query))))

     

       518
       +
       

     

       519
       +
       (defun caledonia-query-recurring ()

     

       520
       +
         "Set whether to filter by recurring events for the current calendar view."

     

       521
       +
         (interactive)

     

       522
       +
         (when (eq major-mode 'caledonia-mode)

     

       523
       +
           (let* ((recurring (completing-read "Recurring events (yes/no/all, leave empty for all): "

     

       524
       +
                                              '("" "yes" "no") nil nil nil))

     

       525
       +
                  (current-query caledonia--current-query)

     

       526
       +
                  (new-query (copy-tree current-query)))

     

       527
       +
             ;; Update the query with the recurring filter

     

       528
       +
             (setq new-query (assq-delete-all 'recurring new-query))

     

       529
       +
             (when (not (string-empty-p recurring))

     

       530
       +
               (push `(recurring ,(if (string= recurring "yes") t nil)) new-query))

     

       531
       +
             ;; Execute the updated query

     

       532
       +
             (caledonia--make-query new-query))))

     

       533
       +
       

     

       534
       +
       (defun caledonia-query-limit ()

     

       535
       +
         "Set the maximum number of events to show in the current calendar view."

     

       536
       +
         (interactive)

     

       537
       +
         (when (eq major-mode 'caledonia-mode)

     

       538
       +
           (let* ((limit-str (read-string "Maximum events to show (leave empty for no limit): "

     

       539
       +
                                          nil 'caledonia-limit-history))

     

       540
       +
                  (limit (when (and limit-str (not (string-empty-p limit-str)))

     

       541
       +
                           (string-to-number limit-str)))

     

       542
       +
                  (current-query caledonia--current-query)

     

       543
       +
                  (new-query (copy-tree current-query)))

     

       544
       +
             ;; Update the query with the new limit

     

       545
       +
             (setq new-query (assq-delete-all 'limit new-query))

     

       546
       +
             (when limit

     

       547
       +
               (push `(limit ,limit) new-query))

     

       548
       +
             ;; Execute the updated query

     

       549
       +
             (caledonia--make-query new-query))))

     

       550
       +
       

     

       551
       +
       (defun caledonia-query-timezone ()

     

       552
       +
         "Set the timezone for the current calendar view."

     

       553
       +
         (interactive)

     

       554
       +
         (when (eq major-mode 'caledonia-mode)

     

       555
       +
           (let* ((timezone-str (read-string "Timezone (e.g. Europe/London, leave empty for default): "

     

       556
       +
                                             nil 'caledonia-timezone-history))

     

       557
       +
                  (timezone (when (not (string-empty-p timezone-str)) timezone-str))

     

       558
       +
                  (current-query caledonia--current-query)

     

       559
       +
                  (new-query (copy-tree current-query)))

     

       560
       +
             ;; Update the query with the new timezone

     

       561
       +
             (setq new-query (assq-delete-all 'timezone new-query))

     

       562
       +
             (when timezone

     

       563
       +
               (push `(timezone ,timezone) new-query))

     

       564
       +
             ;; Execute the updated query

     

       565
       +
             (caledonia--make-query new-query))))

     

       566
       +
       

     

       567
       +
       ;; Buffer functions

     

       568
       +
       

     

       569
       +
       (defun caledonia-show-event ()

     

       570
       +
         "Show details for the event at point in a separate buffer."

     

       571
       +
         (interactive)

     

       572
       +
         (when (eq major-mode 'caledonia-mode)

     

       573
       +
           (let* ((id (tabulated-list-get-id))

     

       574
       +
                  (event (when id (get-text-property 0 'event-data id))))

     

       575
       +
             (if event

     

       576
       +
                 (caledonia--display-event-details event)

     

       577
       +
               (message "No event at point")))))

     

       578
       +
       

     

       579
       +
       (defun caledonia-open-event-file ()

     

       580
       +
         "Open the file associated with the event at point.

     

       581
       +
       If the file contains the event ID, the cursor will be positioned at that

     

       582
       +
       location."

     

       583
       +
         (interactive)

     

       584
       +
         (when (eq major-mode 'caledonia-mode)

     

       585
       +
           (let* ((id (tabulated-list-get-id))

     

       586
       +
                  (event (when id (get-text-property 0 'event-data id)))

     

       587
       +
                  (file (when event (caledonia--get-key 'file event)))

     

       588
       +
                  (event-id (when event (caledonia--get-key 'id event))))

     

       589
       +
             (cond

     

       590
       +
              ((not event)

     

       591
       +
               (message "No event at point"))

     

       592
       +
              ((not file)

     

       593
       +
               (message "No file associated with this event"))

     

       594
       +
              ((not (file-exists-p file))

     

       595
       +
               (message "File does not exist: %s" file))

     

       596
       +
              (t

     

       597
       +
               (find-file file)

     

       598
       +
               (caledonia--find-and-highlight-event-in-file file event-id))))))

     

       599
       +
       

     

       600
       +
       (defun caledonia-refresh ()

     

       601
       +
         "Refresh calendar data from disk and update the current view.

     

       602
       +
       This is useful when calendar files have been modified outside Emacs."

     

       603
       +
         (interactive)

     

       604
       +
         (when (eq major-mode 'caledonia-mode)

     

       605
       +
           ;; Send a refresh command to clear the server's cache

     

       606
       +
           (caledonia--send-request "Refresh")

     

       607
       +
           ;; Re-apply the current query to update the view

     

       608
       +
           (when (string= (buffer-name) caledonia--events-buffer)

     

       609
       +
             ;; Just use caledonia--make-query without args to use the stored query

     

       610
       +
             (caledonia--make-query))))

     

       611
       +
       

     

       612
       +
       ;; Entry functions

     

       613
       +
       

     

       614
       +
       (defun caledonia-query ()

     

       615
       +
         "Query events with interactive prompts for all filter parameters.

     

       616
       +
       Opens a series of prompts to build a complete query and then displays the

     

       617
       +
       results. After the initial query is displayed, you can further refine the

     

       618
       +
       results using the caledonia-query-* family of functions."

     

       619
       +
         (interactive)

     

       620
       +
         (let* (

     

       621
       +
                (dates (caledonia--read-date-range))

     

       622
       +
                (from (car dates))

     

       623
       +
                (to (cdr dates))

     

       624
       +
                (timezone-str (read-string "Timezone (e.g. Europe/London, leave empty for default): "

     

       625
       +
                                           nil 'caledonia-timezone-history))

     

       626
       +
                (timezone (when (not (string-empty-p timezone-str)) timezone-str))

     

       627
       +
                (available-calendars

     

       628
       +
                 (caledonia--send-request "ListCalendars"))

     

       629
       +
                (calendars-list

     

       630
       +
                 (if (and (listp available-calendars)

     

       631
       +
                          (eq (car available-calendars) 'Calendars))

     

       632
       +
                     (cadr available-calendars)

     

       633
       +
                   (progn

     

       634
       +
                     (message "Failed to get calendar list from server")

     

       635
       +
                     nil)))

     

       636
       +
                (selected-calendars

     

       637
       +
                 (completing-read-multiple

     

       638
       +
                  "Select calendars (comma-separated, empty for all): "

     

       639
       +
                  (or calendars-list '()) nil nil nil 'caledonia-calendars-history))

     

       640
       +
                (calendars (mapcar #'string-trim selected-calendars))

     

       641
       +
                (text (read-string "Search text (leave empty for no text search): "

     

       642
       +
                                   nil 'caledonia-text-history))

     

       643
       +
                (search-in-str (when (and text (not (string-empty-p text)))

     

       644
       +
                                 (read-string "Search in (summary,description,location - leave empty for all): "

     

       645
       +
                                              nil 'caledonia-search-fields-history)))

     

       646
       +
                (search-in (when (and search-in-str (not (string-empty-p search-in-str)))

     

       647
       +
                             (mapcar (lambda (field)

     

       648
       +
                                       (intern (string-trim field)))

     

       649
       +
                                     (split-string search-in-str "," t))))

     

       650
       +
                (id (read-string "Event ID (leave empty for all events): "

     

       651
       +
                                 nil 'caledonia-id-history))

     

       652
       +
                (recurring (completing-read "Recurring events (yes/no/all, leave empty for all): "

     

       653
       +
                                            '("" "yes" "no") nil nil nil))

     

       654
       +
                (limit-str (read-string "Maximum events to show (leave empty for no limit): "

     

       655
       +
                                        nil 'caledonia-limit-history))

     

       656
       +
                (limit (when (and limit-str (not (string-empty-p limit-str)))

     

       657
       +
                         (string-to-number limit-str)))

     

       658
       +
                (query nil))

     

       659
       +
           ;; Build query based on parameters

     

       660
       +
           (when (and from (not (string-empty-p from)))

     

       661
       +
             (push `(from ,from) query))

     

       662
       +
           (when (and to (not (string-empty-p to)))

     

       663
       +
             (push `(to ,to) query))

     

       664
       +
           (when timezone

     

       665
       +
             (push `(timezone ,timezone) query))

     

       666
       +
           (when calendars

     

       667
       +
             (push `(calendars ,calendars) query))

     

       668
       +
           (when (and text (not (string-empty-p text)))

     

       669
       +
             (push `(text ,text) query))

     

       670
       +
           (when search-in

     

       671
       +
             (push `(search_in ,search-in) query))

     

       672
       +
           (when (and id (not (string-empty-p id)))

     

       673
       +
             (push `(id ,id) query))

     

       674
       +
           (when (not (string-empty-p recurring))

     

       675
       +
             (push `(recurring ,(if (string= recurring "yes") t nil)) query))

     

       676
       +
           (when limit

     

       677
       +
             (push `(limit ,limit) query))

     

       678
       +
           ;; Create buffer and execute query

     

       679
       +
           (let ((buffer (get-buffer-create caledonia--events-buffer)))

     

       680
       +
             (with-current-buffer buffer

     

       681
       +
               ;; Clear the buffer and reset it

     

       682
       +
               (let ((inhibit-read-only t))

     

       683
       +
                 (erase-buffer))

     

       684
       +
               ;; Activate our mode and make the query

     

       685
       +
               (caledonia-mode)

     

       686
       +
               (caledonia--make-query query)

     

       687
       +
               (switch-to-buffer buffer)))))

     

       688
       +
       

     

       689
       +
       (defun caledonia-list (&optional from-date to-date)

     

       690
       +
         "List calendar in a new buffer within the default date range.

     

       691
       +
       FROM-DATE and TO-DATE override the default date range if provided. TO-DATE is

     

       692
       +
       required and will use a default if not specified. With prefix arg, prompts for

     

       693
       +
       the date range with an interactive calendar."

     

       694
       +
         (interactive

     

       695
       +
          (when current-prefix-arg

     

       696
       +
            (let* ((dates (caledonia--read-date-range)))

     

       697
       +
              (list (car dates) (cdr dates)))))

     

       698
       +
         (let ((buffer (get-buffer-create caledonia--events-buffer))

     

       699
       +
               (from (or from-date caledonia-list-from-date))

     

       700
       +
               ;; Ensure to date is always provided

     

       701
       +
               (to (or (and to-date (not (string-empty-p to-date)) to-date)

     

       702
       +
                       caledonia-list-to-date)))

     

       703
       +
           (with-current-buffer buffer

     

       704
       +
             ;; Clear the buffer and reset it

     

       705
       +
             (let ((inhibit-read-only t))

     

       706
       +
               (erase-buffer))

     

       707
       +
             ;; Build the query

     

       708
       +
             (let* ((query `((to ,to))))

     

       709
       +
               ;; Add from date only if specified

     

       710
       +
               (when (and from (not (string-empty-p from)))

     

       711
       +
                 (setq query (append query `((from ,from)))))

     

       712
       +
               ;; Activate our mode and make the query

     

       713
       +
               (caledonia-mode)

     

       714
       +
               (caledonia--make-query query)

     

       715
       +
               (switch-to-buffer buffer)))))

     

       716
       +
       

     

       717
       +
       (defun caledonia-search (&optional expr from-date to-date)

     

       718
       +
         "Search for query EXPR with optional FROM-DATE and TO-DATE.

     

       719
       +
       This is an interactive function which asks user for EXPR if not passed as an

     

       720
       +
       argument. With prefix arg, also prompts for date range with an interactive

     

       721
       +
       calendar. Use this to find events matching specific text across all calendars.

     

       722
       +
       TO-DATE is required; a default will be used if not provided."

     

       723
       +
         (interactive

     

       724
       +
          (let* ((search-text (read-string "Search for: " nil 'caledonia-search-prompt-history))

     

       725
       +
                 (dates (when current-prefix-arg (caledonia--read-date-range))))

     

       726
       +
            (list search-text

     

       727
       +
                  (when current-prefix-arg (car dates))

     

       728
       +
                  (when current-prefix-arg (cdr dates)))))

     

       729
       +
         (let ((buffer (get-buffer-create caledonia--events-buffer))

     

       730
       +
               (from (or from-date caledonia-search-from-date))

     

       731
       +
               (to (or to-date caledonia-search-to-date)))

     

       732
       +
           (with-current-buffer buffer

     

       733
       +
             ;; Clear the buffer and reset it

     

       734
       +
             (let ((inhibit-read-only t))

     

       735
       +
               (erase-buffer))

     

       736
       +
             ;; Build the query

     

       737
       +
             (let* ((query `((text ,expr)(to ,to))))

     

       738
       +
               ;; Add from date only if specified

     

       739
       +
               (when (and from (not (string-empty-p from)))

     

       740
       +
                 (setq query (append query `((from ,from)))))

     

       741
       +
               ;; Activate our mode and make the query

     

       742
       +
               (caledonia-mode)

     

       743
       +
               (caledonia--make-query query)

     

       744
       +
               (switch-to-buffer buffer)))))

     

       745
       +
       

     

       746
       +
       ;; Modes

     

       747
       +
       ;;;###autoload

     

       748
       +
       

     

       749
       +
       ;; Create a filter prefix map for query refinement

     

       750
       +
       (defvar caledonia-filter-map

     

       751
       +
         (let ((map (make-sparse-keymap)))

     

       752
       +
           (define-key map (kbd "d") 'caledonia-query-date-range)

     

       753
       +
           (define-key map (kbd "c") 'caledonia-query-calendars)

     

       754
       +
           (define-key map (kbd "t") 'caledonia-query-text)

     

       755
       +
           (define-key map (kbd "i") 'caledonia-query-id)

     

       756
       +
           (define-key map (kbd "r") 'caledonia-query-recurring)

     

       757
       +
           (define-key map (kbd "l") 'caledonia-query-limit)

     

       758
       +
           (define-key map (kbd "z") 'caledonia-query-timezone)

     

       759
       +
           map)

     

       760
       +
         "Keymap for filter commands in Caledonia mode.")

     

       761
       +
       

     

       762
       +
       (defvar caledonia-mode-map

     

       763
       +
         (let ((map (make-sparse-keymap)))

     

       764
       +
           (set-keymap-parent map tabulated-list-mode-map)

     

       765
       +
           (define-key map (kbd "RET") 'caledonia-show-event)

     

       766
       +
           (define-key map (kbd "M-RET") 'caledonia-open-event-file)

     

       767
       +
           (define-key map (kbd "l") 'caledonia-list)

     

       768
       +
           (define-key map (kbd "s") 'caledonia-search)

     

       769
       +
           (define-key map (kbd "r") 'caledonia-refresh)

     

       770
       +
           (define-key map (kbd "q") 'quit-window)

     

       771
       +
           ;; Individual filter command bindings

     

       772
       +
           (define-key map (kbd "C-c d") 'caledonia-query-date-range)

     

       773
       +
           (define-key map (kbd "C-c c") 'caledonia-query-calendars)

     

       774
       +
           (define-key map (kbd "C-c t") 'caledonia-query-text)

     

       775
       +
           (define-key map (kbd "C-c i") 'caledonia-query-id)

     

       776
       +
           (define-key map (kbd "C-c r") 'caledonia-query-recurring)

     

       777
       +
           (define-key map (kbd "C-c l") 'caledonia-query-limit)

     

       778
       +
           (define-key map (kbd "C-c z") 'caledonia-query-timezone)

     

       779
       +
           ;; Use f prefix for filter commands

     

       780
       +
           (define-key map (kbd "C-c f") caledonia-filter-map)

     

       781
       +
           map)

     

       782
       +
         "Keymap for Caledonia mode.")

     

       783
       +
       

     

       784
       +
       (define-derived-mode caledonia-mode tabulated-list-mode "Caledonia"

     

       785
       +
         "Major mode for displaying calendar entries in a tabular view.")

     

       786
       +
       

     

       787
       +
       (provide 'caledonia)

     

       788
       +
       ;;; caledonia.el ends here

+175

flake.lock

···

       1
       +
       {

     

       2
       +
         "nodes": {

     

       3
       +
           "flake-compat": {

     

       4
       +
             "flake": false,

     

       5
       +
             "locked": {

     

       6
       +
               "lastModified": 1696426674,

     

       7
       +
               "narHash": "sha256-kvjfFW7WAETZlt09AgDn1MrtKzP7t90Vf7vypd3OL1U=",

     

       8
       +
               "owner": "edolstra",

     

       9
       +
               "repo": "flake-compat",

     

       10
       +
               "rev": "0f9255e01c2351cc7d116c072cb317785dd33b33",

     

       11
       +
               "type": "github"

     

       12
       +
             },

     

       13
       +
             "original": {

     

       14
       +
               "owner": "edolstra",

     

       15
       +
               "repo": "flake-compat",

     

       16
       +
               "type": "github"

     

       17
       +
             }

     

       18
       +
           },

     

       19
       +
           "flake-utils": {

     

       20
       +
             "inputs": {

     

       21
       +
               "systems": "systems"

     

       22
       +
             },

     

       23
       +
             "locked": {

     

       24
       +
               "lastModified": 1731533236,

     

       25
       +
               "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",

     

       26
       +
               "owner": "numtide",

     

       27
       +
               "repo": "flake-utils",

     

       28
       +
               "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",

     

       29
       +
               "type": "github"

     

       30
       +
             },

     

       31
       +
             "original": {

     

       32
       +
               "owner": "numtide",

     

       33
       +
               "repo": "flake-utils",

     

       34
       +
               "type": "github"

     

       35
       +
             }

     

       36
       +
           },

     

       37
       +
           "mirage-opam-overlays": {

     

       38
       +
             "flake": false,

     

       39
       +
             "locked": {

     

       40
       +
               "lastModified": 1710922379,

     

       41
       +
               "narHash": "sha256-j4QREQDUf8oHOX7qg6wAOupgsNQoYlufxoPrgagD+pY=",

     

       42
       +
               "owner": "dune-universe",

     

       43
       +
               "repo": "mirage-opam-overlays",

     

       44
       +
               "rev": "797cb363df3ff763c43c8fbec5cd44de2878757e",

     

       45
       +
               "type": "github"

     

       46
       +
             },

     

       47
       +
             "original": {

     

       48
       +
               "owner": "dune-universe",

     

       49
       +
               "repo": "mirage-opam-overlays",

     

       50
       +
               "type": "github"

     

       51
       +
             }

     

       52
       +
           },

     

       53
       +
           "nixpkgs": {

     

       54
       +
             "locked": {

     

       55
       +
               "lastModified": 1743761221,

     

       56
       +
               "narHash": "sha256-g79y3RpbyfOlwm3W4yuMXLmmNI7iDgIDqg10nq8pz5U=",

     

       57
       +
               "owner": "nixos",

     

       58
       +
               "repo": "nixpkgs",

     

       59
       +
               "rev": "e1964791d66993a8aa5b9f19c1c6dd5827851355",

     

       60
       +
               "type": "github"

     

       61
       +
             },

     

       62
       +
             "original": {

     

       63
       +
               "owner": "nixos",

     

       64
       +
               "repo": "nixpkgs",

     

       65
       +
               "type": "github"

     

       66
       +
             }

     

       67
       +
           },

     

       68
       +
           "opam-nix": {

     

       69
       +
             "inputs": {

     

       70
       +
               "flake-compat": "flake-compat",

     

       71
       +
               "flake-utils": [

     

       72
       +
                 "flake-utils"

     

       73
       +
               ],

     

       74
       +
               "mirage-opam-overlays": "mirage-opam-overlays",

     

       75
       +
               "nixpkgs": [

     

       76
       +
                 "nixpkgs"

     

       77
       +
               ],

     

       78
       +
               "opam-overlays": "opam-overlays",

     

       79
       +
               "opam-repository": "opam-repository",

     

       80
       +
               "opam2json": "opam2json"

     

       81
       +
             },

     

       82
       +
             "locked": {

     

       83
       +
               "lastModified": 1744376747,

     

       84
       +
               "narHash": "sha256-CKZLqLgZtMrUyZKlroISYp6Z4aoN1N9xeyk0dPNxGvc=",

     

       85
       +
               "owner": "RyanGibb",

     

       86
       +
               "repo": "opam-nix",

     

       87
       +
               "rev": "787eeba962582ff0142f445a74f1edb667d7e941",

     

       88
       +
               "type": "github"

     

       89
       +
             },

     

       90
       +
             "original": {

     

       91
       +
               "owner": "RyanGibb",

     

       92
       +
               "ref": "timere",

     

       93
       +
               "repo": "opam-nix",

     

       94
       +
               "type": "github"

     

       95
       +
             }

     

       96
       +
           },

     

       97
       +
           "opam-overlays": {

     

       98
       +
             "flake": false,

     

       99
       +
             "locked": {

     

       100
       +
               "lastModified": 1726822209,

     

       101
       +
               "narHash": "sha256-bwM18ydNT9fYq91xfn4gmS21q322NYrKwfq0ldG9GYw=",

     

       102
       +
               "owner": "dune-universe",

     

       103
       +
               "repo": "opam-overlays",

     

       104
       +
               "rev": "f2bec38beca4aea9e481f2fd3ee319c519124649",

     

       105
       +
               "type": "github"

     

       106
       +
             },

     

       107
       +
             "original": {

     

       108
       +
               "owner": "dune-universe",

     

       109
       +
               "repo": "opam-overlays",

     

       110
       +
               "type": "github"

     

       111
       +
             }

     

       112
       +
           },

     

       113
       +
           "opam-repository": {

     

       114
       +
             "flake": false,

     

       115
       +
             "locked": {

     

       116
       +
               "lastModified": 1740730647,

     

       117
       +
               "narHash": "sha256-6veU2WjUGcWDAzLDjoAI1L6GWZd0KIUq19sHcbJS+u8=",

     

       118
       +
               "owner": "ocaml",

     

       119
       +
               "repo": "opam-repository",

     

       120
       +
               "rev": "f1f75fef5fbf1e8bd1cc9544e50b89ba59f625e2",

     

       121
       +
               "type": "github"

     

       122
       +
             },

     

       123
       +
             "original": {

     

       124
       +
               "owner": "ocaml",

     

       125
       +
               "repo": "opam-repository",

     

       126
       +
               "type": "github"

     

       127
       +
             }

     

       128
       +
           },

     

       129
       +
           "opam2json": {

     

       130
       +
             "inputs": {

     

       131
       +
               "nixpkgs": [

     

       132
       +
                 "opam-nix",

     

       133
       +
                 "nixpkgs"

     

       134
       +
               ]

     

       135
       +
             },

     

       136
       +
             "locked": {

     

       137
       +
               "lastModified": 1671540003,

     

       138
       +
               "narHash": "sha256-5pXfbUfpVABtKbii6aaI2EdAZTjHJ2QntEf0QD2O5AM=",

     

       139
       +
               "owner": "tweag",

     

       140
       +
               "repo": "opam2json",

     

       141
       +
               "rev": "819d291ea95e271b0e6027679de6abb4d4f7f680",

     

       142
       +
               "type": "github"

     

       143
       +
             },

     

       144
       +
             "original": {

     

       145
       +
               "owner": "tweag",

     

       146
       +
               "repo": "opam2json",

     

       147
       +
               "type": "github"

     

       148
       +
             }

     

       149
       +
           },

     

       150
       +
           "root": {

     

       151
       +
             "inputs": {

     

       152
       +
               "flake-utils": "flake-utils",

     

       153
       +
               "nixpkgs": "nixpkgs",

     

       154
       +
               "opam-nix": "opam-nix"

     

       155
       +
             }

     

       156
       +
           },

     

       157
       +
           "systems": {

     

       158
       +
             "locked": {

     

       159
       +
               "lastModified": 1681028828,

     

       160
       +
               "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",

     

       161
       +
               "owner": "nix-systems",

     

       162
       +
               "repo": "default",

     

       163
       +
               "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",

     

       164
       +
               "type": "github"

     

       165
       +
             },

     

       166
       +
             "original": {

     

       167
       +
               "owner": "nix-systems",

     

       168
       +
               "repo": "default",

     

       169
       +
               "type": "github"

     

       170
       +
             }

     

       171
       +
           }

     

       172
       +
         },

     

       173
       +
         "root": "root",

     

       174
       +
         "version": 7

     

       175
       +
       }

+39

flake.nix

···

       1
       +
       {

     

       2
       +
         inputs = {

     

       3
       +
           nixpkgs.url = "github:nixos/nixpkgs";

     

       4
       +
           opam-nix.url = "github:tweag/opam-nix";

     

       5
       +
           flake-utils.url = "github:numtide/flake-utils";

     

       6
       +
           # we pin opam-nix's nixpkgs to follow the flakes, avoiding using two different instances

     

       7
       +
           opam-nix.inputs.nixpkgs.follows = "nixpkgs";

     

       8
       +
           # deduplicate flakes

     

       9
       +
           opam-nix.inputs.flake-utils.follows = "flake-utils";

     

       10
       +
         };

     

       11
       +
         outputs = { self, nixpkgs, flake-utils, opam-nix, ... }@inputs:

     

       12
       +
           flake-utils.lib.eachDefaultSystem (system:

     

       13
       +
             let

     

       14
       +
               package = "caledonia";

     

       15
       +
               pkgs = nixpkgs.legacyPackages.${system};

     

       16
       +
               opam-nix-lib = opam-nix.lib.${system};

     

       17
       +
               devPackagesQuery = {

     

       18
       +
                 ocaml-lsp-server = "*";

     

       19
       +
                 ocamlformat = "*";

     

       20
       +
                 utop = "*";

     

       21
       +
               };

     

       22
       +
               query = {

     

       23
       +
                 ocaml-base-compiler = "*";

     

       24
       +
               };

     

       25
       +
               scope =

     

       26
       +
                 opam-nix-lib.buildOpamProject' { } ./. (query // devPackagesQuery);

     

       27
       +
             in {

     

       28
       +
               packages.default = scope.${package};

     

       29
       +
               defaultPackage = scope.${package};

     

       30
       +
       

     

       31
       +
               devShells.default = let

     

       32
       +
                 devPackages = builtins.attrValues

     

       33
       +
                   (pkgs.lib.getAttrs (builtins.attrNames devPackagesQuery) scope);

     

       34
       +
               in pkgs.mkShell {

     

       35
       +
                 inputsFrom = [ scope.${package} ];

     

       36
       +
                 buildInputs = devPackages;

     

       37
       +
               };

     

       38
       +
             });

     

       39
       +
       }

+48 -84

lib/calendar_dir.ml

···

       1
        
       open Icalendar

     

       2
        
       

     

       3
       -
       module CalendarMap = Map.Make (struct

     

       4
       -
         type t = string

     

       5
       -
       

     

       6
       -
         let compare a b = String.compare a b

     

       7
       -
       end)

     

       8
       -
       

     

       9
       -
       type t = { path : string; mutable calendar_names : Event.t list CalendarMap.t }

     

       10
        
       

     

       11
        
       let get_calendar_path ~fs calendar_dir calendar_name_name =

     

       12
       -
         Eio.Path.(fs / calendar_dir.path / calendar_name_name)

     

       13
        
       

     

       14
        
       let ensure_dir path =

     

       15
        
         try

     
···

       22
        
       

     

       23
        
       let create ~fs path =

     

       24
        
         match ensure_dir Eio.Path.(fs / path) with

     

       25
       -
         | Ok () -> Ok { path; calendar_names = CalendarMap.empty }

     

       26
        
         | Error e -> Error e

     

       27
        
       

     

       28
        
       let list_calendar_names ~fs calendar_dir =

     

       29
        
         try

     

       30
       -
           let dir = Eio.Path.(fs / calendar_dir.path) in

     

       31
        
           let calendar_names =

     

       32
        
             Eio.Path.read_dir dir

     

       33
        
             |> List.filter_map (fun file ->

     

       34
       -
                    if Eio.Path.is_directory Eio.Path.(dir / file) then Some file

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       35
        
                    else None)

     

       36
        
             |> List.sort (fun a b -> String.compare a b)

     

       37
        
           in

     
···

       39
        
         with Eio.Exn.Io _ as exn ->

     

       40
        
           Error

     

       41
        
             (`Msg

     

       42
       -
                (Fmt.str "Failed to list calendar directory %s: %a" calendar_dir.path

     

       43
        
                   Eio.Exn.pp exn))

     

       44
        
       

     

       45
        
       let rec load_events_recursive calendar_name dir_path =

     
···

       71
        
           []

     

       72
        
       

     

       73
        
       let get_calendar_events ~fs calendar_dir calendar_name =

     

       74
       -
         match CalendarMap.find_opt calendar_name calendar_dir.calendar_names with

     

       75
       -
         | Some events -> Ok events

     

       76
       -
         | None -> (

     

       77
       -
             let calendar_name_path =

     

       78
       -
               get_calendar_path ~fs calendar_dir calendar_name

     

       79
       -
             in

     

       80
       -
             if not (Eio.Path.is_directory calendar_name_path) then Error `Not_found

     

       81
       -
             else

     

       82
       -
               try

     

       83
       -
                 let events = load_events_recursive calendar_name calendar_name_path in

     

       84
       -
                 calendar_dir.calendar_names <-

     

       85
       -
                   CalendarMap.add calendar_name events calendar_dir.calendar_names;

     

       86
       -
                 Ok events

     

       87
       -
               with e ->

     

       88
       -
                 Error

     

       89
       -
                   (`Msg

     

       90
       -
                      (Printf.sprintf "Exception processing directory %s: %s"

     

       91
       -
                         (snd calendar_name_path) (Printexc.to_string e))))

     

       92
        
       

     

       93
        
       let ( let* ) = Result.bind

     

       94
        
       

     
···

       113
        
                    (Printf.sprintf "Error getting calendar_names: %s"

     

       114
        
                       (Printexc.to_string exn))))

     

       115
        
       

     

       116
       -
       let add_event ~fs calendar_dir event =

     

       117
        
         let calendar_name = Event.get_calendar_name event in

     

       118
        
         let file = Event.get_file event in

     

       119
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     

       120
        
         let* () = ensure_dir calendar_name_path in

     

       121
        
         let calendar = Event.to_ical_calendar event in

     

       122
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       123
       -
         let* _ =

     

       124
        
           try

     

       125
        
             Eio.Path.save ~create:(`Or_truncate 0o644) file content;

     

       126
       -
             Ok ()

     

       127
        
           with Eio.Exn.Io _ as exn ->

     

       128
        
             Error

     

       129
        
               (`Msg

     

       130
        
                  (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       131
       -
         in

     

       132
       -
         calendar_dir.calendar_names <-

     

       133
       -
           CalendarMap.add calendar_name

     

       134
       -
             (event

     

       135
       -
             ::

     

       136
       -
             (match CalendarMap.find_opt calendar_name calendar_dir.calendar_names with

     

       137
       -
             | Some lst -> lst

     

       138
       -
             | None -> []))

     

       139
       -
             calendar_dir.calendar_names;

     

       140
       -
         Ok ()

     

       141
        
       

     

       142
       -
       let edit_event ~fs calendar_dir event =

     

       143
        
         let calendar_name = Event.get_calendar_name event in

     

       144
        
         let event_id = Event.get_id event in

     

       145
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     
···

       162
        
           (existing_props, `Event ical_event :: filtered_components)

     

       163
        
         in

     

       164
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       165
       -
         let* _ =

     

       166
       -
           try

     

       167
       -
             Eio.Path.save ~create:(`Or_truncate 0o644) file content;

     

       168
       -
             Ok ()

     

       169
       -
           with Eio.Exn.Io _ as exn ->

     

       170
       -
             Error

     

       171
       -
               (`Msg

     

       172
       -
                  (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       173
       -
         in

     

       174
       -
         calendar_dir.calendar_names <-

     

       175
       -
           CalendarMap.add calendar_name

     

       176
       -
             (event

     

       177
       -
             ::

     

       178
       -
             (match CalendarMap.find_opt calendar_name calendar_dir.calendar_names with

     

       179
       -
             (* filter old version *)

     

       180
       -
             | Some lst -> List.filter (fun e -> Event.get_id e = event_id) lst

     

       181
       -
             | None -> []))

     

       182
       -
             calendar_dir.calendar_names;

     

       183
       -
         Ok ()

     

       184
        
       

     

       185
       -
       let delete_event ~fs calendar_dir event =

     

       186
        
         let calendar_name = Event.get_calendar_name event in

     

       187
        
         let event_id = Event.get_id event in

     

       188
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     
···

       208
        
           (existing_props, filtered_components)

     

       209
        
         in

     

       210
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       211
       -
         let* _ =

     

       212
       -
           try

     

       213
       -
             (match !other_events with

     

       214
       -
             | true -> Eio.Path.save ~create:(`Or_truncate 0o644) file content

     

       215
       -
             | false -> Eio.Path.unlink file);

     

       216
       -
             Ok ()

     

       217
       -
           with Eio.Exn.Io _ as exn ->

     

       218
       -
             Error

     

       219
       -
               (`Msg

     

       220
       -
                  (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       221
       -
         in

     

       222
       -
         calendar_dir.calendar_names <-

     

       223
       -
           CalendarMap.add calendar_name

     

       224
       -
             (match CalendarMap.find_opt calendar_name calendar_dir.calendar_names with

     

       225
       -
             (* filter old version *)

     

       226
       -
             | Some lst -> List.filter (fun e -> Event.get_id e = event_id) lst

     

       227
       -
             | None -> [])

     

       228
       -
             calendar_dir.calendar_names;

     

       229
       -
         Ok ()

     

       230
        
       

     

       231
       -
       let get_path t = t.path

···

       1
        
       open Icalendar

     

       2
        
       

     

       3
       +
       type t = string

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       4
        
       

     

       5
        
       let get_calendar_path ~fs calendar_dir calendar_name_name =

     

       6
       +
         Eio.Path.(fs / calendar_dir / calendar_name_name)

     

       7
        
       

     

       8
        
       let ensure_dir path =

     

       9
        
         try

     
···

       16
        
       

     

       17
        
       let create ~fs path =

     

       18
        
         match ensure_dir Eio.Path.(fs / path) with

     

       19
       +
         | Ok () -> Ok path

     

       20
        
         | Error e -> Error e

     

       21
        
       

     

       22
        
       let list_calendar_names ~fs calendar_dir =

     

       23
        
         try

     

       24
       +
           let dir = Eio.Path.(fs / calendar_dir) in

     

       25
        
           let calendar_names =

     

       26
        
             Eio.Path.read_dir dir

     

       27
        
             |> List.filter_map (fun file ->

     

       28
       +
                    if

     

       29
       +
                      String.length file > 0

     

       30
       +
                      && file.[0] != '.'

     

       31
       +
                      && Eio.Path.is_directory Eio.Path.(dir / file)

     

       32
       +
                    then Some file

     

       33
        
                    else None)

     

       34
        
             |> List.sort (fun a b -> String.compare a b)

     

       35
        
           in

     
···

       37
        
         with Eio.Exn.Io _ as exn ->

     

       38
        
           Error

     

       39
        
             (`Msg

     

       40
       +
                (Fmt.str "Failed to list calendar directory %s: %a" calendar_dir

     

       41
        
                   Eio.Exn.pp exn))

     

       42
        
       

     

       43
        
       let rec load_events_recursive calendar_name dir_path =

     
···

       69
        
           []

     

       70
        
       

     

       71
        
       let get_calendar_events ~fs calendar_dir calendar_name =

     

       72
       +
         let calendar_name_path =

     

       73
       +
           get_calendar_path ~fs calendar_dir calendar_name

     

       74
       +
         in

     

       75
       +
         if not (Eio.Path.is_directory calendar_name_path) then Error `Not_found

     

       76
       +
         else

     

       77
       +
           try

     

       78
       +
             let events = load_events_recursive calendar_name calendar_name_path in

     

       79
       +
             Ok events

     

       80
       +
           with e ->

     

       81
       +
             Error

     

       82
       +
               (`Msg

     

       83
       +
                  (Printf.sprintf "Exception processing directory %s: %s"

     

       84
       +
                     (snd calendar_name_path) (Printexc.to_string e)))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       85
        
       

     

       86
        
       let ( let* ) = Result.bind

     

       87
        
       

     
···

       106
        
                    (Printf.sprintf "Error getting calendar_names: %s"

     

       107
        
                       (Printexc.to_string exn))))

     

       108
        
       

     

       109
       +
       let add_event ~fs calendar_dir events event =

     

       110
        
         let calendar_name = Event.get_calendar_name event in

     

       111
        
         let file = Event.get_file event in

     

       112
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     

       113
        
         let* () = ensure_dir calendar_name_path in

     

       114
        
         let calendar = Event.to_ical_calendar event in

     

       115
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       0
        
       
     

       116
        
           try

     

       117
        
             Eio.Path.save ~create:(`Or_truncate 0o644) file content;

     

       118
       +
             Ok (event :: events)

     

       119
        
           with Eio.Exn.Io _ as exn ->

     

       120
        
             Error

     

       121
        
               (`Msg

     

       122
        
                  (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       123
        
       

     

       124
       +
       let edit_event ~fs calendar_dir events event =

     

       125
        
         let calendar_name = Event.get_calendar_name event in

     

       126
        
         let event_id = Event.get_id event in

     

       127
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     
···

       144
        
           (existing_props, `Event ical_event :: filtered_components)

     

       145
        
         in

     

       146
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       147
       +
         try

     

       148
       +
           Eio.Path.save ~create:(`Or_truncate 0o644) file content;

     

       149
       +
           (* Filter out the old event and add the updated one *)

     

       150
       +
           let filtered_events = List.filter (fun e -> Event.get_id e <> event_id) events in

     

       151
       +
           Ok (event :: filtered_events)

     

       152
       +
         with Eio.Exn.Io _ as exn ->

     

       153
       +
           Error

     

       154
       +
             (`Msg

     

       155
       +
                (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       156
        
       

     

       157
       +
       let delete_event ~fs calendar_dir events event =

     

       158
        
         let calendar_name = Event.get_calendar_name event in

     

       159
        
         let event_id = Event.get_id event in

     

       160
        
         let calendar_name_path = get_calendar_path ~fs calendar_dir calendar_name in

     
···

       180
        
           (existing_props, filtered_components)

     

       181
        
         in

     

       182
        
         let content = Icalendar.to_ics ~cr:true calendar in

     

       183
       +
         try

     

       184
       +
           (match !other_events with

     

       185
       +
           | true -> Eio.Path.save ~create:(`Or_truncate 0o644) file content

     

       186
       +
           | false -> Eio.Path.unlink file);

     

       187
       +
           (* Filter out the deleted event from the events list *)

     

       188
       +
           let filtered_events = List.filter (fun e -> Event.get_id e <> event_id) events in

     

       189
       +
           Ok filtered_events

     

       190
       +
         with Eio.Exn.Io _ as exn ->

     

       191
       +
           Error

     

       192
       +
             (`Msg

     

       193
       +
                (Fmt.str "Failed to write file %s: %a\n%!" (snd file) Eio.Exn.pp exn))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       194
        
       

     

       195
       +
       let get_path t = t

+12 -3

lib/calendar_dir.mli

···

       32
        
       val add_event :

     

       33
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       34
        
         t ->

     

       0
        
       
     

       35
        
         Event.t ->

     

       36
       -
         (unit, [> `Msg of string ]) result

     

       0
        
       
     

       0
        
       
     

       37
        
       

     

       38
        
       val edit_event :

     

       39
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       40
        
         t ->

     

       0
        
       
     

       41
        
         Event.t ->

     

       42
       -
         (unit, [> `Msg of string ]) result

     

       0
        
       
     

       0
        
       
     

       43
        
       

     

       44
        
       val delete_event :

     

       45
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       46
        
         t ->

     

       0
        
       
     

       47
        
         Event.t ->

     

       48
       -
         (unit, [> `Msg of string ]) result

     

       0
        
       
     

       0
        
       
     

       49
        
       

     

       50
        
       val get_path : t -> string

···

       32
        
       val add_event :

     

       33
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       34
        
         t ->

     

       35
       +
         Event.t list ->

     

       36
        
         Event.t ->

     

       37
       +
         (Event.t list, [> `Msg of string ]) result

     

       38
       +
       (** Add an event to the calendar directory. Takes the current events list and returns

     

       39
       +
           an updated events list with the new event added. *)

     

       40
        
       

     

       41
        
       val edit_event :

     

       42
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       43
        
         t ->

     

       44
       +
         Event.t list ->

     

       45
        
         Event.t ->

     

       46
       +
         (Event.t list, [> `Msg of string ]) result

     

       47
       +
       (** Edit an event in the calendar directory. Takes the current events list and returns

     

       48
       +
           an updated events list with the event updated. *)

     

       49
        
       

     

       50
        
       val delete_event :

     

       51
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       52
        
         t ->

     

       53
       +
         Event.t list ->

     

       54
        
         Event.t ->

     

       55
       +
         (Event.t list, [> `Msg of string ]) result

     

       56
       +
       (** Delete an event from the calendar directory. Takes the current events list and returns

     

       57
       +
           an updated events list with the event removed. *)

     

       58
        
       

     

       59
        
       val get_path : t -> string

-1

lib/collection.ml

···

       1
       -
       type t = Col of string

···

       0

-3

lib/collection.mli

···

       1
       -
       (** A calendar_name is a directory of `ics` files *)

     

       2
       -
       

     

       3
       -
       type t = Col of string  (** The name of the calendar_name. *)

+167 -70

lib/date.ml

···

       165
        
       let get_end_of_next_month ?(tz = !default_timezone ()) () =

     

       166
        
         get_end_of_month (get_start_of_next_month ~tz ())

     

       167
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       168
        
       let convert_relative_date_formats ?(tz = !default_timezone ()) ~today ~tomorrow

     

       169
        
           ~week ~month () =

     

       170
        
         if today then

     
···

       193
        
       

     

       194
        
       let ( let* ) = Result.bind

     

       195
        
       

     

       196
       -
       (* Parse a date string that could be ISO format or a relative expression *)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       197
        
       let parse_date ?(tz = !default_timezone ()) expr parameter =

     

       198
       -
         let iso_date_regex = Re.Pcre.regexp "^(\\d{4})-(\\d{2})-(\\d{2})$" in

     

       199
       -
         let relative_regex = Re.Pcre.regexp "^([+-])(\\d+)([dwm])$" in

     

       200
        
         match expr with

     

       201
        
         | "today" -> Ok (!get_today ~tz ())

     

       202
        
         | "tomorrow" -> Ok (add_days (!get_today ~tz ()) 1)

     
···

       217
        
             match parameter with

     

       218
        
             | `From -> Ok (get_start_of_next_month ~tz ())

     

       219
        
             | `To -> Ok (get_end_of_next_month ~tz ()))

     

       220
       -
         | _ ->

     

       221
       -
             (* Try to parse as ISO date *)

     

       222
       -
             if Re.Pcre.pmatch ~rex:iso_date_regex expr then

     

       223
       -
               let year =

     

       224
       -
                 int_of_string

     

       225
       -
                   (Re.Pcre.get_substring (Re.Pcre.exec ~rex:iso_date_regex expr) 1)

     

       226
       -
               in

     

       227
       -
               let month =

     

       228
       -
                 int_of_string

     

       229
       -
                   (Re.Pcre.get_substring (Re.Pcre.exec ~rex:iso_date_regex expr) 2)

     

       230
       -
               in

     

       231
       -
               let day =

     

       232
       -
                 int_of_string

     

       233
       -
                   (Re.Pcre.get_substring (Re.Pcre.exec ~rex:iso_date_regex expr) 3)

     

       234
       -
               in

     

       235
       -
               match Timedesc.Date.Ymd.make ~year ~month ~day with

     

       236
       -
               | Ok date ->

     

       237
       -
                   let midnight =

     

       238
       -
                     Timedesc.Time.make_exn ~hour:0 ~minute:0 ~second:0 ()

     

       239
       -
                   in

     

       240
       -
                   let dt = Timedesc.of_date_and_time_exn ~tz date midnight in

     

       241
       -
                   Ok (timedesc_to_ptime dt)

     

       242
       -
               | Error _ -> Error (`Msg (Printf.sprintf "Invalid date: %s" expr))

     

       243
       -
               (* Try to parse as relative expression +Nd, -Nd, etc. *)

     

       244
       -
             else if Re.Pcre.pmatch ~rex:relative_regex expr then

     

       245
       -
               let sign =

     

       246
       -
                 Re.Pcre.get_substring (Re.Pcre.exec ~rex:relative_regex expr) 1

     

       247
       -
               in

     

       248
       -
               let num =

     

       249
       -
                 int_of_string

     

       250
       -
                   (Re.Pcre.get_substring (Re.Pcre.exec ~rex:relative_regex expr) 2)

     

       251
       -
               in

     

       252
       -
               let unit =

     

       253
       -
                 Re.Pcre.get_substring (Re.Pcre.exec ~rex:relative_regex expr) 3

     

       254
       -
               in

     

       255
       -
               let multiplier = if sign = "+" then 1 else -1 in

     

       256
       -
               let value = num * multiplier in

     

       257
       -
               let today = !get_today ~tz () in

     

       258
       -
               match unit with

     

       259
       -
               | "d" -> Ok (add_days today value)

     

       260
       -
               | "w" -> (

     

       261
       -
                   let date = add_weeks today value in

     

       262
       -
                   match parameter with

     

       263
       -
                   | `From -> Ok (get_start_of_week date)

     

       264
       -
                   | `To -> Ok (get_end_of_week date))

     

       265
       -
               | "m" -> (

     

       266
       -
                   let date = add_months today value in

     

       267
       -
                   match parameter with

     

       268
       -
                   | `From -> Ok (get_start_of_month date)

     

       269
       -
                   | `To -> Ok (get_end_of_month date))

     

       270
       -
               | _ -> Error (`Msg (Printf.sprintf "Invalid date unit: %s" unit))

     

       271
       -
             else Error (`Msg (Printf.sprintf "Invalid date format: %s" expr))

     

       272
        
       

     

       273
        
       let parse_time str =

     

       274
        
         try

     
···

       313
        
       let ptime_of_ical = function

     

       314
        
         | `Datetime (`Utc t) -> t

     

       315
        
         | `Datetime (`Local t) ->

     

       316
       -
             let system_tz =

     

       317
       -
               match Timedesc.Time_zone.local () with

     

       318
       -
               | Some tz -> tz

     

       319
       -
               | None -> Timedesc.Time_zone.utc

     

       320
       -
             in

     

       321
        
             let ts = Timedesc.Utils.timestamp_of_ptime t in

     

       0
        
       
     

       322
        
             let dt =

     

       323
       -
               match Timedesc.of_timestamp ~tz_of_date_time:system_tz ts with

     

       324
       -
               | Some dt -> dt

     

       325
       -
               | None -> failwith "Invalid local date conversion"

     

       326
        
             in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       327
        
             timedesc_to_ptime dt

     

       328
        
         | `Datetime (`With_tzid (t, (_, tzid))) ->

     

       329
        
             let tz =

     

       330
        
               match Timedesc.Time_zone.make tzid with

     

       331
        
               | Some tz -> tz

     

       332
       -
               | None ->

     

       333
       -
                   failwith

     

       334
       -
                     (Printf.sprintf

     

       335
       -
                        "Warning: Unknown timezone %s, falling back to UTC\n" tzid)

     

       336
        
             in

     

       0
        
       
     

       337
        
             let ts = Timedesc.Utils.timestamp_of_ptime t in

     

       338
        
             let dt =

     

       339
       -
               match Timedesc.of_timestamp ~tz_of_date_time:tz ts with

     

       340
       -
               | Some dt -> dt

     

       341
       -
               | None -> failwith "Invalid timezone date conversion"

     

       342
        
             in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       343
        
             timedesc_to_ptime dt

     

       344
        
         | `Date date -> (

     

       345
        
             let y, m, d = date in

···

       165
        
       let get_end_of_next_month ?(tz = !default_timezone ()) () =

     

       166
        
         get_end_of_month (get_start_of_next_month ~tz ())

     

       167
        
       

     

       168
       +
       let get_start_of_year date =

     

       169
       +
         let dt = ptime_to_timedesc date in

     

       170
       +
         let year = Timedesc.year dt in

     

       171
       +
       

     

       172
       +
         (* Create a date for the first of January *)

     

       173
       +
         match Timedesc.Date.Ymd.make ~year ~month:1 ~day:1 with

     

       174
       +
         | Ok first_day ->

     

       175
       +
             let midnight = Timedesc.Time.make_exn ~hour:0 ~minute:0 ~second:0 () in

     

       176
       +
             let first_of_year = Timedesc.of_date_and_time_exn first_day midnight in

     

       177
       +
             timedesc_to_ptime first_of_year

     

       178
       +
         | Error _ -> failwith "Invalid date for start of year"

     

       179
       +
       

     

       180
       +
       let get_start_of_current_year ?(tz = !default_timezone ()) () =

     

       181
       +
         get_start_of_year (!get_today ~tz ())

     

       182
       +
       

     

       183
       +
       let get_start_of_next_year ?(tz = !default_timezone ()) () =

     

       184
       +
         add_years (get_start_of_current_year ~tz ()) 1

     

       185
       +
       

     

       186
       +
       let get_end_of_year date =

     

       187
       +
         let dt = ptime_to_timedesc date in

     

       188
       +
         let year = Timedesc.year dt in

     

       189
       +
       

     

       190
       +
         (* Create a date for the last day of the year (December 31) *)

     

       191
       +
         match Timedesc.Date.Ymd.make ~year ~month:12 ~day:31 with

     

       192
       +
         | Ok last_day ->

     

       193
       +
             let end_of_day =

     

       194
       +
               Timedesc.Time.make_exn ~hour:23 ~minute:59 ~second:59 ()

     

       195
       +
             in

     

       196
       +
             let end_of_year = Timedesc.of_date_and_time_exn last_day end_of_day in

     

       197
       +
             timedesc_to_ptime end_of_year

     

       198
       +
         | Error _ -> failwith "Invalid date for end of year"

     

       199
       +
       

     

       200
       +
       let get_end_of_current_year ?(tz = !default_timezone ()) () =

     

       201
       +
         get_end_of_year (!get_today ~tz ())

     

       202
       +
       

     

       203
       +
       let get_end_of_next_year ?(tz = !default_timezone ()) () =

     

       204
       +
         get_end_of_year (get_start_of_next_year ~tz ())

     

       205
       +
       

     

       206
        
       let convert_relative_date_formats ?(tz = !default_timezone ()) ~today ~tomorrow

     

       207
        
           ~week ~month () =

     

       208
        
         if today then

     
···

       231
        
       

     

       232
        
       let ( let* ) = Result.bind

     

       233
        
       

     

       234
       +
       let parse_full_iso_datet ~tz expr =

     

       235
       +
         let regex = Re.Pcre.regexp "^(\\d{4})-(\\d{1,2})-(\\d{1,2})$" in

     

       236
       +
         if Re.Pcre.pmatch ~rex:regex expr then

     

       237
       +
           let match_result = Re.Pcre.exec ~rex:regex expr in

     

       238
       +
           let year = int_of_string (Re.Pcre.get_substring match_result 1) in

     

       239
       +
           let month = int_of_string (Re.Pcre.get_substring match_result 2) in

     

       240
       +
           let day = int_of_string (Re.Pcre.get_substring match_result 3) in

     

       241
       +
           match Timedesc.Date.Ymd.make ~year ~month ~day with

     

       242
       +
           | Ok date ->

     

       243
       +
               let midnight = Timedesc.Time.make_exn ~hour:0 ~minute:0 ~second:0 () in

     

       244
       +
               let dt = Timedesc.of_date_and_time_exn ~tz date midnight in

     

       245
       +
               Some (Ok (timedesc_to_ptime dt))

     

       246
       +
           | Error _ -> Some (Error (`Msg (Printf.sprintf "Invalid date: %s" expr)))

     

       247
       +
         else None

     

       248
       +
       

     

       249
       +
       let parse_year_only ~tz expr parameter =

     

       250
       +
         let regex = Re.Pcre.regexp "^(\\d{4})$" in

     

       251
       +
         if Re.Pcre.pmatch ~rex:regex expr then

     

       252
       +
           let match_result = Re.Pcre.exec ~rex:regex expr in

     

       253
       +
           let year = int_of_string (Re.Pcre.get_substring match_result 1) in

     

       254
       +
           match parameter with

     

       255
       +
           | `From -> (

     

       256
       +
               match Timedesc.Date.Ymd.make ~year ~month:1 ~day:1 with

     

       257
       +
               | Ok date ->

     

       258
       +
                   let time = Timedesc.Time.make_exn ~hour:0 ~minute:0 ~second:0 () in

     

       259
       +
                   let dt = Timedesc.of_date_and_time_exn ~tz date time in

     

       260
       +
                   Some (Ok (timedesc_to_ptime dt))

     

       261
       +
               | Error _ ->

     

       262
       +
                   Some (Error (`Msg (Printf.sprintf "Invalid year: %s" expr))))

     

       263
       +
           | `To -> (

     

       264
       +
               match Timedesc.Date.Ymd.make ~year ~month:12 ~day:31 with

     

       265
       +
               | Ok date ->

     

       266
       +
                   let time =

     

       267
       +
                     Timedesc.Time.make_exn ~hour:23 ~minute:59 ~second:59 ()

     

       268
       +
                   in

     

       269
       +
                   let dt = Timedesc.of_date_and_time_exn ~tz date time in

     

       270
       +
                   Some (Ok (timedesc_to_ptime dt))

     

       271
       +
               | Error _ ->

     

       272
       +
                   Some (Error (`Msg (Printf.sprintf "Invalid year: %s" expr))))

     

       273
       +
         else None

     

       274
       +
       

     

       275
       +
       let parse_year_month ~tz expr parameter =

     

       276
       +
         let regex = Re.Pcre.regexp "^(\\d{4})-(\\d{1,2})$" in

     

       277
       +
         if Re.Pcre.pmatch ~rex:regex expr then

     

       278
       +
           let match_result = Re.Pcre.exec ~rex:regex expr in

     

       279
       +
           let year = int_of_string (Re.Pcre.get_substring match_result 1) in

     

       280
       +
           let month = int_of_string (Re.Pcre.get_substring match_result 2) in

     

       281
       +
           match parameter with

     

       282
       +
           | `From -> (

     

       283
       +
               match Timedesc.Date.Ymd.make ~year ~month ~day:1 with

     

       284
       +
               | Ok date ->

     

       285
       +
                   let time = Timedesc.Time.make_exn ~hour:0 ~minute:0 ~second:0 () in

     

       286
       +
                   let dt = Timedesc.of_date_and_time_exn ~tz date time in

     

       287
       +
                   Some (Ok (timedesc_to_ptime dt))

     

       288
       +
               | Error _ ->

     

       289
       +
                   Some (Error (`Msg (Printf.sprintf "Invalid year-month: %s" expr))))

     

       290
       +
           | `To -> (

     

       291
       +
               let next_month = if month = 12 then 1 else month + 1 in

     

       292
       +
               let next_month_year = if month = 12 then year + 1 else year in

     

       293
       +
               match

     

       294
       +
                 Timedesc.Date.Ymd.make ~year:next_month_year ~month:next_month ~day:1

     

       295
       +
               with

     

       296
       +
               | Ok next_month_date ->

     

       297
       +
                   let last_day_of_month = Timedesc.Date.sub ~days:1 next_month_date in

     

       298
       +
                   let end_of_day =

     

       299
       +
                     Timedesc.Time.make_exn ~hour:23 ~minute:59 ~second:59 ()

     

       300
       +
                   in

     

       301
       +
                   let dt =

     

       302
       +
                     Timedesc.of_date_and_time_exn ~tz last_day_of_month end_of_day

     

       303
       +
                   in

     

       304
       +
                   Some (Ok (timedesc_to_ptime dt))

     

       305
       +
               | Error _ ->

     

       306
       +
                   Some (Error (`Msg (Printf.sprintf "Invalid year-month: %s" expr))))

     

       307
       +
         else None

     

       308
       +
       

     

       309
       +
       let parse_relative ~tz expr parameter =

     

       310
       +
         let regex = Re.Pcre.regexp "^([+-])(\\d+)([dwmy])$" in

     

       311
       +
         if Re.Pcre.pmatch ~rex:regex expr then

     

       312
       +
           let match_result = Re.Pcre.exec ~rex:regex expr in

     

       313
       +
           let sign = Re.Pcre.get_substring match_result 1 in

     

       314
       +
           let num = int_of_string (Re.Pcre.get_substring match_result 2) in

     

       315
       +
           let unit = Re.Pcre.get_substring match_result 3 in

     

       316
       +
           let multiplier = if sign = "+" then 1 else -1 in

     

       317
       +
           let value = num * multiplier in

     

       318
       +
           let today = !get_today ~tz () in

     

       319
       +
           match unit with

     

       320
       +
           | "d" -> Some (Ok (add_days today value))

     

       321
       +
           | "w" -> (

     

       322
       +
               let date = add_weeks today value in

     

       323
       +
               match parameter with

     

       324
       +
               | `From -> Some (Ok (get_start_of_week date))

     

       325
       +
               | `To -> Some (Ok (get_end_of_week date)))

     

       326
       +
           | "m" -> (

     

       327
       +
               let date = add_months today value in

     

       328
       +
               match parameter with

     

       329
       +
               | `From -> Some (Ok (get_start_of_month date))

     

       330
       +
               | `To -> Some (Ok (get_end_of_month date)))

     

       331
       +
           | "y" -> (

     

       332
       +
               let date = add_years today value in

     

       333
       +
               match parameter with

     

       334
       +
               | `From -> Some (Ok (get_start_of_year date))

     

       335
       +
               | `To -> Some (Ok (get_end_of_year date)))

     

       336
       +
           | _ -> Some (Error (`Msg (Printf.sprintf "Invalid date unit: %s" unit)))

     

       337
       +
         else None

     

       338
       +
       

     

       339
        
       let parse_date ?(tz = !default_timezone ()) expr parameter =

     

       0
        
       
     

       0
        
       
     

       340
        
         match expr with

     

       341
        
         | "today" -> Ok (!get_today ~tz ())

     

       342
        
         | "tomorrow" -> Ok (add_days (!get_today ~tz ()) 1)

     
···

       357
        
             match parameter with

     

       358
        
             | `From -> Ok (get_start_of_next_month ~tz ())

     

       359
        
             | `To -> Ok (get_end_of_next_month ~tz ()))

     

       360
       +
         | _ -> (

     

       361
       +
             (* Option alternative operator *)

     

       362
       +
             let ( |>? ) opt f = match opt with None -> f () | Some x -> Some x in

     

       363
       +
             ( ( ( parse_full_iso_datet ~tz expr |>? fun () ->

     

       364
       +
                   parse_year_only ~tz expr parameter )

     

       365
       +
               |>? fun () -> parse_year_month ~tz expr parameter )

     

       366
       +
             |>? fun () -> parse_relative ~tz expr parameter )

     

       367
       +
             |> function

     

       368
       +
             | Some result -> result

     

       369
       +
             | None -> Error (`Msg (Printf.sprintf "Invalid date format: %s" expr)))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       370
        
       

     

       371
        
       let parse_time str =

     

       372
        
         try

     
···

       411
        
       let ptime_of_ical = function

     

       412
        
         | `Datetime (`Utc t) -> t

     

       413
        
         | `Datetime (`Local t) ->

     

       414
       +
             let tz = Timedesc.Time_zone.local_exn () in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       415
        
             let ts = Timedesc.Utils.timestamp_of_ptime t in

     

       416
       +
             (* Icalendar gives us the Ptime in UTC, which we parse to a Timedesc *)

     

       417
        
             let dt =

     

       418
       +
               Timedesc.of_timestamp_exn ~tz_of_date_time:Timedesc.Time_zone.utc ts

     

       0
        
       
     

       0
        
       
     

       419
        
             in

     

       420
       +
             (* We extract the datetime, and reinterpret it in the appropriate timezone *)

     

       421
       +
             let date = Timedesc.date dt in

     

       422
       +
             let time = Timedesc.time dt in

     

       423
       +
             let dt = Timedesc.of_date_and_time_exn ~tz date time in

     

       424
        
             timedesc_to_ptime dt

     

       425
        
         | `Datetime (`With_tzid (t, (_, tzid))) ->

     

       426
        
             let tz =

     

       427
        
               match Timedesc.Time_zone.make tzid with

     

       428
        
               | Some tz -> tz

     

       429
       +
               | None -> failwith (Printf.sprintf "Warning: Unknown timezone %s" tzid)

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       430
        
             in

     

       431
       +
             (* Icalendar gives us the Ptime in UTC, which we parse to a Timedesc *)

     

       432
        
             let ts = Timedesc.Utils.timestamp_of_ptime t in

     

       433
        
             let dt =

     

       434
       +
               Timedesc.of_timestamp_exn ~tz_of_date_time:Timedesc.Time_zone.utc ts

     

       0
        
       
     

       0
        
       
     

       435
        
             in

     

       436
       +
             (* We extract the datetime, and reinterpret it in the appropriate timezone *)

     

       437
       +
             let date = Timedesc.date dt in

     

       438
       +
             let time = Timedesc.time dt in

     

       439
       +
             let dt = Timedesc.of_date_and_time_exn ~tz date time in

     

       440
        
             timedesc_to_ptime dt

     

       441
        
         | `Date date -> (

     

       442
        
             let y, m, d = date in

+38 -2

lib/date.mli

···

       94
        
       (** Get the end of the month for the given date. Raises an exception if the date

     

       95
        
           cannot be calculated. *)

     

       96
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       97
        
       val convert_relative_date_formats :

     

       98
        
         ?tz:Timedesc.Time_zone.t ->

     

       99
        
         today:bool ->

     
···

       117
        
           default_timezone.

     

       118
        
       

     

       119
        
           Supported formats:

     

       120
       -
           - ISO format: "YYYY-MM-DD"

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       121
        
           - Relative expressions:

     

       122
        
           - "today" - Current day

     

       123
        
           - "tomorrow" - Next day

     
···

       129
        
           - "+Nd" - N days from today (e.g., "+7d" for a week from today)

     

       130
        
           - "-Nd" - N days before today (e.g., "-7d" for a week ago)

     

       131
        
           - "+Nw" - N weeks from today

     

       132
       -
           - "+Nm" - N months from today *)

     

       0
        
       
     

       133
        
       

     

       134
        
       val parse_time : string -> (int * int * int, [> `Msg of string ]) result

     

       135
        
       (** Parse a time string in HH:MM or HH:MM:SS format. Returns Ok with (hour,

···

       94
        
       (** Get the end of the month for the given date. Raises an exception if the date

     

       95
        
           cannot be calculated. *)

     

       96
        
       

     

       97
       +
       val get_start_of_year : Ptime.t -> Ptime.t

     

       98
       +
       (** Get the start of the year (Jan 1) for the given date. Raises an exception if

     

       99
       +
           the date cannot be calculated. *)

     

       100
       +
       

     

       101
       +
       val get_start_of_current_year : ?tz:Timedesc.Time_zone.t -> unit -> Ptime.t

     

       102
       +
       (** Get the start of the current year in the specified timezone. If no timezone

     

       103
       +
           is provided, uses the default_timezone. Raises an exception if the date

     

       104
       +
           cannot be calculated. *)

     

       105
       +
       

     

       106
       +
       val get_start_of_next_year : ?tz:Timedesc.Time_zone.t -> unit -> Ptime.t

     

       107
       +
       (** Get the start of next year in the specified timezone. If no timezone is

     

       108
       +
           provided, uses the default_timezone. Raises an exception if the date cannot

     

       109
       +
           be calculated. *)

     

       110
       +
       

     

       111
       +
       val get_end_of_year : Ptime.t -> Ptime.t

     

       112
       +
       (** Get the end of the year (Dec 31, 23:59:59) for the given date. Raises an

     

       113
       +
           exception if the date cannot be calculated. *)

     

       114
       +
       

     

       115
       +
       val get_end_of_current_year : ?tz:Timedesc.Time_zone.t -> unit -> Ptime.t

     

       116
       +
       (** Get the end of the current year in the specified timezone. If no timezone is

     

       117
       +
           provided, uses the default_timezone. Raises an exception if the date cannot

     

       118
       +
           be calculated. *)

     

       119
       +
       

     

       120
       +
       val get_end_of_next_year : ?tz:Timedesc.Time_zone.t -> unit -> Ptime.t

     

       121
       +
       (** Get the end of next year in the specified timezone. If no timezone is

     

       122
       +
           provided, uses the default_timezone. Raises an exception if the date cannot

     

       123
       +
           be calculated. *)

     

       124
       +
       

     

       125
        
       val convert_relative_date_formats :

     

       126
        
         ?tz:Timedesc.Time_zone.t ->

     

       127
        
         today:bool ->

     
···

       145
        
           default_timezone.

     

       146
        
       

     

       147
        
           Supported formats:

     

       148
       +
           - ISO format:

     

       149
       +
           - "YYYY-MM-DD" (full date)

     

       150
       +
           - "YYYY-MM" (partial date)

     

       151
       +
           - For --from: defaults to first day of month

     

       152
       +
           - For --to: defaults to last day of month

     

       153
       +
           - "YYYY" (partial date)

     

       154
       +
           - For --from: defaults to January 1st of year

     

       155
       +
           - For --to: defaults to December 31st of year

     

       156
        
           - Relative expressions:

     

       157
        
           - "today" - Current day

     

       158
        
           - "tomorrow" - Next day

     
···

       164
        
           - "+Nd" - N days from today (e.g., "+7d" for a week from today)

     

       165
        
           - "-Nd" - N days before today (e.g., "-7d" for a week ago)

     

       166
        
           - "+Nw" - N weeks from today

     

       167
       +
           - "+Nm" - N months from today

     

       168
       +
           - "+Ny" - N years from today *)

     

       169
        
       

     

       170
        
       val parse_time : string -> (int * int * int, [> `Msg of string ]) result

     

       171
        
       (** Parse a time string in HH:MM or HH:MM:SS format. Returns Ok with (hour,

+4 -2

lib/dune

···

       13
        
         yojson

     

       14
        
         uuidm

     

       15
        
         eio

     

       16
       -
         eio_main)

     

       0
        
       
     

       0
        
       
     

       17
        
        (preprocess

     

       18
       -
         (pps ppx_deriving.show ppx_deriving.eq)))

···

       13
        
         yojson

     

       14
        
         uuidm

     

       15
        
         eio

     

       16
       +
         eio_main

     

       17
       +
         cmdliner

     

       18
       +
         sexplib)

     

       19
        
        (preprocess

     

       20
       +
         (pps ppx_deriving.show ppx_deriving.eq ppx_sexp_conv)))

+214 -61

lib/event.ml

···

       16
        
         Uuidm.to_string uuid

     

       17
        
       

     

       18
        
       let default_prodid = `Prodid (Params.empty, "-//Freumh//Caledonia//EN")

     

       0
        
       
     

       19
        
       

     

       20
        
       let create ~(fs : Eio.Fs.dir_ty Eio.Path.t) ~calendar_dir_path ~summary ~start

     

       21
        
           ?end_ ?location ?description ?recurrence calendar_name =

     
···

       26
        
           Eio.Path.(

     

       27
        
             fs / calendar_dir_path / (match calendar_name with s -> s) / file_name)

     

       28
        
         in

     

       29
       -
         let dtstart = (Params.empty, start) in

     

       30
        
         let dtend_or_duration = end_ in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       31
        
         let rrule = Option.map (fun r -> (Params.empty, r)) recurrence in

     

       32
        
         let now = Ptime_clock.now () in

     

       33
        
         let props = [ `Summary (Params.empty, summary) ] in

     
···

       57
        
           let components = [ `Event event ] in

     

       58
        
           (props, components)

     

       59
        
         in

     

       60
       -
         { calendar_name; file; event; calendar }

     

       61
        
       

     

       62
        
       let edit ?summary ?start ?end_ ?location ?description ?recurrence t =

     

       63
        
         let now = Ptime_clock.now () in

     

       64
        
         let uid = t.event.uid in

     

       65
       -
         let dtstart =

     

       66
       -
           match start with None -> t.event.dtstart | Some s -> (Params.empty, s)

     

       67
       -
         in

     

       68
        
         let dtend_or_duration =

     

       69
        
           match end_ with None -> t.event.dtend_or_duration | Some _ -> end_

     

       70
        
         in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       71
        
         let rrule =

     

       72
        
           match recurrence with

     

       73
        
           | None -> t.event.rrule

     
···

       113
        
         let calendar_name = t.calendar_name in

     

       114
        
         let file = t.file in

     

       115
        
         let calendar = t.calendar in

     

       116
       -
         { calendar_name; file; event; calendar }

     

       117
        
       

     

       118
        
       let events_of_icalendar calendar_name ~file calendar =

     

       119
        
         let remove_dup_ids lst =

     
···

       168
        
       let get_start_timezone t =

     

       169
        
         match t.event.dtstart with

     

       170
        
         | _, `Datetime (`With_tzid (_, (_, tzid))) -> Some tzid

     

       0
        
       
     

       171
        
         | _ -> None

     

       172
        
       

     

       173
        
       let get_end_timezone t =

     

       174
        
         match t.event.dtend_or_duration with

     

       175
        
         | Some (`Dtend (_, `Datetime (`With_tzid (_, (_, tzid))))) -> Some tzid

     

       0
        
       
     

       176
        
         | _ -> None

     

       177
        
       

     

       178
        
       let get_duration t =

     
···

       288
        
         in

     

       289
        
         Printf.sprintf "%s %s%s" (format_date ?tz date) (format_time ?tz date) tz_str

     

       290
        
       

     

       291
       -
       let same_day day other =

     

       292
       -
         let y1, m1, d1 = Ptime.to_date day in

     

       293
       -
         let y2, m2, d2 = Ptime.to_date other in

     

       294
       -
         y1 == y2 && m1 == m2 && d1 == d2

     

       295
       -
       

     

       296
       -
       let next_day day ~next =

     

       297
       -
         let y1, m1, d1 = Ptime.to_date day in

     

       298
       -
         let y2, m2, d2 = Ptime.to_date next in

     

       299
       -
         y1 == y2 && m1 == m2 && d1 == d2 - 1

     

       300
        
       

     

       301
        
       (* exosed from icalendar *)

     

       302
        
       

     
···

       391
        
         let start = get_start event in

     

       392
        
         let end_ = get_end event in

     

       393
        
         let start_date = format_date ?tz start in

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       394
        
         let start_time =

     

       395
       -
           match is_date event with true -> "" | false -> " " ^ format_time ?tz start

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       396
        
         in

     

       397
        
         let end_date, end_time =

     

       398
        
           match end_ with

     
···

       400
        
           | Some end_ -> (

     

       401
        
               match is_date event with

     

       402
        
               | true -> (

     

       403
       -
                   match next_day start ~next:end_ with

     

       404
        
                   | true -> ("", "")

     

       405
        
                   | false -> (" - " ^ format_date ?tz end_, ""))

     

       406
        
               | false -> (

     

       407
       -
                   match same_day start end_ with

     

       408
       -
                   | true -> ("", " - " ^ format_time ?tz end_)

     

       409
       -
                   | false -> (" - " ^ format_date ?tz end_, " " ^ format_time ?tz end_)

     

       410
       -
                   ))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       411
        
         in

     

       412
        
         let summary =

     

       413
        
           match get_summary event with

     
···

       431
        
             let id, calendar_name, date_time, summary, location =

     

       432
        
               text_event_data ?tz event

     

       433
        
             in

     

       434
       -
             Printf.sprintf "%s\t%s\t%s\t%s\t%s" id calendar_name date_time summary

     

       435
       -
               location

     

       436
        
         | `Entries ->

     

       437
        
             let format_opt label f opt =

     

       438
        
               Option.map (fun x -> Printf.sprintf "%s: %s\n" label (f x)) opt

     

       439
        
               |> Option.value ~default:""

     

       440
        
             in

     

       441
       -
             let format timezone datetime =

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       442
        
               match is_date event with

     

       443
        
               | true -> format_date ?tz datetime

     

       444
       -
               | false -> (

     

       445
       -
                   format_datetime ?tz datetime

     

       446
       -
                   ^ match timezone with None -> "" | Some t -> " (" ^ t ^ ")")

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       447
        
             in

     

       448
        
             let start_str =

     

       449
       -
               format_opt "Start" (format (get_start_timezone event)) (Some start)

     

       450
        
             in

     

       451
       -
             let end_str = format_opt "End" (format (get_end_timezone event)) end_ in

     

       0
        
       
     

       0
        
       
     

       452
        
             let location_str = format_opt "Location" Fun.id (get_location event) in

     

       453
        
             let description_str =

     

       454
        
               format_opt "Description" Fun.id (get_description event)

     
···

       514
        
             let summary =

     

       515
        
               match get_summary event with Some summary -> summary | None -> ""

     

       516
        
             in

     

       517
       -
             let start_date, start_time =

     

       518
        
               let dt = Date.ptime_to_timedesc ?tz start in

     

       519
        
               let y = Timedesc.year dt in

     

       520
        
               let m = Timedesc.month dt in

     
···

       522
        
               let h = Timedesc.hour dt in

     

       523
        
               let min = Timedesc.minute dt in

     

       524
        
               let s = Timedesc.second dt in

     

       525
       -
               let dow =

     

       526
       -
                 match Timedesc.weekday dt with

     

       527
       -
                 | `Mon -> "monday"

     

       528
       -
                 | `Tue -> "tuesday"

     

       529
       -
                 | `Wed -> "wednesday"

     

       530
       -
                 | `Thu -> "thursday"

     

       531
       -
                 | `Fri -> "friday"

     

       532
       -
                 | `Sat -> "saturday"

     

       533
       -
                 | `Sun -> "sunday"

     

       534
       -
               in

     

       535
       -
               ( Printf.sprintf "(%04d %02d %02d %s)" y m d dow,

     

       536
       -
                 Printf.sprintf "(%02d %02d %02d)" h min s )

     

       537
        
             in

     

       538
        
             let end_str =

     

       539
        
               match end_ with

     
···

       545
        
                   let h = Timedesc.hour dt in

     

       546
        
                   let min = Timedesc.minute dt in

     

       547
        
                   let s = Timedesc.second dt in

     

       548
       -
                   let dow =

     

       549
       -
                     match Timedesc.weekday dt with

     

       550
       -
                     | `Mon -> "monday"

     

       551
       -
                     | `Tue -> "tuesday"

     

       552
       -
                     | `Wed -> "wednesday"

     

       553
       -
                     | `Thu -> "thursday"

     

       554
       -
                     | `Fri -> "friday"

     

       555
       -
                     | `Sat -> "saturday"

     

       556
       -
                     | `Sun -> "sunday"

     

       557
       -
                   in

     

       558
       -
                   Printf.sprintf "((%04d %02d %02d %s) (%02d %02d %02d))" y m d dow h

     

       559
       -
                     min s

     

       560
        
               | None -> "nil"

     

       561
        
             in

     

       562
        
             let location =

     
···

       575
        
             in

     

       576
        
             let id = get_id event in

     

       577
        
             Printf.sprintf

     

       578
       -
               "((:id \"%s\" :summary \"%s\" :start (%s %s) :end %s :location %s \

     

       579
        
                :description %s :calendar %s))"

     

       580
       -
               (String.escaped id) (String.escaped summary) start_date start_time

     

       581
       -
               end_str location description calendar

     

       582
        
       

     

       583
        
       let format_events_with_dynamic_columns ?tz events =

     

       584
        
         if events = [] then ""

     
···

       600
        
               (fun acc (_, _, date, _, _) -> max acc (String.length date))

     

       601
        
               0 event_data

     

       602
        
           in

     

       603
       -
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       604
        
           (* Format each event with calculated widths *)

     

       605
        
           let formatted_events =

     

       606
        
             List.map

     

       607
        
               (fun (id, cal, date, summary, location) ->

     

       608
       -
                 Printf.sprintf "%-*s  %-*s  %-*s  %s%s" max_id_width id max_cal_width

     

       609
       -
                   cal max_date_width date summary

     

       610
       -
                   (if location <> "" then " " ^ location else ""))

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       611
        
               event_data

     

       612
        
           in

     

       613
        
           String.concat "\n" formatted_events

     
···

       686
        
               recur_events ~recurrence_ids:other_events ical_event

     

       687
        
             in

     

       688
        
             collect generator []

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       16
        
         Uuidm.to_string uuid

     

       17
        
       

     

       18
        
       let default_prodid = `Prodid (Params.empty, "-//Freumh//Caledonia//EN")

     

       19
       +
       let ( let* ) = Result.bind

     

       20
        
       

     

       21
        
       let create ~(fs : Eio.Fs.dir_ty Eio.Path.t) ~calendar_dir_path ~summary ~start

     

       22
        
           ?end_ ?location ?description ?recurrence calendar_name =

     
···

       27
        
           Eio.Path.(

     

       28
        
             fs / calendar_dir_path / (match calendar_name with s -> s) / file_name)

     

       29
        
         in

     

       30
       +
         let dtstart = start in

     

       31
        
         let dtend_or_duration = end_ in

     

       32
       +
         let* _ =

     

       33
       +
           match (dtstart, dtend_or_duration) with

     

       34
       +
           | (_, `Date _), Some (`Dtend (_, `Datetime _)) ->

     

       35
       +
               Error (`Msg "If the start is a date the end must also be a date.")

     

       36
       +
           | (_, `Datetime _), Some (`Dtend (_, `Date _)) ->

     

       37
       +
               Error

     

       38
       +
                 (`Msg "If the start is a datetime the end must also be a datetime.")

     

       39
       +
           | _ -> Ok ()

     

       40
       +
         in

     

       41
        
         let rrule = Option.map (fun r -> (Params.empty, r)) recurrence in

     

       42
        
         let now = Ptime_clock.now () in

     

       43
        
         let props = [ `Summary (Params.empty, summary) ] in

     
···

       67
        
           let components = [ `Event event ] in

     

       68
        
           (props, components)

     

       69
        
         in

     

       70
       +
         Ok { calendar_name; file; event; calendar }

     

       71
        
       

     

       72
        
       let edit ?summary ?start ?end_ ?location ?description ?recurrence t =

     

       73
        
         let now = Ptime_clock.now () in

     

       74
        
         let uid = t.event.uid in

     

       75
       +
         let dtstart = match start with None -> t.event.dtstart | Some s -> s in

     

       0
        
       
     

       0
        
       
     

       76
        
         let dtend_or_duration =

     

       77
        
           match end_ with None -> t.event.dtend_or_duration | Some _ -> end_

     

       78
        
         in

     

       79
       +
         let* _ =

     

       80
       +
           match (dtstart, dtend_or_duration) with

     

       81
       +
           | (_, `Date _), Some (`Dtend (_, `Datetime _)) ->

     

       82
       +
               Error (`Msg "If the start is a date the end must also be a date.")

     

       83
       +
           | (_, `Datetime _), Some (`Dtend (_, `Date _)) ->

     

       84
       +
               Error

     

       85
       +
                 (`Msg "If the start is a datetime the end must also be a datetime.")

     

       86
       +
           | _ -> Ok ()

     

       87
       +
         in

     

       88
        
         let rrule =

     

       89
        
           match recurrence with

     

       90
        
           | None -> t.event.rrule

     
···

       130
        
         let calendar_name = t.calendar_name in

     

       131
        
         let file = t.file in

     

       132
        
         let calendar = t.calendar in

     

       133
       +
         Ok { calendar_name; file; event; calendar }

     

       134
        
       

     

       135
        
       let events_of_icalendar calendar_name ~file calendar =

     

       136
        
         let remove_dup_ids lst =

     
···

       185
        
       let get_start_timezone t =

     

       186
        
         match t.event.dtstart with

     

       187
        
         | _, `Datetime (`With_tzid (_, (_, tzid))) -> Some tzid

     

       188
       +
         | _, `Datetime (`Utc _) -> Some "UTC"

     

       189
        
         | _ -> None

     

       190
        
       

     

       191
        
       let get_end_timezone t =

     

       192
        
         match t.event.dtend_or_duration with

     

       193
        
         | Some (`Dtend (_, `Datetime (`With_tzid (_, (_, tzid))))) -> Some tzid

     

       194
       +
         | Some (`Dtend (_, `Datetime (`Utc _))) -> Some "UTC"

     

       195
        
         | _ -> None

     

       196
        
       

     

       197
        
       let get_duration t =

     
···

       307
        
         in

     

       308
        
         Printf.sprintf "%s %s%s" (format_date ?tz date) (format_time ?tz date) tz_str

     

       309
        
       

     

       310
       +
       let day_diff day ~next =

     

       311
       +
         let span = Ptime.diff next day in

     

       312
       +
         let d, _ = Ptime.Span.to_d_ps span in

     

       313
       +
         d

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       314
        
       

     

       315
        
       (* exosed from icalendar *)

     

       316
        
       

     
···

       405
        
         let start = get_start event in

     

       406
        
         let end_ = get_end event in

     

       407
        
         let start_date = format_date ?tz start in

     

       408
       +
         let start_timezone = get_start_timezone event in

     

       409
       +
         let end_timezone = get_end_timezone event in

     

       410
       +
         let same_timezone =

     

       411
       +
           match (start_timezone, end_timezone) with

     

       412
       +
           | Some tz1, Some tz2 when tz1 = tz2 -> true

     

       413
       +
           | _ -> false

     

       414
       +
         in

     

       415
        
         let start_time =

     

       416
       +
           match is_date event with

     

       417
       +
           | true -> ""

     

       418
       +
           | false ->

     

       419
       +
               let tz_str =

     

       420
       +
                 if same_timezone then " " ^ format_time ?tz start

     

       421
       +
                 else

     

       422
       +
                   match start_timezone with

     

       423
       +
                   | Some tzid -> " " ^ format_time ?tz start ^ " (" ^ tzid ^ ")"

     

       424
       +
                   | None -> " " ^ format_time ?tz start

     

       425
       +
               in

     

       426
       +
               tz_str

     

       427
        
         in

     

       428
        
         let end_date, end_time =

     

       429
        
           match end_ with

     
···

       431
        
           | Some end_ -> (

     

       432
        
               match is_date event with

     

       433
        
               | true -> (

     

       434
       +
                   match day_diff start ~next:end_ <= 1 with

     

       435
        
                   | true -> ("", "")

     

       436
        
                   | false -> (" - " ^ format_date ?tz end_, ""))

     

       437
        
               | false -> (

     

       438
       +
                   match day_diff start ~next:end_ == 0 with

     

       439
       +
                   | true ->

     

       440
       +
                       let tz_str =

     

       441
       +
                         match end_timezone with

     

       442
       +
                         | Some tzid when same_timezone ->

     

       443
       +
                             ("", " - " ^ format_time ?tz end_ ^ " (" ^ tzid ^ ")")

     

       444
       +
                         | Some tzid ->

     

       445
       +
                             ("", " - " ^ format_time ?tz end_ ^ " (" ^ tzid ^ ")")

     

       446
       +
                         | None -> ("", " - " ^ format_time ?tz end_)

     

       447
       +
                       in

     

       448
       +
                       tz_str

     

       449
       +
                   | false ->

     

       450
       +
                       let tz_str =

     

       451
       +
                         match end_timezone with

     

       452
       +
                         | Some tzid when same_timezone ->

     

       453
       +
                             ( " - " ^ format_date ?tz end_,

     

       454
       +
                               " " ^ format_time ?tz end_ ^ " (" ^ tzid ^ ")" )

     

       455
       +
                         | Some tzid ->

     

       456
       +
                             ( " - " ^ format_date ?tz end_,

     

       457
       +
                               " " ^ format_time ?tz end_ ^ " (" ^ tzid ^ ")" )

     

       458
       +
                         | None ->

     

       459
       +
                             (" - " ^ format_date ?tz end_, " " ^ format_time ?tz end_)

     

       460
       +
                       in

     

       461
       +
                       tz_str))

     

       462
        
         in

     

       463
        
         let summary =

     

       464
        
           match get_summary event with

     
···

       482
        
             let id, calendar_name, date_time, summary, location =

     

       483
        
               text_event_data ?tz event

     

       484
        
             in

     

       485
       +
             Printf.sprintf "%s\t%s\t%s\t%s\t%s" calendar_name date_time summary

     

       486
       +
               location id

     

       487
        
         | `Entries ->

     

       488
        
             let format_opt label f opt =

     

       489
        
               Option.map (fun x -> Printf.sprintf "%s: %s\n" label (f x)) opt

     

       490
        
               |> Option.value ~default:""

     

       491
        
             in

     

       492
       +
             let start_timezone = get_start_timezone event in

     

       493
       +
             let end_timezone = get_end_timezone event in

     

       494
       +
             let same_timezone =

     

       495
       +
               match (start_timezone, end_timezone) with

     

       496
       +
               | Some tz1, Some tz2 when tz1 = tz2 -> true

     

       497
       +
               | _ -> false

     

       498
       +
             in

     

       499
       +
             let format timezone datetime is_end =

     

       500
        
               match is_date event with

     

       501
        
               | true -> format_date ?tz datetime

     

       502
       +
               | false ->

     

       503
       +
                   let tz_suffix =

     

       504
       +
                     if (not is_end) && same_timezone then ""

     

       505
       +
                     else match timezone with None -> "" | Some t -> " (" ^ t ^ ")"

     

       506
       +
                   in

     

       507
       +
                   format_datetime ?tz datetime ^ tz_suffix

     

       508
        
             in

     

       509
        
             let start_str =

     

       510
       +
               format_opt "Start" (fun d -> format start_timezone d false) (Some start)

     

       511
        
             in

     

       512
       +
             let end_str =

     

       513
       +
               format_opt "End" (fun d -> format end_timezone d true) end_

     

       514
       +
             in

     

       515
        
             let location_str = format_opt "Location" Fun.id (get_location event) in

     

       516
        
             let description_str =

     

       517
        
               format_opt "Description" Fun.id (get_description event)

     
···

       577
        
             let summary =

     

       578
        
               match get_summary event with Some summary -> summary | None -> ""

     

       579
        
             in

     

       580
       +
             let start_str =

     

       581
        
               let dt = Date.ptime_to_timedesc ?tz start in

     

       582
        
               let y = Timedesc.year dt in

     

       583
        
               let m = Timedesc.month dt in

     
···

       585
        
               let h = Timedesc.hour dt in

     

       586
        
               let min = Timedesc.minute dt in

     

       587
        
               let s = Timedesc.second dt in

     

       588
       +
               (* Format as a single timestamp string that's easy for Emacs to parse *)

     

       589
       +
               Printf.sprintf "\"%04d-%02d-%02dT%02d:%02d:%02d\"" y m d h min s

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       590
        
             in

     

       591
        
             let end_str =

     

       592
        
               match end_ with

     
···

       598
        
                   let h = Timedesc.hour dt in

     

       599
        
                   let min = Timedesc.minute dt in

     

       600
        
                   let s = Timedesc.second dt in

     

       601
       +
                   Printf.sprintf "\"%04d-%02d-%02dT%02d:%02d:%02d\"" y m d h min s

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       602
        
               | None -> "nil"

     

       603
        
             in

     

       604
        
             let location =

     
···

       617
        
             in

     

       618
        
             let id = get_id event in

     

       619
        
             Printf.sprintf

     

       620
       +
               "((:id \"%s\" :summary \"%s\" :start %s :end %s :location %s \

     

       621
        
                :description %s :calendar %s))"

     

       622
       +
               (String.escaped id) (String.escaped summary) start_str end_str location

     

       623
       +
               description calendar

     

       624
        
       

     

       625
        
       let format_events_with_dynamic_columns ?tz events =

     

       626
        
         if events = [] then ""

     
···

       642
        
               (fun acc (_, _, date, _, _) -> max acc (String.length date))

     

       643
        
               0 event_data

     

       644
        
           in

     

       645
       +
           (* Calculate max width for summary+location *)

     

       646
       +
           let max_summary_loc_width =

     

       647
       +
             List.fold_left

     

       648
       +
               (fun acc (_, _, _, summary, location) ->

     

       649
       +
                 let full_length =

     

       650
       +
                   String.length summary

     

       651
       +
                   + if location <> "" then String.length location + 1 else 0

     

       652
       +
                 in

     

       653
       +
                 max acc full_length)

     

       654
       +
               0 event_data

     

       655
       +
           in

     

       656
        
           (* Format each event with calculated widths *)

     

       657
        
           let formatted_events =

     

       658
        
             List.map

     

       659
        
               (fun (id, cal, date, summary, location) ->

     

       660
       +
                 let summary_loc =

     

       661
       +
                   summary ^ if location <> "" then " " ^ location else ""

     

       662
       +
                 in

     

       663
       +
                 Printf.sprintf "%-*s  %-*s  %-*s  %-*s" max_cal_width cal

     

       664
       +
                   max_date_width date max_summary_loc_width summary_loc max_id_width

     

       665
       +
                   id)

     

       666
        
               event_data

     

       667
        
           in

     

       668
        
           String.concat "\n" formatted_events

     
···

       741
        
               recur_events ~recurrence_ids:other_events ical_event

     

       742
        
             in

     

       743
        
             collect generator []

     

       744
       +
       

     

       745
       +
       let sexp_of_t event =

     

       746
       +
         let open Sexplib.Sexp in

     

       747
       +
         let start = get_start event in

     

       748
       +
         let end_ = get_end event in

     

       749
       +
         let format_ptime_iso p =

     

       750
       +
           let dt = Date.ptime_to_timedesc p in

     

       751
       +
           let y = Timedesc.year dt in

     

       752
       +
           let m = Timedesc.month dt in

     

       753
       +
           let d = Timedesc.day dt in

     

       754
       +
           let h = Timedesc.hour dt in

     

       755
       +
           let min = Timedesc.minute dt in

     

       756
       +
           let s = Timedesc.second dt in

     

       757
       +
           Printf.sprintf "%04d-%02d-%02dT%02d:%02d:%02d" y m d h min s

     

       758
       +
         in

     

       759
       +
         let entries =

     

       760
       +
           [

     

       761
       +
             Some (List [ Atom "id"; Atom (get_id event) ]);

     

       762
       +
             (match get_summary event with

     

       763
       +
             | Some s -> Some (List [ Atom "summary"; Atom s ])

     

       764
       +
             | None -> None);

     

       765
       +
             Some (List [ Atom "start"; Atom (format_ptime_iso start) ]);

     

       766
       +
             (match end_ with

     

       767
       +
             | Some e -> Some (List [ Atom "end"; Atom (format_ptime_iso e) ])

     

       768
       +
             | None -> None);

     

       769
       +
             (match get_location event with

     

       770
       +
             | Some l -> Some (List [ Atom "location"; Atom l ])

     

       771
       +
             | None -> None);

     

       772
       +
             (match get_description event with

     

       773
       +
             | Some d -> Some (List [ Atom "description"; Atom d ])

     

       774
       +
             | None -> None);

     

       775
       +
             Some (List [ Atom "file"; Atom (snd (get_file event)) ]);

     

       776
       +
             Some (List [ Atom "calendar"; Atom (get_calendar_name event) ]);

     

       777
       +
           ]

     

       778
       +
         in

     

       779
       +
         let filtered_entries = List.filter_map Fun.id entries in

     

       780
       +
         List filtered_entries

     

       781
       +
       

     

       782
       +
       type filter = t -> bool

     

       783
       +
       

     

       784
       +
       let text_matches pattern text =

     

       785
       +
         let re = Re.Pcre.regexp ~flags:[ `CASELESS ] (Re.Pcre.quote pattern) in

     

       786
       +
         Re.Pcre.pmatch ~rex:re text

     

       787
       +
       

     

       788
       +
       let summary_contains text event =

     

       789
       +
         match get_summary event with

     

       790
       +
         | Some summary -> text_matches text summary

     

       791
       +
         | None -> false

     

       792
       +
       

     

       793
       +
       let description_contains text event =

     

       794
       +
         match get_description event with

     

       795
       +
         | Some desc -> text_matches text desc

     

       796
       +
         | None -> false

     

       797
       +
       

     

       798
       +
       let location_contains text event =

     

       799
       +
         match get_location event with

     

       800
       +
         | Some loc -> text_matches text loc

     

       801
       +
         | None -> false

     

       802
       +
       

     

       803
       +
       let in_calendars ids event =

     

       804
       +
         let id = get_calendar_name event in

     

       805
       +
         List.exists (fun col -> col = id) ids

     

       806
       +
       

     

       807
       +
       let recurring_only () event = get_recurrence event <> None

     

       808
       +
       let non_recurring_only () event = get_recurrence event = None

     

       809
       +
       let with_id id event = get_id event = id

     

       810
       +
       let and_filter filters event = List.for_all (fun filter -> filter event) filters

     

       811
       +
       let or_filter filters event = List.exists (fun filter -> filter event) filters

     

       812
       +
       let not_filter filter event = not (filter event)

     

       813
       +
       let matches_filter event filter = filter event

     

       814
       +
       

     

       815
       +
       let take n list =

     

       816
       +
         let rec aux n lst acc =

     

       817
       +
           match (lst, n) with

     

       818
       +
           | _, 0 -> List.rev acc

     

       819
       +
           | [], _ -> List.rev acc

     

       820
       +
           | x :: xs, n -> aux (n - 1) xs (x :: acc)

     

       821
       +
         in

     

       822
       +
         aux n list []

     

       823
       +
       

     

       824
       +
       let query_without_recurrence events ?filter ?(comparator = by_start) ?limit () =

     

       825
       +
         let events =

     

       826
       +
           match filter with Some f -> List.filter f events | None -> events

     

       827
       +
         in

     

       828
       +
         let events = List.sort comparator events in

     

       829
       +
         match limit with Some n when n > 0 -> take n events | _ -> events

     

       830
       +
       

     

       831
       +
       let query events ?filter ~from ~to_ ?comparator ?limit () =

     

       832
       +
         let events =

     

       833
       +
           match filter with Some f -> List.filter f events | None -> events

     

       834
       +
         in

     

       835
       +
         let events =

     

       836
       +
           List.concat_map (fun event -> expand_recurrences event ~from ~to_) events

     

       837
       +
         in

     

       838
       +
         let events =

     

       839
       +
           match comparator with None -> events | Some c -> List.sort c events

     

       840
       +
         in

     

       841
       +
         match limit with Some n when n > 0 -> take n events | _ -> events

+54 -7

lib/event.mli

···

       8
        
       

     

       9
        
       type date_error = [ `Msg of string ]

     

       10
        
       

     

       0
        
       
     

       0
        
       
     

       11
        
       val create :

     

       12
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       13
        
         calendar_dir_path:string ->

     

       14
        
         summary:string ->

     

       15
       -
         start:Icalendar.date_or_datetime ->

     

       16
        
         ?end_:

     

       17
        
           [ `Duration of Icalendar.params * Ptime.Span.t

     

       18
        
           | `Dtend of Icalendar.params * Icalendar.date_or_datetime ] ->

     
···

       20
        
         ?description:string ->

     

       21
        
         ?recurrence:Icalendar.recurrence ->

     

       22
        
         string ->

     

       23
       -
         t

     

       24
        
       (** Create a new event with required properties.

     

       25
        
       

     

       26
        
           The start and end times can be specified as Icalendar.timestamp values,

     
···

       31
        
       

     

       32
        
       val edit :

     

       33
        
         ?summary:string ->

     

       34
       -
         ?start:Icalendar.date_or_datetime ->

     

       35
        
         ?end_:

     

       36
        
           [ `Duration of Icalendar.params * Ptime.Span.t

     

       37
        
           | `Dtend of Icalendar.params * Icalendar.date_or_datetime ] ->

     
···

       39
        
         ?description:string ->

     

       40
        
         ?recurrence:Icalendar.recurrence ->

     

       41
        
         t ->

     

       42
       -
         t

     

       43
        
       (** Edit an existing event. *)

     

       44
        
       

     

       45
        
       val events_of_icalendar :

     
···

       72
        
       val get_recurrence : t -> Icalendar.recurrence option

     

       73
        
       val get_calendar_name : t -> string

     

       74
        
       val get_file : t -> Eio.Fs.dir_ty Eio.Path.t

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       75
        
       

     

       76
        
       type comparator = t -> t -> int

     

       77
        
       (** Event comparator function type *)

     
···

       101
        
       (** Chain two comparators together, using the second one as a tiebreaker when

     

       102
        
           the first one returns equality (0) *)

     

       103
        
       

     

       104
       -
       (** Functions for formatting various data structures as strings *)

     

       105
        
       

     

       106
        
       type format = [ `Text | `Entries | `Json | `Csv | `Ics | `Sexp ]

     

       107
        
       (** Format type for output *)

     

       108
        
       

     

       109
       -
       (** Functions for formatting specific event types *)

     

       110
        
       val format_event : ?format:format -> ?tz:Timedesc.Time_zone.t -> t -> string

     

       111
        
       (** Format a single event, optionally using the specified timezone *)

     

       112
        
       

     
···

       114
        
         ?format:format -> ?tz:Timedesc.Time_zone.t -> t list -> string

     

       115
        
       (** Format a list of events, optionally using the specified timezone *)

     

       116
        
       

     

       117
       -
       val expand_recurrences : from:Ptime.t option -> to_:Ptime.t -> t -> t list

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0

···

       8
        
       

     

       9
        
       type date_error = [ `Msg of string ]

     

       10
        
       

     

       11
       +
       (** {2 Events} *)

     

       12
       +
       

     

       13
        
       val create :

     

       14
        
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       15
        
         calendar_dir_path:string ->

     

       16
        
         summary:string ->

     

       17
       +
         start:Icalendar.params * Icalendar.date_or_datetime ->

     

       18
        
         ?end_:

     

       19
        
           [ `Duration of Icalendar.params * Ptime.Span.t

     

       20
        
           | `Dtend of Icalendar.params * Icalendar.date_or_datetime ] ->

     
···

       22
        
         ?description:string ->

     

       23
        
         ?recurrence:Icalendar.recurrence ->

     

       24
        
         string ->

     

       25
       +
         (t, [> `Msg of string ]) result

     

       26
        
       (** Create a new event with required properties.

     

       27
        
       

     

       28
        
           The start and end times can be specified as Icalendar.timestamp values,

     
···

       33
        
       

     

       34
        
       val edit :

     

       35
        
         ?summary:string ->

     

       36
       +
         ?start:Icalendar.params * Icalendar.date_or_datetime ->

     

       37
        
         ?end_:

     

       38
        
           [ `Duration of Icalendar.params * Ptime.Span.t

     

       39
        
           | `Dtend of Icalendar.params * Icalendar.date_or_datetime ] ->

     
···

       41
        
         ?description:string ->

     

       42
        
         ?recurrence:Icalendar.recurrence ->

     

       43
        
         t ->

     

       44
       +
         (t, [> `Msg of string ]) result

     

       45
        
       (** Edit an existing event. *)

     

       46
        
       

     

       47
        
       val events_of_icalendar :

     
···

       74
        
       val get_recurrence : t -> Icalendar.recurrence option

     

       75
        
       val get_calendar_name : t -> string

     

       76
        
       val get_file : t -> Eio.Fs.dir_ty Eio.Path.t

     

       77
       +
       val expand_recurrences : from:Ptime.t option -> to_:Ptime.t -> t -> t list

     

       78
       +
       

     

       79
       +
       (** {2 Comparators} *)

     

       80
        
       

     

       81
        
       type comparator = t -> t -> int

     

       82
        
       (** Event comparator function type *)

     
···

       106
        
       (** Chain two comparators together, using the second one as a tiebreaker when

     

       107
        
           the first one returns equality (0) *)

     

       108
        
       

     

       109
       +
       (** 2 Formatting *)

     

       110
        
       

     

       111
        
       type format = [ `Text | `Entries | `Json | `Csv | `Ics | `Sexp ]

     

       112
        
       (** Format type for output *)

     

       113
        
       

     

       0
        
       
     

       114
        
       val format_event : ?format:format -> ?tz:Timedesc.Time_zone.t -> t -> string

     

       115
        
       (** Format a single event, optionally using the specified timezone *)

     

       116
        
       

     
···

       118
        
         ?format:format -> ?tz:Timedesc.Time_zone.t -> t list -> string

     

       119
        
       (** Format a list of events, optionally using the specified timezone *)

     

       120
        
       

     

       121
       +
       val sexp_of_t : t -> Sexplib0.Sexp.t

     

       122
       +
       

     

       123
       +
       (** 3 Queries *)

     

       124
       +
       

     

       125
       +
       (** Filter-based searching and querying of calendar events *)

     

       126
       +
       

     

       127
       +
       type filter = t -> bool

     

       128
       +
       

     

       129
       +
       val summary_contains : string -> filter

     

       130
       +
       val description_contains : string -> filter

     

       131
       +
       val location_contains : string -> filter

     

       132
       +
       val in_calendars : string list -> filter

     

       133
       +
       val recurring_only : unit -> filter

     

       134
       +
       val non_recurring_only : unit -> filter

     

       135
       +
       val with_id : event_id -> filter

     

       136
       +
       val and_filter : filter list -> filter

     

       137
       +
       val or_filter : filter list -> filter

     

       138
       +
       val not_filter : filter -> filter

     

       139
       +
       

     

       140
       +
       val query_without_recurrence :

     

       141
       +
         t list ->

     

       142
       +
         ?filter:filter ->

     

       143
       +
         ?comparator:comparator ->

     

       144
       +
         ?limit:int ->

     

       145
       +
         unit ->

     

       146
       +
         t list

     

       147
       +
       (** Find events without expansion of recurring events. Returns Ok with the list

     

       148
       +
           of events, or Error with a message. *)

     

       149
       +
       

     

       150
       +
       val query :

     

       151
       +
         t list ->

     

       152
       +
         ?filter:filter ->

     

       153
       +
         from:Ptime.t option ->

     

       154
       +
         to_:Ptime.t ->

     

       155
       +
         ?comparator:comparator ->

     

       156
       +
         ?limit:int ->

     

       157
       +
         unit ->

     

       158
       +
         t list

     

       159
       +
       (** Find events with expansion of recurring events. Returns Ok with the list of

     

       160
       +
           events, or Error with a message. *)

     

       161
       +
       

     

       162
       +
       (* Test-only helper functions *)

     

       163
       +
       val matches_filter : t -> filter -> bool

     

       164
       +
       (** Check if an event matches the given filter *)

-70

lib/query.ml

···

       1
       -
       type filter = Event.t -> bool

     

       2
       -
       

     

       3
       -
       let text_matches pattern text =

     

       4
       -
         let re = Re.Pcre.regexp ~flags:[ `CASELESS ] (Re.Pcre.quote pattern) in

     

       5
       -
         Re.Pcre.pmatch ~rex:re text

     

       6
       -
       

     

       7
       -
       let summary_contains text event =

     

       8
       -
         match Event.get_summary event with

     

       9
       -
         | Some summary -> text_matches text summary

     

       10
       -
         | None -> false

     

       11
       -
       

     

       12
       -
       let description_contains text event =

     

       13
       -
         match Event.get_description event with

     

       14
       -
         | Some desc -> text_matches text desc

     

       15
       -
         | None -> false

     

       16
       -
       

     

       17
       -
       let location_contains text event =

     

       18
       -
         match Event.get_location event with

     

       19
       -
         | Some loc -> text_matches text loc

     

       20
       -
         | None -> false

     

       21
       -
       

     

       22
       -
       let in_calendar_names ids event =

     

       23
       -
         let id = Event.get_calendar_name event in

     

       24
       -
         List.exists (fun col -> col = id) ids

     

       25
       -
       

     

       26
       -
       let recurring_only () event = Event.get_recurrence event <> None

     

       27
       -
       let non_recurring_only () event = Event.get_recurrence event = None

     

       28
       -
       let with_id id event = Event.get_id event = id

     

       29
       -
       let and_filter filters event = List.for_all (fun filter -> filter event) filters

     

       30
       -
       let or_filter filters event = List.exists (fun filter -> filter event) filters

     

       31
       -
       let not_filter filter event = not (filter event)

     

       32
       -
       let matches_filter event filter = filter event

     

       33
       -
       

     

       34
       -
       let take n list =

     

       35
       -
         let rec aux n lst acc =

     

       36
       -
           match (lst, n) with

     

       37
       -
           | _, 0 -> List.rev acc

     

       38
       -
           | [], _ -> List.rev acc

     

       39
       -
           | x :: xs, n -> aux (n - 1) xs (x :: acc)

     

       40
       -
         in

     

       41
       -
         aux n list []

     

       42
       -
       

     

       43
       -
       let ( let* ) = Result.bind

     

       44
       -
       

     

       45
       -
       let query_without_recurrence ~fs calendar_dir ?filter

     

       46
       -
           ?(comparator = Event.by_start) ?limit () =

     

       47
       -
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       48
       -
         let filtered_events =

     

       49
       -
           match filter with Some f -> List.filter f events | None -> events

     

       50
       -
         in

     

       51
       -
         let sorted_events = List.sort comparator filtered_events in

     

       52
       -
         Ok

     

       53
       -
           (match limit with

     

       54
       -
           | Some n when n > 0 -> take n sorted_events

     

       55
       -
           | _ -> sorted_events)

     

       56
       -
       

     

       57
       -
       let query ~fs calendar_dir ?filter ~from ~to_ ?(comparator = Event.by_start)

     

       58
       -
           ?limit () =

     

       59
       -
         let* events = Calendar_dir.get_events ~fs calendar_dir in

     

       60
       -
         let events =

     

       61
       -
           match filter with Some f -> List.filter f events | None -> events

     

       62
       -
         in

     

       63
       -
         let events =

     

       64
       -
           List.concat_map

     

       65
       -
             (fun event -> Event.expand_recurrences event ~from ~to_)

     

       66
       -
             events

     

       67
       -
         in

     

       68
       -
         let sorted_events = List.sort comparator events in

     

       69
       -
         Ok

     

       70
       -
           (match limit with Some n when n > 0 -> take n events | _ -> sorted_events)

-42

lib/query.mli

···

       1
       -
       (** Filter-based searching and querying of calendar events *)

     

       2
       -
       

     

       3
       -
       type filter = Event.t -> bool

     

       4
       -
       

     

       5
       -
       val summary_contains : string -> filter

     

       6
       -
       val description_contains : string -> filter

     

       7
       -
       val location_contains : string -> filter

     

       8
       -
       val in_calendar_names : string list -> filter

     

       9
       -
       val recurring_only : unit -> filter

     

       10
       -
       val non_recurring_only : unit -> filter

     

       11
       -
       val with_id : Event.event_id -> filter

     

       12
       -
       val and_filter : filter list -> filter

     

       13
       -
       val or_filter : filter list -> filter

     

       14
       -
       val not_filter : filter -> filter

     

       15
       -
       

     

       16
       -
       val query_without_recurrence :

     

       17
       -
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       18
       -
         Calendar_dir.t ->

     

       19
       -
         ?filter:filter ->

     

       20
       -
         ?comparator:Event.comparator ->

     

       21
       -
         ?limit:int ->

     

       22
       -
         unit ->

     

       23
       -
         (Event.t list, [> `Msg of string ]) result

     

       24
       -
       (** Find events without expansion of recurring events. Returns Ok with the list

     

       25
       -
           of events, or Error with a message. *)

     

       26
       -
       

     

       27
       -
       val query :

     

       28
       -
         fs:Eio.Fs.dir_ty Eio.Path.t ->

     

       29
       -
         Calendar_dir.t ->

     

       30
       -
         ?filter:filter ->

     

       31
       -
         from:Ptime.t option ->

     

       32
       -
         to_:Ptime.t ->

     

       33
       -
         ?comparator:Event.comparator ->

     

       34
       -
         ?limit:int ->

     

       35
       -
         unit ->

     

       36
       -
         (Event.t list, [> `Msg of string ]) result

     

       37
       -
       (** Find events with expansion of recurring events. Returns Ok with the list of

     

       38
       -
           events, or Error with a message. *)

     

       39
       -
       

     

       40
       -
       (* Test-only helper functions *)

     

       41
       -
       val matches_filter : Event.t -> filter -> bool

     

       42
       -
       (** Check if an event matches the given filter *)

+120

lib/sexp.ml

···

       1
       +
       open Sexplib.Std

     

       2
       +
       

     

       3
       +
       type search_field = Summary | Description | Location [@@deriving sexp]

     

       4
       +
       

     

       5
       +
       type query_request = {

     

       6
       +
         from : string option; [@sexp.option]

     

       7
       +
         to_ : string; (* Required field, not optional *)

     

       8
       +
         timezone : string option; [@sexp.option]

     

       9
       +
         calendars : string list; [@default []]

     

       10
       +
         text : string option; [@sexp.option]

     

       11
       +
         search_in : search_field list; [@default []]

     

       12
       +
         id : string option; [@sexp.option]

     

       13
       +
         recurring : bool option; [@sexp.option]

     

       14
       +
         limit : int option; [@sexp.option]

     

       15
       +
       }

     

       16
       +
       [@@deriving sexp]

     

       17
       +
       

     

       18
       +
       (* workaround https://github.com/janestreet/ppx_sexp_conv/issues/18#issuecomment-2792574295 *)

     

       19
       +
       let query_request_of_sexp sexp =

     

       20
       +
         let open Sexplib.Sexp in

     

       21
       +
         let sexp = match sexp with

     

       22
       +
           | List ss ->

     

       23
       +
             List (List.map (function List (Atom "to" :: v) -> List (Atom "to_" :: v) | v -> v) ss)

     

       24
       +
           | v -> v

     

       25
       +
         in

     

       26
       +
         query_request_of_sexp sexp

     

       27
       +
       

     

       28
       +
       let sexp_of_query_request q =

     

       29
       +
         let open Sexplib.Sexp in

     

       30
       +
         let sexp = sexp_of_query_request q in

     

       31
       +
         let sexp = match sexp with

     

       32
       +
           | List ss ->

     

       33
       +
             List (List.map (function List (Atom "to_" :: v) -> List (Atom "to" :: v) | v -> v) ss)

     

       34
       +
           | v -> v

     

       35
       +
         in

     

       36
       +
         sexp

     

       37
       +
       

     

       38
       +
       type request = ListCalendars | Query of query_request | Refresh [@@deriving sexp]

     

       39
       +
       

     

       40
       +
       type response_payload = Calendars of string list | Events of Event.t list | Empty

     

       41
       +
       [@@deriving sexp_of]

     

       42
       +
       

     

       43
       +
       type response = Ok of response_payload | Error of string [@@deriving sexp_of]

     

       44
       +
       

     

       45
       +
       let filter_func_of_search_field text = function

     

       46
       +
         | Summary -> Event.summary_contains text

     

       47
       +
         | Description -> Event.description_contains text

     

       48
       +
         | Location -> Event.location_contains text

     

       49
       +
       

     

       50
       +
       let parse_timezone ~timezone =

     

       51
       +
         match timezone with

     

       52
       +
         | Some tzid -> (

     

       53
       +
             match Timedesc.Time_zone.make tzid with

     

       54
       +
             | Some tz -> tz

     

       55
       +
             | None -> failwith ("Invalid timezone: " ^ tzid))

     

       56
       +
         | None -> !Date.default_timezone ()

     

       57
       +
       

     

       58
       +
       let generate_query_params (req : query_request) =

     

       59
       +
         let ( let* ) = Result.bind in

     

       60
       +
         let tz = parse_timezone ~timezone:req.timezone in

     

       61
       +
         let* from =

     

       62
       +
           match req.from with

     

       63
       +
           | None -> Ok None

     

       64
       +
           | Some s -> Result.map Option.some (Date.parse_date ~tz s `From)

     

       65
       +
         in

     

       66
       +
         let* to_ =

     

       67
       +
           let* to_date = Date.parse_date ~tz req.to_ `To in

     

       68
       +
           Ok (Date.to_end_of_day to_date)

     

       69
       +
         in

     

       70
       +
         let filters = ref [] in

     

       71
       +
         (match req.calendars with

     

       72
       +
         | [] -> ()

     

       73
       +
         | cals -> filters := Event.in_calendars cals :: !filters);

     

       74
       +
         (match req.text with

     

       75
       +
         | Some text ->

     

       76
       +
             let search_fields =

     

       77
       +
               match req.search_in with

     

       78
       +
               | [] -> [ Summary; Description; Location ]

     

       79
       +
               | fields -> fields

     

       80
       +
             in

     

       81
       +
             let text_filters =

     

       82
       +
               List.map (filter_func_of_search_field text) search_fields

     

       83
       +
             in

     

       84
       +
             filters := Event.or_filter text_filters :: !filters

     

       85
       +
         | None -> ());

     

       86
       +
         (match req.id with

     

       87
       +
         | Some id -> filters := Event.with_id id :: !filters

     

       88
       +
         | None -> ());

     

       89
       +
         (match req.recurring with

     

       90
       +
         | Some true -> filters := Event.recurring_only () :: !filters

     

       91
       +
         | Some false -> filters := Event.non_recurring_only () :: !filters

     

       92
       +
         | _ -> ());

     

       93
       +
         let final_filter = Event.and_filter !filters in

     

       94
       +
         let limit = req.limit in

     

       95
       +
         Ok (final_filter, from, to_, limit, tz)

     

       96
       +
       

     

       97
       +
       let is_whitespace = function ' ' | '\t' | '\n' | '\r' -> true | _ -> false

     

       98
       +
       

     

       99
       +
       let needs_quotes s =

     

       100
       +
         String.exists

     

       101
       +
           (fun c -> is_whitespace c || c = '(' || c = ')' || c = '"' || c = '\'')

     

       102
       +
           s

     

       103
       +
       

     

       104
       +
       let escape s =

     

       105
       +
         let buf = Buffer.create (String.length s) in

     

       106
       +
         String.iter

     

       107
       +
           (function

     

       108
       +
             | '"' -> Buffer.add_string buf "\\\""

     

       109
       +
             | '\\' -> Buffer.add_string buf "\\\\"

     

       110
       +
             | '\n' -> Buffer.add_string buf "\\n"

     

       111
       +
             | '\r' -> Buffer.add_string buf "\\r"

     

       112
       +
             | '\t' -> Buffer.add_string buf "\\t"

     

       113
       +
             | c -> Buffer.add_char buf c)

     

       114
       +
           s;

     

       115
       +
         "\"" ^ Buffer.contents buf ^ "\""

     

       116
       +
       

     

       117
       +
       let rec to_string = function

     

       118
       +
         | Sexplib.Sexp.Atom str -> if needs_quotes str then escape str else str

     

       119
       +
         | Sexplib.Sexp.List lst ->

     

       120
       +
             "(" ^ String.concat " " (List.map to_string lst) ^ ")"

+1 -1

test/dune

···

       1
        
       (tests

     

       2
       -
        (names test_calendar_dir test_query)

     

       3
        
        (libraries caledonia_lib alcotest str ptime)

     

       4
        
        (deps

     

       5
        
         (source_tree calendar)))

···

       1
        
       (tests

     

       2
       +
        (names test_calendar_dir test_date test_event)

     

       3
        
        (libraries caledonia_lib alcotest str ptime)

     

       4
        
        (deps

     

       5
        
         (source_tree calendar)))

+13 -7

test/test_date.ml

···

       1
        
       (* Test the Date module *)

     

       2
        
       

     

       0
        
       
     

       0
        
       
     

       3
        
       (* Setup a fixed date for testing *)

     

       4
        
       let fixed_date = Option.get @@ Ptime.of_date_time ((2025, 3, 27), ((0, 0, 0), 0))

     

       5
        
       

     

       6
        
       let setup_fixed_date () =

     

       7
       -
         (Date.get_today := fun () -> fixed_date);

     

       8
        
         fixed_date

     

       9
        
       

     

       10
        
       let test_parse_date () =

     

       11
        
         let test_expr expr parameter expected =

     

       12
        
           try

     

       13
       -
             let result = Query.parse_date expr parameter in

     

       14
        
             let result_str =

     

       15
        
               let y, m, d = Ptime.to_date result in

     

       16
        
               Printf.sprintf "%04d-%02d-%02d" y m d

     
···

       47
        
         test_expr "+1m" `To "2025-04-30";

     

       48
        
         test_expr "2025-01-01" `From "2025-01-01";

     

       49
        
         test_expr "2025-01-01" `To "2025-01-01";

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       50
        
         (try

     

       51
       -
            let _ = Query.parse_date "invalid-format" `From in

     

       52
        
            Alcotest.fail "Should have raised an exception for invalid format"

     

       53
        
          with Failure msg ->

     

       54
        
            Alcotest.(check bool)

     
···

       56
        
              (String.length msg > 0));

     

       57
        
         ()

     

       58
        
       

     

       59
       -
       let date_tests fs = [ ("date expression parsing", `Quick, test_parse_date) ]

     

       60
        
       

     

       61
        
       let () =

     

       62
       -
         Eio_main.run @@ fun env ->

     

       63
       -
         let fs = Eio.Stdenv.fs env in

     

       64
        
         let _ = setup_fixed_date () in

     

       65
       -
         Alcotest.run "Query Tests" [ ("query", date_tests fs) ]

···

       1
        
       (* Test the Date module *)

     

       2
        
       

     

       3
       +
       open Caledonia_lib

     

       4
       +
       

     

       5
        
       (* Setup a fixed date for testing *)

     

       6
        
       let fixed_date = Option.get @@ Ptime.of_date_time ((2025, 3, 27), ((0, 0, 0), 0))

     

       7
        
       

     

       8
        
       let setup_fixed_date () =

     

       9
       +
         (Date.get_today := fun ?tz:_ () -> fixed_date);

     

       10
        
         fixed_date

     

       11
        
       

     

       12
        
       let test_parse_date () =

     

       13
        
         let test_expr expr parameter expected =

     

       14
        
           try

     

       15
       +
             let result = Result.get_ok @@ Date.parse_date expr parameter in

     

       16
        
             let result_str =

     

       17
        
               let y, m, d = Ptime.to_date result in

     

       18
        
               Printf.sprintf "%04d-%02d-%02d" y m d

     
···

       49
        
         test_expr "+1m" `To "2025-04-30";

     

       50
        
         test_expr "2025-01-01" `From "2025-01-01";

     

       51
        
         test_expr "2025-01-01" `To "2025-01-01";

     

       52
       +
         test_expr "2025-01" `From "2025-01-01";

     

       53
       +
         test_expr "2025-01" `To "2025-01-01";

     

       54
       +
         test_expr "2025" `From "2025-01-01";

     

       55
       +
         test_expr "2025" `To "2025-01-01";

     

       56
       +
         test_expr "2025-3-1" `From "2025-03-01";

     

       57
       +
         test_expr "2025-3-1" `To "2025-03-01";

     

       58
        
         (try

     

       59
       +
            let _ = Result.get_ok @@ Date.parse_date "invalid-format" `From in

     

       60
        
            Alcotest.fail "Should have raised an exception for invalid format"

     

       61
        
          with Failure msg ->

     

       62
        
            Alcotest.(check bool)

     
···

       64
        
              (String.length msg > 0));

     

       65
        
         ()

     

       66
        
       

     

       67
       +
       let date_tests = [ ("date expression parsing", `Quick, test_parse_date) ]

     

       68
        
       

     

       69
        
       let () =

     

       0
        
       
     

       0
        
       
     

       70
        
         let _ = setup_fixed_date () in

     

       71
       +
         Alcotest.run "Query Tests" [ ("query", date_tests) ]

+322

test/test_event.ml

···

       1
       +
       (* Test the Query module *)

     

       2
       +
       

     

       3
       +
       open Caledonia_lib

     

       4
       +
       

     

       5
       +
       (* Setup a fixed date for testing *)

     

       6
       +
       let fixed_date = Option.get @@ Ptime.of_date_time ((2025, 3, 27), ((0, 0, 0), 0))

     

       7
       +
       

     

       8
       +
       let setup_fixed_date () =

     

       9
       +
         (Date.get_today := fun ?tz:_ () -> fixed_date);

     

       10
       +
         fixed_date

     

       11
       +
       

     

       12
       +
       let calendar_dir_path = Filename.concat (Sys.getcwd ()) "calendar"

     

       13
       +
       

     

       14
       +
       let test_query_all ~fs () =

     

       15
       +
         let calendar_dir =

     

       16
       +
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       17
       +
         in

     

       18
       +
         let from =

     

       19
       +
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       20
       +
         in

     

       21
       +
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       22
       +
         let events = Result.get_ok @@ Calendar_dir.get_events ~fs calendar_dir in

     

       23
       +
         let events = Event.query events ~from ~to_ () in

     

       24
       +
         Alcotest.(check int) "Should find events" 791 (List.length events);

     

       25
       +
         let test_event =

     

       26
       +
           List.find_opt

     

       27
       +
             (fun event -> Option.get @@ Event.get_summary event = "Test Event")

     

       28
       +
             events

     

       29
       +
         in

     

       30
       +
         Alcotest.(check bool) "Should find Test Event" true (test_event <> None)

     

       31
       +
       

     

       32
       +
       let test_recurrence_expansion ~fs () =

     

       33
       +
         let calendar_dir =

     

       34
       +
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       35
       +
         in

     

       36
       +
         let from =

     

       37
       +
           Some (Option.get @@ Ptime.of_date_time ((2025, 3, 1), ((0, 0, 0), 0)))

     

       38
       +
         in

     

       39
       +
         let to_ =

     

       40
       +
           Option.get @@ Ptime.of_date_time ((2025, 5, 31), ((23, 59, 59), 0))

     

       41
       +
         in

     

       42
       +
         let events = Result.get_ok @@ Calendar_dir.get_events ~fs calendar_dir in

     

       43
       +
         let events = Event.query events ~from ~to_ () in

     

       44
       +
         let recurring_events =

     

       45
       +
           List.filter

     

       46
       +
             (fun event -> Option.get @@ Event.get_summary event = "Recurring Event")

     

       47
       +
             events

     

       48
       +
         in

     

       49
       +
         Alcotest.(check bool)

     

       50
       +
           "Should find multiple recurring event events" true

     

       51
       +
           (List.length recurring_events > 1)

     

       52
       +
       

     

       53
       +
       let test_text_search ~fs () =

     

       54
       +
         let calendar_dir =

     

       55
       +
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       56
       +
         in

     

       57
       +
         let filter = Event.summary_contains "Test" in

     

       58
       +
         let from =

     

       59
       +
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       60
       +
         in

     

       61
       +
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       62
       +
         let events = Result.get_ok @@ Calendar_dir.get_events ~fs calendar_dir in

     

       63
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       64
       +
          Alcotest.(check int)

     

       65
       +
            "Should find event with 'Test' in summary" 2 (List.length events));

     

       66
       +
         let filter = Event.location_contains "Weekly" in

     

       67
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       68
       +
          Alcotest.(check int)

     

       69
       +
            "Should find event with 'Weekly' in location" 10 (List.length events));

     

       70
       +
         let filter =

     

       71
       +
           Event.and_filter

     

       72
       +
             [ Event.summary_contains "Test"; Event.description_contains "test" ]

     

       73
       +
         in

     

       74
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       75
       +
          Alcotest.(check int)

     

       76
       +
            "Should find events matching combined and criteria" 2 (List.length events));

     

       77
       +
         let filter =

     

       78
       +
           Event.or_filter

     

       79
       +
             [ Event.summary_contains "Test"; Event.location_contains "Weekly" ]

     

       80
       +
         in

     

       81
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       82
       +
          Alcotest.(check int)

     

       83
       +
            "Should find events matching combined or criteria" 12 (List.length events));

     

       84
       +
         ()

     

       85
       +
       

     

       86
       +
       let test_calendar_filter ~fs () =

     

       87
       +
         let calendar_dir =

     

       88
       +
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       89
       +
         in

     

       90
       +
         let from =

     

       91
       +
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       92
       +
         in

     

       93
       +
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       94
       +
         let calendar_name = "example" in

     

       95
       +
         let filter = Event.in_calendars [ calendar_name ] in

     

       96
       +
         let events = Result.get_ok @@ Calendar_dir.get_events ~fs calendar_dir in

     

       97
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       98
       +
          let all_match_calendar =

     

       99
       +
            List.for_all

     

       100
       +
              (fun e ->

     

       101
       +
                match Event.get_calendar_name e with id -> id = calendar_name)

     

       102
       +
              events

     

       103
       +
          in

     

       104
       +
          Alcotest.(check bool)

     

       105
       +
            (Printf.sprintf "All events should be from calendar '%s'" calendar_name)

     

       106
       +
            true all_match_calendar;

     

       107
       +
          Alcotest.(check int) "Should find events" 2 (List.length events));

     

       108
       +
         let calendar_names = [ "example"; "recurrence" ] in

     

       109
       +
         let filter = Event.in_calendars calendar_names in

     

       110
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       111
       +
          Alcotest.(check int) "Should find events" 791 (List.length events));

     

       112
       +
         let filter = Event.in_calendars [ "non-existent-calendar" ] in

     

       113
       +
         (let events = Event.query events ~from ~to_ ~filter () in

     

       114
       +
          Alcotest.(check int)

     

       115
       +
            "Should find 0 events for non-existent calendar" 0 (List.length events));

     

       116
       +
         ()

     

       117
       +
       

     

       118
       +
       let test_events ~fs =

     

       119
       +
         (* Create a test event with specific text in all fields *)

     

       120
       +
         let create_test_event ~calendar_name ~summary ~description ~location ~start =

     

       121
       +
           Event.create ~fs ~calendar_dir_path ~summary ~start

     

       122
       +
             ?description:(if description = "" then None else Some description)

     

       123
       +
             ?location:(if location = "" then None else Some location)

     

       124
       +
             calendar_name

     

       125
       +
         in

     

       126
       +
         [

     

       127
       +
           (* Event with text in all fields *)

     

       128
       +
           Result.get_ok

     

       129
       +
           @@ create_test_event ~calendar_name:"search_test" ~summary:"Project Meeting"

     

       130
       +
                ~description:"Weekly project status meeting with team"

     

       131
       +
                ~location:"Conference Room A"

     

       132
       +
                ~start:(Icalendar.Params.empty, `Datetime (`Utc fixed_date));

     

       133
       +
           (* Event with mixed case to test case insensitivity *)

     

       134
       +
           Result.get_ok

     

       135
       +
           @@ create_test_event ~calendar_name:"search_test"

     

       136
       +
                ~summary:"IMPORTANT Meeting"

     

       137
       +
                ~description:"Critical project review with stakeholders"

     

       138
       +
                ~location:"Executive Suite"

     

       139
       +
                ~start:(Icalendar.Params.empty, `Datetime (`Utc fixed_date));

     

       140
       +
           (* Event with word fragments *)

     

       141
       +
           Result.get_ok

     

       142
       +
           @@ create_test_event ~calendar_name:"search_test" ~summary:"Conference Call"

     

       143
       +
                ~description:"International conference preparation"

     

       144
       +
                ~location:"Remote Meeting Room"

     

       145
       +
                ~start:(Icalendar.Params.empty, `Datetime (`Utc fixed_date));

     

       146
       +
           (* Event with unique text in each field *)

     

       147
       +
           Result.get_ok

     

       148
       +
           @@ create_test_event ~calendar_name:"search_test"

     

       149
       +
                ~summary:"Workshop on Testing"

     

       150
       +
                ~description:"Quality Assurance techniques and practices"

     

       151
       +
                ~location:"Training Center"

     

       152
       +
                ~start:(Icalendar.Params.empty, `Datetime (`Utc fixed_date));

     

       153
       +
         ]

     

       154
       +
       

     

       155
       +
       (* Test helper to verify if a list of events contains an event with a given summary *)

     

       156
       +
       let contains_summary events summary =

     

       157
       +
         List.exists

     

       158
       +
           (fun e -> String.equal (Option.get @@ Event.get_summary e) summary)

     

       159
       +
           events

     

       160
       +
       

     

       161
       +
       let test_case_insensitive_search ~fs () =

     

       162
       +
         (* Test lowercase query for an uppercase word *)

     

       163
       +
         let lowercase_filter = Event.summary_contains "important" in

     

       164
       +
         let matches =

     

       165
       +
           List.filter

     

       166
       +
             (fun e -> Event.matches_filter e lowercase_filter)

     

       167
       +
             (test_events ~fs)

     

       168
       +
         in

     

       169
       +
         Alcotest.(check bool)

     

       170
       +
           "Lowercase query should match uppercase text in summary" true

     

       171
       +
           (contains_summary matches "IMPORTANT Meeting");

     

       172
       +
         (* Test uppercase query for a lowercase word *)

     

       173
       +
         let uppercase_filter = Event.description_contains "WEEKLY" in

     

       174
       +
         let matches =

     

       175
       +
           List.filter

     

       176
       +
             (fun e -> Event.matches_filter e uppercase_filter)

     

       177
       +
             (test_events ~fs)

     

       178
       +
         in

     

       179
       +
         Alcotest.(check bool)

     

       180
       +
           "Uppercase query should match lowercase text in description" true

     

       181
       +
           (contains_summary matches "Project Meeting")

     

       182
       +
       

     

       183
       +
       let test_partial_word_matching ~fs () =

     

       184
       +
         (* Test searching for part of a word *)

     

       185
       +
         let partial_filter = Event.summary_contains "Conf" in

     

       186
       +
         (* Should match "Conference" *)

     

       187
       +
         let matches =

     

       188
       +
           List.filter

     

       189
       +
             (fun e -> Event.matches_filter e partial_filter)

     

       190
       +
             (test_events ~fs)

     

       191
       +
         in

     

       192
       +
         Alcotest.(check bool)

     

       193
       +
           "Partial query should match full word in summary" true

     

       194
       +
           (contains_summary matches "Conference Call");

     

       195
       +
         (* Test another partial word in description *)

     

       196
       +
         let partial_filter = Event.description_contains "nation" in

     

       197
       +
         (* Should match "International" *)

     

       198
       +
         let matches =

     

       199
       +
           List.filter

     

       200
       +
             (fun e -> Event.matches_filter e partial_filter)

     

       201
       +
             (test_events ~fs)

     

       202
       +
         in

     

       203
       +
         Alcotest.(check bool)

     

       204
       +
           "Partial query should match within word in description" true

     

       205
       +
           (contains_summary matches "Conference Call");

     

       206
       +
       

     

       207
       +
         Alcotest.(check bool)

     

       208
       +
           "Partial query should match within word in description" true

     

       209
       +
           (contains_summary matches "Conference Call")

     

       210
       +
       

     

       211
       +
       let test_boolean_logic ~fs () =

     

       212
       +
         (* Test AND filter *)

     

       213
       +
         let and_filter =

     

       214
       +
           Event.and_filter

     

       215
       +
             [ Event.summary_contains "Meeting"; Event.description_contains "project" ]

     

       216
       +
         in

     

       217
       +
         let matches =

     

       218
       +
           List.filter (fun e -> Event.matches_filter e and_filter) (test_events ~fs)

     

       219
       +
         in

     

       220
       +
         Alcotest.(check int)

     

       221
       +
           "AND filter should match events with both terms" 2

     

       222
       +
           (* Two events have both "Meeting" in summary and "project" in description *)

     

       223
       +
           (List.length matches);

     

       224
       +
         (* Test OR filter *)

     

       225
       +
         let or_filter =

     

       226
       +
           Event.or_filter

     

       227
       +
             [ Event.summary_contains "Workshop"; Event.summary_contains "Conference" ]

     

       228
       +
         in

     

       229
       +
         let matches =

     

       230
       +
           List.filter (fun e -> Event.matches_filter e or_filter) (test_events ~fs)

     

       231
       +
         in

     

       232
       +
         Alcotest.(check int)

     

       233
       +
           "OR filter should match events with either term"

     

       234
       +
           2 (* One event has "Workshop", one has "Conference" *)

     

       235
       +
           (List.length matches);

     

       236
       +
       

     

       237
       +
         (* Test NOT filter *)

     

       238
       +
         let not_filter = Event.not_filter (Event.summary_contains "Meeting") in

     

       239
       +
         let matches =

     

       240
       +
           List.filter (fun e -> Event.matches_filter e not_filter) (test_events ~fs)

     

       241
       +
         in

     

       242
       +
         Alcotest.(check int)

     

       243
       +
           "NOT filter should match events without the term"

     

       244
       +
           2 (* Two events don't have "Meeting" in the summary *)

     

       245
       +
           (List.length matches);

     

       246
       +
         (* Test complex combination: (Meeting AND project) OR Workshop BUT NOT Conference *)

     

       247
       +
         let complex_filter =

     

       248
       +
           Event.and_filter

     

       249
       +
             [

     

       250
       +
               Event.or_filter

     

       251
       +
                 [

     

       252
       +
                   Event.and_filter

     

       253
       +
                     [

     

       254
       +
                       Event.summary_contains "Meeting";

     

       255
       +
                       Event.description_contains "project";

     

       256
       +
                     ];

     

       257
       +
                   Event.summary_contains "Workshop";

     

       258
       +
                 ];

     

       259
       +
               Event.not_filter (Event.summary_contains "Conference");

     

       260
       +
             ]

     

       261
       +
         in

     

       262
       +
         let matches =

     

       263
       +
           List.filter

     

       264
       +
             (fun e -> Event.matches_filter e complex_filter)

     

       265
       +
             (test_events ~fs)

     

       266
       +
         in

     

       267
       +
         Alcotest.(check int)

     

       268
       +
           "Complex filter should match correctly"

     

       269
       +
           3 (* Three events should match the complex criteria *)

     

       270
       +
           (List.length matches)

     

       271
       +
       

     

       272
       +
       let test_cross_field_search ~fs () =

     

       273
       +
         (* Search for a term that appears in multiple fields across different events *)

     

       274
       +
         let term_filter =

     

       275
       +
           Event.or_filter

     

       276
       +
             [

     

       277
       +
               Event.summary_contains "meeting";

     

       278
       +
               Event.description_contains "meeting";

     

       279
       +
               Event.location_contains "meeting";

     

       280
       +
             ]

     

       281
       +
         in

     

       282
       +
         let matches =

     

       283
       +
           List.filter (fun e -> Event.matches_filter e term_filter) (test_events ~fs)

     

       284
       +
         in

     

       285
       +
         Alcotest.(check int)

     

       286
       +
           "Cross-field search should find all occurrences"

     

       287
       +
           3 (* "meeting" appears in 3 events across different fields *)

     

       288
       +
           (List.length matches);

     

       289
       +
         (* Another test with a different term *)

     

       290
       +
         let term_filter =

     

       291
       +
           Event.or_filter

     

       292
       +
             [

     

       293
       +
               Event.summary_contains "conference";

     

       294
       +
               Event.description_contains "conference";

     

       295
       +
               Event.location_contains "conference";

     

       296
       +
             ]

     

       297
       +
         in

     

       298
       +
         let matches =

     

       299
       +
           List.filter (fun e -> Event.matches_filter e term_filter) (test_events ~fs)

     

       300
       +
         in

     

       301
       +
         Alcotest.(check int)

     

       302
       +
           "Cross-field search should find all occurrences of 'conference'"

     

       303
       +
           2 (* "conference" appears in 2 events across different fields *)

     

       304
       +
           (List.length matches)

     

       305
       +
       

     

       306
       +
       let query_tests fs =

     

       307
       +
         [

     

       308
       +
           ("query all events", `Quick, test_query_all ~fs);

     

       309
       +
           ("recurrence expansion", `Quick, test_recurrence_expansion ~fs);

     

       310
       +
           ("text search", `Quick, test_text_search ~fs);

     

       311
       +
           ("calendar filter", `Quick, test_calendar_filter ~fs);

     

       312
       +
           ("case insensitive search", `Quick, test_case_insensitive_search ~fs);

     

       313
       +
           ("partial word matching", `Quick, test_partial_word_matching ~fs);

     

       314
       +
           ("boolean logic filters", `Quick, test_boolean_logic ~fs);

     

       315
       +
           ("cross-field searching", `Quick, test_cross_field_search ~fs);

     

       316
       +
         ]

     

       317
       +
       

     

       318
       +
       let () =

     

       319
       +
         Eio_main.run @@ fun env ->

     

       320
       +
         let fs = Eio.Stdenv.fs env in

     

       321
       +
         let _ = setup_fixed_date () in

     

       322
       +
         Alcotest.run "Query Tests" [ ("query", query_tests fs) ]

-334

test/test_query.ml

···

       1
       -
       (* Test the Query module *)

     

       2
       -
       

     

       3
       -
       open Caledonia_lib

     

       4
       -
       

     

       5
       -
       (* Setup a fixed date for testing *)

     

       6
       -
       let fixed_date = Option.get @@ Ptime.of_date_time ((2025, 3, 27), ((0, 0, 0), 0))

     

       7
       -
       

     

       8
       -
       let setup_fixed_date () =

     

       9
       -
         (Date.get_today := fun ?tz:_ () -> fixed_date);

     

       10
       -
         fixed_date

     

       11
       -
       

     

       12
       -
       let calendar_dir_path = Filename.concat (Sys.getcwd ()) "calendar"

     

       13
       -
       

     

       14
       -
       let test_query_all ~fs () =

     

       15
       -
         let calendar_dir =

     

       16
       -
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       17
       -
         in

     

       18
       -
         let from =

     

       19
       -
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       20
       -
         in

     

       21
       -
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       22
       -
         match Query.query ~fs calendar_dir ~from ~to_ () with

     

       23
       -
         | Ok events ->

     

       24
       -
             Alcotest.(check int) "Should find events" 791 (List.length events);

     

       25
       -
             let test_event =

     

       26
       -
               List.find_opt

     

       27
       -
                 (fun event -> Option.get @@ Event.get_summary event = "Test Event")

     

       28
       -
                 events

     

       29
       -
             in

     

       30
       -
             Alcotest.(check bool) "Should find Test Event" true (test_event <> None)

     

       31
       -
         | Error _ -> Alcotest.fail "Error querying events"

     

       32
       -
       

     

       33
       -
       let test_recurrence_expansion ~fs () =

     

       34
       -
         let calendar_dir =

     

       35
       -
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       36
       -
         in

     

       37
       -
         let from =

     

       38
       -
           Some (Option.get @@ Ptime.of_date_time ((2025, 3, 1), ((0, 0, 0), 0)))

     

       39
       -
         in

     

       40
       -
         let to_ =

     

       41
       -
           Option.get @@ Ptime.of_date_time ((2025, 5, 31), ((23, 59, 59), 0))

     

       42
       -
         in

     

       43
       -
         match Query.query ~fs calendar_dir ~from ~to_ () with

     

       44
       -
         | Ok events ->

     

       45
       -
             let recurring_events =

     

       46
       -
               List.filter

     

       47
       -
                 (fun event ->

     

       48
       -
                   Option.get @@ Event.get_summary event = "Recurring Event")

     

       49
       -
                 events

     

       50
       -
             in

     

       51
       -
             Alcotest.(check bool)

     

       52
       -
               "Should find multiple recurring event events" true

     

       53
       -
               (List.length recurring_events > 1)

     

       54
       -
         | Error _ -> Alcotest.fail "Error querying events"

     

       55
       -
       

     

       56
       -
       let test_text_search ~fs () =

     

       57
       -
         let calendar_dir =

     

       58
       -
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       59
       -
         in

     

       60
       -
         let filter = Query.summary_contains "Test" in

     

       61
       -
         let from =

     

       62
       -
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       63
       -
         in

     

       64
       -
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       65
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       66
       -
         | Ok events ->

     

       67
       -
             Alcotest.(check int)

     

       68
       -
               "Should find event with 'Test' in summary" 2 (List.length events)

     

       69
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       70
       -
         let filter = Query.location_contains "Weekly" in

     

       71
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       72
       -
         | Ok events ->

     

       73
       -
             Alcotest.(check int)

     

       74
       -
               "Should find event with 'Weekly' in location" 10 (List.length events)

     

       75
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       76
       -
         let filter =

     

       77
       -
           Query.and_filter

     

       78
       -
             [ Query.summary_contains "Test"; Query.description_contains "test" ]

     

       79
       -
         in

     

       80
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       81
       -
         | Ok events ->

     

       82
       -
             Alcotest.(check int)

     

       83
       -
               "Should find events matching combined and criteria" 2

     

       84
       -
               (List.length events)

     

       85
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       86
       -
         let filter =

     

       87
       -
           Query.or_filter

     

       88
       -
             [ Query.summary_contains "Test"; Query.location_contains "Weekly" ]

     

       89
       -
         in

     

       90
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       91
       -
         | Ok events ->

     

       92
       -
             Alcotest.(check int)

     

       93
       -
               "Should find events matching combined or criteria" 12

     

       94
       -
               (List.length events)

     

       95
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       96
       -
         ()

     

       97
       -
       

     

       98
       -
       let test_calendar_filter ~fs () =

     

       99
       -
         let calendar_dir =

     

       100
       -
           Result.get_ok @@ Calendar_dir.create ~fs calendar_dir_path

     

       101
       -
         in

     

       102
       -
         let from =

     

       103
       -
           Some (Option.get @@ Ptime.of_date_time ((2025, 01, 01), ((0, 0, 0), 0)))

     

       104
       -
         in

     

       105
       -
         let to_ = Option.get @@ Ptime.of_date_time ((2026, 01, 01), ((0, 0, 0), 0)) in

     

       106
       -
         let calendar_name = "example" in

     

       107
       -
         let filter = Query.in_calendar_names [ calendar_name ] in

     

       108
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       109
       -
         | Ok events ->

     

       110
       -
             let all_match_calendar =

     

       111
       -
               List.for_all

     

       112
       -
                 (fun e ->

     

       113
       -
                   match Event.get_calendar_name e with id -> id = calendar_name)

     

       114
       -
                 events

     

       115
       -
             in

     

       116
       -
             Alcotest.(check bool)

     

       117
       -
               (Printf.sprintf "All events should be from calendar '%s'" calendar_name)

     

       118
       -
               true all_match_calendar;

     

       119
       -
             Alcotest.(check int) "Should find events" 2 (List.length events)

     

       120
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       121
       -
         let calendar_names = [ "example"; "recurrence" ] in

     

       122
       -
         let filter = Query.in_calendar_names calendar_names in

     

       123
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       124
       -
         | Ok events ->

     

       125
       -
             Alcotest.(check int) "Should find events" 791 (List.length events)

     

       126
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       127
       -
         let filter = Query.in_calendar_names [ "non-existent-calendar" ] in

     

       128
       -
         (match Query.query ~fs calendar_dir ~from ~to_ ~filter () with

     

       129
       -
         | Ok events ->

     

       130
       -
             Alcotest.(check int)

     

       131
       -
               "Should find 0 events for non-existent calendar" 0 (List.length events)

     

       132
       -
         | Error _ -> Alcotest.fail "Error querying events");

     

       133
       -
         ()

     

       134
       -
       

     

       135
       -
       let test_events ~fs =

     

       136
       -
         (* Create a test event with specific text in all fields *)

     

       137
       -
         let create_test_event ~calendar_name ~summary ~description ~location ~start =

     

       138
       -
           Event.create ~fs ~calendar_dir_path ~summary ~start

     

       139
       -
             ?description:(if description = "" then None else Some description)

     

       140
       -
             ?location:(if location = "" then None else Some location)

     

       141
       -
             calendar_name

     

       142
       -
         in

     

       143
       -
         [

     

       144
       -
           (* Event with text in all fields *)

     

       145
       -
           create_test_event ~calendar_name:"search_test" ~summary:"Project Meeting"

     

       146
       -
             ~description:"Weekly project status meeting with team"

     

       147
       -
             ~location:"Conference Room A"

     

       148
       -
             ~start:(`Datetime (`Utc fixed_date));

     

       149
       -
           (* Event with mixed case to test case insensitivity *)

     

       150
       -
           create_test_event ~calendar_name:"search_test" ~summary:"IMPORTANT Meeting"

     

       151
       -
             ~description:"Critical project review with stakeholders"

     

       152
       -
             ~location:"Executive Suite"

     

       153
       -
             ~start:(`Datetime (`Utc fixed_date));

     

       154
       -
           (* Event with word fragments *)

     

       155
       -
           create_test_event ~calendar_name:"search_test" ~summary:"Conference Call"

     

       156
       -
             ~description:"International conference preparation"

     

       157
       -
             ~location:"Remote Meeting Room"

     

       158
       -
             ~start:(`Datetime (`Utc fixed_date));

     

       159
       -
           (* Event with unique text in each field *)

     

       160
       -
           create_test_event ~calendar_name:"search_test"

     

       161
       -
             ~summary:"Workshop on Testing"

     

       162
       -
             ~description:"Quality Assurance techniques and practices"

     

       163
       -
             ~location:"Training Center"

     

       164
       -
             ~start:(`Datetime (`Utc fixed_date));

     

       165
       -
         ]

     

       166
       -
       

     

       167
       -
       (* Test helper to verify if a list of events contains an event with a given summary *)

     

       168
       -
       let contains_summary events summary =

     

       169
       -
         List.exists

     

       170
       -
           (fun e -> String.equal (Option.get @@ Event.get_summary e) summary)

     

       171
       -
           events

     

       172
       -
       

     

       173
       -
       let test_case_insensitive_search ~fs () =

     

       174
       -
         (* Test lowercase query for an uppercase word *)

     

       175
       -
         let lowercase_filter = Query.summary_contains "important" in

     

       176
       -
         let matches =

     

       177
       -
           List.filter

     

       178
       -
             (fun e -> Query.matches_filter e lowercase_filter)

     

       179
       -
             (test_events ~fs)

     

       180
       -
         in

     

       181
       -
         Alcotest.(check bool)

     

       182
       -
           "Lowercase query should match uppercase text in summary" true

     

       183
       -
           (contains_summary matches "IMPORTANT Meeting");

     

       184
       -
         (* Test uppercase query for a lowercase word *)

     

       185
       -
         let uppercase_filter = Query.description_contains "WEEKLY" in

     

       186
       -
         let matches =

     

       187
       -
           List.filter

     

       188
       -
             (fun e -> Query.matches_filter e uppercase_filter)

     

       189
       -
             (test_events ~fs)

     

       190
       -
         in

     

       191
       -
         Alcotest.(check bool)

     

       192
       -
           "Uppercase query should match lowercase text in description" true

     

       193
       -
           (contains_summary matches "Project Meeting")

     

       194
       -
       

     

       195
       -
       let test_partial_word_matching ~fs () =

     

       196
       -
         (* Test searching for part of a word *)

     

       197
       -
         let partial_filter = Query.summary_contains "Conf" in

     

       198
       -
         (* Should match "Conference" *)

     

       199
       -
         let matches =

     

       200
       -
           List.filter

     

       201
       -
             (fun e -> Query.matches_filter e partial_filter)

     

       202
       -
             (test_events ~fs)

     

       203
       -
         in

     

       204
       -
         Alcotest.(check bool)

     

       205
       -
           "Partial query should match full word in summary" true

     

       206
       -
           (contains_summary matches "Conference Call");

     

       207
       -
         (* Test another partial word in description *)

     

       208
       -
         let partial_filter = Query.description_contains "nation" in

     

       209
       -
         (* Should match "International" *)

     

       210
       -
         let matches =

     

       211
       -
           List.filter

     

       212
       -
             (fun e -> Query.matches_filter e partial_filter)

     

       213
       -
             (test_events ~fs)

     

       214
       -
         in

     

       215
       -
         Alcotest.(check bool)

     

       216
       -
           "Partial query should match within word in description" true

     

       217
       -
           (contains_summary matches "Conference Call");

     

       218
       -
       

     

       219
       -
         Alcotest.(check bool)

     

       220
       -
           "Partial query should match within word in description" true

     

       221
       -
           (contains_summary matches "Conference Call")

     

       222
       -
       

     

       223
       -
       let test_boolean_logic ~fs () =

     

       224
       -
         (* Test AND filter *)

     

       225
       -
         let and_filter =

     

       226
       -
           Query.and_filter

     

       227
       -
             [ Query.summary_contains "Meeting"; Query.description_contains "project" ]

     

       228
       -
         in

     

       229
       -
         let matches =

     

       230
       -
           List.filter (fun e -> Query.matches_filter e and_filter) (test_events ~fs)

     

       231
       -
         in

     

       232
       -
         Alcotest.(check int)

     

       233
       -
           "AND filter should match events with both terms" 2

     

       234
       -
           (* Two events have both "Meeting" in summary and "project" in description *)

     

       235
       -
           (List.length matches);

     

       236
       -
         (* Test OR filter *)

     

       237
       -
         let or_filter =

     

       238
       -
           Query.or_filter

     

       239
       -
             [ Query.summary_contains "Workshop"; Query.summary_contains "Conference" ]

     

       240
       -
         in

     

       241
       -
         let matches =

     

       242
       -
           List.filter (fun e -> Query.matches_filter e or_filter) (test_events ~fs)

     

       243
       -
         in

     

       244
       -
         Alcotest.(check int)

     

       245
       -
           "OR filter should match events with either term"

     

       246
       -
           2 (* One event has "Workshop", one has "Conference" *)

     

       247
       -
           (List.length matches);

     

       248
       -
       

     

       249
       -
         (* Test NOT filter *)

     

       250
       -
         let not_filter = Query.not_filter (Query.summary_contains "Meeting") in

     

       251
       -
         let matches =

     

       252
       -
           List.filter (fun e -> Query.matches_filter e not_filter) (test_events ~fs)

     

       253
       -
         in

     

       254
       -
         Alcotest.(check int)

     

       255
       -
           "NOT filter should match events without the term"

     

       256
       -
           2 (* Two events don't have "Meeting" in the summary *)

     

       257
       -
           (List.length matches);

     

       258
       -
         (* Test complex combination: (Meeting AND project) OR Workshop BUT NOT Conference *)

     

       259
       -
         let complex_filter =

     

       260
       -
           Query.and_filter

     

       261
       -
             [

     

       262
       -
               Query.or_filter

     

       263
       -
                 [

     

       264
       -
                   Query.and_filter

     

       265
       -
                     [

     

       266
       -
                       Query.summary_contains "Meeting";

     

       267
       -
                       Query.description_contains "project";

     

       268
       -
                     ];

     

       269
       -
                   Query.summary_contains "Workshop";

     

       270
       -
                 ];

     

       271
       -
               Query.not_filter (Query.summary_contains "Conference");

     

       272
       -
             ]

     

       273
       -
         in

     

       274
       -
         let matches =

     

       275
       -
           List.filter

     

       276
       -
             (fun e -> Query.matches_filter e complex_filter)

     

       277
       -
             (test_events ~fs)

     

       278
       -
         in

     

       279
       -
         Alcotest.(check int)

     

       280
       -
           "Complex filter should match correctly"

     

       281
       -
           3 (* Three events should match the complex criteria *)

     

       282
       -
           (List.length matches)

     

       283
       -
       

     

       284
       -
       let test_cross_field_search ~fs () =

     

       285
       -
         (* Search for a term that appears in multiple fields across different events *)

     

       286
       -
         let term_filter =

     

       287
       -
           Query.or_filter

     

       288
       -
             [

     

       289
       -
               Query.summary_contains "meeting";

     

       290
       -
               Query.description_contains "meeting";

     

       291
       -
               Query.location_contains "meeting";

     

       292
       -
             ]

     

       293
       -
         in

     

       294
       -
         let matches =

     

       295
       -
           List.filter (fun e -> Query.matches_filter e term_filter) (test_events ~fs)

     

       296
       -
         in

     

       297
       -
         Alcotest.(check int)

     

       298
       -
           "Cross-field search should find all occurrences"

     

       299
       -
           3 (* "meeting" appears in 3 events across different fields *)

     

       300
       -
           (List.length matches);

     

       301
       -
         (* Another test with a different term *)

     

       302
       -
         let term_filter =

     

       303
       -
           Query.or_filter

     

       304
       -
             [

     

       305
       -
               Query.summary_contains "conference";

     

       306
       -
               Query.description_contains "conference";

     

       307
       -
               Query.location_contains "conference";

     

       308
       -
             ]

     

       309
       -
         in

     

       310
       -
         let matches =

     

       311
       -
           List.filter (fun e -> Query.matches_filter e term_filter) (test_events ~fs)

     

       312
       -
         in

     

       313
       -
         Alcotest.(check int)

     

       314
       -
           "Cross-field search should find all occurrences of 'conference'"

     

       315
       -
           2 (* "conference" appears in 2 events across different fields *)

     

       316
       -
           (List.length matches)

     

       317
       -
       

     

       318
       -
       let query_tests fs =

     

       319
       -
         [

     

       320
       -
           ("query all events", `Quick, test_query_all ~fs);

     

       321
       -
           ("recurrence expansion", `Quick, test_recurrence_expansion ~fs);

     

       322
       -
           ("text search", `Quick, test_text_search ~fs);

     

       323
       -
           ("calendar filter", `Quick, test_calendar_filter ~fs);

     

       324
       -
           ("case insensitive search", `Quick, test_case_insensitive_search ~fs);

     

       325
       -
           ("partial word matching", `Quick, test_partial_word_matching ~fs);

     

       326
       -
           ("boolean logic filters", `Quick, test_boolean_logic ~fs);

     

       327
       -
           ("cross-field searching", `Quick, test_cross_field_search ~fs);

     

       328
       -
         ]

     

       329
       -
       

     

       330
       -
       let () =

     

       331
       -
         Eio_main.run @@ fun env ->

     

       332
       -
         let fs = Eio.Stdenv.fs env in

     

       333
       -
         let _ = setup_fixed_date () in

     

       334
       -
         Alcotest.run "Query Tests" [ ("query", query_tests fs) ]

Compare changes