pytaskwarrior 2.0.2__tar.gz → 2.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.2
+Version: 2.0.3
 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.3}/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.3}/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.3}/pyproject.toml

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 2.0.2
+Version: 2.0.3
 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.3}/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.3}/src/taskwarrior/main.py

@@ -566,3 +566,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("@")]