https://blog.wtnqk.org/tags/rust/Recent content in Rust on BlogHugo -- gohugo.iojaSat, 24 Jan 2026 00:00:00 +0000https://blog.wtnqk.org/posts/2026-01-28/Sat, 24 Jan 2026 00:00:00 +0000https://blog.wtnqk.org/posts/2026-01-28/<p>以前自分がせっせこ作っていたTUIツールになります。</p> <table> <thead> <tr> <th>サイト</th> <th>URL</th> </tr> </thead> <tbody> <tr> <td>GitHub</td> <td><a href="https://github.com/wtnqk/ftdv">https://github.com/wtnqk/ftdv</a></td> </tr> <tr> <td>crates.io</td> <td><a href="https://crates.io/crates/ftdv">https://crates.io/crates/ftdv</a></td> </tr> </tbody> </table> <p>ftdv (File Tree Diff Viewer) は、<a href="https://github.com/dlvhdr/diffnav">diffnav</a> と <a href="https://github.com/jesseduffield/lazygit">lazygit</a> にインスパイアされたターミナルベースのdiffビューアで、Rustの <a href="https://github.com/ratatui-org/ratatui">ratatui</a> で構築されています。 diffnavの直感的なファイルナビゲーションとlazygitの柔軟なdiffツール設定システムを組み合わせ、delta、bat、ydiff、difftasticなどの様々なdiffツールをサポートするgit diffの対話的なインターフェースを提供します。</p> <h2 id="概要">概要</h2> <p>![image][461091774-43ab0c27-0764-4342-a049-fb4930463811.png]</p> <h2 id="設計思想">設計思想</h2> <p>ftdvは、対話的なgit統合に焦点を当てたモダンなTUI diffページャーです：</p> <ul> <li><strong>直接的なgit統合</strong>: gitオペレーションのネイティブサポート（<code>ftdv branch1 branch2</code>）</li> <li><strong>ファイル単位のdiff</strong>: 選択されたファイルごとに新しいdiffコンテンツ</li> <li><strong>外部ツール統合</strong>: delta、difftastic、bat、ydiffなどの柔軟な設定</li> <li><strong>対話的なナビゲーション</strong>: 永続的な状態を持つファイルツリーインターフェース</li> </ul> <h2 id="機能">機能</h2> <ul> <li>ディレクトリ折りたたみ機能を持つ対話的なファイルツリーナビゲーション（diffnavにインスパイア）</li> <li>テンプレート変数を使用した柔軟なdiffツール設定（lazygitにインスパイア）</li> <li>複数のdiffツールのサポート：delta、bat、ydiff、difftasticなど</li> <li>ANSIカラーサポート - カラー出力を自動的に検出してレンダリング</li> <li>レビュー済みファイルをマークするチェックボックス機能（レビュー追跡）</li> <li>チェック済みファイルの永続的な状態管理</li> <li>リアルタイムフィルタリング付き検索機能</li> <li>Vimスタイルのキーボードナビゲーション</li> <li>カスタマイズ可能なテーマとカラー</li> <li>直接的なファイル/ディレクトリ比較サポート</li> <li>複数の操作モードを持つGit統合</li> </ul> <h2 id="インストール">インストール</h2> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span><span class="lnt">2 </span><span class="lnt">3 </span><span class="lnt">4 </span><span class="lnt">5 </span><span class="lnt">6 </span><span class="lnt">7 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># crates.ioからインストール</span> </span></span><span class="line"><span class="cl">cargo install ftdv </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># またはソースからクローンしてビルド</span> </span></span><span class="line"><span class="cl">git clone https://github.com/wtnqk/ftdv.git </span></span><span class="line"><span class="cl"><span class="nb">cd</span> ftdv </span></span><span class="line"><span class="cl">cargo install --path . </span></span></code></pre></td></tr></table> </div> </div><h2 id="使い方">使い方</h2> <h3 id="基本コマンド">基本コマンド</h3> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt"> 1 </span><span class="lnt"> 2 </span><span class="lnt"> 3 </span><span class="lnt"> 4 </span><span class="lnt"> 5 </span><span class="lnt"> 6 </span><span class="lnt"> 7 </span><span class="lnt"> 8 </span><span class="lnt"> 9 </span><span class="lnt">10 </span><span class="lnt">11 </span><span class="lnt">12 </span><span class="lnt">13 </span><span class="lnt">14 </span><span class="lnt">15 </span><span class="lnt">16 </span><span class="lnt">17 </span><span class="lnt">18 </span><span class="lnt">19 </span><span class="lnt">20 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 作業ディレクトリの変更を表示（デフォルト）</span> </span></span><span class="line"><span class="cl">ftdv </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># ステージされた変更を表示</span> </span></span><span class="line"><span class="cl">ftdv --cached </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 特定のコミット/ブランチと比較</span> </span></span><span class="line"><span class="cl">ftdv main </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 2つのコミット/ブランチを比較</span> </span></span><span class="line"><span class="cl">ftdv main feature-branch </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 2つのファイルを比較</span> </span></span><span class="line"><span class="cl">ftdv file1.txt file2.txt </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># 2つのディレクトリを比較</span> </span></span><span class="line"><span class="cl">ftdv dir1/ dir2/ </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># シェル補完を生成</span> </span></span><span class="line"><span class="cl">ftdv completions bash &gt; ftdv.bash </span></span></code></pre></td></tr></table> </div> </div><h3 id="キーボードショートカット">キーボードショートカット</h3> <h4 id="ナビゲーション">ナビゲーション</h4> <table> <thead> <tr> <th>キー</th> <th>アクション</th> </tr> </thead> <tbody> <tr> <td><code>j</code> / <code>↓</code></td> <td>ファイルリストで下に移動</td> </tr> <tr> <td><code>k</code> / <code>↑</code></td> <td>ファイルリストで上に移動</td> </tr> <tr> <td><code>g</code></td> <td>ファイルリストの最上部へジャンプ</td> </tr> <tr> <td><code>G</code></td> <td>ファイルリストの最下部へジャンプ</td> </tr> </tbody> </table> <h4 id="diffコンテンツスクロール">Diffコンテンツスクロール</h4> <table> <thead> <tr> <th>キー</th> <th>アクション</th> </tr> </thead> <tbody> <tr> <td><code>h</code> / <code>←</code></td> <td>diff左スクロール（5文字）</td> </tr> <tr> <td><code>l</code> / <code>→</code></td> <td>diff右スクロール（5文字）</td> </tr> <tr> <td><code>H</code></td> <td>diff左スクロール（20文字）</td> </tr> <tr> <td><code>L</code></td> <td>diff右スクロール（20文字）</td> </tr> <tr> <td><code>e</code> / <code>J</code></td> <td>diff下スクロール（1行）</td> </tr> <tr> <td><code>y</code> / <code>K</code></td> <td>diff上スクロール（1行）</td> </tr> <tr> <td><code>d</code> / <code>PageDown</code></td> <td>diff下スクロール（10行）</td> </tr> <tr> <td><code>u</code> / <code>PageUp</code></td> <td>diff上スクロール（10行）</td> </tr> <tr> <td><code>f</code></td> <td>diff下スクロール（20行）</td> </tr> <tr> <td><code>b</code></td> <td>diff上スクロール（20行）</td> </tr> </tbody> </table> <h4 id="ファイル操作">ファイル操作</h4> <table> <thead> <tr> <th>キー</th> <th>アクション</th> </tr> </thead> <tbody> <tr> <td><code>Enter</code></td> <td>ディレクトリの展開/折りたたみ</td> </tr> <tr> <td><code>Space</code></td> <td>diffコンテンツの更新</td> </tr> <tr> <td><code>Tab</code></td> <td>ファイルチェックボックスの切替</td> </tr> </tbody> </table> <h4 id="検索">検索</h4> <table> <thead> <tr> <th>キー</th> <th>アクション</th> </tr> </thead> <tbody> <tr> <td><code>/</code></td> <td>検索モードに入る</td> </tr> <tr> <td><code>Enter</code></td> <td>検索確定（検索中）</td> </tr> <tr> <td><code>Esc</code></td> <td>検索モードを終了</td> </tr> <tr> <td><code>Backspace</code></td> <td>文字を削除（検索中）</td> </tr> </tbody> </table> <h4 id="アプリケーション">アプリケーション</h4> <table> <thead> <tr> <th>キー</th> <th>アクション</th> </tr> </thead> <tbody> <tr> <td><code>q</code></td> <td>アプリケーションを終了</td> </tr> <tr> <td><code>Esc</code></td> <td>アプリケーションを終了（検索中でない場合）</td> </tr> </tbody> </table> <h2 id="設定">設定</h2> <p>ftdvは <code>~/.config/ftdv/config.yaml</code> にあるYAML設定ファイルを使用します。</p>