devtodo 0.1.0__tar.gz

devtodo-0.1.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: devtodo
+Version: 0.1.0
+Summary: A developer-focused CLI todo tool
+Author: jakok
+License: MIT
+Project-URL: Homepage, https://github.com/jakok/devtodo
+Project-URL: Repository, https://github.com/jakok/devtodo
+Keywords: todo,cli,developer,terminal,productivity
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Requires-Dist: sqlmodel>=0.0.19
+Requires-Dist: textual>=0.80
+Requires-Dist: httpx>=0.27
+
+# devtodo 📝
+
+A fast, developer-focused CLI todo tool with a beautiful TUI.
+
+## Install
+
+```bash
+pipx install devtodo
+```
+
+> Requires Python 3.12+. Install `pipx` first: `pip install pipx`
+
+## Usage
+
+```bash
+dt add "Fix login bug" --priority high --project backend
+dt list
+dt list --project backend
+dt done 1
+dt edit 2 --priority low --tags "bug,ui"
+dt remove 3
+dt clear-completed
+dt today         # high priority + due today
+dt start         # interactive TUI
+```
+
+## GitHub Integration
+
+```bash
+export GITHUB_TOKEN=ghp_yourtoken
+
+dt github sync --repo owner/repo     # import open issues as todos
+dt github push 5 --repo owner/repo   # push todo #5 as a GitHub issue
+dt github list                        # show todos linked to GitHub
+```
+
+## Keyboard shortcuts (TUI)
+
+| Key | Action |
+|-----|--------|
+| `a` | Add todo |
+| `e` | Edit selected |
+| `d` | Mark done |
+| `Del` | Remove |
+| `f` / `F` | Filter open / show all |
+| `q` | Quit |
+
+## Data
+
+Todos are stored locally at `~/.devtodo/devtodo.db` (SQLite).

devtodo-0.1.0/README.md

@@ -0,0 +1,50 @@
+# devtodo 📝
+
+A fast, developer-focused CLI todo tool with a beautiful TUI.
+
+## Install
+
+```bash
+pipx install devtodo
+```
+
+> Requires Python 3.12+. Install `pipx` first: `pip install pipx`
+
+## Usage
+
+```bash
+dt add "Fix login bug" --priority high --project backend
+dt list
+dt list --project backend
+dt done 1
+dt edit 2 --priority low --tags "bug,ui"
+dt remove 3
+dt clear-completed
+dt today         # high priority + due today
+dt start         # interactive TUI
+```
+
+## GitHub Integration
+
+```bash
+export GITHUB_TOKEN=ghp_yourtoken
+
+dt github sync --repo owner/repo     # import open issues as todos
+dt github push 5 --repo owner/repo   # push todo #5 as a GitHub issue
+dt github list                        # show todos linked to GitHub
+```
+
+## Keyboard shortcuts (TUI)
+
+| Key | Action |
+|-----|--------|
+| `a` | Add todo |
+| `e` | Edit selected |
+| `d` | Mark done |
+| `Del` | Remove |
+| `f` / `F` | Filter open / show all |
+| `q` | Quit |
+
+## Data
+
+Todos are stored locally at `~/.devtodo/devtodo.db` (SQLite).

devtodo-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devtodo"
+version = "0.1.0"
+description = "A developer-focused CLI todo tool"
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "MIT" }
+authors = [{ name = "jakok" }]
+keywords = ["todo", "cli", "developer", "terminal", "productivity"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Environment :: Console",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13",
+    "sqlmodel>=0.0.19",
+    "textual>=0.80",
+    "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/jakok/devtodo"
+Repository = "https://github.com/jakok/devtodo"
+
+[project.scripts]
+devtodo = "devtodo.main:app"
+dt = "devtodo.main:app"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

devtodo-0.1.0/setup.cfg

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

devtodo-0.1.0/src/devtodo/__init__.py

@@ -0,0 +1,3 @@
+"""devtodo – a developer-focused CLI todo tool."""
+
+__version__ = "0.1.0"

devtodo-0.1.0/src/devtodo/commands/add.py

@@ -0,0 +1,44 @@
+from typing import Optional
+import typer
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import success, error, print_todo
+from devtodo.utils.dates import parse_date
+
+app = typer.Typer(help="Add a new todo.")
+
+
+@app.callback(invoke_without_command=True)
+def add(
+    title: str = typer.Argument(..., help="Title of the todo"),
+    description: Optional[str] = typer.Option(None, "--desc", "-d", help="Optional description"),
+    priority: str = typer.Option("medium", "--priority", "-p", help="Priority: low, medium, high"),
+    project: Optional[str] = typer.Option(None, "--project", "-P", help="Project name"),
+    tags: Optional[str] = typer.Option(None, "--tags", "-t", help="Comma-separated tags"),
+    due: Optional[str] = typer.Option(None, "--due", help="Due date (YYYY-MM-DD)"),
+) -> None:
+    if priority not in ("low", "medium", "high"):
+        error(f"Invalid priority '{priority}'. Use: low, medium, high")
+        raise typer.Exit(1)
+
+    due_date = None
+    if due:
+        try:
+            due_date = parse_date(due)
+        except ValueError as e:
+            error(str(e))
+            raise typer.Exit(1)
+
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todo = service.add(
+            title=title,
+            description=description,
+            priority=priority,
+            project=project,
+            tags=tags,
+            due_date=due_date,
+        )
+    success(f"Added todo [bold]#{todo.id}[/bold]: {todo.title}")
+    print_todo(todo)

devtodo-0.1.0/src/devtodo/commands/done.py

@@ -0,0 +1,22 @@
+import typer
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import success, error
+
+app = typer.Typer(help="Mark a todo as done.")
+
+
+@app.callback(invoke_without_command=True)
+def done(
+    todo_id: int = typer.Argument(..., help="ID of the todo to mark as done"),
+) -> None:
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todo = service.mark_done(todo_id)
+
+    if todo:
+        success(f"Todo [bold]#{todo.id}[/bold] marked as done: {todo.title}")
+    else:
+        error(f"Todo #{todo_id} not found.")
+        raise typer.Exit(1)

devtodo-0.1.0/src/devtodo/commands/edit.py

@@ -0,0 +1,56 @@
+from typing import Optional
+import typer
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import success, error, print_todo
+from devtodo.utils.dates import parse_date
+
+app = typer.Typer(help="Edit a todo.")
+
+
+@app.callback(invoke_without_command=True)
+def edit(
+    todo_id: int = typer.Argument(..., help="ID of the todo to edit"),
+    title: Optional[str] = typer.Option(None, "--title", help="New title"),
+    description: Optional[str] = typer.Option(None, "--desc", "-d", help="New description"),
+    status: Optional[str] = typer.Option(None, "--status", "-s", help="New status: open, done, in_progress"),
+    priority: Optional[str] = typer.Option(None, "--priority", "-p", help="New priority: low, medium, high"),
+    project: Optional[str] = typer.Option(None, "--project", "-P", help="New project"),
+    tags: Optional[str] = typer.Option(None, "--tags", "-t", help="New tags (comma-separated)"),
+    due: Optional[str] = typer.Option(None, "--due", help="New due date (YYYY-MM-DD)"),
+) -> None:
+    if priority and priority not in ("low", "medium", "high"):
+        error(f"Invalid priority '{priority}'. Use: low, medium, high")
+        raise typer.Exit(1)
+    if status and status not in ("open", "done", "in_progress"):
+        error(f"Invalid status '{status}'. Use: open, done, in_progress")
+        raise typer.Exit(1)
+
+    due_date = None
+    if due:
+        try:
+            due_date = parse_date(due)
+        except ValueError as e:
+            error(str(e))
+            raise typer.Exit(1)
+
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todo = service.edit(
+            todo_id=todo_id,
+            title=title,
+            description=description,
+            status=status,
+            priority=priority,
+            project=project,
+            tags=tags,
+            due_date=due_date,
+        )
+
+    if todo:
+        success(f"Todo [bold]#{todo.id}[/bold] updated.")
+        print_todo(todo)
+    else:
+        error(f"Todo #{todo_id} not found.")
+        raise typer.Exit(1)

devtodo-0.1.0/src/devtodo/commands/github_cmd.py

@@ -0,0 +1,120 @@
+"""devtodo github – GitHub Issue integration commands."""
+
+from typing import Optional
+import typer
+from rich.console import Console
+
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import success, error, print_todos
+
+app = typer.Typer(help="GitHub Issue integration.")
+console = Console()
+
+
+def _require_repo(repo: Optional[str]) -> str:
+    if not repo:
+        error("Provide --repo owner/reponame  e.g. --repo torvalds/linux")
+        raise typer.Exit(1)
+    if "/" not in repo:
+        error("--repo must be in format  owner/reponame")
+        raise typer.Exit(1)
+    return repo
+
+
+@app.command("sync")
+def sync(
+    repo: Optional[str] = typer.Option(None, "--repo", "-r", help="GitHub repo (owner/name)"),
+    state: str = typer.Option("open", "--state", "-s", help="Issue state: open / closed / all"),
+    limit: int = typer.Option(50, "--limit", "-n", help="Max issues to fetch"),
+) -> None:
+    """Import GitHub Issues as todos."""
+    from devtodo.github_client import fetch_issues
+    repo = _require_repo(repo)
+
+    console.print(f"[dim]Fetching {state} issues from [bold]{repo}[/bold]...[/dim]")
+    try:
+        issues = fetch_issues(repo, state=state, limit=limit)
+    except Exception as e:
+        error(f"GitHub API error: {e}")
+        raise typer.Exit(1)
+
+    if not issues:
+        console.print("[dim]No issues found.[/dim]")
+        return
+
+    engine = init_db()
+    added = 0
+    skipped = 0
+    with get_session(engine) as session:
+        service = TodoService(session)
+        existing_urls = {t.github_url for t in service.list_todos() if t.github_url}
+
+        for issue in issues:
+            url = issue["html_url"]
+            if url in existing_urls:
+                skipped += 1
+                continue
+            service.add(
+                title=issue["title"],
+                description=issue.get("body") or None,
+                github_url=url,
+                github_issue_number=issue["number"],
+            )
+            added += 1
+
+    success(f"Imported {added} issue(s) from [bold]{repo}[/bold]  ({skipped} already existed).")
+
+
+@app.command("push")
+def push(
+    todo_id: int = typer.Argument(..., help="Todo ID to push as GitHub Issue"),
+    repo: Optional[str] = typer.Option(None, "--repo", "-r", help="GitHub repo (owner/name)"),
+) -> None:
+    """Push a todo as a new GitHub Issue."""
+    from devtodo.github_client import create_issue
+    repo = _require_repo(repo)
+
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todo = service.get(todo_id)
+        if not todo:
+            error(f"Todo #{todo_id} not found.")
+            raise typer.Exit(1)
+
+        if todo.github_url:
+            error(f"Todo #{todo_id} is already linked to: {todo.github_url}")
+            raise typer.Exit(1)
+
+        console.print(f"[dim]Creating issue in [bold]{repo}[/bold]...[/dim]")
+        try:
+            issue = create_issue(repo, title=todo.title, body=todo.description)
+        except Exception as e:
+            error(f"GitHub API error: {e}")
+            raise typer.Exit(1)
+
+        service.edit(
+            todo_id=todo_id,
+            github_url=issue["html_url"],
+            github_issue_number=issue["number"],
+        )
+
+    success(f"Issue created: [link={issue['html_url']}]{issue['html_url']}[/link]")
+
+
+@app.command("list")
+def list_linked() -> None:
+    """List todos that are linked to GitHub Issues."""
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todos = [t for t in service.list_todos() if t.github_url]
+
+    if not todos:
+        console.print("[dim]No todos linked to GitHub Issues.[/dim]")
+        return
+
+    print_todos(todos)
+    for t in todos:
+        console.print(f"  #{t.id} → [dim]{t.github_url}[/dim]")

devtodo-0.1.0/src/devtodo/commands/list.py

@@ -0,0 +1,21 @@
+from typing import Optional
+import typer
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import print_todos
+
+app = typer.Typer(help="List todos.")
+
+
+@app.callback(invoke_without_command=True)
+def list_todos(
+    status: Optional[str] = typer.Option(None, "--status", "-s", help="Filter by status (open, done, in_progress)"),
+    project: Optional[str] = typer.Option(None, "--project", "-P", help="Filter by project"),
+    priority: Optional[str] = typer.Option(None, "--priority", "-p", help="Filter by priority"),
+    tag: Optional[str] = typer.Option(None, "--tag", "-t", help="Filter by tag"),
+) -> None:
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todos = service.list_todos(status=status, project=project, priority=priority, tag=tag)
+    print_todos(todos)

devtodo-0.1.0/src/devtodo/commands/remove.py

@@ -0,0 +1,27 @@
+import typer
+from devtodo.db import init_db, get_session
+from devtodo.services.todo_service import TodoService
+from devtodo.utils.output import success, error
+
+app = typer.Typer(help="Remove a todo.")
+
+
+@app.callback(invoke_without_command=True)
+def remove(
+    todo_id: int = typer.Argument(..., help="ID of the todo to remove"),
+    force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation"),
+) -> None:
+    engine = init_db()
+    with get_session(engine) as session:
+        service = TodoService(session)
+        todo = service.get(todo_id)
+        if not todo:
+            error(f"Todo #{todo_id} not found.")
+            raise typer.Exit(1)
+
+        if not force:
+            typer.confirm(f"Remove todo #{todo_id}: '{todo.title}'?", abort=True)
+
+        service.remove(todo_id)
+
+    success(f"Todo #{todo_id} removed.")

devtodo-0.1.0/src/devtodo/db.py

@@ -0,0 +1,39 @@
+from pathlib import Path
+from sqlmodel import SQLModel, create_engine, Session
+
+DB_PATH = Path.home() / ".devtodo" / "devtodo.db"
+
+
+def get_engine():
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+    return create_engine(f"sqlite:///{DB_PATH}", connect_args={"check_same_thread": False})
+
+
+def init_db(engine=None):
+    from devtodo.models import Todo  # noqa: F401 – registers the table
+    if engine is None:
+        engine = get_engine()
+    SQLModel.metadata.create_all(engine)
+    _migrate(engine)
+    return engine
+
+
+def _migrate(engine) -> None:
+    """Add new columns to existing databases without Alembic."""
+    new_columns = [
+        ("github_url", "TEXT"),
+        ("github_issue_number", "INTEGER"),
+    ]
+    with engine.connect() as conn:
+        for col, col_type in new_columns:
+            try:
+                conn.exec_driver_sql(f"ALTER TABLE todo ADD COLUMN {col} {col_type}")
+                conn.commit()
+            except Exception:
+                pass  # column already exists
+
+
+def get_session(engine=None):
+    if engine is None:
+        engine = get_engine()
+    return Session(engine)

devtodo-0.1.0/src/devtodo/github_client.py

@@ -0,0 +1,50 @@
+"""GitHub API client for devtodo."""
+
+import os
+from typing import Optional
+import httpx
+
+GITHUB_API = "https://api.github.com"
+
+
+def _get_token() -> Optional[str]:
+    return os.environ.get("GITHUB_TOKEN")
+
+
+def _headers() -> dict:
+    token = _get_token()
+    headers = {"Accept": "application/vnd.github+json", "X-GitHub-Api-Version": "2022-11-28"}
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+    return headers
+
+
+def fetch_issues(repo: str, state: str = "open", limit: int = 50) -> list[dict]:
+    """Fetch issues from a GitHub repo. repo = 'owner/name'"""
+    url = f"{GITHUB_API}/repos/{repo}/issues"
+    params = {"state": state, "per_page": min(limit, 100), "page": 1}
+    resp = httpx.get(url, headers=_headers(), params=params, timeout=10)
+    resp.raise_for_status()
+    # filter out pull requests (GitHub returns PRs as issues too)
+    return [i for i in resp.json() if "pull_request" not in i]
+
+
+def create_issue(repo: str, title: str, body: Optional[str] = None, labels: list[str] | None = None) -> dict:
+    """Create a GitHub issue. Returns the created issue dict."""
+    url = f"{GITHUB_API}/repos/{repo}/issues"
+    payload: dict = {"title": title}
+    if body:
+        payload["body"] = body
+    if labels:
+        payload["labels"] = labels
+    resp = httpx.post(url, headers=_headers(), json=payload, timeout=10)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def close_issue(repo: str, issue_number: int) -> dict:
+    """Close a GitHub issue."""
+    url = f"{GITHUB_API}/repos/{repo}/issues/{issue_number}"
+    resp = httpx.patch(url, headers=_headers(), json={"state": "closed"}, timeout=10)
+    resp.raise_for_status()
+    return resp.json()