doingapp 0.5.0__tar.gz → 0.6.0__tar.gz

{doingapp-0.5.0 → doingapp-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.5.0
+Version: 0.6.0
 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.5.0 → doingapp-0.6.0}/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.5.0 → doingapp-0.6.0}/doing_cli/api.py

@@ -28,9 +28,9 @@ def _client() -> httpx.Client:
     return httpx.Client(base_url=BASE_URL, timeout=10.0, headers=headers)
 
 
-def register(email: str, password: str) -> dict:
+def register(token: str, password: str) -> dict:
     with httpx.Client(base_url=BASE_URL, timeout=10.0) as c:
-        r = c.post("/auth/register", json={"email": email, "password": password})
+        r = c.post("/auth/register", json={"token": token, "password": password})
         r.raise_for_status()
         return r.json()
 
@@ -134,6 +134,29 @@ def delete_task(task_id: int) -> None:
         r.raise_for_status()
 
 
+def get_stats(context_id: int | None = None) -> dict:
+    params: dict = {"tz": _local_tz()}
+    if context_id is not None:
+        params["context_id"] = context_id
+    with _client() as c:
+        r = c.get("/stats", params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+def get_done_history(limit: int = 7, before: str | None = None,
+                     context_id: int | None = None) -> dict:
+    params: dict = {"tz": _local_tz(), "limit": limit}
+    if before is not None:
+        params["before"] = before
+    if context_id is not None:
+        params["context_id"] = context_id
+    with _client() as c:
+        r = c.get("/done", params=params)
+        r.raise_for_status()
+        return r.json()
+
+
 def get_today(context_id: int | None = None) -> dict:
     params: dict = {"tz": _local_tz()}
     if context_id is not None:
@@ -161,6 +184,38 @@ def create_context(name: str) -> dict:
         return r.json()
 
 
+def get_context(context_id: int) -> dict:
+    with _client() as c:
+        r = c.get(f"/contexts/{context_id}")
+        r.raise_for_status()
+        return r.json()
+
+
+def update_context(context_id: int, name: str, icon: str | None = None) -> dict:
+    payload: dict = {"name": name}
+    if icon is not None:
+        payload["icon"] = icon
+    with _client() as c:
+        r = c.put(f"/contexts/{context_id}", json=payload)
+        r.raise_for_status()
+        return r.json()
+
+
+def snooze_context(context_id: int) -> dict:
+    params: dict = {"tz": _local_tz()}
+    with _client() as c:
+        r = c.post(f"/contexts/{context_id}/snooze", params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+def unsnooze_context(context_id: int) -> dict:
+    with _client() as c:
+        r = c.post(f"/contexts/{context_id}/unsnooze")
+        r.raise_for_status()
+        return r.json()
+
+
 def delete_context(context_id: int) -> None:
     with _client() as c:
         r = c.delete(f"/contexts/{context_id}")

{doingapp-0.5.0 → doingapp-0.6.0}/doing_cli/main.py

@@ -75,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]")
@@ -129,9 +153,10 @@ def login():
 
 
 @app.command()
-def register():
-    """Create a new Doing account."""
-    email = typer.prompt("Email")
+def register(
+    token: str = typer.Argument(..., help="Invite token from your invitation link"),
+):
+    """Create a new Doing account using an invite token."""
     password = typer.prompt("Password", hide_input=True)
     password_confirm = typer.prompt("Confirm password", hide_input=True)
     if password != password_confirm:
@@ -140,13 +165,13 @@ def register():
         console.print("[bold red]Passwords do not match.[/bold red]")
         raise typer.Exit(code=1)
     try:
-        data = api.register(email, password)
+        data = api.register(token, password)
     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]")
+        _output_json({"ok": True})
+    console.print("[bold green]Account created![/bold green] You're now logged in.")
 
 
 @app.command()
@@ -197,6 +222,7 @@ 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:
@@ -268,16 +294,28 @@ def log(
 
 @app.command()
 def done(
-    task_id: int = typer.Argument(..., help="ID of the task to mark done"),
+    task_ids: list[int] = typer.Argument(..., help="ID(s) of the task(s) to mark done"),
 ):
-    """Mark a task as done."""
-    try:
-        task = api.mark_done(task_id)
-    except Exception as exc:
-        _handle_api_error(exc)
+    """Mark one or more tasks as done."""
+    results = []
+    errors = []
+    for task_id in task_ids:
+        try:
+            task = api.mark_done(task_id)
+        except Exception as exc:
+            if _json_mode and len(task_ids) == 1:
+                _handle_api_error(exc)
+            if not _json_mode:
+                console.print(f"[red]Failed to complete task #{task_id}[/red]")
+            errors.append(task_id)
+            continue
+        results.append(task)
+        if not _json_mode:
+            console.print(f"[green]✓[/green] Done: [bold]{task['title']}[/bold]")
     if _json_mode:
-        _output_json(task)
-    console.print(f"[green]✓[/green] Done: [bold]{task['title']}[/bold]")
+        _output_json(results[0] if len(task_ids) == 1 and results else results)
+    if errors:
+        raise typer.Exit(code=1)
 
 
 @app.command()
@@ -331,6 +369,15 @@ 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.")
+
+    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)
@@ -447,7 +494,7 @@ 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:
@@ -457,12 +504,69 @@ def context_add(
     console.print(f"[green bold]Created context:[/green bold] {ctx['name']}  [dim](#{ctx['id']})[/dim]")
 
 
+@context_app.command("edit")
+def context_edit(
+    context_id: int = typer.Argument(..., help="Context ID to edit"),
+    name: str = typer.Option(None, "--name", "-n", help="New name"),
+    icon: str = typer.Option(None, "--icon", "-i", help="New icon (emoji)"),
+):
+    """Rename a context or change its icon."""
+    if name is None and icon is None:
+        _validation_error("No changes specified. Use --name or --icon.")
+
+    if name is not None:
+        name = _validate_name(name)
+
+    # Need current name if only changing icon (API requires name)
+    if name is None:
+        try:
+            current = api.get_context(context_id)
+        except Exception as exc:
+            _handle_api_error(exc)
+        name = current["name"]
+
+    try:
+        ctx = api.update_context(context_id, name=name, icon=icon)
+    except Exception as exc:
+        _handle_api_error(exc)
+    if _json_mode:
+        _output_json(ctx)
+    console.print(f"[green bold]Updated context:[/green bold] {ctx['name']}  [dim](#{ctx['id']})[/dim]")
+
+
+@context_app.command("snooze")
+def context_snooze(
+    context_id: int = typer.Argument(..., help="Context ID to snooze"),
+):
+    """Snooze a context until end of day (hides its tasks)."""
+    try:
+        ctx = api.snooze_context(context_id)
+    except Exception as exc:
+        _handle_api_error(exc)
+    if _json_mode:
+        _output_json(ctx)
+    console.print(f"[yellow]😴 Snoozed:[/yellow] {ctx['name']} until end of day")
+
+
+@context_app.command("unsnooze")
+def context_unsnooze(
+    context_id: int = typer.Argument(..., help="Context ID to unsnooze"),
+):
+    """Unsnooze a context (show its tasks again)."""
+    try:
+        ctx = api.unsnooze_context(context_id)
+    except Exception as exc:
+        _handle_api_error(exc)
+    if _json_mode:
+        _output_json(ctx)
+    console.print(f"[green bold]Unsnoozed:[/green bold] {ctx['name']}")
+
+
 @context_app.command("rm")
 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:
@@ -472,5 +576,30 @@ def context_rm(
     console.print(f"[dim]Deleted context #{context_id}.[/dim]")
 
 
+@app.command()
+def stats(
+    context: int = typer.Option(None, "--context", "-c", help="Filter by context ID"),
+):
+    """Show how many tasks you've completed today and this week."""
+    try:
+        data = api.get_stats(context_id=context)
+    except Exception as exc:
+        _handle_api_error(exc)
+
+    if _json_mode:
+        _output_json(data)
+
+    today_count = data["today"]
+    week_count = data["this_week"]
+    total_count = data["total"]
+
+    console.print(f"\n  [bold]Today:[/bold]     {today_count} task{'s' if today_count != 1 else ''} done")
+    console.print(f"  [bold]This week:[/bold] {week_count} task{'s' if week_count != 1 else ''} done")
+
+    if total_count > week_count:
+        console.print(f"  [dim]All time: {total_count} total[/dim]")
+    console.print()
+
+
 if __name__ == "__main__":
     app()

{doingapp-0.5.0 → doingapp-0.6.0}/doingapp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.5.0
+Version: 0.6.0
 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.5.0 → doingapp-0.6.0}/pyproject.toml

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