ed
ef98f6d1a1
Added standalone Result[T] (frozen+slots, ok/err classmethods, is_ok) to error_types.py per canonical AND-over-OR error_handling.md (not the video_analysis _Ok|_Err sum type). render_markdown renders YAML front-matter from root post, per-post ## sections with reply markers, quote blockquotes, and ./media/<name> links; media_names mapping keeps render decoupled from download_media. TDD: red (no Result) -> green (7 render + 9 types passed).
71 lines
2.5 KiB
Python
71 lines
2.5 KiB
Python
"""Render ThreadData into a Markdown file with YAML front-matter."""
|
|
from __future__ import annotations
|
|
from pathlib import Path
|
|
from scripts.twitter_threads.error_types import ErrorInfo, make_error, Result, ThreadData, PostData
|
|
|
|
_EM_DASH = "\u2014"
|
|
|
|
def _build_id_to_index(thread: ThreadData) -> dict[str, int]:
|
|
return {post.post_id: i + 1 for i, post in enumerate(thread.posts)}
|
|
|
|
def _format_view_count(value: int | None) -> str:
|
|
if value is None:
|
|
return "null"
|
|
return str(value)
|
|
|
|
def _render_yaml(thread: ThreadData, title: str) -> list[str]:
|
|
root = thread.posts[0]
|
|
return [
|
|
"---",
|
|
f'title: "{title}"',
|
|
f'author: "{root.author}"',
|
|
f'handle: "@{root.handle}"',
|
|
f'post_url: "{thread.source_url}"',
|
|
f'post_id: "{thread.root_post_id}"',
|
|
f'timestamp: "{root.timestamp}"',
|
|
f'post_count: {len(thread.posts)}',
|
|
f'reply_count: {root.metrics.reply_count}',
|
|
f'repost_count: {root.metrics.repost_count}',
|
|
f'like_count: {root.metrics.like_count}',
|
|
f'view_count: {_format_view_count(root.metrics.view_count)}',
|
|
"---",
|
|
]
|
|
|
|
def _render_post(post: PostData, n: int, id_to_index: dict[str, int], media_names: dict[str, list[str]]) -> list[str]:
|
|
lines: list[str] = []
|
|
header = f"## Post {n} ({post.timestamp})"
|
|
if post.reply_to_id is not None and post.reply_to_id in id_to_index:
|
|
header += f" {_EM_DASH} reply to Post {id_to_index[post.reply_to_id]}"
|
|
lines.append(header)
|
|
lines.append("")
|
|
lines.append(post.text)
|
|
lines.append("")
|
|
if post.quote_of_id is not None:
|
|
lines.append(f"> [Quoting post {post.quote_of_id}](https://x.com/i/web/status/{post.quote_of_id})")
|
|
lines.append("")
|
|
names = media_names.get(post.post_id, [])
|
|
if names:
|
|
for k, name in enumerate(names, start=1):
|
|
lines.append(f"[Media {k}](./media/{name})")
|
|
lines.append("")
|
|
return lines
|
|
|
|
def render_markdown(thread: ThreadData, media_names: dict[str, list[str]], output: Path) -> Result[Path]:
|
|
lines: list[str] = []
|
|
id_to_index = _build_id_to_index(thread)
|
|
root = thread.posts[0]
|
|
first_line = root.text.splitlines()[0] if root.text.splitlines() else ""
|
|
title = first_line[:80]
|
|
lines.extend(_render_yaml(thread, title))
|
|
lines.append("")
|
|
lines.append(f"# @{root.handle} {_EM_DASH} {title}")
|
|
lines.append("")
|
|
for i, post in enumerate(thread.posts):
|
|
n = i + 1
|
|
lines.extend(_render_post(post, n, id_to_index, media_names))
|
|
content = "\n".join(lines)
|
|
try:
|
|
output.write_text(content, encoding="utf-8")
|
|
except OSError as e:
|
|
return Result.err(make_error("WriteError", "render_markdown", str(e)))
|
|
return Result.ok(output) |