git-candlestick

Gitコミット履歴を株価のローソク足チャートのように可視化するツール。

各コミットを1本のローソク足として、コードベースの総行数の推移を表現します。

ローソク足の定義

要素	定義
始値 (Open)	コミット前の総行数
終値 (Close)	コミット後の総行数
高値 (High)	始値 + 追加行数
安値 (Low)	始値 - 削除行数
陽線 (緑)	終値 > 始値
陰線 (赤)	終値 < 始値

インストール

uv (推奨)

cd git-candlestick/
# 直接実行（インストール不要）
uv run git_candlestick.py /path/to/repo
# または開発用にインストール
uv pip install -e .
git-candlestick /path/to/repo

pip

pip install -e .

システムPython (Arch Linux)

sudo pacman -S python-plotly python-pandas
python git_candlestick.py /path/to/repo

使い方

# 基本
git-candlestick /path/to/repo
# ブラウザで表示（デフォルト）
git-candlestick .# HTMLにエクスポート
git-candlestick . -o chart.html
# CDN使用（軽量HTML、Web公開向け）
git-candlestick . -o chart.html --cdn
# コミットメッセージ・作者を非表示（公開向け）
git-candlestick . -o chart.html --cdn --hide-message

オプション

オプション	説明
-o, --output FILE	HTMLファイルに出力
-b, --branch BRANCH	対象ブランチを指定
-s, --since DATE	開始日 (例: 2024-01-01, 1 month ago)
-u, --until DATE	終了日 (例: 2024-12-31, yesterday)
-p, --pattern GLOB	ファイルパターン (例: *.py, *.go)
-n, --limit N	最新N件のコミットのみ
--hide-message	コミットメッセージと作者を非表示
--cdn	plotly.jsをCDNから読み込む（HTML軽量化）

使用例

# Goファイルのみ、最新100コミット
git-candlestick . -p "*.go" -n 100 -o chart.html --cdn
# 2024年のコミットのみ
git-candlestick . --since 2024-01-01 --until 2024-12-31
# 特定ブランチ
git-candlestick . -b develop
# 公開用HTML（CDN + メッセージ非表示）
git-candlestick . -o public/chart.html --cdn --hide-message

Webページへの埋め込み

<iframesrc="/chart.html"
width="100%"
height="600"
frameborder="0"></iframe>

出力サイズ

オプション	HTMLサイズ
デフォルト	~3MB (plotly.js埋め込み)
--cdn	~10KB (CDNから読み込み)

--cdn を使用する場合、閲覧時にインターネット接続が必要です。