taskrepo 0.1.0__tar.gz

taskrepo-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# UV
+uv.lock
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# Local config (user-specific)
+.taskreporc

taskrepo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ricardo Henriques
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

taskrepo-0.1.0/pyproject.toml

@@ -0,0 +1,134 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "taskrepo"
+dynamic = ["version"]
+authors = [
+    { name = "Ricardo Henriques", email = "paxcalpt@gmail.com" }
+]
+keywords = ["task-management", "git", "markdown", "cli", "taskwarrior", "productivity"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development",
+    "Topic :: Office/Business :: Scheduling",
+]
+description = "TaskWarrior-inspired CLI for managing tasks as markdown files in git repositories"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.0.0",
+    "prompt_toolkit>=3.0.0",
+    "GitPython>=3.1.0",
+    "PyYAML>=6.0.0",
+    "rich>=13.0.0",
+    "python-dateutil>=2.8.0",
+    "dateparser>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/henriqueslab/TaskRepo"
+Repository = "https://github.com/henriqueslab/TaskRepo"
+Issues = "https://github.com/henriqueslab/TaskRepo/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4,<9.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.12.2",
+    "mypy>=1.0",
+    "pre-commit>=4.2.0",
+    "types-PyYAML>=6.0.0",
+    "types-python-dateutil>=2.8.0",
+]
+
+# Ruff configuration
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # Pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "D",    # pydocstyle
+]
+
+ignore = [
+    "E203",  # whitespace before ':'
+    "E501",  # line too long
+    "D100",  # Missing docstring in public module
+    "D101",  # Missing docstring in public class
+    "D102",  # Missing docstring in public method
+    "D103",  # Missing docstring in public function
+    "D104",  # Missing docstring in public package
+    "D105",  # Missing docstring in magic method
+    "D107",  # Missing docstring in __init__
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.ruff.lint.isort]
+known-first-party = ["taskrepo"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["D"]
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = false
+warn_unused_configs = false
+disallow_untyped_defs = false
+check_untyped_defs = true
+explicit_package_bases = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "-v",
+    "--tb=short",
+    "--strict-markers",
+    "--strict-config",
+]
+
+# Hatch configuration
+[tool.hatch.version]
+path = "src/taskrepo/__version__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/taskrepo"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml"
+]
+
+# Console scripts entry point
+[project.scripts]
+taskrepo = "taskrepo.cli.main:cli"
+tsk = "taskrepo.cli.main:cli"

taskrepo-0.1.0/src/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-0.1.0/src/taskrepo/__version__.py

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

taskrepo-0.1.0/src/taskrepo/cli/__init__.py

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

taskrepo-0.1.0/src/taskrepo/cli/commands/__init__.py

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

taskrepo-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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")