taskrepo 0.1.0__py3-none-any.whl

taskrepo/__init__.py

@@ -0,0 +1,5 @@
+"""TaskRepo - TaskWarrior-inspired CLI for managing tasks as markdown files in git repositories."""
+
+from taskrepo.__version__ import __version__
+
+__all__ = ["__version__"]

taskrepo/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

taskrepo/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI module for TaskRepo."""

taskrepo/cli/commands/__init__.py

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

taskrepo/cli/commands/add.py

@@ -0,0 +1,166 @@
+"""Add command for creating new tasks."""
+
+import click
+
+from taskrepo.core.repository import RepositoryManager
+from taskrepo.core.task import Task
+from taskrepo.tui import prompts
+
+
+@click.command()
+@click.option("--repo", "-r", help="Repository name (will prompt if not specified)")
+@click.option("--title", "-t", help="Task title (will prompt if not specified)")
+@click.option("--project", "-p", help="Project name")
+@click.option("--priority", type=click.Choice(["H", "M", "L"], case_sensitive=False), help="Task priority")
+@click.option("--assignees", "-a", help="Comma-separated list of assignees (e.g., @user1,@user2)")
+@click.option("--tags", help="Comma-separated list of tags")
+@click.option("--due", help="Due date (e.g., 2025-12-31)")
+@click.option("--description", "-d", help="Task description")
+@click.option("--interactive/--no-interactive", "-i/-I", default=True, help="Use interactive mode")
+@click.pass_context
+def add(ctx, repo, title, project, priority, assignees, tags, due, description, interactive):
+    """Add a new task."""
+    config = ctx.obj["config"]
+    manager = RepositoryManager(config.parent_dir)
+
+    repositories = manager.discover_repositories()
+
+    # Interactive mode
+    if interactive:
+        click.echo("Creating a new task...\n")
+
+        # Select repository
+        if not repo:
+            selected_repo = prompts.prompt_repository(repositories)
+            if not selected_repo:
+                click.echo("Cancelled.")
+                ctx.exit(0)
+        else:
+            selected_repo = manager.get_repository(repo)
+            if not selected_repo:
+                click.secho(f"Error: Repository '{repo}' not found", fg="red", err=True)
+                ctx.exit(1)
+
+        # Get task title
+        if not title:
+            title = prompts.prompt_title()
+            if not title:
+                click.echo("Cancelled.")
+                ctx.exit(0)
+
+        # Get project
+        if project is None:
+            existing_projects = selected_repo.get_projects()
+            project = prompts.prompt_project(existing_projects)
+
+        # Get priority
+        if priority is None:
+            priority = prompts.prompt_priority(config.default_priority)
+
+        # Get assignees
+        if assignees is None:
+            existing_assignees = selected_repo.get_assignees()
+            # Add default assignee to existing list if configured
+            if config.default_assignee and config.default_assignee not in existing_assignees:
+                existing_assignees = [config.default_assignee] + existing_assignees
+            assignees_list = prompts.prompt_assignees(existing_assignees)
+            # If no assignees entered and default_assignee is set, use it
+            if not assignees_list and config.default_assignee:
+                assignees_list = [config.default_assignee]
+        else:
+            assignees_list = [a.strip() for a in assignees.split(",")]
+            # Ensure @ prefix
+            assignees_list = [a if a.startswith("@") else f"@{a}" for a in assignees_list]
+
+        # Get tags
+        if tags is None:
+            existing_tags = selected_repo.get_tags()
+            tags_list = prompts.prompt_tags(existing_tags)
+        else:
+            tags_list = [t.strip() for t in tags.split(",")]
+
+        # Get due date
+        if due is None:
+            due_date = prompts.prompt_due_date()
+        else:
+            import dateparser
+
+            try:
+                due_date = dateparser.parse(due, settings={'PREFER_DATES_FROM': 'future'})
+                if due_date is None:
+                    raise ValueError("Could not parse date")
+            except Exception as e:
+                click.secho(f"Error: Invalid due date: {e}", fg="red", err=True)
+                ctx.exit(1)
+
+        # Get description
+        if description is None:
+            description = prompts.prompt_description()
+
+    else:
+        # Non-interactive mode - validate required fields
+        if not repo or not title:
+            click.secho("Error: --repo and --title are required in non-interactive mode", fg="red", err=True)
+            ctx.exit(1)
+
+        selected_repo = manager.get_repository(repo)
+        if not selected_repo:
+            click.secho(f"Error: Repository '{repo}' not found", fg="red", err=True)
+            ctx.exit(1)
+
+        # Parse assignees
+        assignees_list = []
+        if assignees:
+            assignees_list = [a.strip() for a in assignees.split(",")]
+            assignees_list = [a if a.startswith("@") else f"@{a}" for a in assignees_list]
+        elif config.default_assignee:
+            # Use default assignee if none specified
+            assignees_list = [config.default_assignee]
+
+        # Parse tags
+        tags_list = []
+        if tags:
+            tags_list = [t.strip() for t in tags.split(",")]
+
+        # Parse due date
+        due_date = None
+        if due:
+            import dateparser
+
+            try:
+                due_date = dateparser.parse(due, settings={'PREFER_DATES_FROM': 'future'})
+                if due_date is None:
+                    raise ValueError("Could not parse date")
+            except Exception as e:
+                click.secho(f"Error: Invalid due date: {e}", fg="red", err=True)
+                ctx.exit(1)
+
+        if not priority:
+            priority = config.default_priority
+
+        if not description:
+            description = ""
+
+    # Generate task ID
+    task_id = selected_repo.next_task_id()
+
+    # Create task
+    task = Task(
+        id=task_id,
+        title=title,
+        status=config.default_status,
+        priority=priority.upper(),
+        project=project,
+        assignees=assignees_list,
+        tags=tags_list,
+        due=due_date,
+        description=description,
+        repo=selected_repo.name,
+    )
+
+    # Save task
+    task_file = selected_repo.save_task(task)
+
+    click.echo()
+    click.secho(f"✓ Task created: {task}", fg="green")
+    click.echo(f"  File: {task_file}")

taskrepo/cli/commands/config.py

@@ -0,0 +1,161 @@
+"""Config command for interactive configuration management."""
+
+from pathlib import Path
+
+import click
+from prompt_toolkit import prompt
+from prompt_toolkit.completion import WordCompleter
+
+from taskrepo.core.config import Config
+
+
+@click.command(name="config")
+@click.pass_context
+def config_cmd(ctx):
+    """Interactive configuration management."""
+    config = ctx.obj["config"]
+
+    while True:
+        click.echo("\n" + "=" * 50)
+        click.echo("TaskRepo Configuration")
+        click.echo("=" * 50)
+        click.echo("\nWhat would you like to configure?\n")
+        click.echo("  1. View current settings")
+        click.echo("  2. Change parent directory")
+        click.echo("  3. Set default priority")
+        click.echo("  4. Set default status")
+        click.echo("  5. Set default assignee")
+        click.echo("  6. Configure task sorting")
+        click.echo("  7. Reset to defaults")
+        click.echo("  8. Exit")
+
+        try:
+            choice = prompt("\nEnter choice (1-8): ", completer=WordCompleter(["1", "2", "3", "4", "5", "6", "7", "8"]))
+        except (KeyboardInterrupt, EOFError):
+            click.echo("\nExiting configuration.")
+            break
+
+        choice = choice.strip()
+
+        if choice == "1":
+            # View current settings
+            click.echo("\n" + "-" * 50)
+            click.echo("Current Configuration:")
+            click.echo("-" * 50)
+            click.echo(f"  Config file: {config.config_path}")
+            click.echo(f"  Parent directory: {config.parent_dir}")
+            click.echo(f"  Default priority: {config.default_priority}")
+            click.echo(f"  Default status: {config.default_status}")
+            default_assignee = config.default_assignee if config.default_assignee else "(none)"
+            click.echo(f"  Default assignee: {default_assignee}")
+            sort_by = ", ".join(config.sort_by)
+            click.echo(f"  Sort by: {sort_by}")
+            click.echo("-" * 50)
+
+        elif choice == "2":
+            # Change parent directory
+            click.echo(f"\nCurrent parent directory: {config.parent_dir}")
+            try:
+                new_dir = prompt("Enter new parent directory (or press Enter to cancel): ")
+                if new_dir.strip():
+                    config.parent_dir = Path(new_dir.strip()).expanduser()
+                    click.secho(f"✓ Parent directory updated to: {config.parent_dir}", fg="green")
+                else:
+                    click.echo("Cancelled.")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "3":
+            # Set default priority
+            click.echo(f"\nCurrent default priority: {config.default_priority}")
+            try:
+                new_priority = prompt(
+                    "Enter default priority (H/M/L): ",
+                    completer=WordCompleter(["H", "M", "L"], ignore_case=True),
+                )
+                new_priority = new_priority.strip().upper()
+                if new_priority in {"H", "M", "L"}:
+                    config.default_priority = new_priority
+                    click.secho(f"✓ Default priority updated to: {new_priority}", fg="green")
+                elif new_priority:
+                    click.secho("✗ Invalid priority. Must be H, M, or L.", fg="red")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "4":
+            # Set default status
+            click.echo(f"\nCurrent default status: {config.default_status}")
+            statuses = ["pending", "in_progress", "completed", "cancelled"]
+            try:
+                new_status = prompt(
+                    "Enter default status: ",
+                    completer=WordCompleter(statuses, ignore_case=True),
+                )
+                new_status = new_status.strip().lower()
+                if new_status in statuses:
+                    config.default_status = new_status
+                    click.secho(f"✓ Default status updated to: {new_status}", fg="green")
+                elif new_status:
+                    click.secho(f"✗ Invalid status. Must be one of: {', '.join(statuses)}", fg="red")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "5":
+            # Set default assignee
+            current_assignee = config.default_assignee if config.default_assignee else "(none)"
+            click.echo(f"\nCurrent default assignee: {current_assignee}")
+            try:
+                new_assignee = prompt("Enter default assignee (GitHub handle, or leave empty for none): ")
+                new_assignee = new_assignee.strip()
+                if new_assignee:
+                    if not new_assignee.startswith("@"):
+                        new_assignee = f"@{new_assignee}"
+                    config.default_assignee = new_assignee
+                    click.secho(f"✓ Default assignee updated to: {new_assignee}", fg="green")
+                else:
+                    config.default_assignee = None
+                    click.secho("✓ Default assignee cleared", fg="green")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "6":
+            # Configure task sorting
+            click.echo(f"\nCurrent sort order: {', '.join(config.sort_by)}")
+            click.echo("\nAvailable sort fields:")
+            click.echo("  priority, due, created, modified, status, title, project")
+            click.echo("  (prefix with '-' for descending order, e.g., '-created')")
+            try:
+                new_sort = prompt("Enter sort fields (comma-separated): ")
+                if new_sort.strip():
+                    sort_fields = [f.strip() for f in new_sort.split(",") if f.strip()]
+                    try:
+                        config.sort_by = sort_fields
+                        click.secho(f"✓ Sort order updated to: {', '.join(sort_fields)}", fg="green")
+                    except ValueError as e:
+                        click.secho(f"✗ Error: {e}", fg="red")
+                else:
+                    click.echo("Cancelled.")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "7":
+            # Reset to defaults
+            click.echo("\n⚠️  This will reset ALL configuration to defaults.")
+            try:
+                confirm = prompt("Are you sure? (yes/no): ")
+                if confirm.strip().lower() in {"yes", "y"}:
+                    config._data = Config.DEFAULT_CONFIG.copy()
+                    config.save()
+                    click.secho("✓ Configuration reset to defaults", fg="green")
+                else:
+                    click.echo("Cancelled.")
+            except (KeyboardInterrupt, EOFError):
+                click.echo("\nCancelled.")
+
+        elif choice == "8":
+            # Exit
+            click.echo("\nExiting configuration.")
+            break
+
+        else:
+            click.secho("✗ Invalid choice. Please enter a number from 1-8.", fg="red")

taskrepo/cli/commands/delete.py

@@ -0,0 +1,62 @@
+"""Delete command for removing tasks."""
+
+import click
+
+from taskrepo.core.repository import RepositoryManager
+from taskrepo.utils.helpers import normalize_task_id
+
+
+@click.command(name="delete")
+@click.argument("task_id")
+@click.option("--repo", "-r", help="Repository name (will search all repos if not specified)")
+@click.option("--force", "-f", is_flag=True, help="Skip confirmation prompt")
+@click.pass_context
+def delete(ctx, task_id, repo, force):
+    """Delete a task permanently.
+
+    TASK_ID: Task ID to delete
+    """
+    config = ctx.obj["config"]
+    manager = RepositoryManager(config.parent_dir)
+
+    # Normalize task ID (convert "1" to "001", etc.)
+    task_id = normalize_task_id(task_id)
+
+    # Find the task
+    if repo:
+        repository = manager.get_repository(repo)
+        if not repository:
+            click.secho(f"Error: Repository '{repo}' not found", fg="red", err=True)
+            ctx.exit(1)
+        task = repository.get_task(task_id)
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found in repository '{repo}'", fg="red", err=True)
+            ctx.exit(1)
+    else:
+        # Search all repositories
+        task = None
+        repository = None
+        for r in manager.discover_repositories():
+            t = r.get_task(task_id)
+            if t:
+                task = t
+                repository = r
+                break
+
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found", fg="red", err=True)
+            ctx.exit(1)
+
+    # Confirmation prompt (unless --force flag is used)
+    if not force:
+        click.echo(f"\nTask to delete: {task}")
+        if not click.confirm("Are you sure you want to delete this task? This cannot be undone.", default=False):
+            click.echo("Deletion cancelled.")
+            ctx.exit(0)
+
+    # Delete the task
+    if repository.delete_task(task_id):
+        click.secho(f"✓ Task deleted: {task}", fg="green")
+    else:
+        click.secho(f"Error: Failed to delete task '{task_id}'", fg="red", err=True)
+        ctx.exit(1)

taskrepo/cli/commands/done.py

@@ -0,0 +1,53 @@
+"""Done command for marking tasks as completed."""
+
+import click
+
+from taskrepo.core.repository import RepositoryManager
+from taskrepo.utils.helpers import normalize_task_id
+
+
+@click.command()
+@click.argument("task_id")
+@click.option("--repo", "-r", help="Repository name (will search all repos if not specified)")
+@click.pass_context
+def done(ctx, task_id, repo):
+    """Mark a task as completed.
+
+    TASK_ID: Task ID to mark as done
+    """
+    config = ctx.obj["config"]
+    manager = RepositoryManager(config.parent_dir)
+
+    # Normalize task ID (convert "1" to "001", etc.)
+    task_id = normalize_task_id(task_id)
+
+    # Find the task
+    if repo:
+        repository = manager.get_repository(repo)
+        if not repository:
+            click.secho(f"Error: Repository '{repo}' not found", fg="red", err=True)
+            ctx.exit(1)
+        task = repository.get_task(task_id)
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found in repository '{repo}'", fg="red", err=True)
+            ctx.exit(1)
+    else:
+        # Search all repositories
+        task = None
+        repository = None
+        for r in manager.discover_repositories():
+            t = r.get_task(task_id)
+            if t:
+                task = t
+                repository = r
+                break
+
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found", fg="red", err=True)
+            ctx.exit(1)
+
+    # Mark as completed
+    task.status = "completed"
+    repository.save_task(task)
+
+    click.secho(f"✓ Task marked as completed: {task}", fg="green")

taskrepo/cli/commands/edit.py

@@ -0,0 +1,85 @@
+"""Edit command for modifying existing tasks."""
+
+import subprocess
+import tempfile
+from pathlib import Path
+
+import click
+
+from taskrepo.core.repository import RepositoryManager
+from taskrepo.core.task import Task
+from taskrepo.utils.helpers import normalize_task_id
+
+
+@click.command()
+@click.argument("task_id")
+@click.option("--repo", "-r", help="Repository name (will search all repos if not specified)")
+@click.option("--editor", "-e", envvar="EDITOR", default="vim", help="Editor to use (defaults to $EDITOR or vim)")
+@click.pass_context
+def edit(ctx, task_id, repo, editor):
+    """Edit an existing task.
+
+    TASK_ID: Task ID to edit
+    """
+    config = ctx.obj["config"]
+    manager = RepositoryManager(config.parent_dir)
+
+    # Normalize task ID (convert "1" to "001", etc.)
+    task_id = normalize_task_id(task_id)
+
+    # Find the task
+    if repo:
+        repository = manager.get_repository(repo)
+        if not repository:
+            click.secho(f"Error: Repository '{repo}' not found", fg="red", err=True)
+            ctx.exit(1)
+        task = repository.get_task(task_id)
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found in repository '{repo}'", fg="red", err=True)
+            ctx.exit(1)
+    else:
+        # Search all repositories
+        task = None
+        repository = None
+        for r in manager.discover_repositories():
+            t = r.get_task(task_id)
+            if t:
+                task = t
+                repository = r
+                break
+
+        if not task:
+            click.secho(f"Error: Task '{task_id}' not found", fg="red", err=True)
+            ctx.exit(1)
+
+    # Create temporary file with task content
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".md", delete=False) as f:
+        temp_file = Path(f.name)
+        f.write(task.to_markdown())
+
+    # Open editor
+    try:
+        subprocess.run([editor, str(temp_file)], check=True)
+    except subprocess.CalledProcessError:
+        click.secho(f"Error: Editor '{editor}' failed", fg="red", err=True)
+        temp_file.unlink()
+        ctx.exit(1)
+    except FileNotFoundError:
+        click.secho(f"Error: Editor '{editor}' not found", fg="red", err=True)
+        temp_file.unlink()
+        ctx.exit(1)
+
+    # Read modified content
+    try:
+        content = temp_file.read_text()
+        modified_task = Task.from_markdown(content, task_id, repository.name)
+    except Exception as e:
+        click.secho(f"Error: Failed to parse edited task: {e}", fg="red", err=True)
+        temp_file.unlink()
+        ctx.exit(1)
+    finally:
+        temp_file.unlink()
+
+    # Save modified task
+    repository.save_task(modified_task)
+    click.secho(f"✓ Task updated: {modified_task}", fg="green")