Open-source AI podcast clipper. Generate vertical clips with face tracking and burned-in captions. CLI, MCP server, web app.
Python ai-toolsauto-captionscaptionscliffmpegmcpmcp-serveropusclip-alternativepodcast-clipspodcastsshortform-videovertical-videowhisper
import os
import subprocess
import sys
import unittest
from unittest import mock
ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
BACKEND_ROOT = os.path.join(ROOT, "backend")
if BACKEND_ROOT not in sys.path:
sys.path.insert(0, BACKEND_ROOT)
from services import thumbnail_html as th
class ThumbnailHtmlTests(unittest.TestCase):
def test_default_font_stack_covers_georgian(self):
cfg = th._load_config()
self.assertIn("Noto Sans Georgian", cfg["font_family"])
self.assertIn("Noto+Sans+Georgian", cfg["font_import_url"])
def test_prepare_thumbnail_lines_compacts_long_sentence_title(self):
line1, line2 = th._prepare_thumbnail_lines(
"We build 10 megawatt data centers in 200 days \u2014 everyone is shocked",
)
self.assertIn("10MW", f"{line1} {line2}")
self.assertNotIn("everyone", f"{line1} {line2}".lower())
self.assertLessEqual(len(line1), 24)
self.assertLessEqual(len(line2), 24)
self.assertLessEqual(len((line1 + " " + line2).split()), 8)
def test_prepare_thumbnail_lines_rewrites_overlong_ai_lines(self):
line1, line2 = th._prepare_thumbnail_lines(
title="ignored",
line1="WE BUILD 10 MEGAWATT DATA",
line2="CENTERS IN 200 DAYS \u2014 EVERYONE IS SHOCKED",
)
self.assertLessEqual(len(line1), 24)
self.assertLessEqual(len(line2), 24)
self.assertNotIn("EVERYONE", f"{line1} {line2}")
@unittest.skipIf(os.name == "nt", "POSIX node paths; Windows node discovery differs")
def test_build_remotion_screenshot_command(self):
script_suffix = os.path.join("backend", "scripts", "remotion_screenshot.cjs")
renderer_suffix = os.path.join("node_modules", "@remotion", "renderer", "package.json")
def exists(path):
return path.endswith(script_suffix) or path.endswith(renderer_suffix)
with mock.patch.object(th.os.path, "exists", side_effect=exists), \
mock.patch.object(th.shutil, "which", side_effect=lambda name: { "node": "/usr/local/bin/node" }.get(name)):
cmd = th._build_remotion_screenshot_command(
script_path="/repo/backend/scripts/remotion_screenshot.cjs",
html_path="/tmp/thumb.html",
output_path="/tmp/thumb.png",
width=1080,
height=1920,
wait_ms=1500,
)
self.assertEqual(
cmd,
[
"/usr/local/bin/node",
"/repo/backend/scripts/remotion_screenshot.cjs",
"/tmp/thumb.html",
"/tmp/thumb.png",
"1080",
"1920",
"1500",
],
)
@unittest.skipIf(os.name == "nt", "POSIX binary paths; Windows playwright discovery differs")
def test_playwright_cli_candidates_prefers_local_then_global_then_npx(self):
local_suffix = os.path.join("node_modules", ".bin", "playwright")
with mock.patch.object(th.os.path, "exists", side_effect=lambda p: p.endswith(local_suffix)), \
mock.patch.object(th.shutil, "which", side_effect=lambda name: {"playwright": "/usr/local/bin/playwright", "npx": "/usr/local/bin/npx"}.get(name)):
candidates = th._playwright_cli_candidates()
self.assertTrue(candidates[0][0].endswith(local_suffix))
self.assertEqual(candidates[1:], [
["/usr/local/bin/playwright"],
["/usr/local/bin/npx", "--no-install", "playwright"],
["/usr/local/bin/npx", "playwright"],
])
def test_build_playwright_screenshot_command(self):
cmd = th._build_playwright_screenshot_command(
cli_cmd=["/usr/local/bin/npx", "--no-install", "playwright"],
html_path="/tmp/thumb.html",
output_path="/tmp/thumb.png",
width=1080,
height=1920,
wait_ms=1200,
)
self.assertEqual(
cmd,
[
"/usr/local/bin/npx",
"--no-install",
"playwright",
"screenshot",
"--viewport-size",
"1080, 1920",
"--wait-for-timeout",
"1200",
"file:///tmp/thumb.html",
"/tmp/thumb.png",
],
)
def test_generate_thumbnail_prefers_remotion_before_playwright(self):
with mock.patch.object(th, "_build_html", return_value="<html></html>"), \
mock.patch.object(th, "_build_remotion_screenshot_command", return_value=["node", "script", "a", "b", "1080", "1920", "1500"]), \
mock.patch.object(th, "_playwright_cli_candidates", return_value=[["playwright"]]), \
mock.patch.object(th, "_build_playwright_screenshot_command", return_value=["playwright", "screenshot"]), \
mock.patch.object(th.subprocess, "run", side_effect=[
subprocess.CompletedProcess(args=["node"], returncode=0, stdout="", stderr=""),
]) as run_mock:
output = th.generate_thumbnail("line1", "line2", "/tmp/thumb.png")
self.assertEqual(output, "/tmp/thumb.png")
self.assertEqual(run_mock.call_args_list[0].args[0], ["node", "script", "a", "b", "1080", "1920", "1500"])
class LayerTests(unittest.TestCase):
"""
The parts a show adds itself, over a template whose anatomy is fixed.
A layer nobody can see is worse than one that fails to draw: the picture
goes out with a badge missing and nothing says so. Everything here is
about a layer either appearing where it was put or being skipped for a
reason.
"""
def test_draws_a_badge_and_a_picture_in_the_order_given(self):
html = th._layer_html([
{"kind": "text", "text": "NEW", "top": "5%", "left": "6%", "size": 72},
{"kind": "image", "src": "https://example.com/badge.png", "width": "220px"},
])
self.assertIn(">NEW<", html)
self.assertIn("https://example.com/badge.png", html)
# Later in the list is nearer the front, and both clear the logo.
self.assertLess(html.index("z-index:20"), html.index("z-index:21"))
def test_skips_what_it_cannot_draw_rather_than_drawing_it_wrong(self):
html = th._layer_html([
{"kind": "text", "text": " "},
{"kind": "image", "src": ""},
{"kind": "sticker", "src": "x"},
{"kind": "text", "text": "off", "hidden": True},
"not a layer",
])
self.assertEqual(html, "")
def test_a_local_path_is_given_the_scheme_a_browser_needs(self):
# Built from the path rather than asserted as one, because an absolute
# path is D:\tmp\badge.png on Windows and file:// glued to that is not
# a URI any browser will open.
from pathlib import Path
wanted = Path(os.path.abspath(os.path.join("tmp", "badge.png"))).as_uri()
html = th._layer_html([{"kind": "image", "src": os.path.join("tmp", "badge.png")}])
self.assertIn(wanted, html)
self.assertNotIn("\\", html)
def test_text_cannot_close_the_attribute_it_sits_in(self):
html = th._layer_html([
{"kind": "text", "text": '"><script>alert(1)</script>'},
{"kind": "image", "src": 'x" onerror="alert(1)'},
])
self.assertNotIn("<script>", html)
self.assertNotIn('onerror="', html)
def test_nothing_at_all_when_no_layers_were_set(self):
self.assertEqual(th._layer_html(None), "")
self.assertEqual(th._layer_html([]), "")
class GeorgianCasingTests(unittest.TestCase):
"""Georgian is caseless; uppercasing for emphasis must not swap it to a
different alphabet (Mkhedruli -> Mtavruli), whether that uppercasing
happens in Python or in the CSS the HTML carries."""
def test_build_html_uppercases_latin_but_not_georgian(self):
html = th._build_html("hello მიშა", "second line", config={})
self.assertIn("HELLO", html)
self.assertIn("მიშა", html)
self.assertNotIn("Მიშა".upper(), html)
def test_build_html_css_does_not_redundantly_uppercase(self):
# text-transform: uppercase in the CSS would re-break Georgian in the
# headless browser even after the Python-side fix above.
html = th._build_html("hello world", "second line", config={})
self.assertNotIn("text-transform: uppercase", html)
if __name__ == "__main__":
unittest.main()