taskdog-client
HTTP API client library for Taskdog server.
Overview
This package provides a type-safe HTTP client for communicating with the Taskdog API server. It handles authentication, error mapping, and response conversion to domain DTOs.
Use cases:
- Building custom CLI tools
- Integrating Taskdog with other systems
- Creating automated workflows
- Testing API endpoints
Installation
pip install taskdog-client
For development:
pip install -e ".[dev]"
Client Classes
| Client | Purpose |
|---|---|
TaskClient |
Task CRUD operations (create, update, delete, archive) |
LifecycleClient |
Status changes (start, complete, pause, cancel, reopen) |
RelationshipClient |
Dependencies and tags |
QueryClient |
List tasks, get task details |
AnalyticsClient |
Statistics and Gantt data |
NotesClient |
Task notes (markdown) |
AuditClient |
Audit log access |
BaseApiClient |
Base class with common HTTP logic |
Usage Example
from taskdog_client import TaskClient, LifecycleClient, QueryClient
# Create clients
base_url = "http://127.0.0.1:8000"
api_key = "your-api-key" # Optional, for authenticated servers
task_client = TaskClient(base_url, api_key)
lifecycle_client = LifecycleClient(base_url, api_key)
query_client = QueryClient(base_url, api_key)
# Create a task
task = task_client.create_task(
name="My Task",
priority=100,
estimated_duration=8.0,
tags=["backend"]
)
print(f"Created task: {task.id}")
# List tasks
tasks = query_client.list_tasks(status="pending")
for t in tasks:
print(f"- {t.name} (ID: {t.id})")
# Start a task
lifecycle_client.start_task(task.id)
# Complete a task
lifecycle_client.complete_task(task.id)
Error Handling
Clients raise exceptions from taskdog_core.domain.exceptions:
from taskdog_core.domain.exceptions import TaskNotFoundException, TaskValidationError
try:
task_client.get_task(999)
except TaskNotFoundException:
print("Task not found")
except TaskValidationError as e:
print(f"Validation error: {e}")
Configuration
Clients accept optional configuration:
from taskdog_client import TaskClient
# Basic usage (no auth)
client = TaskClient("http://127.0.0.1:8000")
# With API key authentication
client = TaskClient(
base_url="http://127.0.0.1:8000",
api_key="your-secret-key"
)
# Custom timeout (in seconds)
client = TaskClient(
base_url="http://127.0.0.1:8000",
timeout=30.0
)
Dependencies
taskdog-core: Domain DTOs and exceptionshttpx: HTTP client library
Related Packages
- taskdog-core: Domain DTOs used by this package
- taskdog-server: API server this client connects to
- taskdog-ui: CLI/TUI that uses this client
- taskdog-mcp: MCP server that uses this client
Testing
pytest tests/
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
taskdog_client-0.25.0.tar.gz
(35.6 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file taskdog_client-0.25.0.tar.gz.
File metadata
- Download URL: taskdog_client-0.25.0.tar.gz
- Upload date:
- Size: 35.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c9811a7a1073bd37f4c23ab78718400c609a0059a6090b4733c614431d8aceec
|
|
| MD5 |
3a3879dcfbc10b939765ffa8e9f5c2af
|
|
| BLAKE2b-256 |
23f054d4ba2dad9d07c857c363b093021484a80c215c30985495d6cd145f4cef
|
Provenance
The following attestation bundles were made for taskdog_client-0.25.0.tar.gz:
Publisher:
release.yml on Kohei-Wada/taskdog
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
taskdog_client-0.25.0.tar.gz -
Subject digest:
c9811a7a1073bd37f4c23ab78718400c609a0059a6090b4733c614431d8aceec - Sigstore transparency entry: 2186098522
- Sigstore integration time:
-
Permalink:
Kohei-Wada/taskdog@4c7416e5d5e0553b8e33c8fba8cb452812d5f27a -
Branch / Tag:
refs/tags/v0.25.0 - Owner: https://github.com/Kohei-Wada
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@4c7416e5d5e0553b8e33c8fba8cb452812d5f27a -
Trigger Event:
push
-
Statement type:
File details
Details for the file taskdog_client-0.25.0-py3-none-any.whl.
File metadata
- Download URL: taskdog_client-0.25.0-py3-none-any.whl
- Upload date:
- Size: 32.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
62b32089f65ff24133e3136c881d4694c8414abea4d43c6f93b9c31291c70818
|
|
| MD5 |
05d1970f5fa009225e8bc4afd7023632
|
|
| BLAKE2b-256 |
15d8805e52c44c25001e4ebe9d59e598c0d759810e0daea5241351395ab051d2
|
Provenance
The following attestation bundles were made for taskdog_client-0.25.0-py3-none-any.whl:
Publisher:
release.yml on Kohei-Wada/taskdog
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
taskdog_client-0.25.0-py3-none-any.whl -
Subject digest:
62b32089f65ff24133e3136c881d4694c8414abea4d43c6f93b9c31291c70818 - Sigstore transparency entry: 2186098571
- Sigstore integration time:
-
Permalink:
Kohei-Wada/taskdog@4c7416e5d5e0553b8e33c8fba8cb452812d5f27a -
Branch / Tag:
refs/tags/v0.25.0 - Owner: https://github.com/Kohei-Wada
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@4c7416e5d5e0553b8e33c8fba8cb452812d5f27a -
Trigger Event:
push
-
Statement type:
