A CLI tool to create punchard visualizations.
Project description
clipunch - a CLI tool to create punchard visualizations.
clipunch consumes data from stdin. It has to be comma-separated pairs of dates with frequencies. For example, piping the following data to clipunch creates a punchard visualization for the complete year 2022 printed to the terminal.
cat << EOF | clipunch
2022-10-25,3
2022-11-07,3
2022-11-08,1
2022-11-09,3
2022-11-28,1
2022-12-04,7
2022-12-05,1
2022-12-06,1
2022-12-07,5
2022-12-08,2
2022-12-14,21
EOF
In case data spans more than a year, multiple punchcard visualizations -one per year- are created in chronological order.
Note, the tools assumes that provided dates are unique. If multiple data values for a single date are given, only the last one is visualized.
Installation
pip install clipunch
Usage
clipunch [--html]
Options: --html Create punchcard as HTML file, which is open in browser.
Examples:
To plot the commit activity to the
Spring Framework, clone the
repository, create commit frequencies per day, and pip it to clipunch
.
git clone https://github.com/spring-projects/spring-framework.git
git -C ./spring-framework/ log --date=short --pretty=format:%ad | \
sort | uniq -c | awk '{print $2","$1}' | \
clipunch --html
The output on the terminal will look similar to the following.
git -C ./spring-framework/ log --author "Juergen Hoeller" --date=short --pretty=format:%ad | \
sort | uniq -c | awk '{print $2","$1}' | \
clipunch --html
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.