podojo-cli 0.1.0__tar.gz

podojo_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+
+      - run: uv build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

podojo_cli-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.env

podojo_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,40 @@
+# Podojo CLI
+
+CLI tool for the Podojo user research platform. Part of the Podojo multi-repo architecture.
+
+## Tech Stack
+
+- Python 3.12, uv for dependency management
+- Typer for CLI framework
+- httpx for HTTP client
+- Rich for terminal output
+- ffmpeg for video editing (system dependency, install via `brew install ffmpeg`)
+
+## Usage
+
+```bash
+podojo auth login <api-key>
+podojo auth logout
+podojo projects list
+podojo transcripts list <project>
+podojo transcripts download <project> <batch_id> -o output.txt
+podojo videos list <project>
+podojo videos download <batch_id> -o output.mp4
+podojo showreel create clips.json -o showreel.mp4
+podojo gdrive setup ~/.podojo-gdrive.json
+podojo gdrive upload report.md --title "My Report"
+```
+
+## Configuration
+
+Set via env vars or `~/.podojo.toml`:
+
+```toml
+base_url = "https://your-api.example.com"
+api_key = "your-api-key"
+```
+
+## Git Commits
+
+- Do NOT add "Co-Authored-By: Claude" trailers to commit messages
+- Keep commit messages concise and focused on the "why"

podojo_cli-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: podojo-cli
+Version: 0.1.0
+Summary: CLI for the Podojo user research platform
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: google-api-python-client>=2.0
+Requires-Dist: google-auth>=2.0
+Requires-Dist: httpx>=0.28
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.15
+Description-Content-Type: text/markdown
+
+# podojo-cli
+
+CLI for the Podojo user research platform.
+
+## Installation
+
+```bash
+uv tool install podojo-cli
+```
+
+## Usage
+
+```bash
+podojo --help
+```

podojo_cli-0.1.0/README.md

@@ -0,0 +1,15 @@
+# podojo-cli
+
+CLI for the Podojo user research platform.
+
+## Installation
+
+```bash
+uv tool install podojo-cli
+```
+
+## Usage
+
+```bash
+podojo --help
+```

podojo_cli-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "podojo-cli"
+version = "0.1.0"
+description = "CLI for the Podojo user research platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+dependencies = [
+    "typer>=0.15",
+    "httpx>=0.28",
+    "rich>=13.0",
+    "google-auth>=2.0",
+    "google-api-python-client>=2.0",
+]
+
+[project.scripts]
+podojo = "podojo_cli.main:app"
+
+[dependency-groups]
+dev = ["pytest>=8.0", "pytest-httpx>=0.35"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/podojo_cli"]

podojo_cli-0.1.0/src/podojo_cli/client.py

@@ -0,0 +1,54 @@
+import httpx
+
+from .config import load_config
+
+
+class PodojoClient:
+    def __init__(self):
+        config = load_config()
+        self.base_url = config["base_url"].rstrip("/") + "/api/v1"
+        self.api_key = config["api_key"]
+
+    def _headers(self) -> dict:
+        return {"Authorization": f"Bearer {self.api_key}"}
+
+    def list_projects(self, skip: int = 0, limit: int = 50) -> list:
+        r = httpx.get(
+            f"{self.base_url}/projects",
+            params={"skip": skip, "limit": limit},
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.json()["projects"]
+
+    def list_transcripts(self, project: str) -> dict:
+        r = httpx.get(
+            f"{self.base_url}/projects/{project}/transcripts",
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def download_transcript(self, project: str, batch_id: str) -> str:
+        r = httpx.get(
+            f"{self.base_url}/projects/{project}/transcripts/{batch_id}",
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.text
+
+    def list_videos(self, project: str) -> dict:
+        r = httpx.get(
+            f"{self.base_url}/projects/{project}/videos",
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def get_video_url(self, batch_id: str) -> dict:
+        r = httpx.get(
+            f"{self.base_url}/videos/{batch_id}",
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.json()

podojo_cli-0.1.0/src/podojo_cli/commands/auth.py

@@ -0,0 +1,43 @@
+import httpx
+import typer
+from rich.console import Console
+
+from ..config import DEFAULT_BASE_URL, clear_api_key, load_config, save_config
+
+app = typer.Typer(help="Authenticate with Podojo")
+console = Console()
+
+
+def _verify_key(api_key: str) -> bool:
+    config = load_config()
+    base_url = config["base_url"].rstrip("/") + "/api/v1"
+    try:
+        r = httpx.get(
+            f"{base_url}/projects",
+            params={"limit": 1},
+            headers={"Authorization": f"Bearer {api_key}"},
+            timeout=10,
+        )
+        return r.status_code == 200
+    except httpx.RequestError:
+        return False
+
+
+@app.command("login")
+def login(api_key: str = typer.Argument(help="Your Podojo API key")):
+    """Save your API key and verify it works."""
+    console.print("Verifying key…", end=" ")
+    if not _verify_key(api_key):
+        console.print("[red]failed[/red]")
+        console.print("[red]Error:[/red] Invalid API key or could not reach the server.")
+        raise typer.Exit(1)
+    save_config(api_key)
+    console.print("[green]done[/green]")
+    console.print("[green]Logged in successfully.[/green]")
+
+
+@app.command("logout")
+def logout():
+    """Remove the saved API key."""
+    clear_api_key()
+    console.print("Logged out.")

podojo_cli-0.1.0/src/podojo_cli/commands/gdrive.py

@@ -0,0 +1,51 @@
+from pathlib import Path
+
+import typer
+from rich.console import Console
+
+from ..gdrive.list import list_files
+from ..gdrive.upload import CREDENTIALS_FILENAME, upload_md_as_doc
+
+app = typer.Typer(help="Upload documents to Google Drive")
+console = Console()
+
+
+@app.command("upload")
+def upload(
+    file: Path = typer.Argument(help="Markdown file to upload"),
+    folder_id: str = typer.Option(..., "--folder-id", "-f", help="Google Drive folder ID"),
+    title: str = typer.Option(None, "--title", "-t", help="Document title (defaults to filename)"),
+):
+    """Upload a markdown file to Google Drive as a Google Doc."""
+    if not file.exists():
+        console.print(f"[red]Error:[/red] File not found: {file}")
+        raise typer.Exit(1)
+
+    if not Path(CREDENTIALS_FILENAME).exists():
+        console.print(f"[red]Error:[/red] {CREDENTIALS_FILENAME} not found in current directory")
+        raise typer.Exit(1)
+
+    console.print(f"Uploading [bold]{file}[/bold]…", end=" ")
+    _, url = upload_md_as_doc(str(file), folder_id=folder_id, title=title)
+    console.print("[green]done[/green]")
+    console.print(url)
+
+
+@app.command("list")
+def list_cmd(
+    folder_id: str = typer.Option(..., "--folder-id", "-f", help="Google Drive folder ID"),
+):
+    """List files in a Google Drive folder."""
+    if not Path(CREDENTIALS_FILENAME).exists():
+        console.print(f"[red]Error:[/red] {CREDENTIALS_FILENAME} not found in current directory")
+        raise typer.Exit(1)
+
+    files = list_files(folder_id=folder_id)
+
+    if not files:
+        console.print("No files found.")
+        return
+
+    for f in files:
+        link = f.get("webViewLink", "")
+        console.print(f"[bold]{f['name']}[/bold]  {link}")

podojo_cli-0.1.0/src/podojo_cli/commands/projects.py

@@ -0,0 +1,27 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ..client import PodojoClient
+
+app = typer.Typer(help="Manage projects")
+console = Console()
+
+
+@app.command("list")
+def list_projects(
+    skip: int = typer.Option(0, help="Number of projects to skip"),
+    limit: int = typer.Option(50, help="Max projects to return"),
+):
+    """List all projects."""
+    client = PodojoClient()
+    projects = client.list_projects(skip=skip, limit=limit)
+
+    table = Table(title="Projects")
+    table.add_column("Name")
+    table.add_column("Brief")
+
+    for p in projects:
+        table.add_row(p.get("name", ""), p.get("brief", ""))
+
+    console.print(table)

podojo_cli-0.1.0/src/podojo_cli/commands/showreel.py

@@ -0,0 +1,108 @@
+import json
+import os
+import shutil
+import tempfile
+from pathlib import Path
+
+import httpx
+import typer
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn, BarColumn, DownloadColumn
+
+from ..client import PodojoClient
+from ..video.showreel import extract_clip, make_title_card, concatenate
+
+app = typer.Typer(help="Generate video showreels")
+console = Console()
+
+
+def _check_ffmpeg():
+    if shutil.which("ffmpeg") is None:
+        console.print("[red]Error:[/red] ffmpeg not found. Install it with: brew install ffmpeg")
+        raise typer.Exit(1)
+
+
+def _download_video(url: str, dest: Path):
+    with httpx.stream("GET", url, follow_redirects=True) as r:
+        r.raise_for_status()
+        total = int(r.headers.get("content-length", 0))
+        with open(dest, "wb") as f, Progress(
+            SpinnerColumn(),
+            TextColumn("{task.description}"),
+            BarColumn(),
+            DownloadColumn(),
+            console=console,
+        ) as progress:
+            task = progress.add_task(f"  Downloading {dest.name}…", total=total or None)
+            for chunk in r.iter_bytes(chunk_size=8192):
+                f.write(chunk)
+                progress.update(task, advance=len(chunk))
+
+
+@app.command("create")
+def create_showreel(
+    clips_json: Path = typer.Argument(help="Path to clips JSON file"),
+    output: Path = typer.Option("showreel.mp4", "-o", "--output", help="Output .mp4 path"),
+):
+    """Create a video showreel from a clips JSON config.
+
+    The clips JSON should be a list of objects with these fields:
+      batch_id   - video batch ID to fetch from the API
+      participant - display name (e.g. "P09 — Umid")
+      country    - participant country
+      topic      - short description of what the clip shows
+      start      - clip start time (MM:SS or HH:MM:SS)
+      end        - clip end time (MM:SS or HH:MM:SS)
+    """
+    _check_ffmpeg()
+
+    with open(clips_json) as f:
+        clips = json.load(f)
+
+    if not clips:
+        console.print("[yellow]No clips found in JSON.[/yellow]")
+        raise typer.Exit(0)
+
+    client = PodojoClient()
+    output = output.resolve()
+    output.parent.mkdir(parents=True, exist_ok=True)
+
+    with tempfile.TemporaryDirectory(prefix="podojo-showreel-") as tmp:
+        tmp = Path(tmp)
+
+        # Download each unique batch_id once
+        video_paths: dict[str, Path] = {}
+        unique_ids = {c["batch_id"] for c in clips}
+        console.print(f"\nDownloading {len(unique_ids)} video(s)…")
+
+        for batch_id in unique_ids:
+            data = client.get_video_url(batch_id)
+            dest = tmp / f"{batch_id}.mp4"
+            _download_video(data["url"], dest)
+            video_paths[batch_id] = dest
+
+        # Build segments
+        parts: list[str] = []
+        console.print(f"\nProcessing {len(clips)} clip(s)…")
+
+        for i, clip in enumerate(clips, 1):
+            participant = clip["participant"]
+            country = clip["country"]
+            topic = clip["topic"]
+            src = str(video_paths[clip["batch_id"]])
+
+            console.print(f"  [{i}/{len(clips)}] {participant} — {topic}")
+
+            title_dst = str(tmp / f"_title_{i:02d}.mp4")
+            clip_dst = str(tmp / f"_clip_{i:02d}.mp4")
+
+            make_title_card(participant, country, topic, title_dst)
+            extract_clip(src, clip["start"], clip["end"], clip_dst)
+
+            parts.extend([title_dst, clip_dst])
+
+        console.print("\nConcatenating…")
+        concatenate(parts, str(output))
+
+    size_mb = os.path.getsize(output) / (1024 * 1024)
+    console.print(f"\n[green]Done![/green] {output} ({size_mb:.1f} MB)")

podojo_cli-0.1.0/src/podojo_cli/commands/transcripts.py

@@ -0,0 +1,43 @@
+from pathlib import Path
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from ..client import PodojoClient
+
+app = typer.Typer(help="Manage transcripts")
+console = Console()
+
+
+@app.command("list")
+def list_transcripts(project: str = typer.Argument(help="Project name")):
+    """List transcripts for a project."""
+    client = PodojoClient()
+    data = client.list_transcripts(project)
+
+    table = Table(title=f"Transcripts — {project} ({data['total']} total)")
+    table.add_column("Batch ID")
+    table.add_column("Name")
+
+    for t in data["interviews"]:
+        table.add_row(t.get("batch_id", ""), t.get("batch_name", ""))
+
+    console.print(table)
+
+
+@app.command("download")
+def download_transcript(
+    project: str = typer.Argument(help="Project name"),
+    batch_id: str = typer.Argument(help="Batch ID"),
+    output: Path = typer.Option(None, "-o", "--output", help="Output file path"),
+):
+    """Download a transcript."""
+    client = PodojoClient()
+    text = client.download_transcript(project, batch_id)
+
+    if output:
+        output.write_text(text)
+        console.print(f"Saved to {output}")
+    else:
+        console.print(text)

podojo_cli-0.1.0/src/podojo_cli/commands/videos.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+
+import httpx
+import typer
+from rich.console import Console
+from rich.progress import Progress
+from rich.table import Table
+
+from ..client import PodojoClient
+
+app = typer.Typer(help="Manage videos")
+console = Console()
+
+
+@app.command("list")
+def list_videos(project: str = typer.Argument(help="Project name")):
+    """List videos for a project."""
+    client = PodojoClient()
+    data = client.list_videos(project)
+
+    table = Table(title=f"Videos — {project} ({data['total']} total)")
+    table.add_column("Batch ID")
+    table.add_column("Name")
+    table.add_column("Duration (min)")
+
+    for v in data["videos"]:
+        table.add_row(
+            v.get("batch_id", ""),
+            v.get("batch_name", ""),
+            str(v.get("duration_minutes", "")),
+        )
+
+    console.print(table)
+
+
+@app.command("download")
+def download_video(
+    batch_id: str = typer.Argument(help="Batch ID"),
+    output: Path = typer.Option(None, "-o", "--output", help="Output file path"),
+):
+    """Download a video file."""
+    client = PodojoClient()
+    data = client.get_video_url(batch_id)
+    url = data["url"]
+
+    filename = output or Path(data.get("filename", f"{batch_id}.mp4"))
+
+    with httpx.stream("GET", url) as r:
+        r.raise_for_status()
+        total = int(r.headers.get("content-length", 0))
+        with open(filename, "wb") as f, Progress() as progress:
+            task = progress.add_task("Downloading...", total=total)
+            for chunk in r.iter_bytes(chunk_size=8192):
+                f.write(chunk)
+                progress.update(task, advance=len(chunk))
+
+    console.print(f"Saved to {filename}")

podojo_cli-0.1.0/src/podojo_cli/config.py

@@ -0,0 +1,39 @@
+import os
+from pathlib import Path
+
+import tomllib
+
+
+CONFIG_PATH = Path.home() / ".podojo.toml"
+DEFAULT_BASE_URL = "https://podojo-fastapi-mcp.onrender.com"
+
+
+def load_config() -> dict:
+    config = {}
+    if CONFIG_PATH.exists():
+        config = tomllib.loads(CONFIG_PATH.read_text())
+    config.setdefault("base_url", os.getenv("PODOJO_BASE_URL", DEFAULT_BASE_URL))
+    config.setdefault("api_key", os.getenv("PODOJO_API_KEY", ""))
+    return config
+
+
+def save_config(api_key: str):
+    config = {}
+    if CONFIG_PATH.exists():
+        config = tomllib.loads(CONFIG_PATH.read_text())
+    config["api_key"] = api_key
+    config.setdefault("base_url", DEFAULT_BASE_URL)
+    lines = "\n".join(f'{k} = "{v}"' for k, v in config.items())
+    CONFIG_PATH.write_text(lines + "\n")
+
+
+def clear_api_key():
+    if not CONFIG_PATH.exists():
+        return
+    config = tomllib.loads(CONFIG_PATH.read_text())
+    config.pop("api_key", None)
+    if config:
+        lines = "\n".join(f'{k} = "{v}"' for k, v in config.items())
+        CONFIG_PATH.write_text(lines + "\n")
+    else:
+        CONFIG_PATH.unlink()

podojo_cli-0.1.0/src/podojo_cli/gdrive/list.py

@@ -0,0 +1,20 @@
+"""List files in a Google Drive folder."""
+
+from .upload import get_drive_service
+
+
+def list_files(folder_id: str) -> list[dict]:
+    """Return a list of files in the given folder (id, name, mimeType, webViewLink)."""
+    drive = get_drive_service()
+
+    results = (
+        drive.files()
+        .list(
+            q=f"'{folder_id}' in parents and trashed = false",
+            fields="files(id, name, mimeType, webViewLink)",
+            supportsAllDrives=True,
+            includeItemsFromAllDrives=True,
+        )
+        .execute()
+    )
+    return results.get("files", [])

podojo_cli-0.1.0/src/podojo_cli/gdrive/upload.py

@@ -0,0 +1,56 @@
+"""Upload a markdown file to Google Drive as a Google Doc."""
+
+import os
+from pathlib import Path
+
+from google.oauth2.service_account import Credentials
+from googleapiclient.discovery import build
+from googleapiclient.http import MediaFileUpload
+
+
+CREDENTIALS_FILENAME = "service-account.json"
+
+
+def get_drive_service():
+    credentials_path = Path.cwd() / CREDENTIALS_FILENAME
+    if not credentials_path.exists():
+        raise FileNotFoundError(f"{CREDENTIALS_FILENAME} not found in current directory")
+    creds = Credentials.from_service_account_file(
+        str(credentials_path),
+        scopes=["https://www.googleapis.com/auth/drive"],
+    )
+    return build("drive", "v3", credentials=creds)
+
+
+def upload_md_as_doc(
+    md_file: str,
+    folder_id: str,
+    title: str | None = None,
+) -> tuple[str, str]:
+    drive = get_drive_service()
+
+    if not title:
+        title = os.path.splitext(os.path.basename(md_file))[0]
+
+    parent = folder_id
+
+    media = MediaFileUpload(md_file, mimetype="text/markdown")
+    file_metadata = {
+        "name": title,
+        "mimeType": "application/vnd.google-apps.document",
+        "parents": [parent],
+    }
+    result = (
+        drive.files()
+        .create(
+            body=file_metadata,
+            media_body=media,
+            fields="id",
+            supportsAllDrives=True,
+        )
+        .execute()
+    )
+
+    doc_id = result["id"]
+    url = f"https://docs.google.com/document/d/{doc_id}/edit"
+    return doc_id, url

podojo_cli-0.1.0/src/podojo_cli/main.py

@@ -0,0 +1,19 @@
+import typer
+
+from .commands import auth, gdrive, projects, showreel, transcripts, videos
+
+app = typer.Typer(
+    name="podojo",
+    help="CLI for the Podojo user research platform",
+    no_args_is_help=True,
+)
+
+app.add_typer(auth.app, name="auth")
+app.add_typer(projects.app, name="projects")
+app.add_typer(transcripts.app, name="transcripts")
+app.add_typer(videos.app, name="videos")
+app.add_typer(showreel.app, name="showreel")
+app.add_typer(gdrive.app, name="gdrive")
+
+if __name__ == "__main__":
+    app()