taskcheck 0.1.1__tar.gz → 0.1.2__tar.gz

{taskcheck-0.1.1/taskcheck.egg-info → taskcheck-0.1.2}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.1
 Name: taskcheck
-Version: 0.1.1
+Version: 0.1.2
 Summary: Automatic scheduler for taskwarrior
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: icalendar>=6.0.1
-Requires-Dist: requests-cache>=1.2.1
 Requires-Dist: requests>=2.32.3
 
 
@@ -72,6 +71,7 @@ days_ahead = 1000 # how far go with the schedule (lower values make the computat
 [calendars.1]
 url = "https://your/url/to/calendar.ics"
 expiration = 0.08 # in hours (0.08 hours =~ 5 minutes)
+timezone = "Europe/Rome" # if set, force timezone for this calendar; timezone values are TZ identifiers (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
 
 [calendars.holidays]
 url = "https://www.officeholidays.com/ics-clean/italy/milan"
@@ -92,16 +92,21 @@ uda.completion_date.type = date
 uda.completion_date.label = Expected Completion Date
 
 # Adjust urgency for taskcheck
-urgency.uda.estimated.coefficient = 1.0   # Increase urgency for tasks with longer estimated durations
-urgency.waiting.coefficient = 0.0 # you will use `wait:` to avoid scheduling tasks too much sooner
+# you will use `wait:` to avoid scheduling tasks too much sooner
+urgency.waiting.coefficient = 0.0
+# you will use `active:` to prioritize tasks already started even if the estimated amount is decreased
+urgency.active.coefficient = 3.0 
+urgency.scheduled.coefficient = 0.0 # tasks that are not scheduled may still be urgent
 
 # we need to be able to modify recurrent tasks without prompt
 recurrence.confirmation=no
 
 # suggested
-urgency.inherit=1
+urgency.inherit=1 # use dependencies to automatically prioritize tasks
 urgency.blocking.coefficient=2
 
+# give urgeny values to the estimated time
+# this is ln(estimation)
 urgency.uda.estimated.PT1H.coefficient = 1
 urgency.uda.estimated.PT2H.coefficient = 2.32
 urgency.uda.estimated.PT3H.coefficient = 3.67
@@ -138,11 +143,15 @@ urgency.uda.estimated.PT33H.coefficient = 11.73
 urgency.uda.estimated.PT34H.coefficient = 11.81
 urgency.uda.estimated.PT35H.coefficient = 11.89
 urgency.uda.estimated.PT36H.coefficient = 11.96
+# maximum duration is 36 hours
+
 ```
 
 ## CLI Options
 
 ```
+
 -v, --verbose: increase output verbosity
 -t, --today: how much time has been already used today (default: 0)
+
 ```

{taskcheck-0.1.1 → taskcheck-0.1.2}/README.md

@@ -60,6 +60,7 @@ days_ahead = 1000 # how far go with the schedule (lower values make the computat
 [calendars.1]
 url = "https://your/url/to/calendar.ics"
 expiration = 0.08 # in hours (0.08 hours =~ 5 minutes)
+timezone = "Europe/Rome" # if set, force timezone for this calendar; timezone values are TZ identifiers (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
 
 [calendars.holidays]
 url = "https://www.officeholidays.com/ics-clean/italy/milan"
@@ -80,16 +81,21 @@ uda.completion_date.type = date
 uda.completion_date.label = Expected Completion Date
 
 # Adjust urgency for taskcheck
-urgency.uda.estimated.coefficient = 1.0   # Increase urgency for tasks with longer estimated durations
-urgency.waiting.coefficient = 0.0 # you will use `wait:` to avoid scheduling tasks too much sooner
+# you will use `wait:` to avoid scheduling tasks too much sooner
+urgency.waiting.coefficient = 0.0
+# you will use `active:` to prioritize tasks already started even if the estimated amount is decreased
+urgency.active.coefficient = 3.0 
+urgency.scheduled.coefficient = 0.0 # tasks that are not scheduled may still be urgent
 
 # we need to be able to modify recurrent tasks without prompt
 recurrence.confirmation=no
 
 # suggested
-urgency.inherit=1
+urgency.inherit=1 # use dependencies to automatically prioritize tasks
 urgency.blocking.coefficient=2
 
+# give urgeny values to the estimated time
+# this is ln(estimation)
 urgency.uda.estimated.PT1H.coefficient = 1
 urgency.uda.estimated.PT2H.coefficient = 2.32
 urgency.uda.estimated.PT3H.coefficient = 3.67
@@ -126,11 +132,15 @@ urgency.uda.estimated.PT33H.coefficient = 11.73
 urgency.uda.estimated.PT34H.coefficient = 11.81
 urgency.uda.estimated.PT35H.coefficient = 11.89
 urgency.uda.estimated.PT36H.coefficient = 11.96
+# maximum duration is 36 hours
+
 ```
 
 ## CLI Options
 
 ```
+
 -v, --verbose: increase output verbosity
 -t, --today: how much time has been already used today (default: 0)
+
 ```

{taskcheck-0.1.1 → taskcheck-0.1.2}/pyproject.toml

@@ -1,15 +1,10 @@
 [project]
 name = "taskcheck"
-version = "0.1.1"
+version = "0.1.2"
 description = "Automatic scheduler for taskwarrior"
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = [
-  "appdirs>=1.4.4",
-  "icalendar>=6.0.1",
-  "requests-cache>=1.2.1",
-  "requests>=2.32.3",
-]
+dependencies = ["appdirs>=1.4.4", "icalendar>=6.0.1", "requests>=2.32.3"]
 
 [project.scripts]
 taskcheck = "taskcheck.__main__:main"

{taskcheck-0.1.1 → taskcheck-0.1.2}/taskcheck/__main__.py

@@ -54,11 +54,11 @@ def _hours_to_decimal(hour):
 
 def _hours_to_time(hour):
     hours = int(hour)
-    minutes = int((hour - hours) * 60)
+    minutes = int((hour - hours) * 100)
     return datetime.strptime(f"{hours}:{minutes}", "%H:%M").time()
 
 
-def _time_to_hours(time):
+def _time_to_decimal(time):
     return time.hour + time.minute / 60
 
 
@@ -75,6 +75,7 @@ def get_available_hours(time_map, date, calendars):
         # so let's convert them to datetime.time objects
         schedule_start = _hours_to_time(schedule_start)
         schedule_end = _hours_to_time(schedule_end)
+        schedule_blocked_hours = 0
         for calendar in calendars:
             for event in calendar:
                 # we use str to make object serializable as jsons
@@ -87,13 +88,24 @@ def get_available_hours(time_map, date, calendars):
                     break
                 elif event["end"].date() < date:
                     continue
+
                 # check if the event overlaps with one of the working hours
                 event_start = event["start"].time()
                 event_end = event["end"].time()
+                if event["start"].date() < date:
+                    event_start = datetime(date.year, date.month, date.day, 0, 0).time()
+                if event["end"].date() > date:
+                    event_end = datetime(date.year, date.month, date.day, 23, 59).time()
+
                 if event_start < schedule_end and event_end > schedule_start:
-                    blocked_hours += _time_to_hours(
+                    schedule_blocked_hours += _time_to_decimal(
                         min(schedule_end, event_end)
-                    ) - _time_to_hours(max(schedule_start, event_start))
+                    ) - _time_to_decimal(max(schedule_start, event_start))
+        if args.verbose and schedule_blocked_hours > 0:
+            print(
+                f"Blocked hours on {date} between {schedule_start} and {schedule_end}: {schedule_blocked_hours}"
+            )
+        blocked_hours += schedule_blocked_hours
     available_hours -= blocked_hours
     return available_hours
 
@@ -204,6 +216,7 @@ def get_calendars(config):
             all_day=calendar["event_all_day_is_blocking"],
             expiration=calendar["expiration"],
             verbose=args.verbose,
+            tz_name=calendar.get("timezone"),
         )
         calendar.sort(key=lambda e: e["start"])
         calendars.append(calendar)

{taskcheck-0.1.1 → taskcheck-0.1.2}/taskcheck/ical.py

@@ -3,38 +3,29 @@ import json
 from icalendar import Calendar
 from datetime import datetime, timedelta
 from dateutil.rrule import rruleset, rrulestr
-from requests_cache import CachedSession
+import requests
 from pathlib import Path
 import appdirs
+import zoneinfo
 
 import time
 
 CACHE = Path(appdirs.user_cache_dir("taskcheck"))
 
 
-def fetch_ical_data(url, expiration):
-    session = CachedSession(
-        "taskcheck",
-        use_cache_dir=True,  # Save files in the default user cache dir
-        cache_control=True,  # Use Cache-Control response headers for expiration, if available
-        urls_expire_after={url: expiration},  # Set expiration time
-        allowable_codes=[
-            200,
-        ],
-        allowable_methods=["GET", "POST"],  # Cache whatever HTTP methods you want
-        stale_if_error=True,  # In case of request errors, use stale cache data if possible
-    )
-    response = session.get(url)
+def fetch_ical_data(url):
+    response = requests.get(url)
     response.raise_for_status()
     return response.text
 
 
-def parse_ical_events(ical_text, days_ahead, all_day):
+def parse_ical_events(ical_text, days_ahead, all_day, tz_name=None, verbose=False):
     cal = Calendar.from_ical(ical_text)
     today = datetime.now().date()
     end_date = today + timedelta(days=days_ahead)
 
     events = []
+    exceptions = set()
 
     for component in cal.walk():
         if component.name == "VEVENT":
@@ -61,9 +52,12 @@ def parse_ical_events(ical_text, days_ahead, all_day):
                     )
                     event_end = event_start + timedelta(days=1) - timedelta(seconds=1)
             if recurrence_id:
-                continue  # Ignore recurrence exceptions here for simplicity
+                if end_date >= recurrence_id.dt.date() >= today:
+                    # this was an occurrence of a recurring event
+                    # but has been moved, let's record the exception that must be removed
+                    exceptions.add(recurrence_id.dt.isoformat())
 
-            event_dates = rruleset()
+            occurrences = rruleset()
             if recurrence_rule:
                 # avoid handling rules that are already ended
                 # and don't create events beyond end_date
@@ -72,26 +66,49 @@ def parse_ical_events(ical_text, days_ahead, all_day):
                     until = until[0].date()
                     if until < today:
                         continue
-                    elif until > end_date:
-                        recurrence_rule["UNTIL"] = end_date
                 rrule = rrulestr(
                     str(recurrence_rule.to_ical(), "utf-8"),
                     dtstart=event_start,
                 )
-                event_dates.rrule(rrule)  # type: ignore
+                occurrences.rrule(rrule)  # type: ignore
+                # exceptions to recurring events
+                excdates = component.get("exdate")
+                if excdates is not None:
+                    if isinstance(excdates, list):
+                        # concatenate all the .dts into one list
+                        excdates = [e for exdate in excdates for e in exdate.dts]
+                    else:
+                        excdates = excdates.dts
+                    for excdate in excdates:
+                        if end_date >= excdate.dt.date() >= today:
+                            exceptions.add(excdate.dt.isoformat())
             else:
-                event_dates.rdate(event_start)
-
-            for event_date in event_dates:
-                if today <= event_date.date() <= end_date:
+                # if event is not recurring, add it as a single event
+                if event_start.date() >= today and event_end.date() <= end_date:
+                    occurrences.rdate(event_start)
+
+            for occurrence in occurrences:
+                if tz_name is not None:
+                    occurrence = occurrence.astimezone(zoneinfo.ZoneInfo(tz_name))
+                end = occurrence + (event_end - event_start)
+                if occurrence.date() >= today and end.date() <= end_date:
                     events.append(
                         {
-                            "summary": component.get("summary"),
-                            "start": event_date.isoformat(),
-                            "end": event_end.isoformat(),
+                            # "summary": component.get("summary"),
+                            "start": occurrence.isoformat(),
+                            "end": end.isoformat(),
                         }
                     )
+                elif end.date() > end_date:
+                    break
 
+    with_exc_len = len(events)
+    events = [event for event in events if event["start"] not in exceptions]
+    if verbose:
+        print(
+            f"Removed {with_exc_len - len(events)} events that are exceptions to recurring events"
+        )
+    events.sort(key=lambda x: x["start"])
     return events
 
 
@@ -100,7 +117,9 @@ def get_cache_filename(url):
     return CACHE / f"{hash_object.hexdigest()}.json"
 
 
-def ical_to_dict(url, days_ahead=7, all_day=False, expiration=0.25, verbose=False):
+def ical_to_dict(
+    url, days_ahead=7, all_day=False, expiration=0.25, verbose=False, tz_name=None
+):
     CACHE.mkdir(exist_ok=True, parents=True)
     cache_file = CACHE / get_cache_filename(url)
     current_time = time.time()
@@ -117,11 +136,13 @@ def ical_to_dict(url, days_ahead=7, all_day=False, expiration=0.25, verbose=Fals
 
     # Fetch and parse iCal data
     ttt = time.time()
-    ical_text = fetch_ical_data(url, expiration * 3600)
+    ical_text = fetch_ical_data(url)
     if verbose:
         print("Time taken to fetch ical data: ", time.time() - ttt)
     ttt = time.time()
-    events = parse_ical_events(ical_text, days_ahead, all_day)
+    events = parse_ical_events(
+        ical_text, days_ahead, all_day, tz_name=tz_name, verbose=verbose
+    )
     if verbose:
         print("Time taken to parse ical data: ", time.time() - ttt)
 

{taskcheck-0.1.1 → taskcheck-0.1.2/taskcheck.egg-info}/PKG-INFO

@@ -1,13 +1,12 @@
 Metadata-Version: 2.1
 Name: taskcheck
-Version: 0.1.1
+Version: 0.1.2
 Summary: Automatic scheduler for taskwarrior
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: icalendar>=6.0.1
-Requires-Dist: requests-cache>=1.2.1
 Requires-Dist: requests>=2.32.3
 
 
@@ -72,6 +71,7 @@ days_ahead = 1000 # how far go with the schedule (lower values make the computat
 [calendars.1]
 url = "https://your/url/to/calendar.ics"
 expiration = 0.08 # in hours (0.08 hours =~ 5 minutes)
+timezone = "Europe/Rome" # if set, force timezone for this calendar; timezone values are TZ identifiers (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
 
 [calendars.holidays]
 url = "https://www.officeholidays.com/ics-clean/italy/milan"
@@ -92,16 +92,21 @@ uda.completion_date.type = date
 uda.completion_date.label = Expected Completion Date
 
 # Adjust urgency for taskcheck
-urgency.uda.estimated.coefficient = 1.0   # Increase urgency for tasks with longer estimated durations
-urgency.waiting.coefficient = 0.0 # you will use `wait:` to avoid scheduling tasks too much sooner
+# you will use `wait:` to avoid scheduling tasks too much sooner
+urgency.waiting.coefficient = 0.0
+# you will use `active:` to prioritize tasks already started even if the estimated amount is decreased
+urgency.active.coefficient = 3.0 
+urgency.scheduled.coefficient = 0.0 # tasks that are not scheduled may still be urgent
 
 # we need to be able to modify recurrent tasks without prompt
 recurrence.confirmation=no
 
 # suggested
-urgency.inherit=1
+urgency.inherit=1 # use dependencies to automatically prioritize tasks
 urgency.blocking.coefficient=2
 
+# give urgeny values to the estimated time
+# this is ln(estimation)
 urgency.uda.estimated.PT1H.coefficient = 1
 urgency.uda.estimated.PT2H.coefficient = 2.32
 urgency.uda.estimated.PT3H.coefficient = 3.67
@@ -138,11 +143,15 @@ urgency.uda.estimated.PT33H.coefficient = 11.73
 urgency.uda.estimated.PT34H.coefficient = 11.81
 urgency.uda.estimated.PT35H.coefficient = 11.89
 urgency.uda.estimated.PT36H.coefficient = 11.96
+# maximum duration is 36 hours
+
 ```
 
 ## CLI Options
 
 ```
+
 -v, --verbose: increase output verbosity
 -t, --today: how much time has been already used today (default: 0)
+
 ```

{taskcheck-0.1.1 → taskcheck-0.1.2}/taskcheck.egg-info/requires.txt

@@ -1,4 +1,3 @@
 appdirs>=1.4.4
 icalendar>=6.0.1
-requests-cache>=1.2.1
 requests>=2.32.3