https://blog.fuga.jp/tags/cli/Recent content in CLI on 思いつきそうで思いつかなくていたときにHugo -- gohugo.ioja-jpCopyright(c) 2022-2025 SATO Daisuke. All rights reserved.Wed, 26 Aug 2026 06:00:00 +0900https://blog.fuga.jp/posts/2026-08-26-podcast-tool-devdiary-12-todays-shape/Wed, 26 Aug 2026 06:00:00 +0900https://blog.fuga.jp/posts/2026-08-26-podcast-tool-devdiary-12-todays-shape/<p>前回（第11回）は、5月後半にPythonの外へエンジンを持ち出したSwift統合の話だった。動画書き出しを速くする「速さ」の軸を追った回だ。今回はほぼ同じ時期に並行して積まれていた、もう一つの軸を追う。台本を書き終えたあとの「配信物を組み立てる」工程——タイムライン、topics画像、概要欄、リンク——を自動化していく5月末から6月にかけての流れだ。連載はこれで最終回になる。</p> <h2 id="7分間で3つの部品が生まれた日"><a href="#7%e5%88%86%e9%96%93%e3%81%a73%e3%81%a4%e3%81%ae%e9%83%a8%e5%93%81%e3%81%8c%e7%94%9f%e3%81%be%e3%82%8c%e3%81%9f%e6%97%a5" class="header-anchor"></a>7分間で3つの部品が生まれた日 </h2><p>5月24日の朝、9時44分。<code>bed037b</code>「timeline_generator モジュール追加（テスト含む）」で、<code>timeline_generator.py</code>（106行）とテスト163行が追加された。台本や音声セグメントから、動画のタイムライン情報を組み立てるモジュールだ。</p> <p>2分後の9時46分、<code>6b6c487</code>「topics_image_composer モジュール追加（テスト含む）」。こちらは285行、テスト147行というより厚みのある実装で、トピック紹介用の画像を合成する役割を持つ。</p> <p>さらに5分後の9時51分、<code>a94cbfa</code>「CLIに compose-topics-image / timeline-generate サブコマンド追加」で、この2つのモジュールが <code>commands_topics.py</code> とmain.pyのディスパッチ経由でコマンドラインから呼べるようになった。</p> <p>モジュール2本とCLI配線を合わせて7分。第1回で書いた「26分でCLI骨格からVoicevox連携・m4a出力まで到達した」あの初日のスピード感が、11か月後のこの日にも形を変えて残っている。翌25日の<code>43d807f</code>では、timeline_generatorが<code>speakers.json</code>を参照して話者を動的に検出するよう手直しが入り、ハードコードだった話者名の扱いが一段汎用的になった。</p> <h2 id="16分間で概要欄とリンクが片付いた日"><a href="#16%e5%88%86%e9%96%93%e3%81%a7%e6%a6%82%e8%a6%81%e6%ac%84%e3%81%a8%e3%83%aa%e3%83%b3%e3%82%af%e3%81%8c%e7%89%87%e4%bb%98%e3%81%84%e3%81%9f%e6%97%a5" class="header-anchor"></a>16分間で概要欄とリンクが片付いた日 </h2><p>5日後の5月29日、14時46分。<code>9670fc9</code>「description-generate サブコマンドを追加」。<code>commands_description.py</code>（37行）が新設され、<code>--template</code>/<code>--intro</code>/<code>--timeline</code>/<code>--links</code>/<code>--output</code>の各パスを上書きしながら配信用の概要欄を生成できるようになった。コミットメッセージには「timeline-generateと同じサブコマンド形式」と書かれていて、直前に作ったパターンをそのまま横展開したことが読み取れる。</p> <p>14分後の15時00分から15時02分にかけて、今度はリンク周りが一気に片付く。まず<code>21f3871</code>「is.gd/TinyURLフォールバック短縮を追加」。<code>link_shortener.py</code>（113行）に実装された<code>shorten_url</code>は、is.gdを試してダメならTinyURLへフォールバックする2段構え。<code>shorten_links_in_file</code>は<code>links.source.json</code>のうち<code>short_url</code>が未設定の項目だけを短縮して書き戻す、冪等な作りになっている。ネットワークI/Oをこの1ファイルに閉じ込めた設計が意識されている。</p> <p>1分後、<code>56adecb</code>「links.source.jsonからlinks.txt生成を追加」。<code>links_text.py</code>の<code>render_links_text</code>が、トピックごとに一次情報→参考情報の順で整形し、短縮URLがあればそちらを優先する。</p> <p>さらに1分後、<code>e5a3a45</code>「links 抽出・短縮・整形サブコマンドを追加」。<code>commands_links.py</code>（55行）に<code>extract-source-links</code>・<code>shorten-links</code>・<code>build-links-text</code>の3コマンドがまとまり、ここまでの部品がCLIから使える形に組み上がった。</p> <p>description生成とlinks処理、合わせて16分。5月24日の7分間burstと合わせると、この時期は「モジュールを書く→即CLIに配線する」を数分〜十数分でこなすリズムが定着していたようだ。</p> <h2 id="6月細部を詰める"><a href="#6%e6%9c%88%e7%b4%b0%e9%83%a8%e3%82%92%e8%a9%b0%e3%82%81%e3%82%8b" class="header-anchor"></a>6月、細部を詰める </h2><p>6月に入ると、5月末に生まれた仕組みの周辺を締める修正が続く。6月3日には<code>55fc6ba</code>/<code>c451d12</code>でcompose-topics-imageの<code>base_dir</code>解決にフォールバックが入り、パス解決がマシン非依存になった。6月26日の<code>d9ead70</code>では、descriptionのリンク取得タイトルでHTML実体参照が誤って残る不具合が修正されている。28日には<code>d20fd44</code>でsource_reportの参考文献URL抽出の不具合が2点直り、同日<code>32abd2e</code>でパーサと正規化処理が一本化された。</p> <p>同じ28日、黒板（<code>@panel</code>記法）まわりにも手が入った。<code>dfd5f18</code>「黒板anchor安定化（内容アンカーA改・指紋自動埋め込み）」、続く<code>b592413</code>「static_checkが黒板指紋(<code>@panel[#xxxx]:</code>)を取りこぼす不具合を修正」。翌29日の<code>e554e69</code>では、<code>@panel_close</code>の書き忘れがそれまで警告どまりだったのを、エラーとして止めるよう昇格させている。第6回で扱ったASS字幕の話者別スタイリングから半年、黒板の配置そのものを機械的にチェックする層が育ってきているのが分かる。前日27日の<code>cc271c3</code>「監査を『ゲート』化」は、この一連の静的チェックをCIの通過条件として組み込む動きで、後半の回で触れた監査ワークフローの実装側がここでも進んでいる。</p> <h2 id="軌跡から見えてくるもの"><a href="#%e8%bb%8c%e8%b7%a1%e3%81%8b%e3%82%89%e8%a6%8b%e3%81%88%e3%81%a6%e3%81%8f%e3%82%8b%e3%82%82%e3%81%ae" class="header-anchor"></a>軌跡から見えてくるもの </h2><p>この連載の起点は、2025年7月11日、<code>pyproject.toml</code>一つだけのリポジトリだった。単一ファイルの<code>main.py</code>が295行、依存ライブラリは4つ、その日のうちに音が出た。いま<code>main.py</code>は316行——分量はほとんど変わっていないが、中身はディスパッチ表だけになり、実際のロジックは<code>src/podcast_tool</code>配下245個のPythonファイルに散らばっている。第7回で追った近代化リファクタが土台を作り、今回追った5月〜6月の動きは、その土台の上に「配信物を組み立てる」ための部品を一つずつ足していく作業だった。</p> <p>構成設計書を書いた6月12日時点でコミット数は1068、そこから今日までにさらに900以上積まれている。休眠期を挟みながらも、月ごとに姿を変えながら11か月ぶん積み上がってきた開発の記録を、この12回で追ってきたことになる。次に見るとしたら、それはまた別の「今日」の話だ。</p>