pytaskwarrior 1.2.0.dev0__tar.gz → 2.0.1__tar.gz

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 1.2.0.dev0
+Version: 2.0.1
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/sznicolas/pytaskwarrior/
+Project-URL: Homepage, https://pytaskwarrior.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/sznicolas/pytaskwarrior/
 Project-URL: Issues, https://github.com/sznicolas/pytaskwarrior/issues
 Project-URL: Changelog, https://github.com/sznicolas/pytaskwarrior/blob/main/CHANGELOG.md
@@ -21,7 +21,6 @@ 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
@@ -35,15 +34,16 @@ Dynamic: license-file
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-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 164 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, PEP 561 type hints for IDE support, and a consistent exception hierarchy.
 
 ## Features
 
-- ✅ Full CRUD operations for tasks
-- ✅ Type-safe with Pydantic models
-- ✅ Context management
-- ✅ UDA (User Defined Attributes) support
-- ✅ Recurring tasks and annotations
+-  Full CRUD operations for tasks
+-  Type-safe with Pydantic models
+-  Context management
+-  UDA (User Defined Attributes) support
+-  Recurring tasks and annotations
+-  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
 ## Requirements
 

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

@@ -9,15 +9,16 @@
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-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 164 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, PEP 561 type hints for IDE support, and a consistent exception hierarchy.
 
 ## Features
 
-- ✅ Full CRUD operations for tasks
-- ✅ Type-safe with Pydantic models
-- ✅ Context management
-- ✅ UDA (User Defined Attributes) support
-- ✅ Recurring tasks and annotations
+-  Full CRUD operations for tasks
+-  Type-safe with Pydantic models
+-  Context management
+-  UDA (User Defined Attributes) support
+-  Recurring tasks and annotations
+-  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
 ## Requirements
 

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

@@ -9,17 +9,17 @@
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/) v3.4, the command-line task management tool.
 
-**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.
+**v2.0.0**: Major release with breaking API changes (Context.define now accepts ContextDTO; UdaConfig.type → UdaConfig.uda_type). All tests passing and documentation updated.
 
 ## Features
 
-- ✅ **Full CRUD operations** - Create, read, update, delete tasks
-- ✅ **Type-safe** - Pydantic models with full type hints
-- ✅ **Context management** - Define, apply, and switch contexts
-- ✅ **UDA support** - User Defined Attributes
-- ✅ **Recurring tasks** - Full recurrence support
-- ✅ **Annotations** - Add notes to tasks
-- ✅ **Date calculations** - Use TaskWarrior's date expressions
+- **Full CRUD operations** - Create, read, update, delete tasks
+- **Type-safe** - Pydantic models with full type hints
+- **Context management** - Define, apply, and switch contexts
+- **UDA support** - User Defined Attributes
+- **Recurring tasks** - Full recurrence support
+- **Annotations** - Add notes to tasks
+- **Date calculations** - Use TaskWarrior's date expressions
 
 ## Requirements
 
@@ -31,7 +31,7 @@ A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/) v3.4, the co
 ## Installation
 
 ```bash
-pip install pytaskwarrior==1.0.0
+pip install pytaskwarrior==2.0.0
 ```
 
 Or install from source:
@@ -132,7 +132,7 @@ tw = TaskWarrior(
 
 | Method | Description |
 |--------|-------------|
-| `define_context(name, read_filter, write_filter)` | Create a context with read and write filters |
+| `define_context(ctx: ContextDTO)` | Create a context from a ContextDTO (name, read_filter, write_filter) |
 | `apply_context(name)` | Activate a context |
 | `unset_context()` | Deactivate current context |
 | `get_contexts()` | List all contexts |
@@ -140,6 +140,37 @@ tw = TaskWarrior(
 | `delete_context(name)` | Remove a context |
 | `has_context(name)` | Check if context exists |
 
+#### Synchronization Operations
+
+| Method | Description |
+|--------|-------------|
+| `is_sync_configured()` | Return `True` if any `sync.*` key is present in configuration (ConfigStore). |
+| `synchronize()` | Run `task sync`; raises `TaskSyncError` if not configured or sync fails. |
+
+### Exceptions
+
+All exceptions inherit from `TaskWarriorError` and are importable from the top-level package:
+
+```python
+from taskwarrior import (
+    TaskWarriorError,        # Base class — catch all library errors
+    TaskNotFound,            # Task does not exist
+    TaskValidationError,     # Invalid input data (empty description, etc.)
+    TaskOperationError,      # Operation failed on an existing task
+    TaskConfigurationError,  # Environment issue (binary not found, taskrc missing)
+    TaskSyncError,           # Synchronization failure
+)
+```
+
+| Exception | Raised when |
+|-----------|-------------|
+| `TaskWarriorError` | Base class; catch-all for any library error |
+| `TaskNotFound` | The requested task does not exist |
+| `TaskValidationError` | Input data is invalid (e.g., empty description) |
+| `TaskOperationError` | A write operation failed on an existing task (delete, done, start…) |
+| `TaskConfigurationError` | Environment error (binary not in PATH, taskrc missing/unreadable) |
+| `TaskSyncError` | Sync backend not configured or synchronization failed |
+
 ### Data Models
 
 #### TaskInputDTO
@@ -213,9 +244,10 @@ RecurrencePeriod.YEARLY
 ### Working with Contexts
 
 ```python
+from taskwarrior import ContextDTO
 # Define contexts for different workflows
-tw.define_context("work", read_filter="project:work or +urgent", write_filter="project:work or +urgent")
-tw.define_context("home", read_filter="project:home or project:personal", write_filter="project:home or project:personal")
+tw.define_context(ContextDTO(name="work", read_filter="project:work or +urgent", write_filter="project:work or +urgent"))
+tw.define_context(ContextDTO(name="home", read_filter="project:home or project:personal", write_filter="project:home or project:personal"))
 
 # Switch to work context
 tw.apply_context("work")
@@ -340,4 +372,3 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 - [TaskWarrior](https://taskwarrior.org/) - The underlying task management tool
 - [GitHub Repository](https://github.com/sznicolas/pytaskwarrior/)
 - [PyPI Package](https://pypi.org/project/pytaskwarrior/)
-

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

@@ -1,6 +1,6 @@
 [project]
 name = "pytaskwarrior"
-version = "1.2.0.dev0"
+version = "2.0.1"
 description = "Taskwarrior wrapper python module"
 readme = "PYPI_README.md"
 requires-python = ">=3.12"
@@ -21,7 +21,6 @@ classifiers = [
 ]
 dependencies = [
     "pydantic>=2.11.7",
-    "taskchampion-py>=2.0.2",
 ]
 
 [dependency-groups]
@@ -38,7 +37,7 @@ docs = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/sznicolas/pytaskwarrior/"
+Homepage = "https://pytaskwarrior.readthedocs.io/en/latest/"
 Repository = "https://github.com/sznicolas/pytaskwarrior/"
 Issues = "https://github.com/sznicolas/pytaskwarrior/issues"
 Changelog = "https://github.com/sznicolas/pytaskwarrior/blob/main/CHANGELOG.md"

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: pytaskwarrior
-Version: 1.2.0.dev0
+Version: 2.0.1
 Summary: Taskwarrior wrapper python module
 Author-email: sznicolas <sznicolas@users.noreply.github.com>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/sznicolas/pytaskwarrior/
+Project-URL: Homepage, https://pytaskwarrior.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/sznicolas/pytaskwarrior/
 Project-URL: Issues, https://github.com/sznicolas/pytaskwarrior/issues
 Project-URL: Changelog, https://github.com/sznicolas/pytaskwarrior/blob/main/CHANGELOG.md
@@ -21,7 +21,6 @@ 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
@@ -35,15 +34,16 @@ Dynamic: license-file
 
 A modern Python wrapper for [TaskWarrior](https://taskwarrior.org/), the command-line task management tool.
 
-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 164 tests (96% coverage), strict type checking, and professional-grade code quality. Zero linting errors, full async-safe subprocess handling, PEP 561 type hints for IDE support, and a consistent exception hierarchy.
 
 ## Features
 
-- ✅ Full CRUD operations for tasks
-- ✅ Type-safe with Pydantic models
-- ✅ Context management
-- ✅ UDA (User Defined Attributes) support
-- ✅ Recurring tasks and annotations
+-  Full CRUD operations for tasks
+-  Type-safe with Pydantic models
+-  Context management
+-  UDA (User Defined Attributes) support
+-  Recurring tasks and annotations
+-  Consistent exception hierarchy (`TaskNotFound`, `TaskValidationError`, `TaskOperationError`, `TaskConfigurationError`, …)
 
 ## Requirements
 

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

@@ -15,18 +15,18 @@ src/taskwarrior/main.py
 src/taskwarrior/py.typed
 src/taskwarrior/adapters/__init__.py
 src/taskwarrior/adapters/taskwarrior_adapter.py
+src/taskwarrior/config/config_store.py
+src/taskwarrior/config/uda_parser.py
 src/taskwarrior/dto/__init__.py
 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-2.0.1/src/pytaskwarrior.egg-info/requires.txt

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

{pytaskwarrior-1.2.0.dev0 → pytaskwarrior-2.0.1}/src/taskwarrior/__init__.py

@@ -39,6 +39,14 @@ from .dto.context_dto import ContextDTO
 from .dto.task_dto import TaskInputDTO, TaskOutputDTO
 from .dto.uda_dto import UdaConfig, UdaType
 from .enums import Priority, RecurrencePeriod, TaskStatus
+from .exceptions import (
+    TaskConfigurationError,
+    TaskNotFound,
+    TaskOperationError,
+    TaskSyncError,
+    TaskValidationError,
+    TaskWarriorError,
+)
 from .main import TaskWarrior
 from .registry.uda_registry import UdaRegistry
 from .utils.dto_converter import task_output_to_input
@@ -54,12 +62,17 @@ __all__ = [
     "Priority",
     "RecurrencePeriod",
     "TaskStatus",
+    "TaskConfigurationError",
     "TaskInputDTO",
+    "TaskNotFound",
+    "TaskOperationError",
     "TaskOutputDTO",
+    "TaskSyncError",
+    "TaskValidationError",
     "TaskWarrior",
+    "TaskWarriorError",
     "task_output_to_input",
     "UdaConfig",
     "UdaRegistry",
     "UdaType",
 ]
-