podojo-cli 0.8.0__tar.gz → 0.8.2__tar.gz

{podojo_cli-0.8.0 → podojo_cli-0.8.2}/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.8.2] - 2026-05-14
+
+### Changed
+- Enriched PyPI package metadata: added `keywords`, `classifiers`, author email, and a `Changelog` project URL.
+
+## [0.8.1] - 2026-05-13
+
+### Changed
+- `projects upload-doc` strips embedded images (base64 reference definitions, inline `![](...)`, reference-style `![][ref]`, and `<img>` tags) before upload. Google-Docs-exported markdown often inlines images as multi-MB base64 blobs; the CLI now prints the count and size reduction.
+
 ## [0.8.0] - 2026-05-13
 
 ### Added

{podojo_cli-0.8.0 → podojo_cli-0.8.2}/PKG-INFO

@@ -1,12 +1,23 @@
 Metadata-Version: 2.4
 Name: podojo-cli
-Version: 0.8.0
+Version: 0.8.2
 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
 Project-URL: Issues, https://github.com/podojo/cli-podojo/issues
-Author: Jochen Ade
+Project-URL: Changelog, https://github.com/podojo/cli-podojo/blob/main/CHANGELOG.md
+Author-email: Jochen Ade <jochen.ade@podojo.com>
 License-Expression: MIT
+Keywords: cli,podojo,transcripts,user-research,ux-research
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Other Audience
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
 Requires-Python: >=3.12
 Requires-Dist: google-api-python-client>=2.0
 Requires-Dist: google-auth>=2.0

{podojo_cli-0.8.0 → podojo_cli-0.8.2}/pyproject.toml

@@ -1,11 +1,23 @@
 [project]
 name = "podojo-cli"
-version = "0.8.0"
+version = "0.8.2"
 description = "CLI for the Podojo user research platform"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.12"
-authors = [{ name = "Jochen Ade" }]
+authors = [{ name = "Jochen Ade", email = "jochen.ade@podojo.com" }]
+keywords = ["podojo", "ux-research", "user-research", "cli", "transcripts"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Other Audience",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Utilities",
+]
 dependencies = [
     "typer>=0.15",
     "httpx>=0.28",
@@ -23,6 +35,7 @@ synth = ["playwright>=1.40"]
 Homepage = "https://github.com/podojo/cli-podojo"
 Source = "https://github.com/podojo/cli-podojo"
 Issues = "https://github.com/podojo/cli-podojo/issues"
+Changelog = "https://github.com/podojo/cli-podojo/blob/main/CHANGELOG.md"
 
 [project.scripts]
 podojo = "podojo_cli.main:app"

{podojo_cli-0.8.0 → podojo_cli-0.8.2}/src/podojo_cli/commands/projects.py

@@ -1,3 +1,4 @@
+import re
 from pathlib import Path
 
 import httpx
@@ -18,6 +19,33 @@ CLI_TO_API_DOC_TYPE = {
 UPLOADABLE_DOC_TYPES = {"brief", "final"}
 MARKDOWN_SUFFIXES = {".md", ".markdown"}
 
+# Reference-style image definition with a data: URL — `[label]: <data:image/png;base64,...>`
+# These pack base64-encoded images into a single line and dominate file size.
+DATA_URI_REF_DEF_RE = re.compile(
+    r"^\s*\[[^\]\n]+\]:\s+<?data:[^\n>]*>?[^\n]*\n?",
+    re.MULTILINE,
+)
+INLINE_IMG_RE = re.compile(r"!\[[^\]]*\]\([^)]*\)")
+REF_IMG_RE = re.compile(r"!\[[^\]]*\]\[[^\]]*\]")
+HTML_IMG_RE = re.compile(r"<img\b[^>]*/?>", re.IGNORECASE)
+
+
+def strip_images(text: str) -> tuple[str, int]:
+    """Remove image markdown and HTML img tags. Returns (cleaned_text, count_removed)."""
+    count = 0
+    for pattern in (DATA_URI_REF_DEF_RE, INLINE_IMG_RE, REF_IMG_RE, HTML_IMG_RE):
+        text, n = pattern.subn("", text)
+        count += n
+    return text, count
+
+
+def _human_size(n: int) -> str:
+    if n >= 1024 * 1024:
+        return f"{n / 1024 / 1024:.1f} MB"
+    if n >= 1024:
+        return f"{n / 1024:.1f} KB"
+    return f"{n} B"
+
 
 @app.command("list")
 def list_projects(
@@ -86,6 +114,15 @@ def upload_doc(
         console.print(f"[red]Error:[/red] File is not valid UTF-8 text: {file}")
         raise typer.Exit(1)
 
+    original_size = len(content.encode("utf-8"))
+    content, image_count = strip_images(content)
+    new_size = len(content.encode("utf-8"))
+    if image_count:
+        console.print(
+            f"Stripped [bold]{image_count}[/bold] image(s) "
+            f"({_human_size(original_size)} → {_human_size(new_size)})"
+        )
+
     api_type = CLI_TO_API_DOC_TYPE[doc_type]
     client = PodojoClient()
     try:

podojo_cli-0.8.2/tests/test_projects.py

@@ -0,0 +1,147 @@
+from podojo_cli.commands.projects import strip_images
+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
+
+
+def test_strip_images_base64_reference_defs():
+    text = (
+        "# Title\n\n"
+        "Paragraph with ![][image1] inline reference.\n\n"
+        "[image1]: <data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA>\n"
+        "[image2]: <data:image/jpeg;base64,/9j/4AAQSkZJRg==>\n"
+    )
+    cleaned, count = strip_images(text)
+    assert "data:image" not in cleaned
+    assert "![]" not in cleaned
+    assert "image1" not in cleaned
+    assert "# Title" in cleaned
+    assert "Paragraph with  inline reference." in cleaned
+    assert count == 3
+
+
+def test_strip_images_inline_and_html():
+    text = (
+        "Inline: ![alt](https://example.com/x.png)\n"
+        'HTML: <img src="https://example.com/y.jpg" alt="y">\n'
+        "Reference: ![alt][ref]\n"
+    )
+    cleaned, count = strip_images(text)
+    assert "example.com" not in cleaned
+    assert "<img" not in cleaned
+    assert "![alt]" not in cleaned
+    assert count == 3
+
+
+def test_strip_images_keeps_regular_links():
+    text = "See [the doc](https://example.com/doc) and [ref][label]."
+    cleaned, count = strip_images(text)
+    assert cleaned == text
+    assert count == 0
+
+
+def test_upload_doc_strips_images_before_upload(runner, tmp_path, httpx_mock):
+    md = (
+        "# Brief\n\nBody text ![][image1] continues.\n\n"
+        "[image1]: <data:image/png;base64,AAAA>\n"
+    )
+    file = tmp_path / "brief.md"
+    file.write_text(md, encoding="utf-8")
+
+    httpx_mock.add_response(
+        method="PUT",
+        url="http://test.local/api/v1/projects/Alpha/documents/research_brief",
+        match_json={"content": "# Brief\n\nBody text  continues.\n"},
+        json={"ok": True},
+    )
+
+    result = runner.invoke(app, ["projects", "upload-doc", "Alpha", str(file), "--type", "brief"])
+
+    assert result.exit_code == 0
+    assert "Stripped" in result.output
+    assert "2 image" in result.output
+
+
+def test_upload_doc_no_images_no_strip_message(runner, tmp_path, httpx_mock):
+    file = tmp_path / "brief.md"
+    file.write_text("# Brief\n\nJust text, no images.\n", encoding="utf-8")
+
+    httpx_mock.add_response(
+        method="PUT",
+        url="http://test.local/api/v1/projects/Alpha/documents/research_brief",
+        json={"ok": True},
+    )
+
+    result = runner.invoke(app, ["projects", "upload-doc", "Alpha", str(file), "--type", "brief"])
+
+    assert result.exit_code == 0
+    assert "Stripped" not in result.output

{podojo_cli-0.8.0 → podojo_cli-0.8.2}/uv.lock

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

podojo_cli-0.8.0/tests/test_projects.py

@@ -1,72 +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
-
-
-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