pytaskwarrior 1.1.0__tar.gz → 1.2.0.dev0__tar.gz

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 1.1.0
+Version: 1.2.0.dev0
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
@@ -21,6 +21,7 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pydantic>=2.11.7
+Requires-Dist: taskchampion-py>=2.0.2
 Dynamic: license-file
 
 # pytaskwarrior
@@ -34,7 +35,7 @@ Dynamic: license-file
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-**v1.0.0**: Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
+Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
 
 ## Features
 

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/PYPI_README.md

@@ -9,7 +9,7 @@
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-**v1.0.0**: Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
+Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
 
 ## Features
 

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/README.md

@@ -9,7 +9,7 @@
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/) v3.4, the command-line task management tool.
 
-**v1.0.0**: Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
+**v1.1.1**: Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
 
 ## Features
 

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pytaskwarrior"
-version = "1.1.0"
+version = "1.2.0.dev0"
 description = "Taskwarrior wrapper python module"
 readme = "PYPI_README.md"
 requires-python = ">=3.12"
@@ -21,6 +21,7 @@ classifiers = [
 ]
 dependencies = [
     "pydantic>=2.11.7",
+    "taskchampion-py>=2.0.2",
 ]
 
 [dependency-groups]

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/src/pytaskwarrior.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 1.1.0
+Version: 1.2.0.dev0
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
@@ -21,6 +21,7 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pydantic>=2.11.7
+Requires-Dist: taskchampion-py>=2.0.2
 Dynamic: license-file
 
 # pytaskwarrior
@@ -34,7 +35,7 @@ Dynamic: license-file
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-**v1.0.0**: Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
+Production-ready with 132 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, and PEP 561 type hints for IDE support.
 
 ## Features
 

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/src/pytaskwarrior.egg-info/SOURCES.txt

@@ -20,11 +20,13 @@ src/taskwarrior/dto/annotation_dto.py
 src/taskwarrior/dto/context_dto.py
 src/taskwarrior/dto/task_dto.py
 src/taskwarrior/dto/uda_dto.py
+src/taskwarrior/protocols/sync.py
 src/taskwarrior/registry/__init__.py
 src/taskwarrior/registry/uda_registry.py
 src/taskwarrior/services/__init__.py
 src/taskwarrior/services/context_service.py
 src/taskwarrior/services/uda_service.py
+src/taskwarrior/sync_backends/sync_local.py
 src/taskwarrior/utils/__init__.py
 src/taskwarrior/utils/conversions.py
 src/taskwarrior/utils/dto_converter.py

pytaskwarrior-1.2.0.dev0/src/pytaskwarrior.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pydantic>=2.11.7
+taskchampion-py>=2.0.2

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/src/taskwarrior/adapters/taskwarrior_adapter.py

@@ -16,7 +16,7 @@ from uuid import UUID
 
 from ..dto.task_dto import TaskInputDTO, TaskOutputDTO
 from ..enums import TaskStatus
-from ..exceptions import TaskNotFound, TaskValidationError, TaskWarriorError
+from ..exceptions import TaskNotFound, TaskValidationError, TaskWarriorError, TaskSyncError
 
 logger = logging.getLogger(__name__)
 
@@ -35,7 +35,13 @@ class TaskWarriorInfo(TypedDict, total=False):
     version: str
 
 
+from ..protocols.sync import SyncProtocol
+from ..sync_backends.sync_local import SyncLocal
+from typing import Optional
+
 class TaskWarriorAdapter:
+    _sync_configured: bool | None = None
+
     """Low-level adapter for TaskWarrior CLI commands.
 
     This class handles direct communication with the TaskWarrior binary,
@@ -52,7 +58,8 @@ class TaskWarriorAdapter:
         self,
         task_cmd: str = "task",
         taskrc_file: str = "~/.taskrc",
-        data_location: str | None = None
+        data_location: str | None = None,
+        sync: SyncProtocol | None = None
     ):
         """Initialize the adapter.
 
@@ -60,6 +67,7 @@ class TaskWarriorAdapter:
             task_cmd: TaskWarrior binary name or path.
             taskrc_file: Path to taskrc file.
             data_location: Path to data directory (optional).
+            sync: Optional SyncProtocol instance to handle synchronization.
 
         Raises:
             TaskValidationError: If TaskWarrior binary not found.
@@ -77,6 +85,37 @@ class TaskWarriorAdapter:
 
         self._options.extend(DEFAULT_OPTIONS)
 
+        # --- Begin sync config parsing ---
+        self.sync_config = self._parse_sync_config()
+        # --- End sync config parsing ---
+
+        # SyncProtocol injection or auto-detection
+        if sync is not None:
+            self._sync = sync
+        elif self.sync_config.get('sync.local.server_dir'):
+            # Prepare SyncLocal if sync.local.server is present
+            try:
+                self._sync = SyncLocal(self.sync_config.get('sync.local.server_dir'))
+            except Exception:
+                self._sync = None
+        else:
+            self._sync = None
+
+    def _parse_sync_config(self) -> dict:
+        """Parse the taskrc file and return all keys starting with 'sync.'"""
+        config = {}
+        if self.taskrc_file.exists():
+            with self.taskrc_file.open("r") as f:
+                for line in f:
+                    line = line.strip()
+                    if not line or line.startswith('#'):
+                        continue
+                    if line.startswith('sync.'):
+                        if '=' in line:
+                            key, value = line.split('=', 1)
+                            config[key.strip()] = value.strip()
+        return config
+
     def _check_binary_path(self, task_cmd: str) -> Path:
         """Verify TaskWarrior binary exists in PATH."""
         resolved_path = shutil.which(task_cmd)
@@ -104,6 +143,12 @@ rc.bulk=0
             self.data_location.mkdir(parents=True, exist_ok=True)
             logger.info(f"Created Task data direcory '{self.data_location}'")
 
+    def is_sync_configured(self) -> bool:
+        """Return True if synchronization is configured via SyncProtocol."""
+        if self._sync is None:
+            return False
+        return  True
+
     def run_task_command(
         self, args: list[str], no_opt: bool = False
     ) -> subprocess.CompletedProcess[str]:
@@ -146,6 +191,16 @@ rc.bulk=0
             logger.error(f"Exception while running '{cmd}': {e}")
             raise
 
+    def synchronize(self) -> None:
+        """Synchronize tasks using the injected or auto-detected SyncProtocol."""
+        if self._sync is not None:
+            try:
+                self._sync.synchronize()
+            except Exception as e:
+                raise TaskSyncError(f"SyncProtocol synchronization failed: {e}")
+        else:
+            raise TaskSyncError("No SyncProtocol is configured for synchronization.")
+
     @staticmethod
     def _wrap_filter(f: str) -> str:
         """Wrap a non-empty filter expression in parentheses.

{pytaskwarrior-1.1.0 → pytaskwarrior-1.2.0.dev0}/src/taskwarrior/exceptions.py

@@ -21,6 +21,14 @@ class TaskWarriorError(Exception):
     pass
 
 
+class TaskSyncError(TaskWarriorError):
+    """Raised when a synchronization error occurs in TaskWarrior.
+
+    This exception is used to signal errors encountered during sync operations.
+    """
+    pass
+
+
 class TaskNotFound(TaskWarriorError):  # noqa: N818
     """Raised when a requested task does not exist.
 

pytaskwarrior-1.2.0.dev0/src/taskwarrior/protocols/sync.py

@@ -0,0 +1,8 @@
+from typing import Protocol
+
+class SyncProtocol(Protocol):
+    def synchronize(self) -> None:
+        """Perform the synchronization process."""
+        ...
+
+    # Future extension: add more sync-related methods as needed

pytaskwarrior-1.2.0.dev0/src/taskwarrior/sync_backends/sync_local.py

@@ -0,0 +1,14 @@
+from typing import Optional
+from ..protocols.sync import SyncProtocol
+
+from taskchampion import Replica
+import os
+
+class SyncLocal(SyncProtocol):
+    def __init__(self, sync_dir: str):
+        self.sync_dir = sync_dir
+        self._replica = Replica.new_on_disk(self.sync_dir, True)
+
+    def synchronize(self) -> None:
+        # Use the Replica object for local sync
+        self._replica.sync_to_local(self.sync_dir, avoid_snapshots=False)

pytaskwarrior-1.1.0/src/pytaskwarrior.egg-info/requires.txt

@@ -1 +0,0 @@
-pydantic>=2.11.7