doingapp 0.4.0__tar.gz → 0.5.1__tar.gz

{doingapp-0.4.0 → doingapp-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.4.0
+Version: 0.5.1
 Summary: A fast CLI task tracker — track what you're doing from the terminal.
 Author-email: Parker Grimes <parker@altellus.com>
 License-Expression: MIT
@@ -62,27 +62,55 @@ doing                # See what's on your plate
 doing done 1         # Mark task #1 as done
 ```
 
+Or authenticate with an API key (get one from the web UI at Settings → API Keys):
+
+```bash
+doing apikey --key doing_xxxxx
+```
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
 | `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing get <id>` | Get a single task by ID |
 | `doing done <id>` | Mark a task as done |
 | `doing pause <id>` | Pause a task |
 | `doing resume <id>` | Resume a paused task |
 | `doing reopen <id>` | Reopen a completed task |
 | `doing edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`) |
 | `doing rm <id>` | Delete a task |
-| `doing ls` | List active tasks |
-| `doing log` | Show tasks done today (`-d YYYY-MM-DD` for other dates) |
-| `doing today` | Show all tasks grouped by status |
+| `doing ls` | List active tasks (`-c` context ID) |
+| `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
+| `doing today` | Show all tasks grouped by status (`-c` context ID) |
 | `doing clear` | Mark all active tasks as done |
 | `doing contexts` | List contexts |
 | `doing context add <name>` | Create a context |
 | `doing context rm <id>` | Delete a context |
+| `doing me` | Show current user info |
 | `doing login` | Log in |
 | `doing logout` | Log out |
+| `doing apikey` | Save an API key (`-k` key) |
+
+## JSON output
+
+Every command supports `--json` (or `-j`) for machine-readable output. This is useful for scripting and AI coding agents like Claude Code or Codex CLI.
+
+```bash
+doing --json ls                  # [{"id": 1, "title": "...", ...}]
+doing --json add "New task"      # {"id": 2, "title": "New task", ...}
+doing --json done 2              # {"id": 2, "status": "done", ...}
+doing --json contexts            # [{"id": 1, "name": "Work", ...}]
+doing --json get 2               # {"id": 2, "title": "...", ...}
+doing --json me                  # {"id": 1, "email": "...", ...}
+```
+
+Errors also return structured JSON with a non-zero exit code:
+
+```bash
+doing --json done 99999          # {"error": true, "status": 404, "detail": "Task not found"}
+```
 
 ## Configuration
 

{doingapp-0.4.0 → doingapp-0.5.1}/README.md

@@ -37,27 +37,55 @@ doing                # See what's on your plate
 doing done 1         # Mark task #1 as done
 ```
 
+Or authenticate with an API key (get one from the web UI at Settings → API Keys):
+
+```bash
+doing apikey --key doing_xxxxx
+```
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
 | `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing get <id>` | Get a single task by ID |
 | `doing done <id>` | Mark a task as done |
 | `doing pause <id>` | Pause a task |
 | `doing resume <id>` | Resume a paused task |
 | `doing reopen <id>` | Reopen a completed task |
 | `doing edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`) |
 | `doing rm <id>` | Delete a task |
-| `doing ls` | List active tasks |
-| `doing log` | Show tasks done today (`-d YYYY-MM-DD` for other dates) |
-| `doing today` | Show all tasks grouped by status |
+| `doing ls` | List active tasks (`-c` context ID) |
+| `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
+| `doing today` | Show all tasks grouped by status (`-c` context ID) |
 | `doing clear` | Mark all active tasks as done |
 | `doing contexts` | List contexts |
 | `doing context add <name>` | Create a context |
 | `doing context rm <id>` | Delete a context |
+| `doing me` | Show current user info |
 | `doing login` | Log in |
 | `doing logout` | Log out |
+| `doing apikey` | Save an API key (`-k` key) |
+
+## JSON output
+
+Every command supports `--json` (or `-j`) for machine-readable output. This is useful for scripting and AI coding agents like Claude Code or Codex CLI.
+
+```bash
+doing --json ls                  # [{"id": 1, "title": "...", ...}]
+doing --json add "New task"      # {"id": 2, "title": "New task", ...}
+doing --json done 2              # {"id": 2, "status": "done", ...}
+doing --json contexts            # [{"id": 1, "name": "Work", ...}]
+doing --json get 2               # {"id": 2, "title": "...", ...}
+doing --json me                  # {"id": 1, "email": "...", ...}
+```
+
+Errors also return structured JSON with a non-zero exit code:
+
+```bash
+doing --json done 99999          # {"error": true, "status": 404, "detail": "Task not found"}
+```
 
 ## Configuration
 

{doingapp-0.4.0 → doingapp-0.5.1}/doing_cli/api.py

@@ -42,6 +42,13 @@ def login(email: str, password: str) -> dict:
         return r.json()
 
 
+def get_me() -> dict:
+    with _client() as c:
+        r = c.get("/auth/me")
+        r.raise_for_status()
+        return r.json()
+
+
 def create_task(title: str, notes: str | None = None, context_id: int | None = None) -> dict:
     payload: dict = {"title": title}
     if notes is not None:
@@ -54,6 +61,13 @@ def create_task(title: str, notes: str | None = None, context_id: int | None = N
         return r.json()
 
 
+def get_task(task_id: int) -> dict:
+    with _client() as c:
+        r = c.get(f"/tasks/{task_id}")
+        r.raise_for_status()
+        return r.json()
+
+
 def list_tasks(status: str | None = None, date: str | None = None,
                context_id: int | None = None) -> list[dict]:
     params: dict = {"tz": _local_tz()}

{doingapp-0.4.0 → doingapp-0.5.1}/doing_cli/main.py

@@ -1,4 +1,5 @@
 import json
+import sys
 
 import httpx
 import typer
@@ -19,15 +20,41 @@ console = Console()
 # Commands that don't require authentication
 AUTH_COMMANDS = {"login", "register", "logout", "apikey"}
 
+# Global JSON mode flag, set by --json on any command
+_json_mode = False
+
+
+def _output_json(data) -> None:
+    """Write raw JSON to stdout (no Rich formatting) and exit."""
+    sys.stdout.write(json.dumps(data) + "\n")
+    raise typer.Exit()
+
 
 def _require_auth():
     """Exit with a message if the user is not logged in."""
     if load_token() is None:
+        if _json_mode:
+            _output_json({"error": True, "detail": "Not logged in"})
         console.print("[bold red]Not logged in.[/bold red] Run: [bold]doing login[/bold]")
         raise typer.Exit(code=1)
 
 
 def _handle_api_error(exc: Exception):
+    if _json_mode:
+        error: dict = {"error": True}
+        if isinstance(exc, httpx.HTTPStatusError):
+            error["status"] = exc.response.status_code
+            try:
+                error["detail"] = exc.response.json().get("detail", exc.response.text)
+            except Exception:
+                error["detail"] = exc.response.text
+        elif isinstance(exc, (httpx.ConnectError, httpx.TimeoutException)):
+            error["detail"] = f"Could not connect to {api.BASE_URL}"
+        else:
+            error["detail"] = str(exc)
+        sys.stdout.write(json.dumps(error) + "\n")
+        raise typer.Exit(code=1)
+
     if isinstance(exc, httpx.HTTPStatusError):
         status = exc.response.status_code
         if status == 401:
@@ -48,6 +75,30 @@ def _handle_api_error(exc: Exception):
     raise typer.Exit(code=1)
 
 
+def _validation_error(detail: str):
+    """Print a validation error (JSON or Rich) and exit with code 1."""
+    if _json_mode:
+        _output_json({"error": True, "detail": detail})
+    console.print(f"[bold red]{detail}[/bold red]")
+    raise typer.Exit(code=1)
+
+
+def _validate_title(title: str) -> str:
+    """Strip whitespace and newlines from title, validate non-empty."""
+    cleaned = title.replace("\n", " ").replace("\r", " ").strip()
+    if not cleaned:
+        _validation_error("Title cannot be empty")
+    return cleaned
+
+
+def _validate_name(name: str) -> str:
+    """Strip and validate non-empty name for contexts."""
+    cleaned = name.strip()
+    if not cleaned:
+        _validation_error("Name cannot be empty")
+    return cleaned
+
+
 def _print_notes(task: dict) -> None:
     if task.get("notes"):
         console.print(f"       [dim]{task['notes']}[/dim]")
@@ -72,11 +123,16 @@ def _print_done_task(task: dict) -> None:
 
 
 @app.callback()
-def main(ctx: typer.Context):
+def main(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON (for scripting and AI agents)"),
+):
     """Doing - track what you're working on."""
+    global _json_mode
+    _json_mode = json_output
     if ctx.invoked_subcommand is None:
         _require_auth()
-        ls(context=None, json_output=False)
+        ls()
     elif ctx.invoked_subcommand not in AUTH_COMMANDS:
         _require_auth()
 
@@ -91,6 +147,8 @@ def login():
     except Exception as exc:
         _handle_api_error(exc)
     save_token(data["access_token"])
+    if _json_mode:
+        _output_json({"ok": True, "email": email})
     console.print(f"[bold green]Logged in[/bold green] as [bold]{email}[/bold]")
 
 
@@ -101,6 +159,8 @@ def register():
     password = typer.prompt("Password", hide_input=True)
     password_confirm = typer.prompt("Confirm password", hide_input=True)
     if password != password_confirm:
+        if _json_mode:
+            _output_json({"error": True, "detail": "Passwords do not match"})
         console.print("[bold red]Passwords do not match.[/bold red]")
         raise typer.Exit(code=1)
     try:
@@ -108,6 +168,8 @@ def register():
     except Exception as exc:
         _handle_api_error(exc)
     save_token(data["access_token"])
+    if _json_mode:
+        _output_json({"ok": True, "email": email})
     console.print(f"[bold green]Account created![/bold green] Logged in as [bold]{email}[/bold]")
 
 
@@ -115,6 +177,8 @@ def register():
 def logout():
     """Log out and clear stored credentials."""
     clear_token()
+    if _json_mode:
+        _output_json({"ok": True})
     console.print("[dim]Logged out.[/dim]")
 
 
@@ -126,12 +190,30 @@ def apikey(
     if key is None:
         key = typer.prompt("API key", hide_input=True)
     if not key.startswith("doing_"):
+        if _json_mode:
+            _output_json({"error": True, "detail": "Invalid API key. Keys start with doing_"})
         console.print("[bold red]Invalid API key.[/bold red] Keys start with [bold]doing_[/bold]")
         raise typer.Exit(code=1)
     save_token(key)
+    if _json_mode:
+        _output_json({"ok": True})
     console.print("[bold green]API key saved.[/bold green] You're all set.")
 
 
+@app.command()
+def me():
+    """Show current user info (useful for verifying auth)."""
+    try:
+        user = api.get_me()
+    except Exception as exc:
+        _handle_api_error(exc)
+    if _json_mode:
+        _output_json(user)
+    console.print(f"  [bold]{user['email']}[/bold]  [dim](#{user['id']})[/dim]")
+    if user.get("is_admin"):
+        console.print("  [yellow]Admin[/yellow]")
+
+
 @app.command()
 def add(
     title: str = typer.Argument(..., help="What are you working on?"),
@@ -139,26 +221,47 @@ def add(
     context: int = typer.Option(None, "--context", "-c", help="Context ID"),
 ):
     """Add something to your plate."""
+    title = _validate_title(title)
     try:
         task = api.create_task(title, notes, context)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[green bold]●[/green bold] Added: [bold]{task['title']}[/bold]  [dim](#{task['id']})[/dim]")
 
 
+@app.command()
+def get(
+    task_id: int = typer.Argument(..., help="ID of the task to fetch"),
+):
+    """Get a single task by ID."""
+    try:
+        task = api.get_task(task_id)
+    except Exception as exc:
+        _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
+    status_icon = {"active": "[green bold]●[/green bold]", "paused": "[yellow]⏸[/yellow]", "done": "[green]✓[/green]"}
+    icon = status_icon.get(task["status"], "?")
+    ctx = f"  [dim][{task['context_name']}][/dim]" if task.get("context_name") else ""
+    console.print(f"  {icon} [dim]#{task['id']}[/dim]  {task['title']}{ctx}")
+    if task.get("notes"):
+        console.print(f"       [dim]{task['notes']}[/dim]")
+    console.print(f"       [dim]Status: {task['status']}  Created: {task['created_at']}[/dim]")
+
+
 @app.command()
 def ls(
     context: int = typer.Option(None, "--context", "-c", help="Filter by context ID"),
-    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ):
     """Show what's on your plate right now."""
     try:
         tasks = api.list_tasks(status="active", context_id=context)
     except Exception as exc:
         _handle_api_error(exc)
-    if json_output:
-        console.print_json(json.dumps(tasks))
-        raise typer.Exit()
+    if _json_mode:
+        _output_json(tasks)
     if not tasks:
         console.print("Nothing on your plate. Add something: [bold]doing add 'task name'[/bold]")
         raise typer.Exit()
@@ -170,7 +273,6 @@ def ls(
 def log(
     date: str = typer.Option(None, "--date", "-d", help="Date (YYYY-MM-DD), defaults to today"),
     context: int = typer.Option(None, "--context", "-c", help="Filter by context ID"),
-    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ):
     """List tasks marked done today (or on a given date)."""
     from datetime import date as date_cls
@@ -179,9 +281,8 @@ def log(
         tasks = api.list_tasks(status="done", date=query_date, context_id=context)
     except Exception as exc:
         _handle_api_error(exc)
-    if json_output:
-        console.print_json(json.dumps(tasks))
-        raise typer.Exit()
+    if _json_mode:
+        _output_json(tasks)
     if not tasks:
         label = query_date if date else "today"
         console.print(f"Nothing marked done {label}.")
@@ -199,6 +300,8 @@ def done(
         task = api.mark_done(task_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[green]✓[/green] Done: [bold]{task['title']}[/bold]")
 
 
@@ -211,6 +314,8 @@ def reopen(
         task = api.reopen_task(task_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[green bold]●[/green bold] Reopened: [bold]{task['title']}[/bold]")
 
 
@@ -223,6 +328,8 @@ def pause(
         task = api.pause_task(task_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[yellow]⏸[/yellow] Paused: [bold]{task['title']}[/bold]")
 
 
@@ -235,6 +342,8 @@ def resume(
         task = api.resume_task(task_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[green bold]●[/green bold] Resumed: [bold]{task['title']}[/bold]")
 
 
@@ -247,18 +356,29 @@ def edit(
     no_context: bool = typer.Option(False, "--no-context", help="Remove context"),
 ):
     """Edit a task's title, notes, or context."""
+    if no_context and context is not None:
+        _validation_error("--no-context and --context cannot be used together")
+
+    if title is None and notes is None and context is None and not no_context:
+        _validation_error("No changes specified. Use --title, --notes, --context, or --no-context.")
+
+    # BUG-8: Validate title if provided
+    if title is not None:
+        title = _validate_title(title)
+
     try:
         task = api.update_task(task_id, title=title, notes=notes,
                                context_id=context, clear_context=no_context)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(task)
     console.print(f"[green bold]Updated:[/green bold] {task['title']}  [dim](#{task['id']})[/dim]")
 
 
 @app.command()
 def today(
     context: int = typer.Option(None, "--context", "-c", help="Filter by context ID"),
-    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
 ):
     """Show everything from today, grouped by status."""
     try:
@@ -266,9 +386,8 @@ def today(
     except Exception as exc:
         _handle_api_error(exc)
 
-    if json_output:
-        console.print_json(json.dumps(data))
-        raise typer.Exit()
+    if _json_mode:
+        _output_json(data)
 
     active = data.get("active", [])
     paused = data.get("paused", [])
@@ -305,6 +424,8 @@ def rm(
         api.delete_task(task_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json({"deleted": True, "id": task_id})
     console.print(f"[dim]Deleted task #{task_id}.[/dim]")
 
 
@@ -317,16 +438,25 @@ def clear():
         _handle_api_error(exc)
 
     if not tasks:
+        if _json_mode:
+            _output_json([])
         console.print("Nothing to clear.")
         raise typer.Exit()
 
+    results = []
     for t in tasks:
         try:
-            api.mark_done(t["id"])
+            result = api.mark_done(t["id"])
+            results.append(result)
         except Exception:
-            console.print(f"[red]Failed to complete task #{t['id']}[/red]")
+            if not _json_mode:
+                console.print(f"[red]Failed to complete task #{t['id']}[/red]")
             continue
-        console.print(f"[green]✓[/green] Done: [bold]{t['title']}[/bold]")
+        if not _json_mode:
+            console.print(f"[green]✓[/green] Done: [bold]{t['title']}[/bold]")
+
+    if _json_mode:
+        _output_json(results)
 
     console.print(f"\n[dim]Cleared {len(tasks)} task(s).[/dim]")
 
@@ -338,6 +468,8 @@ def contexts():
         ctx_list = api.list_contexts()
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(ctx_list)
     if not ctx_list:
         console.print("No contexts. Create one: [bold]doing context add 'name'[/bold]")
         raise typer.Exit()
@@ -350,11 +482,13 @@ def context_add(
     name: str = typer.Argument(..., help="Context name"),
 ):
     """Create a new context."""
-    _require_auth()
+    name = _validate_name(name)
     try:
         ctx = api.create_context(name)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json(ctx)
     console.print(f"[green bold]Created context:[/green bold] {ctx['name']}  [dim](#{ctx['id']})[/dim]")
 
 
@@ -363,11 +497,12 @@ def context_rm(
     context_id: int = typer.Argument(..., help="Context ID to delete"),
 ):
     """Delete a context (tasks keep their data, just lose the context)."""
-    _require_auth()
     try:
         api.delete_context(context_id)
     except Exception as exc:
         _handle_api_error(exc)
+    if _json_mode:
+        _output_json({"deleted": True, "id": context_id})
     console.print(f"[dim]Deleted context #{context_id}.[/dim]")
 
 

{doingapp-0.4.0 → doingapp-0.5.1}/doingapp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.4.0
+Version: 0.5.1
 Summary: A fast CLI task tracker — track what you're doing from the terminal.
 Author-email: Parker Grimes <parker@altellus.com>
 License-Expression: MIT
@@ -62,27 +62,55 @@ doing                # See what's on your plate
 doing done 1         # Mark task #1 as done
 ```
 
+Or authenticate with an API key (get one from the web UI at Settings → API Keys):
+
+```bash
+doing apikey --key doing_xxxxx
+```
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
 | `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing get <id>` | Get a single task by ID |
 | `doing done <id>` | Mark a task as done |
 | `doing pause <id>` | Pause a task |
 | `doing resume <id>` | Resume a paused task |
 | `doing reopen <id>` | Reopen a completed task |
 | `doing edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`) |
 | `doing rm <id>` | Delete a task |
-| `doing ls` | List active tasks |
-| `doing log` | Show tasks done today (`-d YYYY-MM-DD` for other dates) |
-| `doing today` | Show all tasks grouped by status |
+| `doing ls` | List active tasks (`-c` context ID) |
+| `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
+| `doing today` | Show all tasks grouped by status (`-c` context ID) |
 | `doing clear` | Mark all active tasks as done |
 | `doing contexts` | List contexts |
 | `doing context add <name>` | Create a context |
 | `doing context rm <id>` | Delete a context |
+| `doing me` | Show current user info |
 | `doing login` | Log in |
 | `doing logout` | Log out |
+| `doing apikey` | Save an API key (`-k` key) |
+
+## JSON output
+
+Every command supports `--json` (or `-j`) for machine-readable output. This is useful for scripting and AI coding agents like Claude Code or Codex CLI.
+
+```bash
+doing --json ls                  # [{"id": 1, "title": "...", ...}]
+doing --json add "New task"      # {"id": 2, "title": "New task", ...}
+doing --json done 2              # {"id": 2, "status": "done", ...}
+doing --json contexts            # [{"id": 1, "name": "Work", ...}]
+doing --json get 2               # {"id": 2, "title": "...", ...}
+doing --json me                  # {"id": 1, "email": "...", ...}
+```
+
+Errors also return structured JSON with a non-zero exit code:
+
+```bash
+doing --json done 99999          # {"error": true, "status": 404, "detail": "Task not found"}
+```
 
 ## Configuration
 

{doingapp-0.4.0 → doingapp-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "doingapp"
-version = "0.4.0"
+version = "0.5.1"
 description = "A fast CLI task tracker — track what you're doing from the terminal."
 readme = "README.md"
 license = "MIT"