pytaskwarrior 2.0.5__tar.gz → 2.0.7__tar.gz

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

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

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

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

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

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

{pytaskwarrior-2.0.5 → pytaskwarrior-2.0.7}/src/pytaskwarrior.egg-info/SOURCES.txt

@@ -30,4 +30,5 @@ src/taskwarrior/services/context_service.py
 src/taskwarrior/services/uda_service.py
 src/taskwarrior/utils/__init__.py
 src/taskwarrior/utils/conversions.py
-src/taskwarrior/utils/dto_converter.py
+src/taskwarrior/utils/dto_converter.py
+tests/test_main_get_udas.py

{pytaskwarrior-2.0.5 → pytaskwarrior-2.0.7}/src/taskwarrior/dto/annotation_dto.py

@@ -37,7 +37,7 @@ class AnnotationDTO(BaseModel):
 
     @field_validator("entry", mode="before")
     @classmethod
-    def parse_entry_date(cls, value: str | datetime | None) -> datetime:
+    def parse_entry_date(cls, value: str | datetime) -> datetime:
         """Parse the entry date from TaskWarrior format.
 
         Args:
@@ -48,4 +48,4 @@ class AnnotationDTO(BaseModel):
         """
         if isinstance(value, datetime):
             return value
-        return parse_taskwarrior_date(value or "")
+        return parse_taskwarrior_date(value)

{pytaskwarrior-2.0.5 → 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,
@@ -307,7 +313,7 @@ class TaskOutputDTO(BaseModel):
         mode="before",
     )
     @classmethod
-    def parse_datetime_field(cls, value: str | datetime | None) -> datetime:
+    def parse_datetime_field(cls, value: str | datetime | None) -> datetime | None:
         """Parse datetime fields from TaskWarrior format.
 
         Handles both TaskWarrior's compact format (20260101T193139Z)
@@ -317,11 +323,13 @@ class TaskOutputDTO(BaseModel):
             value: The datetime value to parse, either as string or datetime.
 
         Returns:
-            A datetime object with timezone info.
+            A datetime object with timezone info, or None if value is None.
         """
+        if value is None:
+            return None
         if isinstance(value, datetime):
             return value
-        return parse_taskwarrior_date(value or "")
+        return parse_taskwarrior_date(value)
 
     def get_uda(self, name: str, default: Any = None) -> Any:
         """Get a User Defined Attribute value by name.

{pytaskwarrior-2.0.5 → 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"

{pytaskwarrior-2.0.5 → pytaskwarrior-2.0.7}/src/taskwarrior/main.py

@@ -556,6 +556,14 @@ class TaskWarrior:
         """
         return self.uda_service.registry.get_uda(name)
 
+    def get_udas(self) -> list[UdaConfig]:
+        """Get full UDA definitions.
+
+        Returns:
+            List of UdaConfig objects for all defined UDAs.
+        """
+        return self.uda_service.registry.get_udas()
+
     def define_uda(self, uda: UdaConfig) -> None:
         """Define a new UDA via the TaskWarrior facade.
 

{pytaskwarrior-2.0.5 → pytaskwarrior-2.0.7}/src/taskwarrior/registry/uda_registry.py

@@ -68,3 +68,11 @@ class UdaRegistry:
     def is_uda_field(self, field_name: str) -> bool:
         """Check if a field name corresponds to a registered UDA."""
         return field_name in self._udas
+
+    def get_udas(self) -> list[UdaConfig]:
+        """Return all registered UdaConfig objects as a list.
+
+        This provides a direct way to retrieve the full UdaConfig objects
+        currently stored in the registry.
+        """
+        return list(self._udas.values())

pytaskwarrior-2.0.7/tests/test_main_get_udas.py

@@ -0,0 +1,22 @@
+
+from taskwarrior import TaskWarrior
+
+
+def test_get_udas_empty(monkeypatch):
+    tw = TaskWarrior(task_cmd="task", taskrc_file="/tmp/nonexistent", data_location=None)
+    monkeypatch.setattr(tw.uda_service.registry, "get_udas", lambda: [])
+    assert tw.get_udas() == []
+
+
+def test_get_udas_multiple(monkeypatch):
+    tw = TaskWarrior(task_cmd="task", taskrc_file="/tmp/nonexistent", data_location=None)
+
+    class DummyUda:
+        def __init__(self, name):
+            self.name = name
+
+    names = {"sev", "est"}
+    monkeypatch.setattr(tw.uda_service.registry, "get_udas", lambda: [DummyUda("sev"), DummyUda("est")])
+
+    udas = tw.get_udas()
+    assert {u.name for u in udas} == names