doingapp 0.6.0__tar.gz → 0.7.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.6.0
+Version: 0.7.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
@@ -73,13 +73,14 @@ doing apikey --key doing_xxxxx
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
-| `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing add <title>` | Add a task (`-n` notes, `-c` context ID, `-d "tomorrow 3pm"` due, `-r daily` repeat) |
 | `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 edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`, `-d` due, `--no-due`, `-r` repeat, `--no-repeat`) |
+| `doing snooze <id> [10m\|1h\|3h\|1d\|morning]` | Push a due task back (default 10m) |
 | `doing rm <id>` | Delete a task |
 | `doing ls` | List active tasks (`-c` context ID) |
 | `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
@@ -93,6 +94,19 @@ doing apikey --key doing_xxxxx
 | `doing logout` | Log out |
 | `doing apikey` | Save an API key (`-k` key) |
 
+## Due dates and reminders
+
+Give a task a due date and the Doing iOS app nags you every few minutes once it's overdue, until you mark it done or snooze it.
+
+```bash
+doing add "Call mom" -d "tomorrow 3pm"
+doing add "Water plants" -d friday -r 3d      # repeats 3 days after each completion
+doing add "Standup notes" -d "9am" -r weekdays
+doing snooze 12 1h
+```
+
+`-d` accepts natural language: `in 20m`, `tonight`, `fri 9am`, `oct 30`. Dates without a time use your morning time (9:00 by default). `-r` accepts `daily`, `weekdays`, days like `mon,thu`, or `Nd` (N days after done).
+
 ## 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.

{doingapp-0.6.0 → doingapp-0.7.1}/README.md

@@ -48,13 +48,14 @@ doing apikey --key doing_xxxxx
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
-| `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing add <title>` | Add a task (`-n` notes, `-c` context ID, `-d "tomorrow 3pm"` due, `-r daily` repeat) |
 | `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 edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`, `-d` due, `--no-due`, `-r` repeat, `--no-repeat`) |
+| `doing snooze <id> [10m\|1h\|3h\|1d\|morning]` | Push a due task back (default 10m) |
 | `doing rm <id>` | Delete a task |
 | `doing ls` | List active tasks (`-c` context ID) |
 | `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
@@ -68,6 +69,19 @@ doing apikey --key doing_xxxxx
 | `doing logout` | Log out |
 | `doing apikey` | Save an API key (`-k` key) |
 
+## Due dates and reminders
+
+Give a task a due date and the Doing iOS app nags you every few minutes once it's overdue, until you mark it done or snooze it.
+
+```bash
+doing add "Call mom" -d "tomorrow 3pm"
+doing add "Water plants" -d friday -r 3d      # repeats 3 days after each completion
+doing add "Standup notes" -d "9am" -r weekdays
+doing snooze 12 1h
+```
+
+`-d` accepts natural language: `in 20m`, `tonight`, `fri 9am`, `oct 30`. Dates without a time use your morning time (9:00 by default). `-r` accepts `daily`, `weekdays`, days like `mon,thu`, or `Nd` (N days after done).
+
 ## 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.

{doingapp-0.6.0 → doingapp-0.7.1}/doing_cli/api.py

@@ -1,5 +1,5 @@
 import os
-import time as _time
+from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
 
 import httpx
 
@@ -8,16 +8,35 @@ from doing_cli.auth import load_token
 BASE_URL = os.environ.get("DOING_API_URL", "https://doingapp.co")
 
 
-def _local_tz() -> str:
+def _is_iana_tz(name: str) -> bool:
     try:
-        # Works on most Unix systems
-        return os.path.realpath("/etc/localtime").split("zoneinfo/")[1]
+        ZoneInfo(name)
+    except (ZoneInfoNotFoundError, ValueError):
+        return False
+    return True
+
+
+def _local_tz() -> str | None:
+    """IANA name of the local timezone, or None if it can't be determined.
+
+    TZ wins over /etc/localtime, as it does for the OS itself; containers
+    commonly set TZ while /etc/localtime still points at UTC. Abbreviations
+    like "MST" are never sent: the server would treat them as fixed offsets
+    with no DST. When this returns None the server uses the account timezone.
+    """
+    candidates = []
+    if tz := os.environ.get("TZ", "").lstrip(":"):
+        candidates.append(tz)
+    try:
+        candidates.append(os.path.realpath("/etc/localtime").split("zoneinfo/")[1])
     except (IndexError, OSError):
         pass
-    tz = os.environ.get("TZ")
-    if tz:
-        return tz
-    return _time.tzname[0]
+    return next((name for name in candidates if _is_iana_tz(name)), None)
+
+
+def _tz_params() -> dict:
+    tz = _local_tz()
+    return {"tz": tz} if tz else {}
 
 
 def _client() -> httpx.Client:
@@ -49,14 +68,19 @@ def get_me() -> dict:
         return r.json()
 
 
-def create_task(title: str, notes: str | None = None, context_id: int | None = None) -> dict:
+def create_task(title: str, notes: str | None = None, context_id: int | None = None,
+                due: str | None = None, recurrence: str | None = None) -> dict:
     payload: dict = {"title": title}
     if notes is not None:
         payload["notes"] = notes
     if context_id is not None:
         payload["context_id"] = context_id
+    if due is not None:
+        payload["due"] = due
+    if recurrence is not None:
+        payload["recurrence"] = recurrence
     with _client() as c:
-        r = c.post("/tasks", json=payload)
+        r = c.post("/tasks", json=payload, params=_tz_params())
         r.raise_for_status()
         return r.json()
 
@@ -70,7 +94,7 @@ def get_task(task_id: int) -> dict:
 
 def list_tasks(status: str | None = None, date: str | None = None,
                context_id: int | None = None) -> list[dict]:
-    params: dict = {"tz": _local_tz()}
+    params: dict = _tz_params()
     if status is not None:
         params["status"] = status
     if date is not None:
@@ -85,7 +109,7 @@ def list_tasks(status: str | None = None, date: str | None = None,
 
 def mark_done(task_id: int) -> dict:
     with _client() as c:
-        r = c.post(f"/tasks/{task_id}/done")
+        r = c.post(f"/tasks/{task_id}/done", params=_tz_params())
         r.raise_for_status()
         return r.json()
 
@@ -112,7 +136,9 @@ def resume_task(task_id: int) -> dict:
 
 
 def update_task(task_id: int, title: str | None = None, notes: str | None = None,
-                context_id: int | None = None, clear_context: bool = False) -> dict:
+                context_id: int | None = None, clear_context: bool = False,
+                due: str | None = None, recurrence: str | None = None,
+                clear_due: bool = False, clear_recurrence: bool = False) -> dict:
     payload: dict = {}
     if title is not None:
         payload["title"] = title
@@ -122,8 +148,24 @@ def update_task(task_id: int, title: str | None = None, notes: str | None = None
         payload["clear_context"] = True
     elif context_id is not None:
         payload["context_id"] = context_id
+    if clear_due:
+        payload["clear_due"] = True
+    elif due is not None:
+        payload["due"] = due
+    if clear_recurrence:
+        payload["clear_recurrence"] = True
+    elif recurrence is not None:
+        payload["recurrence"] = recurrence
+    with _client() as c:
+        r = c.patch(f"/tasks/{task_id}", json=payload, params=_tz_params())
+        r.raise_for_status()
+        return r.json()
+
+
+def snooze_task(task_id: int, minutes: int | None = None, preset: str | None = None) -> dict:
+    payload: dict = {"minutes": minutes} if minutes is not None else {"preset": preset}
     with _client() as c:
-        r = c.patch(f"/tasks/{task_id}", json=payload)
+        r = c.post(f"/tasks/{task_id}/snooze", json=payload, params=_tz_params())
         r.raise_for_status()
         return r.json()
 
@@ -135,7 +177,7 @@ def delete_task(task_id: int) -> None:
 
 
 def get_stats(context_id: int | None = None) -> dict:
-    params: dict = {"tz": _local_tz()}
+    params: dict = _tz_params()
     if context_id is not None:
         params["context_id"] = context_id
     with _client() as c:
@@ -146,7 +188,7 @@ def get_stats(context_id: int | None = None) -> dict:
 
 def get_done_history(limit: int = 7, before: str | None = None,
                      context_id: int | None = None) -> dict:
-    params: dict = {"tz": _local_tz(), "limit": limit}
+    params: dict = {**_tz_params(), "limit": limit}
     if before is not None:
         params["before"] = before
     if context_id is not None:
@@ -158,7 +200,7 @@ def get_done_history(limit: int = 7, before: str | None = None,
 
 
 def get_today(context_id: int | None = None) -> dict:
-    params: dict = {"tz": _local_tz()}
+    params: dict = _tz_params()
     if context_id is not None:
         params["context_id"] = context_id
     with _client() as c:
@@ -202,7 +244,7 @@ def update_context(context_id: int, name: str, icon: str | None = None) -> dict:
 
 
 def snooze_context(context_id: int) -> dict:
-    params: dict = {"tz": _local_tz()}
+    params: dict = _tz_params()
     with _client() as c:
         r = c.post(f"/contexts/{context_id}/snooze", params=params)
         r.raise_for_status()

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

@@ -1,5 +1,7 @@
 import json
+import re
 import sys
+from datetime import datetime, timezone
 
 import httpx
 import typer
@@ -99,6 +101,51 @@ def _validate_name(name: str) -> str:
     return cleaned
 
 
+WEEKDAYS = ("mon", "tue", "wed", "thu", "fri", "sat", "sun")
+
+
+def _normalize_repeat(value: str) -> str:
+    """Accept friendly repeat specs: daily, weekdays, mon,thu, 3d, or the raw API form."""
+    v = value.strip().lower().replace(" ", "")
+    if v in ("daily", "weekdays") or v.startswith(("weekly:", "after:")):
+        return v
+    if all(day in WEEKDAYS for day in v.split(",")):
+        return f"weekly:{v}"
+    if m := re.fullmatch(r"(\d+)d(ays?)?", v):
+        return f"after:{m.group(1)}"
+    _validation_error(f"Invalid --repeat '{value}'. Use daily, weekdays, mon,thu, or 3d (days after done).")
+
+
+def _describe_repeat(rule: str) -> str:
+    if rule.startswith("weekly:"):
+        return "every " + ", ".join(d.title() for d in rule.split(":", 1)[1].split(","))
+    if rule.startswith("after:"):
+        n = rule.split(":", 1)[1]
+        return f"{n} day{'s' if n != '1' else ''} after done"
+    return rule
+
+
+def _format_due(task: dict) -> str:
+    """Rich-formatted due label, e.g. '[red]overdue · Mon 3:00 PM[/red]'."""
+    if not task.get("due_at"):
+        return ""
+    due = datetime.fromisoformat(task["due_at"])
+    if due.tzinfo is None:
+        due = due.replace(tzinfo=timezone.utc)
+    due = due.astimezone()
+    now = datetime.now().astimezone()
+    if task.get("due_all_day"):
+        when = due.strftime("%a %b %-d")
+    elif due.date() == now.date():
+        when = due.strftime("%-I:%M %p")
+    else:
+        when = due.strftime("%a %b %-d %-I:%M %p")
+    repeat = f" ↻ {_describe_repeat(task['recurrence'])}" if task.get("recurrence") else ""
+    if task.get("status") == "active" and due <= now:
+        return f"  [bold red]⏰ overdue · {when}{repeat}[/bold red]"
+    return f"  [cyan]⏰ {when}{repeat}[/cyan]"
+
+
 def _print_notes(task: dict) -> None:
     if task.get("notes"):
         console.print(f"       [dim]{task['notes']}[/dim]")
@@ -106,13 +153,13 @@ def _print_notes(task: dict) -> None:
 
 def _print_active_task(task: dict) -> None:
     ctx = f"  [dim][{task['context_name']}][/dim]" if task.get("context_name") else ""
-    console.print(f"  [green bold]●[/green bold] [dim]#{task['id']}[/dim]  {task['title']}{ctx}")
+    console.print(f"  [green bold]●[/green bold] [dim]#{task['id']}[/dim]  {task['title']}{ctx}{_format_due(task)}")
     _print_notes(task)
 
 
 def _print_paused_task(task: dict) -> None:
     ctx = f"  [dim][{task['context_name']}][/dim]" if task.get("context_name") else ""
-    console.print(f"  [yellow]⏸[/yellow] [dim]#{task['id']}[/dim]  {task['title']}{ctx}")
+    console.print(f"  [yellow]⏸[/yellow] [dim]#{task['id']}[/dim]  {task['title']}{ctx}{_format_due(task)}")
     _print_notes(task)
 
 
@@ -220,16 +267,19 @@ def add(
     title: str = typer.Argument(..., help="What are you working on?"),
     notes: str = typer.Option(None, "--notes", "-n", help="Optional notes"),
     context: int = typer.Option(None, "--context", "-c", help="Context ID"),
+    due: str = typer.Option(None, "--due", "-d", help="When it's due, e.g. 'tomorrow 3pm', 'in 20m', 'friday'"),
+    repeat: str = typer.Option(None, "--repeat", "-r", help="daily, weekdays, mon,thu, or 3d (3 days after done)"),
 ):
     """Add something to your plate."""
     title = _validate_title(title)
+    recurrence = _normalize_repeat(repeat) if repeat else None
     try:
-        task = api.create_task(title, notes, context)
+        task = api.create_task(title, notes, context, due=due, recurrence=recurrence)
     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]")
+    console.print(f"[green bold]●[/green bold] Added: [bold]{task['title']}[/bold]  [dim](#{task['id']})[/dim]{_format_due(task)}")
 
 
 @app.command()
@@ -246,7 +296,7 @@ def get(
     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}")
+    console.print(f"  {icon} [dim]#{task['id']}[/dim]  {task['title']}{ctx}{_format_due(task)}")
     if task.get("notes"):
         console.print(f"       [dim]{task['notes']}[/dim]")
     console.print(f"       [dim]Status: {task['status']}  Created: {task['created_at']}[/dim]")
@@ -311,7 +361,8 @@ def done(
             continue
         results.append(task)
         if not _json_mode:
-            console.print(f"[green]✓[/green] Done: [bold]{task['title']}[/bold]")
+            next_due = f"  [dim]next:[/dim]{_format_due(task)}" if task.get("recurrence") else ""
+            console.print(f"[green]✓[/green] Done: [bold]{task['title']}[/bold]{next_due}")
     if _json_mode:
         _output_json(results[0] if len(task_ids) == 1 and results else results)
     if errors:
@@ -367,25 +418,60 @@ def edit(
     notes: str = typer.Option(None, "--notes", "-n", help="New notes"),
     context: int = typer.Option(None, "--context", "-c", help="Move to context ID"),
     no_context: bool = typer.Option(False, "--no-context", help="Remove context"),
+    due: str = typer.Option(None, "--due", "-d", help="When it's due, e.g. 'tomorrow 3pm'"),
+    no_due: bool = typer.Option(False, "--no-due", help="Remove due date (and repeat)"),
+    repeat: str = typer.Option(None, "--repeat", "-r", help="daily, weekdays, mon,thu, or 3d"),
+    no_repeat: bool = typer.Option(False, "--no-repeat", help="Stop repeating"),
 ):
-    """Edit a task's title, notes, or context."""
+    """Edit a task's title, notes, context, due date, or repeat."""
     if no_context and context is not None:
         _validation_error("--no-context and --context cannot be used together")
+    if no_due and due is not None:
+        _validation_error("--no-due and --due cannot be used together")
+    if no_repeat and repeat is not None:
+        _validation_error("--no-repeat and --repeat 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 None and notes is None and context is None and not no_context
+            and due is None and not no_due and repeat is None and not no_repeat):
+        _validation_error("No changes specified. Use --title, --notes, --context, --due, or --repeat.")
 
     if title is not None:
         title = _validate_title(title)
+    recurrence = _normalize_repeat(repeat) if repeat else None
 
     try:
         task = api.update_task(task_id, title=title, notes=notes,
-                               context_id=context, clear_context=no_context)
+                               context_id=context, clear_context=no_context,
+                               due=due, clear_due=no_due,
+                               recurrence=recurrence, clear_recurrence=no_repeat)
+    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]{_format_due(task)}")
+
+
+@app.command()
+def snooze(
+    task_id: int = typer.Argument(..., help="ID of the task to snooze"),
+    duration: str = typer.Argument("10m", help="10m, 1h, 3h, 1d, or 'morning' (tomorrow morning)"),
+):
+    """Push a task's due time back (stops the nagging until then)."""
+    d = duration.strip().lower()
+    minutes = preset = None
+    if d in ("morning", "tomorrow"):
+        preset = "tomorrow_morning"
+    elif m := re.fullmatch(r"(\d+)\s*(m|min|h|hr|d)", d):
+        minutes = int(m.group(1)) * {"m": 1, "min": 1, "h": 60, "hr": 60, "d": 1440}[m.group(2)]
+    else:
+        _validation_error(f"Invalid duration '{duration}'. Use 10m, 1h, 3h, 1d, or morning.")
+    try:
+        task = api.snooze_task(task_id, minutes=minutes, preset=preset)
     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]")
+    console.print(f"[cyan]💤 Snoozed:[/cyan] [bold]{task['title']}[/bold]{_format_due(task)}")
 
 
 @app.command()

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doingapp
-Version: 0.6.0
+Version: 0.7.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
@@ -73,13 +73,14 @@ doing apikey --key doing_xxxxx
 | Command | Description |
 |---------|-------------|
 | `doing` | Show active tasks (same as `doing ls`) |
-| `doing add <title>` | Add a task (`-n` notes, `-c` context ID) |
+| `doing add <title>` | Add a task (`-n` notes, `-c` context ID, `-d "tomorrow 3pm"` due, `-r daily` repeat) |
 | `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 edit <id>` | Edit a task (`-t` title, `-n` notes, `-c` context, `--no-context`, `-d` due, `--no-due`, `-r` repeat, `--no-repeat`) |
+| `doing snooze <id> [10m\|1h\|3h\|1d\|morning]` | Push a due task back (default 10m) |
 | `doing rm <id>` | Delete a task |
 | `doing ls` | List active tasks (`-c` context ID) |
 | `doing log` | Show tasks done today (`-d YYYY-MM-DD`, `-c` context ID) |
@@ -93,6 +94,19 @@ doing apikey --key doing_xxxxx
 | `doing logout` | Log out |
 | `doing apikey` | Save an API key (`-k` key) |
 
+## Due dates and reminders
+
+Give a task a due date and the Doing iOS app nags you every few minutes once it's overdue, until you mark it done or snooze it.
+
+```bash
+doing add "Call mom" -d "tomorrow 3pm"
+doing add "Water plants" -d friday -r 3d      # repeats 3 days after each completion
+doing add "Standup notes" -d "9am" -r weekdays
+doing snooze 12 1h
+```
+
+`-d` accepts natural language: `in 20m`, `tonight`, `fri 9am`, `oct 30`. Dates without a time use your morning time (9:00 by default). `-r` accepts `daily`, `weekdays`, days like `mon,thu`, or `Nd` (N days after done).
+
 ## 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.

{doingapp-0.6.0 → doingapp-0.7.1}/pyproject.toml

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