Exceptions

Custom exceptions for error handling.

All exceptions inherit from TaskWarriorError, allowing you to catch all library errors with a single except clause.

from taskwarrior.exceptions import TaskWarriorError, TaskNotFound

try:
    task = tw.get_task("nonexistent-uuid")
except TaskNotFound:
    print("Task not found")
except TaskWarriorError as e:
    print(f"TaskWarrior error: {e}")

TaskWarriorError

TaskWarriorError

Bases: Exception

Base exception for all TaskWarrior-related errors.

All custom exceptions in pytaskwarrior inherit from this class, allowing you to catch all library errors with a single except clause.

Example

try: ... tw.get_task("nonexistent-uuid") ... except TaskWarriorError as e: ... print(f"TaskWarrior error: {e}")

TaskNotFound

TaskNotFound

Bases: TaskWarriorError

Raised when a requested task does not exist.

This exception is raised when attempting to retrieve, modify, delete, or perform any operation on a task that doesn't exist in the TaskWarrior database.

Example

try: ... task = tw.get_task("nonexistent-uuid") ... except TaskNotFound: ... print("Task not found")

TaskValidationError

TaskValidationError

Bases: TaskWarriorError

Raised when task data validation fails.

This exception is raised when: - Task description is empty - Required fields are missing - Field values are invalid - TaskWarrior rejects the task data

Example

try: ... task = TaskInputDTO(description="") # Empty description ... except TaskValidationError as e: ... print(f"Invalid task: {e}")