Pywayne Bin Gitstats

Pywayne Bin Gitstats

Analyze Git 仓库 commit time distribution and 生成 可视化s.

Quick 启动 # Analyze current 仓库 (default: current directory, current branch) gitstats

# Specify custom 输出 path gitstats --save 输出.png

# Analyze with time 过滤器 gitstats --since "2024-01-01"

Usage Examples Basic Analysis # Analyze current 仓库 gitstats

# Analyze specific 仓库 path gitstats /path/to/repo

# Show plot in popup window (no file saved) gitstats -p

Time Range 过滤器ing # Commits since specific date gitstats --since "2024-01-01"

# Commits within date range gitstats --since "2024-01-01" --until "2024-12-31"

# Relative time expressions gitstats --since "1 year ago" gitstats --since "90 days ago" gitstats --until "30 days ago"

Branch Selection # Analyze specific branch gitstats --branch mAIn gitstats --branch develop gitstats --branch origin/mAIn

# Analyze all branches gitstats --all

Timezone Configuration # Use UTC timezone gitstats --tz UTC

# Use specific timezone gitstats --tz "America/New_York" gitstats --tz "Europe/London"

# Default is Asia/ShanghAI gitstats --tz "Asia/ShanghAI"

Custom 输出 # Custom 输出 filename gitstats --save my_stats.png

# 输出 to subdirectory gitstats --save 结果s/commit_analysis.png

# Absolute path gitstats --save /tmp/git_stats.png

Combined Examples # All branches, last year, custom 输出 gitstats --since "1 year ago" --all --save yearly_stats.png

# MAIn branch, last 90 days, UTC timezone gitstats --branch mAIn --since "90 days ago" --tz UTC

# Develop branch, date range, show plot gitstats --branch develop --since "2024-01-01" --until "2024-06-30" -p

Command Reference Argument Description repo Git 仓库 path. Default: current directory --since 启动 time (e.g., "2024-01-01", "1 year ago", "90 days ago") --until End time (same 格式化s as --since) --tz Timezone. Default: "Asia/ShanghAI". Examples: "UTC", "America/New_York" --branch Specific branch to analyze. Examples: "mAIn", "develop", "origin/mAIn" --all Analyze all branches (overrides --branch) --save 输出 image path. Default: "git_time_distribution.png" -p, --show-plot Show plot in popup window without saving file 输出 图表s

生成s a 3×2 subplot layout 可视化:

Commits per Day - Line 图表 showing dAIly commit counts Commits by Hour - Bar 图表 for hours 0-23 Commits by Weekday - Bar 图表 for Mon-Sun Heatmap: Weekday × Hour - Color-coded activity matrix

图表 title includes: 仓库 name, branch, and timezone.

Branch Selection Priority If --all is specified, all branches are analyzed If --branch is specified, only that branch is analyzed If neither is specified, current HEAD branch is used Requirements Git must be 安装ed Python dependencies: pandas, matplotlib (安装ed with pywayne) Notes Time range can use Git's flexible date 格式化s (absolute dates, relative expressions) 输出 file is overwritten if it exists Large repositories with --all may take longer to process Commit times are 解析d in UTC, then converted to specified timezone