pytaskwarrior 2.0.2__tar.gz → 2.0.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.2
+Version: 2.0.4
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
@@ -42,6 +42,7 @@ Production-ready with 164 tests (96% coverage), strict type checking, and profes
 -  Type-safe with Pydantic models
 -  Context management
 -  UDA (User Defined Attributes) support
+-  Tag discovery and `@` context tags
 -  Recurring tasks and annotations
 -  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
@@ -80,6 +81,14 @@ for t in tw.get_tasks():
 tw.done_task(added.uuid)
 ```
 
+## Tags
+
+```python
+tags = tw.get_tags()  # virtual tags excluded
+all_tags = tw.get_tags(include_virtual_tags=True)
+context_tags = tw.get_context_tags()  # tags starting with "@"
+```
+
 ## Documentation
 
 Full documentation: [GitHub Repository](https://github.com/sznicolas/pytaskwarrior/)

{pytaskwarrior-2.0.2 → pytaskwarrior-2.0.4}/PYPI_README.md

@@ -17,6 +17,7 @@ Production-ready with 164 tests (96% coverage), strict type checking, and profes
 -  Type-safe with Pydantic models
 -  Context management
 -  UDA (User Defined Attributes) support
+-  Tag discovery and `@` context tags
 -  Recurring tasks and annotations
 -  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
@@ -55,6 +56,14 @@ for t in tw.get_tasks():
 tw.done_task(added.uuid)
 ```
 
+## Tags
+
+```python
+tags = tw.get_tags()  # virtual tags excluded
+all_tags = tw.get_tags(include_virtual_tags=True)
+context_tags = tw.get_context_tags()  # tags starting with "@"
+```
+
 ## Documentation
 
 Full documentation: [GitHub Repository](https://github.com/sznicolas/pytaskwarrior/)

{pytaskwarrior-2.0.2 → pytaskwarrior-2.0.4}/README.md

@@ -17,6 +17,7 @@ A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/) v3.4, the co
 - **Type-safe** - Pydantic models with full type hints
 - **Context management** - Define, apply, and switch contexts
 - **UDA support** - User Defined Attributes
+- **Tag discovery** - List real tags, virtual tags, and `@` context tags
 - **Recurring tasks** - Full recurrence support
 - **Annotations** - Add notes to tasks
 - **Date calculations** - Use TaskWarrior's date expressions
@@ -128,6 +129,13 @@ tw = TaskWarrior(
 | `stop_task(uuid)` | Stop working on task |
 | `annotate_task(uuid, annotation)` | Add annotation to task |
 
+#### Tags Operations
+
+| Method | Description |
+|--------|-------------|
+| `get_tags(include_virtual_tags=False)` | List tags, excluding virtual tags by default |
+| `get_context_tags()` | List tags that start with `@` |
+
 #### Context Operations
 
 | Method | Description |

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.2
+Version: 2.0.4
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
@@ -42,6 +42,7 @@ Production-ready with 164 tests (96% coverage), strict type checking, and profes
 -  Type-safe with Pydantic models
 -  Context management
 -  UDA (User Defined Attributes) support
+-  Tag discovery and `@` context tags
 -  Recurring tasks and annotations
 -  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
@@ -80,6 +81,14 @@ for t in tw.get_tasks():
 tw.done_task(added.uuid)
 ```
 
+## Tags
+
+```python
+tags = tw.get_tags()  # virtual tags excluded
+all_tags = tw.get_tags(include_virtual_tags=True)
+context_tags = tw.get_context_tags()  # tags starting with "@"
+```
+
 ## Documentation
 
 Full documentation: [GitHub Repository](https://github.com/sznicolas/pytaskwarrior/)

{pytaskwarrior-2.0.2 → pytaskwarrior-2.0.4}/src/taskwarrior/adapters/taskwarrior_adapter.py

@@ -26,6 +26,40 @@ from ..exceptions import (
 
 logger = logging.getLogger(__name__)
 
+TASKWARRIOR_VIRTUAL_TAGS: tuple[str, ...] = (
+    "BLOCKED",
+    "UNBLOCKED",
+    "BLOCKING",
+    "DUE",
+    "DUETODAY",
+    "TODAY",
+    "OVERDUE",
+    "WEEK",
+    "MONTH",
+    "QUARTER",
+    "YEAR",
+    "ACTIVE",
+    "SCHEDULED",
+    "PARENT",
+    "CHILD",
+    "UNTIL",
+    "WAITING",
+    "ANNOTATED",
+    "READY",
+    "YESTERDAY",
+    "TOMORROW",
+    "TAGGED",
+    "PENDING",
+    "COMPLETED",
+    "DELETED",
+    "UDA",
+    "ORPHAN",
+    "PRIORITY",
+    "PROJECT",
+    "LATEST",
+)
+TASKWARRIOR_VIRTUAL_TAG_SET = frozenset(TASKWARRIOR_VIRTUAL_TAGS)
+
 
 class TaskWarriorAdapter:
     """Low-level adapter for TaskWarrior CLI commands.
@@ -515,3 +549,23 @@ class TaskWarriorAdapter:
 
         projects = [line.strip() for line in result.stdout.split("\n") if line.strip()]
         return projects
+
+    def get_tags(self, include_virtual_tags: bool = False) -> list[str]:
+        """Get all tags defined in TaskWarrior.
+
+        Args:
+            include_virtual_tags: If ``True``, include TaskWarrior virtual tags
+                such as ``TODAY`` and ``READY``.
+
+        Returns:
+            List of tag names.
+        """
+        result = self.run_task_command(["_tags"])
+
+        if result.returncode != 0:
+            raise TaskWarriorError(f"Failed to get tags: {result.stderr}")
+
+        tags = [line.strip() for line in result.stdout.splitlines() if line.strip()]
+        if include_virtual_tags:
+            return list(dict.fromkeys(tags + list(TASKWARRIOR_VIRTUAL_TAGS)))
+        return [tag for tag in tags if tag not in TASKWARRIOR_VIRTUAL_TAG_SET]

{pytaskwarrior-2.0.2 → 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.
 
@@ -566,3 +607,22 @@ class TaskWarrior:
             ['dmc.fil.aretordre', 'dmc.fil.adérouler', 'perso', 'perso.orl', 'pro']
         """
         return self.adapter.get_projects()
+
+    def get_tags(self, include_virtual_tags: bool = False) -> list[str]:
+        """Get all tags defined in TaskWarrior.
+
+        Args:
+            include_virtual_tags: If ``True``, include TaskWarrior virtual tags
+                such as ``TODAY`` and ``READY``.
+
+        Returns:
+            List of tag names.
+        """
+        return self.adapter.get_tags(include_virtual_tags=include_virtual_tags)
+
+    def get_context_tags(self) -> list[str]:
+        """Return tags that follow the ``@`` context convention.
+
+        This is a convenience filter for user-defined tags such as ``@work``.
+        """
+        return [tag for tag in self.get_tags() if tag.startswith("@")]

{pytaskwarrior-2.0.2 → 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: