taskcheck 0.3.3.post1__tar.gz → 0.3.3.post3__tar.gz

{taskcheck-0.3.3.post1/taskcheck.egg-info → taskcheck-0.3.3.post3}/PKG-INFO

@@ -1,10 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: taskcheck
-Version: 0.3.3.post1
+Version: 0.3.3.post3
 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: random-unicode-emoji>=2.8
@@ -40,7 +39,7 @@ It considers their estimated time to schedule all tasks starting from the most u
 
 #### UDAs
 
-Taskcheck leverages to UDAs, `estimated` and `time_map`. The `estimated` attribute is
+Taskcheck leverages two UDAs, `estimated` and `time_map`. The `estimated` attribute is
 the expected time to complete the task in hours. The `time_map` is a comma-separated list of strings
 that indicates the hours per day in which you will work on a task (e.g. `work`, `weekend`, etc.).
 The exact correspondence between the `time_map` and the hours of the day is defined in the configuration
@@ -74,18 +73,8 @@ how much time you have to work on which task in which day. For
 instance:
 
 - `taskcheck -r today` will show the tasks planned for today
-- `taskcheck -r 1w` will show the tasks planned for the next week,
+- `taskcheck -r 1w` will show the tasks planned for the next week
 
-## Algorithm
-
-The algorithm allocates a fixed amount of time for each task (e.g. 1 hour) and then recomputes the
-urgency and restart the allocation procedure.
-
-If after 1 hour the long task has decreased urgency, that will be noticed and the newer most urgent
-task will get scheduled in its place.
-
-The minimum time for a task is by default 2 hours, but you can change it by tuning the `min_block`
-taskwarrior UDA.
 
 ## Configuration
 
@@ -132,6 +121,25 @@ include_unplanned = true # include unplanned tasks in the report in an ad-hoc se
 additional_attributes_unplanned = ["due", "urgency"] # additional attributes to show in the report for unplanned tasks
 ```
 
+## Algorithm
+
+The algorithm simulates what happens if you work on a task for a certain time on a given day.
+
+For each day X starting from today, it sorts the tasks by decreasing urgency. 
+It start from the most urgent tasks that can be allocated on day X depending on the task's
+`time_map` and on your calendars. It allocates a few number of hours to the task,
+then recomputes the urgencies exactly as Taskwarrior would do
+if it was running on day X. Having recomputed the urgencies, it restarts.
+
+If after 2 hours a long task has decreased its urgency, it will be noticed and the newer most urgent
+task will get scheduled in its place.
+
+For `today`, taskcheck will skip the hours in the past -- i.e. if you're running at 12 pm, it will
+skip all the available slots until 12 pm.
+
+The maximum time that is allocated at each attempt is by default 2 hours
+(or less if the task is shorter), but you can change it by tuning the Taskwarrior UDA `min_block`.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.
@@ -144,7 +152,3 @@ additional_attributes_unplanned = ["due", "urgency"] # additional attributes to
 -i, --install: install taskcheck configuration
 -r, --report: show tasks planned until a certain time
 ```
-
-## TODO
-
-- [ ] Consider due dates are nearer while planning in the future

{taskcheck-0.3.3.post1 → taskcheck-0.3.3.post3}/README.md

@@ -27,7 +27,7 @@ It considers their estimated time to schedule all tasks starting from the most u
 
 #### UDAs
 
-Taskcheck leverages to UDAs, `estimated` and `time_map`. The `estimated` attribute is
+Taskcheck leverages two UDAs, `estimated` and `time_map`. The `estimated` attribute is
 the expected time to complete the task in hours. The `time_map` is a comma-separated list of strings
 that indicates the hours per day in which you will work on a task (e.g. `work`, `weekend`, etc.).
 The exact correspondence between the `time_map` and the hours of the day is defined in the configuration
@@ -61,18 +61,8 @@ how much time you have to work on which task in which day. For
 instance:
 
 - `taskcheck -r today` will show the tasks planned for today
-- `taskcheck -r 1w` will show the tasks planned for the next week,
+- `taskcheck -r 1w` will show the tasks planned for the next week
 
-## Algorithm
-
-The algorithm allocates a fixed amount of time for each task (e.g. 1 hour) and then recomputes the
-urgency and restart the allocation procedure.
-
-If after 1 hour the long task has decreased urgency, that will be noticed and the newer most urgent
-task will get scheduled in its place.
-
-The minimum time for a task is by default 2 hours, but you can change it by tuning the `min_block`
-taskwarrior UDA.
 
 ## Configuration
 
@@ -119,6 +109,25 @@ include_unplanned = true # include unplanned tasks in the report in an ad-hoc se
 additional_attributes_unplanned = ["due", "urgency"] # additional attributes to show in the report for unplanned tasks
 ```
 
+## Algorithm
+
+The algorithm simulates what happens if you work on a task for a certain time on a given day.
+
+For each day X starting from today, it sorts the tasks by decreasing urgency. 
+It start from the most urgent tasks that can be allocated on day X depending on the task's
+`time_map` and on your calendars. It allocates a few number of hours to the task,
+then recomputes the urgencies exactly as Taskwarrior would do
+if it was running on day X. Having recomputed the urgencies, it restarts.
+
+If after 2 hours a long task has decreased its urgency, it will be noticed and the newer most urgent
+task will get scheduled in its place.
+
+For `today`, taskcheck will skip the hours in the past -- i.e. if you're running at 12 pm, it will
+skip all the available slots until 12 pm.
+
+The maximum time that is allocated at each attempt is by default 2 hours
+(or less if the task is shorter), but you can change it by tuning the Taskwarrior UDA `min_block`.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.
@@ -131,7 +140,3 @@ additional_attributes_unplanned = ["due", "urgency"] # additional attributes to
 -i, --install: install taskcheck configuration
 -r, --report: show tasks planned until a certain time
 ```
-
-## TODO
-
-- [ ] Consider due dates are nearer while planning in the future

{taskcheck-0.3.3.post1 → taskcheck-0.3.3.post3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "taskcheck"
-version = "0.3.3-1"
+version = "0.3.3-3"
 description = "Automatic scheduler for taskwarrior"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -14,3 +14,6 @@ dependencies = [
 
 [project.scripts]
 taskcheck = "taskcheck.__main__:main"
+
+[tool.setuptools]
+license-files = []

{taskcheck-0.3.3.post1 → taskcheck-0.3.3.post3}/taskcheck/install.py

@@ -68,19 +68,19 @@ def install():
         ("urgency.uda.estimated.PT21H.coefficient", "10.38"),
         ("urgency.uda.estimated.PT22H.coefficient", "10.53"),
         ("urgency.uda.estimated.PT23H.coefficient", "10.67"),
-        ("urgency.uda.estimated.PT24H.coefficient", "10.80"),
-        ("urgency.uda.estimated.PT25H.coefficient", "10.93"),
-        ("urgency.uda.estimated.PT26H.coefficient", "11.05"),
-        ("urgency.uda.estimated.PT27H.coefficient", "11.16"),
-        ("urgency.uda.estimated.PT28H.coefficient", "11.27"),
-        ("urgency.uda.estimated.PT29H.coefficient", "11.37"),
-        ("urgency.uda.estimated.PT30H.coefficient", "11.47"),
-        ("urgency.uda.estimated.PT31H.coefficient", "11.56"),
-        ("urgency.uda.estimated.PT32H.coefficient", "11.65"),
-        ("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"),
+        ("urgency.uda.estimated.P1D.coefficient", "10.80"),
+        ("urgency.uda.estimated.P1DT1H.coefficient", "10.93"),
+        ("urgency.uda.estimated.P1DT2H.coefficient", "11.05"),
+        ("urgency.uda.estimated.P1DT3H.coefficient", "11.16"),
+        ("urgency.uda.estimated.P1DT4H.coefficient", "11.27"),
+        ("urgency.uda.estimated.P1DT5H.coefficient", "11.37"),
+        ("urgency.uda.estimated.P1DT6H.coefficient", "11.47"),
+        ("urgency.uda.estimated.P1DT7H.coefficient", "11.56"),
+        ("urgency.uda.estimated.P1DT8H.coefficient", "11.65"),
+        ("urgency.uda.estimated.P1DT9H.coefficient", "11.73"),
+        ("urgency.uda.estimated.P1DT10H.coefficient", "11.81"),
+        ("urgency.uda.estimated.P1DT11H.coefficient", "11.89"),
+        ("urgency.uda.estimated.P1DT12H.coefficient", "11.96"),
         (
             "report.ready.columns",
             "id,start.age,entry.age,depends.indicator,priority,project,tags,recur.indicator,scheduled.relative,due.relative,until.remaining,description,urgency",

{taskcheck-0.3.3.post1 → taskcheck-0.3.3.post3}/taskcheck/report.py

@@ -179,7 +179,7 @@ DEFAULT_EMOJI_KEYWORDS = {
 
 
 def get_tasks(config, tasks, year, month, day):
-    regex = re.compile(rf"{year}-{month}-{day} - ([PDTHM0-9]+)")
+    regex = re.compile(rf"{year:04d}-{month:02d}-{day:02d} - ([PDTHM0-9]+)")
     valid_tasks = []
     for task in tasks:
         for line in task["scheduling"].split("\n"):
@@ -265,6 +265,10 @@ def generate_report(config, constraint, verbose=False):
     console = Console()
     tasks = fetch_tasks()
 
+    if config.get("include_unplanned"):
+        unplanned_tasks = get_unplanned_tasks(config, tasks)
+        display_unplanned_tasks(console, config, unplanned_tasks)
+
     for year, month, day in get_days_in_constraint(constraint):
         this_day_tasks = get_tasks(config, tasks, year, month, day)
 
@@ -272,10 +276,6 @@ def generate_report(config, constraint, verbose=False):
 
         display_tasks_table(console, config, this_day_tasks)
 
-    if config.get("include_unplanned"):
-        unplanned_tasks = get_unplanned_tasks(config, tasks)
-        display_unplanned_tasks(console, config, unplanned_tasks)
-
 
 def fetch_tasks():
     """Fetch tasks from the task manager and return them as a JSON object."""

{taskcheck-0.3.3.post1 → taskcheck-0.3.3.post3/taskcheck.egg-info}/PKG-INFO

@@ -1,10 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: taskcheck
-Version: 0.3.3.post1
+Version: 0.3.3.post3
 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: random-unicode-emoji>=2.8
@@ -40,7 +39,7 @@ It considers their estimated time to schedule all tasks starting from the most u
 
 #### UDAs
 
-Taskcheck leverages to UDAs, `estimated` and `time_map`. The `estimated` attribute is
+Taskcheck leverages two UDAs, `estimated` and `time_map`. The `estimated` attribute is
 the expected time to complete the task in hours. The `time_map` is a comma-separated list of strings
 that indicates the hours per day in which you will work on a task (e.g. `work`, `weekend`, etc.).
 The exact correspondence between the `time_map` and the hours of the day is defined in the configuration
@@ -74,18 +73,8 @@ how much time you have to work on which task in which day. For
 instance:
 
 - `taskcheck -r today` will show the tasks planned for today
-- `taskcheck -r 1w` will show the tasks planned for the next week,
+- `taskcheck -r 1w` will show the tasks planned for the next week
 
-## Algorithm
-
-The algorithm allocates a fixed amount of time for each task (e.g. 1 hour) and then recomputes the
-urgency and restart the allocation procedure.
-
-If after 1 hour the long task has decreased urgency, that will be noticed and the newer most urgent
-task will get scheduled in its place.
-
-The minimum time for a task is by default 2 hours, but you can change it by tuning the `min_block`
-taskwarrior UDA.
 
 ## Configuration
 
@@ -132,6 +121,25 @@ include_unplanned = true # include unplanned tasks in the report in an ad-hoc se
 additional_attributes_unplanned = ["due", "urgency"] # additional attributes to show in the report for unplanned tasks
 ```
 
+## Algorithm
+
+The algorithm simulates what happens if you work on a task for a certain time on a given day.
+
+For each day X starting from today, it sorts the tasks by decreasing urgency. 
+It start from the most urgent tasks that can be allocated on day X depending on the task's
+`time_map` and on your calendars. It allocates a few number of hours to the task,
+then recomputes the urgencies exactly as Taskwarrior would do
+if it was running on day X. Having recomputed the urgencies, it restarts.
+
+If after 2 hours a long task has decreased its urgency, it will be noticed and the newer most urgent
+task will get scheduled in its place.
+
+For `today`, taskcheck will skip the hours in the past -- i.e. if you're running at 12 pm, it will
+skip all the available slots until 12 pm.
+
+The maximum time that is allocated at each attempt is by default 2 hours
+(or less if the task is shorter), but you can change it by tuning the Taskwarrior UDA `min_block`.
+
 ## Tips and Tricks
 
 - You can exclude a task from being scheduled by removing the `time_map` or `estimated` attributes.
@@ -144,7 +152,3 @@ additional_attributes_unplanned = ["due", "urgency"] # additional attributes to
 -i, --install: install taskcheck configuration
 -r, --report: show tasks planned until a certain time
 ```
-
-## TODO
-
-- [ ] Consider due dates are nearer while planning in the future