podojo-cli 0.4.4__tar.gz → 0.5.0__tar.gz

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to the Podojo CLI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com),
 and this project adheres to [Semantic Versioning](https://semver.org).
 
+## [0.5.0] - 2026-05-01
+
+### Added
+- `interviews upload` command uploads audio/video interview files to an existing project
+- `projects create` command creates a new empty project (uploads now require a pre-existing project, no auto-creation)
+
+## [0.4.5] - 2026-04-25
+
+### Added
+- Show interview date/time in `transcripts list` and `videos list` tables
+
 ## [0.4.4] - 2026-04-19
 
 ### Added

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: podojo-cli
-Version: 0.4.4
+Version: 0.5.0
 Summary: CLI for the Podojo user research platform
 Project-URL: Homepage, https://github.com/podojo/cli-podojo
 Project-URL: Source, https://github.com/podojo/cli-podojo

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "podojo-cli"
-version = "0.4.4"
+version = "0.5.0"
 description = "CLI for the Podojo user research platform"
 readme = "README.md"
 license = "MIT"

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/src/podojo_cli/client.py

@@ -1,3 +1,6 @@
+import urllib.parse
+from pathlib import Path
+
 import httpx
 
 from .config import load_config
@@ -21,6 +24,37 @@ class PodojoClient:
         r.raise_for_status()
         return r.json()["projects"]
 
+    def create_project(self, name: str, brief: str = "") -> dict:
+        r = httpx.post(
+            f"{self.base_url}/projects",
+            json={"name": name, "brief": brief},
+            headers=self._headers(),
+        )
+        r.raise_for_status()
+        return r.json()
+
+    def upload_interview(
+        self,
+        project: str,
+        file_path: Path,
+        audio_only: bool = False,
+        batch_name: str | None = None,
+    ) -> dict:
+        encoded = urllib.parse.quote(project, safe="")
+        data = {"audio_only": str(audio_only).lower()}
+        if batch_name:
+            data["batch_name"] = batch_name
+        with file_path.open("rb") as f:
+            r = httpx.post(
+                f"{self.base_url}/projects/{encoded}/interviews",
+                files={"file": (file_path.name, f)},
+                data=data,
+                headers=self._headers(),
+                timeout=httpx.Timeout(None),
+            )
+        r.raise_for_status()
+        return r.json()
+
     def list_transcripts(self, project: str) -> dict:
         r = httpx.get(
             f"{self.base_url}/projects/{project}/transcripts",

podojo_cli-0.5.0/src/podojo_cli/commands/interviews.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+
+import httpx
+import typer
+from rich.console import Console
+
+from ..client import PodojoClient
+
+app = typer.Typer(help="Manage interviews")
+console = Console()
+
+
+@app.command("upload")
+def upload_interview(
+    file: Path = typer.Argument(
+        ...,
+        exists=True,
+        dir_okay=False,
+        readable=True,
+        help="Audio/video file to upload",
+    ),
+    project: str = typer.Option(..., "--project", "-p", help="Existing project name"),
+    audio_only: bool = typer.Option(False, "--audio-only", help="Skip video processing"),
+    batch_name: str = typer.Option(
+        None, "--name", "-n", help="Override interview name (defaults to filename)"
+    ),
+):
+    """Upload an audio/video interview file to an existing project."""
+    client = PodojoClient()
+    size_mb = file.stat().st_size / (1024 * 1024)
+    with console.status(f"Uploading {file.name} ({size_mb:.1f} MB)..."):
+        try:
+            result = client.upload_interview(
+                project, file, audio_only=audio_only, batch_name=batch_name
+            )
+        except httpx.HTTPStatusError as e:
+            status = e.response.status_code
+            detail = ""
+            try:
+                detail = e.response.json().get("detail", "")
+            except Exception:
+                detail = e.response.text
+            if status == 404:
+                console.print(
+                    f"[red]Project '{project}' not found.[/red] "
+                    f"Create it first: [bold]podojo projects create \"{project}\"[/bold]"
+                )
+            elif status == 400:
+                console.print(f"[red]{detail}[/red]")
+            else:
+                console.print(f"[red]{status}: {detail}[/red]")
+            raise typer.Exit(code=1)
+
+    console.print(
+        f"Uploaded [bold]{file.name}[/bold] → {project} "
+        f"(batch_id={result['batch_id']})"
+    )

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

@@ -0,0 +1,47 @@
+import httpx
+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)
+
+
+@app.command("create")
+def create_project(
+    name: str = typer.Argument(help="Project name"),
+    brief: str = typer.Option("", "--brief", "-b", help="Short project description"),
+):
+    """Create a new empty project."""
+    client = PodojoClient()
+    try:
+        result = client.create_project(name, brief)
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 409:
+            console.print(f"[red]Project '{name}' already exists.[/red]")
+            raise typer.Exit(code=1)
+        console.print(f"[red]{e.response.status_code}: {e.response.text}[/red]")
+        raise typer.Exit(code=1)
+
+    console.print(f"Created project [bold]{result['name']}[/bold] (id={result['id']})")

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/src/podojo_cli/commands/transcripts.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from pathlib import Path
 
 import typer
@@ -10,6 +11,15 @@ app = typer.Typer(help="Manage transcripts")
 console = Console()
 
 
+def _format_date(value) -> str:
+    if not value:
+        return ""
+    try:
+        return datetime.fromisoformat(value.replace("Z", "+00:00")).strftime("%Y-%m-%d %H:%M")
+    except (ValueError, AttributeError):
+        return str(value)
+
+
 @app.command("list")
 def list_transcripts(project: str = typer.Argument(help="Project name")):
     """List transcripts for a project."""
@@ -17,11 +27,12 @@ def list_transcripts(project: str = typer.Argument(help="Project name")):
     data = client.list_transcripts(project)
 
     table = Table(title=f"Transcripts — {project} ({data['total']} total)")
+    table.add_column("Date")
     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", ""))
+        table.add_row(_format_date(t.get("date")), t.get("batch_id", ""), t.get("batch_name", ""))
 
     console.print(table)
 

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/src/podojo_cli/commands/videos.py

@@ -1,3 +1,4 @@
+from datetime import datetime
 from pathlib import Path
 
 import httpx
@@ -12,6 +13,17 @@ app = typer.Typer(help="Manage videos")
 console = Console()
 
 
+def _format_date(value) -> str:
+    if not value:
+        return ""
+    if isinstance(value, datetime):
+        return value.strftime("%Y-%m-%d %H:%M")
+    try:
+        return datetime.fromisoformat(str(value).replace("Z", "+00:00")).strftime("%Y-%m-%d %H:%M")
+    except ValueError:
+        return str(value)
+
+
 @app.command("list")
 def list_videos(project: str = typer.Argument(help="Project name")):
     """List videos for a project."""
@@ -19,12 +31,14 @@ def list_videos(project: str = typer.Argument(help="Project name")):
     data = client.list_videos(project)
 
     table = Table(title=f"Videos — {project} ({data['total']} total)")
+    table.add_column("Date")
     table.add_column("Batch ID")
     table.add_column("Name")
     table.add_column("Duration (min)")
 
     for v in data["videos"]:
         table.add_row(
+            _format_date(v.get("batch_timestamp")),
             v.get("batch_id", ""),
             v.get("batch_name", ""),
             str(v.get("duration_minutes", "")),

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/src/podojo_cli/main.py

@@ -1,6 +1,6 @@
 import typer
 
-from .commands import auth, gdrive, projects, usertests, showreel, transcripts, videos
+from .commands import auth, gdrive, interviews, projects, showreel, transcripts, usertests, videos
 
 app = typer.Typer(
     name="podojo",
@@ -10,6 +10,7 @@ app = typer.Typer(
 
 app.add_typer(auth.app, name="auth")
 app.add_typer(projects.app, name="projects")
+app.add_typer(interviews.app, name="interviews")
 app.add_typer(usertests.app, name="usertests")
 app.add_typer(transcripts.app, name="transcripts")
 app.add_typer(videos.app, name="videos")

podojo_cli-0.5.0/tests/test_interviews.py

@@ -0,0 +1,86 @@
+from podojo_cli.main import app
+
+
+def test_upload_interview(runner, httpx_mock, tmp_path):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects/Alpha/interviews",
+        json={
+            "batch_id": "batch-xyz",
+            "filename": "session_20260501120000.mp4",
+            "project_name": "Alpha",
+            "message": "File successfully uploaded",
+        },
+    )
+
+    file_path = tmp_path / "session.mp4"
+    file_path.write_bytes(b"fake video bytes")
+
+    result = runner.invoke(app, ["interviews", "upload", str(file_path), "--project", "Alpha"])
+
+    assert result.exit_code == 0
+    assert "session.mp4" in result.output
+    assert "batch-xyz" in result.output
+
+
+def test_upload_interview_url_encodes_project(runner, httpx_mock, tmp_path):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects/Acme%20Q4/interviews",
+        json={
+            "batch_id": "batch-1",
+            "filename": "x.mp4",
+            "project_name": "Acme Q4",
+            "message": "ok",
+        },
+    )
+
+    file_path = tmp_path / "x.mp4"
+    file_path.write_bytes(b"data")
+
+    result = runner.invoke(app, ["interviews", "upload", str(file_path), "--project", "Acme Q4"])
+
+    assert result.exit_code == 0
+
+
+def test_upload_interview_unknown_project(runner, httpx_mock, tmp_path):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects/Ghost/interviews",
+        status_code=404,
+        json={"detail": "Project 'Ghost' not found"},
+    )
+
+    file_path = tmp_path / "session.mp4"
+    file_path.write_bytes(b"fake")
+
+    result = runner.invoke(app, ["interviews", "upload", str(file_path), "--project", "Ghost"])
+
+    assert result.exit_code == 1
+    assert "not found" in result.output
+    assert "projects create" in result.output
+
+
+def test_upload_interview_bad_extension(runner, httpx_mock, tmp_path):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects/Alpha/interviews",
+        status_code=400,
+        json={"detail": "File type not allowed"},
+    )
+
+    file_path = tmp_path / "notes.txt"
+    file_path.write_text("hello")
+
+    result = runner.invoke(app, ["interviews", "upload", str(file_path), "--project", "Alpha"])
+
+    assert result.exit_code == 1
+    assert "File type not allowed" in result.output
+
+
+def test_upload_interview_missing_file(runner, tmp_path):
+    missing = tmp_path / "does-not-exist.mp4"
+
+    result = runner.invoke(app, ["interviews", "upload", str(missing), "--project", "Alpha"])
+
+    assert result.exit_code != 0

podojo_cli-0.5.0/tests/test_projects.py

@@ -0,0 +1,72 @@
+from podojo_cli.main import app
+
+
+def test_list_projects(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/projects?skip=0&limit=50",
+        json={
+            "projects": [
+                {"name": "Alpha", "brief": "First project"},
+                {"name": "Beta", "brief": "Second project"},
+            ],
+            "total": 2,
+            "skip": 0,
+            "limit": 50,
+        },
+    )
+
+    result = runner.invoke(app, ["projects", "list"])
+
+    assert result.exit_code == 0
+    assert "Alpha" in result.output
+    assert "Beta" in result.output
+
+
+def test_list_projects_empty(runner, httpx_mock):
+    httpx_mock.add_response(
+        url="http://test.local/api/v1/projects?skip=0&limit=50",
+        json={
+            "projects": [],
+            "total": 0,
+            "skip": 0,
+            "limit": 50,
+        },
+    )
+
+    result = runner.invoke(app, ["projects", "list"])
+
+    assert result.exit_code == 0
+
+
+def test_create_project(runner, httpx_mock):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects",
+        match_json={"name": "Gamma", "brief": "Third project"},
+        json={
+            "id": "abc123",
+            "name": "Gamma",
+            "brief": "Third project",
+            "message": "Project created successfully",
+        },
+    )
+
+    result = runner.invoke(app, ["projects", "create", "Gamma", "--brief", "Third project"])
+
+    assert result.exit_code == 0
+    assert "Gamma" in result.output
+    assert "abc123" in result.output
+
+
+def test_create_project_duplicate(runner, httpx_mock):
+    httpx_mock.add_response(
+        method="POST",
+        url="http://test.local/api/v1/projects",
+        status_code=409,
+        json={"detail": "Project with this name already exists"},
+    )
+
+    result = runner.invoke(app, ["projects", "create", "Gamma"])
+
+    assert result.exit_code == 1
+    assert "already exists" in result.output

{podojo_cli-0.4.4 → podojo_cli-0.5.0}/uv.lock

@@ -472,7 +472,7 @@ wheels = [
 
 [[package]]
 name = "podojo-cli"
-version = "0.4.4"
+version = "0.5.0"
 source = { editable = "." }
 dependencies = [
     { name = "google-api-python-client" },

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

@@ -1,27 +0,0 @@
-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.4.4/tests/test_projects.py

@@ -1,38 +0,0 @@
-from podojo_cli.main import app
-
-
-def test_list_projects(runner, httpx_mock):
-    httpx_mock.add_response(
-        url="http://test.local/api/v1/projects?skip=0&limit=50",
-        json={
-            "projects": [
-                {"name": "Alpha", "brief": "First project"},
-                {"name": "Beta", "brief": "Second project"},
-            ],
-            "total": 2,
-            "skip": 0,
-            "limit": 50,
-        },
-    )
-
-    result = runner.invoke(app, ["projects", "list"])
-
-    assert result.exit_code == 0
-    assert "Alpha" in result.output
-    assert "Beta" in result.output
-
-
-def test_list_projects_empty(runner, httpx_mock):
-    httpx_mock.add_response(
-        url="http://test.local/api/v1/projects?skip=0&limit=50",
-        json={
-            "projects": [],
-            "total": 0,
-            "skip": 0,
-            "limit": 50,
-        },
-    )
-
-    result = runner.invoke(app, ["projects", "list"])
-
-    assert result.exit_code == 0