pytaskwarrior 2.0.6__tar.gz → 2.0.7__tar.gz

{pytaskwarrior-2.0.6 → pytaskwarrior-2.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.6
+Version: 2.0.7
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT

{pytaskwarrior-2.0.6 → pytaskwarrior-2.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pytaskwarrior"
-version = "2.0.6"
+version = "2.0.7"
 description = "Taskwarrior wrapper python module"
 readme = "PYPI_README.md"
 requires-python = ">=3.12"

{pytaskwarrior-2.0.6 → pytaskwarrior-2.0.7}/src/pytaskwarrior.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.6
+Version: 2.0.7
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT

{pytaskwarrior-2.0.6 → pytaskwarrior-2.0.7}/src/taskwarrior/dto/task_dto.py

@@ -82,8 +82,14 @@ class TaskInputDTO(BaseModel):
         default_factory=list, description="List of UUIDs of tasks this task depends on"
     )
     parent: UUID | None = Field(default=None, description="UUID of the template task")
-    recur: RecurrencePeriod | None = Field(
-        default=None, description="Recurrence period for recurring tasks"
+    recur: RecurrencePeriod | str | None = Field(
+        default=None,
+        description=(
+            "Recurrence period. "
+            "Use standard values: 'daily', 'weekly', 'monthly', 'yearly', 'quarterly', 'semiannually', 'hourly', 'minutely', 'secondly'. "
+            "OR use custom TaskWarrior expressions like '2weeks', '3days', 'every 10 days', '2months'. "
+            "TaskWarrior will validate the expression."
+        )
     )
     scheduled: str | None = Field(
         default=None,

{pytaskwarrior-2.0.6 → pytaskwarrior-2.0.7}/src/taskwarrior/enums.py

@@ -57,34 +57,26 @@ class Priority(str, Enum):
 class RecurrencePeriod(str, Enum):
     """Supported recurrence periods for recurring tasks.
 
-    Defines how often a recurring task should repeat. When a recurring
-    task is completed, TaskWarrior automatically creates the next instance.
-
-    Attributes:
-        DAILY: Task repeats every day.
-        WEEKLY: Task repeats every week.
-        MONTHLY: Task repeats every month.
-        YEARLY: Task repeats every year.
-        QUARTERLY: Task repeats every quarter (3 months).
-        SEMIANNUALLY: Task repeats every 6 months.
-        HOURLY: Task repeats every hour.
-        MINUTELY: Task repeats every minute.
-        SECONDLY: Task repeats every second.
-
-    Example:
-        >>> from taskwarrior import TaskInputDTO, RecurrencePeriod
-        >>> weekly_task = TaskInputDTO(
-        ...     description="Weekly review",
-        ...     due="monday",
-        ...     recur=RecurrencePeriod.WEEKLY
-        ... )
-
-    Note:
-        For custom periods not listed here (e.g. ``"2weeks"``, ``"10days"``,
-        ``"6months"``), pass a plain string directly to the ``recur`` field —
-        TaskWarrior accepts any valid recurrence expression:
-
-        >>> custom_task = TaskInputDTO(description="Bi-weekly review", recur="2weeks")
+    TaskWarrior supports both standard keywords and custom duration expressions.
+
+    Standard Keywords (Recommended):
+        - DAILY, WEEKLY, MONTHLY, YEARLY
+        - QUARTERLY, SEMIANNUALLY
+        - HOURLY, MINUTELY, SECONDLY
+
+    Custom Expressions (Also Valid):
+        - "2weeks" (Every two weeks)
+        - "3days" (Every three days)
+        - "every 10 days"
+        - "2months"
+        - "6months"
+
+    Example (Standard):
+        >>> task = TaskInputDTO(description="Daily standup", recur=RecurrencePeriod.DAILY)
+
+    Example (Custom):
+        >>> task = TaskInputDTO(description="Bi-weekly report", recur="2weeks")
+        # Note: Passing a string directly bypasses the Enum but is fully supported by TaskWarrior.
     """
 
     DAILY = "daily"