kcal-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{kcal_cli-0.1.0 → kcal_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kcal-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Non-interactive CLI for managing local iCalendar (.ics) files
 Author: hebbian
 License-Expression: MIT
@@ -42,6 +42,8 @@ kcal -f ~/calendar.ics list
 kcal -f ~/calendar.ics list --date 2026-06-25
 ```
 
+Recurring events show their frequency in brackets: `[weekly]`, `[monthly]`, etc.
+
 ### Add a timed event
 
 ```
@@ -60,12 +62,22 @@ For multi-day events, set `--end` to the day after the last day (iCal convention
 kcal -f ~/calendar.ics add "Conference" -s "2026-08-01" -e "2026-08-04" --allday
 ```
 
+### Add a recurring event
+
+```
+kcal -f ~/calendar.ics add "Standup" -s "2026-06-26 09:00" -e "2026-06-26 09:15" --repeat weekly --byday MO,WE,FR
+kcal -f ~/calendar.ics add "Review" -s "2026-07-01 14:00" -e "2026-07-01 15:00" --repeat monthly --count 6
+kcal -f ~/calendar.ics add "Sync" -s "2026-07-01 10:00" -e "2026-07-01 11:00" --repeat weekly --interval 2 --until "2026-12-31"
+```
+
 ### Edit an event
 
 ```
 kcal -f ~/calendar.ics edit 1cc4704e --summary "New title"
 kcal -f ~/calendar.ics edit 1cc4704e --start "2026-06-26 10:00" --end "2026-06-26 11:00"
 kcal -f ~/calendar.ics edit 1cc4704e --start "2026-06-26" --allday
+kcal -f ~/calendar.ics edit 1cc4704e --repeat weekly --byday MO,FR
+kcal -f ~/calendar.ics edit 1cc4704e --no-repeat
 ```
 
 ### Delete an event
@@ -84,6 +96,12 @@ UID prefix matching — only the first few characters of the event UID are neede
 | `-s`, `--start` | Start date/time (`YYYY-MM-DD HH:MM` or `YYYY-MM-DD`) |
 | `-e`, `--end` | End date/time (optional for all-day events) |
 | `--allday` | Create/convert to all-day event (uses `VALUE=DATE`) |
+| `--repeat` | Recurrence: `daily`, `weekly`, `monthly`, `yearly` |
+| `--interval` | Repeat every N periods (default: 1) |
+| `--count` | Total number of occurrences |
+| `--until` | Recurrence end date (`YYYY-MM-DD`) |
+| `--byday` | Days for weekly recurrence (e.g. `MO,WE,FR`) |
+| `--no-repeat` | Remove recurrence rule (edit only) |
 | `-d`, `--description` | Event description |
 | `-l`, `--location` | Event location |
 

{kcal_cli-0.1.0 → kcal_cli-0.2.0}/README.md

@@ -25,6 +25,8 @@ kcal -f ~/calendar.ics list
 kcal -f ~/calendar.ics list --date 2026-06-25
 ```
 
+Recurring events show their frequency in brackets: `[weekly]`, `[monthly]`, etc.
+
 ### Add a timed event
 
 ```
@@ -43,12 +45,22 @@ For multi-day events, set `--end` to the day after the last day (iCal convention
 kcal -f ~/calendar.ics add "Conference" -s "2026-08-01" -e "2026-08-04" --allday
 ```
 
+### Add a recurring event
+
+```
+kcal -f ~/calendar.ics add "Standup" -s "2026-06-26 09:00" -e "2026-06-26 09:15" --repeat weekly --byday MO,WE,FR
+kcal -f ~/calendar.ics add "Review" -s "2026-07-01 14:00" -e "2026-07-01 15:00" --repeat monthly --count 6
+kcal -f ~/calendar.ics add "Sync" -s "2026-07-01 10:00" -e "2026-07-01 11:00" --repeat weekly --interval 2 --until "2026-12-31"
+```
+
 ### Edit an event
 
 ```
 kcal -f ~/calendar.ics edit 1cc4704e --summary "New title"
 kcal -f ~/calendar.ics edit 1cc4704e --start "2026-06-26 10:00" --end "2026-06-26 11:00"
 kcal -f ~/calendar.ics edit 1cc4704e --start "2026-06-26" --allday
+kcal -f ~/calendar.ics edit 1cc4704e --repeat weekly --byday MO,FR
+kcal -f ~/calendar.ics edit 1cc4704e --no-repeat
 ```
 
 ### Delete an event
@@ -67,6 +79,12 @@ UID prefix matching — only the first few characters of the event UID are neede
 | `-s`, `--start` | Start date/time (`YYYY-MM-DD HH:MM` or `YYYY-MM-DD`) |
 | `-e`, `--end` | End date/time (optional for all-day events) |
 | `--allday` | Create/convert to all-day event (uses `VALUE=DATE`) |
+| `--repeat` | Recurrence: `daily`, `weekly`, `monthly`, `yearly` |
+| `--interval` | Repeat every N periods (default: 1) |
+| `--count` | Total number of occurrences |
+| `--until` | Recurrence end date (`YYYY-MM-DD`) |
+| `--byday` | Days for weekly recurrence (e.g. `MO,WE,FR`) |
+| `--no-repeat` | Remove recurrence rule (edit only) |
 | `-d`, `--description` | Event description |
 | `-l`, `--location` | Event location |
 

{kcal_cli-0.1.0 → kcal_cli-0.2.0}/kcal.py

@@ -41,6 +41,29 @@ def parse_date(s: str) -> date:
     raise ValueError(f"Cannot parse date: {s!r}")
 
 
+def build_rrule(args):
+    if not args.repeat:
+        return None
+    rule = {"freq": args.repeat.upper()}
+    if hasattr(args, "interval") and args.interval:
+        rule["interval"] = int(args.interval)
+    if hasattr(args, "count") and args.count:
+        rule["count"] = int(args.count)
+    if hasattr(args, "until") and args.until:
+        rule["until"] = parse_dt(args.until) if " " in args.until else parse_date(args.until)
+    if hasattr(args, "byday") and args.byday:
+        rule["byday"] = args.byday.upper().split(",")
+    return rule
+
+
+def apply_rrule(event, args):
+    rrule = build_rrule(args)
+    if rrule:
+        if "rrule" in event:
+            del event["rrule"]
+        event.add("rrule", rrule)
+
+
 def cmd_add(args):
     cal = load_calendar(args.file)
     event = Event()
@@ -62,6 +85,7 @@ def cmd_add(args):
         event.add("description", args.description)
     if args.location:
         event.add("location", args.location)
+    apply_rrule(event, args)
     cal.add_component(event)
     save_calendar(cal, args.file)
     print(f"Added: {args.summary} (uid: {event['uid']})")
@@ -119,7 +143,12 @@ def cmd_list(args):
             start = dt.strftime("%Y-%m-%d %H:%M")
             dtend = e.get("dtend")
             end = " - " + dtend.dt.strftime("%H:%M") if dtend else ""
-        print(f"  {start}{end}  {summary}  [uid: {uid[:8]}...]")
+        rrule = e.get("rrule")
+        repeat = ""
+        if rrule:
+            freq = rrule.get("freq", [""])[0].lower() if isinstance(rrule.get("freq"), list) else str(rrule.get("freq", "")).lower()
+            repeat = f" [{freq}]"
+        print(f"  {start}{end}  {summary}{repeat}  [uid: {uid[:8]}...]")
 
 
 def cmd_delete(args):
@@ -177,6 +206,11 @@ def cmd_edit(args):
             if args.end:
                 del component["dtend"]
                 component.add("dtend", parse_dt(args.end))
+        if args.repeat:
+            apply_rrule(component, args)
+        if args.no_repeat:
+            if "rrule" in component:
+                del component["rrule"]
         if args.description:
             if "description" in component:
                 del component["description"]
@@ -205,6 +239,11 @@ def main():
     p_add.add_argument("--start", "-s", required=True, help="Start date/time (YYYY-MM-DD HH:MM, or YYYY-MM-DD for all-day)")
     p_add.add_argument("--end", "-e", help="End date/time (optional for all-day events)")
     p_add.add_argument("--allday", action="store_true", help="Create an all-day event (uses DATE values)")
+    p_add.add_argument("--repeat", choices=["daily", "weekly", "monthly", "yearly"], help="Recurrence frequency")
+    p_add.add_argument("--interval", type=int, help="Repeat every N periods (default: 1)")
+    p_add.add_argument("--count", type=int, help="Number of occurrences")
+    p_add.add_argument("--until", help="Recurrence end date (YYYY-MM-DD)")
+    p_add.add_argument("--byday", help="Days for weekly recurrence (e.g. MO,WE,FR)")
     p_add.add_argument("--description", "-d", help="Description")
     p_add.add_argument("--location", "-l", help="Location")
 
@@ -220,6 +259,12 @@ def main():
     p_edit.add_argument("--start", "-s", help="New start date/time")
     p_edit.add_argument("--end", "-e", help="New end date/time")
     p_edit.add_argument("--allday", action="store_true", help="Convert to an all-day event")
+    p_edit.add_argument("--repeat", choices=["daily", "weekly", "monthly", "yearly"], help="Set/change recurrence")
+    p_edit.add_argument("--interval", type=int, help="Repeat every N periods")
+    p_edit.add_argument("--count", type=int, help="Number of occurrences")
+    p_edit.add_argument("--until", help="Recurrence end date (YYYY-MM-DD)")
+    p_edit.add_argument("--byday", help="Days for weekly recurrence (e.g. MO,WE,FR)")
+    p_edit.add_argument("--no-repeat", action="store_true", help="Remove recurrence rule")
     p_edit.add_argument("--description", "-d", help="New description")
     p_edit.add_argument("--location", "-l", help="New location")
 

{kcal_cli-0.1.0 → kcal_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kcal-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "Non-interactive CLI for managing local iCalendar (.ics) files"
 readme = "README.md"
 requires-python = ">=3.10"