pytaskwarrior 2.0.3__tar.gz → 2.0.4__tar.gz

{pytaskwarrior-2.0.3 → pytaskwarrior-2.0.4}/PKG-INFO

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

{pytaskwarrior-2.0.3 → pytaskwarrior-2.0.4}/pyproject.toml

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

{pytaskwarrior-2.0.3 → pytaskwarrior-2.0.4}/src/pytaskwarrior.egg-info/PKG-INFO

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

{pytaskwarrior-2.0.3 → pytaskwarrior-2.0.4}/src/taskwarrior/main.py

@@ -554,6 +554,47 @@ class TaskWarrior:
         """
         return self.uda_service.registry.get_uda(name)
 
+    def define_uda(self, uda: UdaConfig) -> None:
+        """Define a new UDA via the TaskWarrior facade.
+
+        Delegates to UdaService.define_uda which performs the necessary
+        TaskWarrior config writes and registers the UDA in the local registry.
+
+        Args:
+            uda: The UdaConfig describing the UDA to create.
+
+        Raises:
+            TaskOperationError: If creating the UDA via the underlying adapter fails.
+        """
+        self.uda_service.define_uda(uda)
+
+    def update_uda(self, uda: UdaConfig) -> None:
+        """Update an existing UDA via the TaskWarrior facade.
+
+        Delegates to UdaService.update_uda.
+
+        Args:
+            uda: The UdaConfig with updated fields.
+
+        Raises:
+            TaskOperationError: If applying the update fails.
+        """
+        self.uda_service.update_uda(uda)
+
+    def delete_uda(self, uda: UdaConfig) -> None:
+        """Delete a UDA via the TaskWarrior facade.
+
+        Delegates to UdaService.delete_uda which removes TaskWarrior config
+        keys and the UDA from the local registry.
+
+        Args:
+            uda: The UdaConfig identifying the UDA to remove.
+
+        Raises:
+            TaskOperationError: If deletion fails for reasons other than missing keys.
+        """
+        self.uda_service.delete_uda(uda)
+
     def get_projects(self) -> list[str]:
         """Get all projects defined in TaskWarrior.
 

{pytaskwarrior-2.0.3 → pytaskwarrior-2.0.4}/src/taskwarrior/services/uda_service.py

@@ -59,6 +59,16 @@ class UdaService:
 
         The service executes the required `task config` commands via the adapter
         and only updates the registry if all commands succeed.
+
+        Args:
+            uda: The UdaConfig describing the UDA to create.
+
+        Raises:
+            TaskOperationError: If any underlying TaskWarrior config command fails.
+
+        Example:
+            >>> uda = UdaConfig(name="sev", uda_type=UdaType.STRING, label="Severity")
+            >>> service.define_uda(uda)
         """
         # Build commands to define the UDA
         field_names = uda.__class__.model_fields.keys() - {"name"}
@@ -86,6 +96,12 @@ class UdaService:
         """Update an existing UDA in TaskWarrior and in the registry.
 
         Executes commands via adapter and updates the registry on success.
+
+        Args:
+            uda: The UdaConfig with updated settings to apply.
+
+        Raises:
+            TaskOperationError: If applying the updated configuration fails.
         """
         # For now, same as define_uda
         self.define_uda(uda)
@@ -94,9 +110,26 @@ class UdaService:
         """Delete a UDA from TaskWarrior and remove it from the registry.
 
         Executes `task config <key>` without a value to remove each UDA key.
+
+        Args:
+            uda: The UdaConfig identifying the UDA to remove.
+
+        Raises:
+            TaskOperationError: If an unexpected TaskWarrior error occurs while
+                attempting to remove configuration keys (missing keys are tolerated).
         """
-        field_names = uda.__class__.model_fields.keys()
-        for key in field_names:
+        # Mirror define_uda: skip 'name' and map internal 'uda_type' -> TaskWarrior 'type'
+        field_names = set(uda.__class__.model_fields.keys()) - {"name"}
+        keys_to_delete: list[str] = []
+
+        if "uda_type" in field_names:
+            keys_to_delete.append("type")
+            field_names.remove("uda_type")
+
+        # delete remaining fields deterministically
+        keys_to_delete.extend(sorted(field_names))
+
+        for key in keys_to_delete:
             cmd = ["config", f"uda.{uda.name}.{key}"]
             result = self.adapter.run_task_command(cmd)
             if getattr(result, "returncode", 0) != 0: