taskdog-ui 0.18.1__tar.gz

taskdog_ui-0.18.1/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: taskdog-ui
+Version: 0.18.1
+Summary: CLI and TUI for Taskdog task management system
+Author: Kohei Wada
+License: MIT
+Project-URL: Homepage, https://github.com/Kohei-Wada/taskdog
+Project-URL: Repository, https://github.com/Kohei-Wada/taskdog
+Project-URL: Bug Tracker, https://github.com/Kohei-Wada/taskdog/issues
+Keywords: task,management,cli,tui
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: taskdog-core==0.18.1
+Requires-Dist: taskdog-client==0.18.1
+Requires-Dist: click>=8.3.0
+Requires-Dist: rich>=14.2.0
+Requires-Dist: textual>=8.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: websockets>=14.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.7.0; extra == "dev"
+Provides-Extra: server
+Requires-Dist: taskdog-server==0.18.1; extra == "server"
+
+# taskdog-ui
+
+Command-line interface and terminal user interface for Taskdog task management system.
+
+## Overview
+
+This package provides two user interfaces for Taskdog:
+
+### CLI (Command-Line Interface)
+
+- 30+ commands for task management
+- Rich terminal output with colors and formatting
+- Batch operations support
+- Export capabilities (JSON, CSV, Markdown)
+
+### TUI (Terminal User Interface)
+
+- Full-screen interactive interface powered by Textual
+- Real-time task table with filtering and search
+- Gantt chart visualization
+- Vi-style keyboard navigation
+- Modal dialogs for task creation and editing
+
+## Installation
+
+Basic installation (CLI and TUI):
+
+```bash
+pip install taskdog-ui
+```
+
+With server support (includes taskdog-server):
+
+```bash
+pip install taskdog-ui[server]
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Prerequisites
+
+**IMPORTANT**: The CLI and TUI require a running API server. All commands will fail without it.
+
+### 1. Install the Server
+
+```bash
+# Server should be installed via workspace
+cd /path/to/taskdog
+make install
+```
+
+### 2. Start the Server
+
+```bash
+# Start the server (required before any CLI/TUI usage)
+taskdog-server --host 127.0.0.1 --port 8000
+
+# Or use systemd for auto-start (recommended)
+systemctl --user start taskdog-server
+systemctl --user enable taskdog-server
+```
+
+### 3. Configure API Connection
+
+Edit `~/.config/taskdog/cli.toml`:
+
+```toml
+[api]
+enabled = true
+host = "127.0.0.1"
+port = 8000
+```
+
+Or set environment variables:
+
+```bash
+export TASKDOG_API_HOST=127.0.0.1
+export TASKDOG_API_PORT=8000
+```
+
+### 4. Verify Connection
+
+```bash
+# Test that CLI can connect to server
+taskdog table
+```
+
+## Usage
+
+**Note**: All commands below require the server to be running (see Prerequisites above).
+
+### CLI Examples
+
+```bash
+# Add a task
+taskdog add "Implement feature" --priority 3
+
+# View tasks
+taskdog table
+taskdog gantt
+
+# Task lifecycle
+taskdog start 1
+taskdog done 1
+
+# Optimization
+taskdog optimize --algorithm balanced
+```
+
+### TUI
+
+Launch the interactive interface:
+
+```bash
+taskdog tui
+```
+
+Keyboard shortcuts:
+
+- `a`: Add task
+- `s`: Start task
+- `d`: Complete task
+- `e`: Edit task
+- `/`: Search
+- `q`: Quit
+
+## Architecture
+
+The UI uses:
+
+- **Click**: CLI framework
+- **Rich**: Terminal formatting and rendering
+- **Textual**: TUI framework
+- **httpx**: API client (for client-server mode)
+- **taskdog-core**: Core business logic and infrastructure
+
+## Dependencies
+
+- `taskdog-core`: Core business logic
+- `click`: CLI framework
+- `rich`: Terminal formatting
+- `textual`: TUI framework
+- `httpx`: HTTP client
+
+## Testing
+
+```bash
+pytest tests/
+```
+
+## License
+
+MIT

taskdog_ui-0.18.1/README.md

@@ -0,0 +1,157 @@
+# taskdog-ui
+
+Command-line interface and terminal user interface for Taskdog task management system.
+
+## Overview
+
+This package provides two user interfaces for Taskdog:
+
+### CLI (Command-Line Interface)
+
+- 30+ commands for task management
+- Rich terminal output with colors and formatting
+- Batch operations support
+- Export capabilities (JSON, CSV, Markdown)
+
+### TUI (Terminal User Interface)
+
+- Full-screen interactive interface powered by Textual
+- Real-time task table with filtering and search
+- Gantt chart visualization
+- Vi-style keyboard navigation
+- Modal dialogs for task creation and editing
+
+## Installation
+
+Basic installation (CLI and TUI):
+
+```bash
+pip install taskdog-ui
+```
+
+With server support (includes taskdog-server):
+
+```bash
+pip install taskdog-ui[server]
+```
+
+For development:
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Prerequisites
+
+**IMPORTANT**: The CLI and TUI require a running API server. All commands will fail without it.
+
+### 1. Install the Server
+
+```bash
+# Server should be installed via workspace
+cd /path/to/taskdog
+make install
+```
+
+### 2. Start the Server
+
+```bash
+# Start the server (required before any CLI/TUI usage)
+taskdog-server --host 127.0.0.1 --port 8000
+
+# Or use systemd for auto-start (recommended)
+systemctl --user start taskdog-server
+systemctl --user enable taskdog-server
+```
+
+### 3. Configure API Connection
+
+Edit `~/.config/taskdog/cli.toml`:
+
+```toml
+[api]
+enabled = true
+host = "127.0.0.1"
+port = 8000
+```
+
+Or set environment variables:
+
+```bash
+export TASKDOG_API_HOST=127.0.0.1
+export TASKDOG_API_PORT=8000
+```
+
+### 4. Verify Connection
+
+```bash
+# Test that CLI can connect to server
+taskdog table
+```
+
+## Usage
+
+**Note**: All commands below require the server to be running (see Prerequisites above).
+
+### CLI Examples
+
+```bash
+# Add a task
+taskdog add "Implement feature" --priority 3
+
+# View tasks
+taskdog table
+taskdog gantt
+
+# Task lifecycle
+taskdog start 1
+taskdog done 1
+
+# Optimization
+taskdog optimize --algorithm balanced
+```
+
+### TUI
+
+Launch the interactive interface:
+
+```bash
+taskdog tui
+```
+
+Keyboard shortcuts:
+
+- `a`: Add task
+- `s`: Start task
+- `d`: Complete task
+- `e`: Edit task
+- `/`: Search
+- `q`: Quit
+
+## Architecture
+
+The UI uses:
+
+- **Click**: CLI framework
+- **Rich**: Terminal formatting and rendering
+- **Textual**: TUI framework
+- **httpx**: API client (for client-server mode)
+- **taskdog-core**: Core business logic and infrastructure
+
+## Dependencies
+
+- `taskdog-core`: Core business logic
+- `click`: CLI framework
+- `rich`: Terminal formatting
+- `textual`: TUI framework
+- `httpx`: HTTP client
+
+## Testing
+
+```bash
+pytest tests/
+```
+
+## License
+
+MIT

taskdog_ui-0.18.1/pyproject.toml

@@ -0,0 +1,108 @@
+[project]
+name = "taskdog-ui"
+version = "0.18.1"
+description = "CLI and TUI for Taskdog task management system"
+readme = "README.md"
+requires-python = ">=3.12"
+authors = [
+    { name = "Kohei Wada" }
+]
+license = { text = "MIT" }
+keywords = ["task", "management", "cli", "tui"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "taskdog-core==0.18.1",
+    "taskdog-client==0.18.1",
+    "click>=8.3.0",
+    "rich>=14.2.0",
+    "textual>=8.0.0",
+    "python-dateutil>=2.8.0",
+    "websockets>=14.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-asyncio>=1.0.0",
+    "mypy>=1.0.0",
+    "ruff>=0.7.0",
+]
+server = [
+    "taskdog-server==0.18.1",
+]
+
+[project.scripts]
+taskdog = "taskdog.cli_main:cli"
+
+[project.urls]
+Homepage = "https://github.com/Kohei-Wada/taskdog"
+Repository = "https://github.com/Kohei-Wada/taskdog"
+"Bug Tracker" = "https://github.com/Kohei-Wada/taskdog/issues"
+
+[build-system]
+requires = ["setuptools>=68.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = [
+    "taskdog",
+    "taskdog.formatters",
+    "taskdog.services",
+    "taskdog.cli",
+    "taskdog.cli.commands",
+    "taskdog.tui",
+    "taskdog.tui.commands",
+    "taskdog.tui.constants",
+    "taskdog.tui.palette",
+    "taskdog.tui.palette.providers",
+    "taskdog.tui.services",
+    "taskdog.tui.utils",
+    "taskdog.tui.screens",
+    "taskdog.tui.dialogs",
+    "taskdog.tui.widgets",
+    "taskdog.tui.forms",
+    "taskdog.tui.forms.suggesters",
+    "taskdog.tui.forms.validators",
+    "taskdog.tui.state",
+    "taskdog.tui.styles",
+    "taskdog.console",
+    "taskdog.renderers",
+    "taskdog.exporters",
+    "taskdog.constants",
+    "taskdog.presenters",
+    "taskdog.view_models",
+    "taskdog.utils",
+    "taskdog.shared",
+    "taskdog.shared.click_types",
+    "taskdog.infrastructure",
+]
+package-dir = { "" = "src" }
+
+[tool.setuptools.package-data]
+taskdog = ["py.typed"]
+"taskdog.tui.styles" = ["*.tcss"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+# Disable unused-ignore warnings (environment-dependent)
+warn_unused_ignores = false
+
+# Ignore missing imports for taskdog_client (installed separately)
+[[tool.mypy.overrides]]
+module = "taskdog_client"
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]

taskdog_ui-0.18.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

taskdog_ui-0.18.1/src/taskdog/__init__.py

@@ -0,0 +1,8 @@
+"""taskdog - CLI task management tool"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("taskdog-ui")
+except PackageNotFoundError:
+    __version__ = "unknown"

taskdog_ui-0.18.1/src/taskdog/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI interface."""

taskdog_ui-0.18.1/src/taskdog/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands."""

taskdog_ui-0.18.1/src/taskdog/cli/commands/add.py

@@ -0,0 +1,148 @@
+"""Add command - Add a new task."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import click
+
+from taskdog.cli.error_handler import handle_task_errors
+
+if TYPE_CHECKING:
+    from datetime import datetime
+
+    from taskdog.cli.context import CliContext
+from taskdog_core.domain.exceptions.task_exceptions import TaskValidationError
+
+
+@click.command(name="add", help="Add a new task.")
+@click.argument("name", type=str)
+@click.option(
+    "--priority",
+    "-p",
+    type=int,
+    default=None,
+    help="Task priority (default: from config or 5, higher value = higher priority)",
+)
+@click.option(
+    "--fixed",
+    "-f",
+    is_flag=True,
+    help="Mark task as fixed (won't be rescheduled by optimizer)",
+)
+@click.option(
+    "--depends-on",
+    "-d",
+    multiple=True,
+    type=int,
+    help="Task IDs this task depends on (can be specified multiple times)",
+)
+@click.option(
+    "--tag",
+    "-t",
+    multiple=True,
+    type=str,
+    help="Tags for categorization and filtering (can be specified multiple times)",
+)
+@click.option(
+    "--deadline",
+    "-D",
+    type=click.DateTime(formats=["%Y-%m-%d %H:%M:%S"]),
+    default=None,
+    help="Task deadline (format: YYYY-MM-DD HH:MM:SS)",
+)
+@click.option(
+    "--estimate",
+    "-e",
+    type=float,
+    default=None,
+    help="Estimated duration in hours (must be > 0)",
+)
+@click.option(
+    "--start",
+    "-s",
+    type=click.DateTime(formats=["%Y-%m-%d %H:%M:%S"]),
+    default=None,
+    help="Planned start time (format: YYYY-MM-DD HH:MM:SS)",
+)
+@click.option(
+    "--end",
+    "-E",
+    type=click.DateTime(formats=["%Y-%m-%d %H:%M:%S"]),
+    default=None,
+    help="Planned end time (format: YYYY-MM-DD HH:MM:SS)",
+)
+@click.pass_context
+@handle_task_errors("adding task")
+def add_command(
+    ctx: click.Context,
+    name: str,
+    priority: int,
+    fixed: bool,
+    depends_on: tuple[int, ...],
+    tag: tuple[str, ...],
+    deadline: datetime | None,
+    estimate: float | None,
+    start: datetime | None,
+    end: datetime | None,
+) -> None:
+    """Add a new task.
+
+    You can set all task properties at creation time, or use dedicated commands
+    after creation (deadline, estimate, schedule) for updates.
+
+    Usage:
+        # Basic task
+        taskdog add "Task name"
+
+        # With priority and tags
+        taskdog add "Task name" --priority 3 --tag backend
+
+        # Full task with all properties
+        taskdog add "Implement auth" -p 5 -D "2025-12-01" -e 8 -s "2025-11-20" -t backend
+
+    Examples:
+        # Simple task
+        taskdog add "Implement authentication"
+
+        # With priority
+        taskdog add "Fix login bug" -p 5
+
+        # With deadline and estimate
+        taskdog add "Add unit tests" --deadline "2025-12-15" --estimate 4
+
+        # Complete task with schedule
+        taskdog add "Code review" -p 3 -s "2025-11-20 09:00" -e "2025-11-20 12:00"
+
+        # With dependencies and tags
+        taskdog add "Deploy feature" -d 123 -t deployment -p 5
+    """
+    ctx_obj: CliContext = ctx.obj
+    console_writer = ctx_obj.console_writer
+
+    # Create task via API client
+    task = ctx_obj.api_client.create_task(
+        name=name,
+        priority=priority,
+        is_fixed=fixed,
+        tags=list(tag) if tag else None,
+        deadline=deadline,
+        estimated_duration=estimate,
+        planned_start=start,
+        planned_end=end,
+    )
+
+    # Add dependencies if specified
+    if depends_on:
+        for dep_id in depends_on:
+            try:
+                task = ctx_obj.api_client.add_dependency(task.id, dep_id)
+            except TaskValidationError as e:
+                console_writer.validation_error(str(e))
+                # Continue adding other dependencies even if one fails
+
+    console_writer.task_success("Added", task)
+    if task.depends_on:
+        console_writer.info(f"Dependencies: {task.depends_on}")
+    if task.tags:
+        console_writer.info(f"Tags: {', '.join(task.tags)}")

taskdog_ui-0.18.1/src/taskdog/cli/commands/add_dependency.py

@@ -0,0 +1,40 @@
+"""Add-dependency command - Add a task dependency."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+import click
+
+from taskdog.cli.error_handler import handle_task_errors
+
+if TYPE_CHECKING:
+    from taskdog.cli.context import CliContext
+
+
+@click.command(name="add-dependency", help="Add a dependency to a task.")
+@click.argument("task_id", type=int)
+@click.argument("depends_on_id", type=int)
+@click.pass_context
+@handle_task_errors("adding dependency")
+def add_dependency_command(
+    ctx: click.Context, task_id: int, depends_on_id: int
+) -> None:
+    """Add a dependency to a task.
+
+    Usage:
+        taskdog add-dependency <TASK_ID> <DEPENDS_ON_ID>
+
+    Examples:
+        taskdog add-dependency 5 3    # Task 5 depends on task 3
+    """
+    ctx_obj: CliContext = ctx.obj
+    console_writer = ctx_obj.console_writer
+
+    # Add dependency via API client
+    task = ctx_obj.api_client.add_dependency(task_id, depends_on_id)
+
+    console_writer.success(
+        f"Added dependency: Task {task_id} now depends on task {depends_on_id}"
+    )
+    console_writer.info(f"Task {task_id} dependencies: {task.depends_on}")