Merge pull request #190 from git-quick-stats/task/commits-heatmap

commits heatmap

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,46 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at lukas.mestan@googlemail.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

.github/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+Contributing
+============
+
+Want to contribute? Great! First, read this page.
+
+# Code reviews
+All submissions, including submissions by project members, require review. We
+use Github pull requests for this purpose.
+
+# Some tips for good pull requests:
+* Use our code
+  When in doubt, try to stay true to the existing code of the project.
+* Write a descriptive commit message. What problem are you solving and what
+  are the consequences? Where and what did you test? Some good tips:
+  [here](http://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message)
+  and [here](https://www.kernel.org/doc/Documentation/SubmittingPatches).
+* If your PR consists of multiple commits which are successive improvements /
+  fixes to your first commit, consider squashing them into a single commit
+  (`git rebase -i`) such that your PR is a single commit on top of the current
+  HEAD. This make reviewing the code so much easier, and our history more
+  readable.
+
+# Formatting
+
+This documentation is written using standard [markdown syntax](https://help.github.com/articles/markdown-basics/). Please submit your changes using the same syntax.

.github/FUNDING.yml

@@ -1,4 +1 @@
 # These are supported funding model platforms
-
-github: [arzzen]
-open_collective: git-quick-stats

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/issue_template.md

@@ -0,0 +1,9 @@
+#### Expected behavior and actual behavior.
+
+
+#### Steps to reproduce the problem.
+    
+    
+#### Specifications like the version of the project, operating system, or hardware.
+
+

.gitignore

@@ -7,4 +7,7 @@
 .Spotlight*
 .Trash*
 **/*~
-/nbproject/*
+nbproject/*
+/tests/test-git/.git/
+#/tests/test-git/*
+!/tests/test-git/resetgit

.mailmap

@@ -0,0 +1,3 @@
+Lukas <test@gmail.com> Lukáš <arzzen@users.noreply.github.com> 
+Lukas <lukas@gmail.com> arzzen 
+

.travis.yml

@@ -0,0 +1,32 @@
+language: generic
+
+sudo: required
+
+addons:
+  apt:
+    packages:
+      - libcurl4-openssl-dev
+      - libelf-dev
+      - libdw-dev
+      - cmake
+
+install:
+  - git rev-parse HEAD
+
+script: make test
+
+after_success: |
+  wget https://github.com/SimonKagstrom/kcov/archive/master.tar.gz &&
+  tar xzf master.tar.gz &&
+  cd kcov-master &&
+  mkdir build &&
+  cd build &&
+  cmake .. &&
+  make &&
+  sudo make install &&
+  cd ../.. &&
+  rm -rf kcov-master &&
+  mkdir -p coverage &&
+  kcov coverage git-quick-stats suggestReviewers && bash <(curl -s https://codecov.io/bash) -cF suggestReviewers &&
+  kcov coverage git-quick-stats detailedGitStats && bash <(curl -s https://codecov.io/bash) -cF detailedGitStats &&
+  kcov coverage git-quick-stats commitsPerDay && bash <(curl -s https://codecov.io/bash) -cF commitsPerDay

CITATION.cff

@@ -0,0 +1,25 @@
+cff-version: 1.2.0
+title: Git Quick Stats
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - name-particle: tomice
+  - name-particle: arzzen
+identifiers:
+  - type: url
+    value: "https://github.com/git-quick-stats"
+    description: >-
+      Simple and efficient way to access various statistics
+      in a git repository
+repository-code: "https://github.com/git-quick-stats/git-quick-stats"
+url: "https://git-quick-stats.sh/"
+abstract: >-
+  Git-quick-stats is a simple and efficient way to access
+  various statistics in a git repository.
+keywords:
+  - git
+  - stats
+license: MIT
+version: 2.6.2

CNAME

@@ -1 +0,0 @@
-git-quick-stats.sh

Dockerfile

@@ -0,0 +1,28 @@
+FROM alpine
+
+# Copy sources
+COPY . /app
+
+# Install required packages & build git-quick-stats
+RUN     apk add --no-cache bash git make ncurses util-linux \
+    &&  cd /app \
+    &&  make install \
+    &&  rm -rf /app \
+    &&  apk del --no-cache make \
+    &&  mkdir -p /usr/local/bin \
+    &&  echo -en "#!/bin/bash\nset -e\n[[ \"\${1::1}\" == '-' ]] && set -- /usr/bin/git quick-stats \"\$@\"\nexec \"\$@\"" \
+            > /usr/local/bin/docker-entrypoint \
+    &&  chmod +x /usr/local/bin/docker-entrypoint
+
+# Declare all variables usables by git-quick-stats
+ENV _GIT_SINCE= \
+    _GIT_UNTIL= \
+    _GIT_LIMIT= \
+    _GIT_PATHSPEC= \
+    _MENU_THEME=default \
+    TERM=xterm-256color
+
+WORKDIR /git
+RUN git config --global --add safe.directory /git
+ENTRYPOINT [ "/usr/local/bin/docker-entrypoint" ]
+CMD [ "/usr/bin/git", "quick-stats" ]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 git-quick-stats.sh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,44 @@
+PREFIX ?= /usr/local
+_INSTDIR ?= $(DESTDIR)$(PREFIX)
+BINDIR ?= $(_INSTDIR)/bin
+MANDIR ?= $(_INSTDIR)/share/man
+TASK_DONE = echo -e "\n✓ $@ done\n"
+SHELL := $(shell which bash)
+
+.PHONY: test
+
+all:
+	@echo "Usage:"
+	@echo "  make install"
+	@echo "  make reinstall"
+	@echo "  make uninstall"
+	@echo "  make test"
+
+help:
+	$(MAKE) all
+	@$(TASK_DONE)
+
+install:
+	install -d -m 0755 $(BINDIR)
+	install -m 0755 git-quick-stats $(BINDIR)/git-quick-stats
+	$(MAKE) man
+	@$(TASK_DONE)
+
+uninstall:
+	rm -f $(BINDIR)/git-quick-stats
+	rm -f $(MANDIR)/man1/git-quick-stats.1
+	@$(TASK_DONE)
+
+reinstall:
+	@curl -sO https://raw.githubusercontent.com/git-quick-stats/git-quick-stats/master/git-quick-stats
+	@curl -sO https://raw.githubusercontent.com/git-quick-stats/git-quick-stats/master/git-quick-stats.1
+	$(MAKE) install
+	@$(TASK_DONE)
+
+man:
+	install -d -m 0755 $(MANDIR)/man1/
+	install -m 0644 git-quick-stats.1 $(MANDIR)/man1/
+
+test:
+	tests/commands_test.sh
+	@$(TASK_DONE)

README.md

@@ -1,300 +1,411 @@
-
-# GIT quick statistics [![Backers on Open Collective](https://opencollective.com/git-quick-stats/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/git-quick-stats/sponsors/badge.svg)](#sponsors) [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Simple%20and%20efficient%20way%20to%20access%20various%20statistics%20in%20git%20repository&url=https://github.com/arzzen/git-quick-stat&via=arzzen&hashtags=git,stats,tool,statistics,developers) [![Travis](https://api.travis-ci.org/arzzen/git-quick-stats.svg?branch=master)](https://travis-ci.org/arzzen/git-quick-stats) [![Homebrew package](https://repology.org/badge/version-for-repo/homebrew/git-quick-stats.svg)](http://braumeister.org/formula/git-quick-stats) [![Linuxbrew package](https://repology.org/badge/version-for-repo/linuxbrew/git-quick-stats.svg)](https://repology.org/metapackage/git-quick-stats/packages)
-
-> `git-quick-stats` is a simple and efficient way to access various statistics in a git repository.
->
-> Any git repository may contain tons of information about commits, contributors, and files. Extracting this information is not always trivial, mostly because there are a gadzillion options to a gadzillion git commands – I don’t think there is a single person alive who knows them all. Probably not even [Linus Torvalds](https://github.com/torvalds) himself :).
-
-![mainMenuScreenshot](https://user-images.githubusercontent.com/8818630/58364013-61e53800-7e7b-11e9-87f9-790d6744fbd5.png)
-
-## Table of Contents
-
-[**Screenshots**](#screenshots)
-
-[**Usage**](#usage)
-
-* [**Interactive**](#interactive)
-* [**Non-interactive**](#non-interactive)
-* [**Command-line arguments**](#command-line-arguments)
-* [**Git log since and until**](#git-log-since-and-until)
-* [**Git log limit**](#git-log-limit)
-* [**Git pathspec**](#git-pathspec)
-* [**Color themes**](#color-themes)
-
-[**Installation**](#installation)
-
-* [**UNIX and Linux**](#unix-and-linux)
-* [**macOS**](#macos-homebrew)
-* [**Windows**](#windows)
-* [**Docker**](#docker)
-
-[**System requirements**](#system-requirements)
-
-* [**Dependencies**](#dependencies)
-
-[**FAQ**](#faq)
-
-[**Contribution**](#contribution)
-
-* [**Code reviews**](#code-reviews)
-* [**Some tips for good pull requests**](#some-tips-for-good-pull-requests)
-* [**Formatting**](#formatting)
-
-[**Tests**](#tests)
-
-[**Licensing**](#licensing)
-
-[**Contributors**](#contributors)
-
-* [**Backers**](#backers)
-* [**Sponsors**](#sponsors)
-
-## Screenshots
-
-![commitsByWeekdayScreenshot](https://user-images.githubusercontent.com/8818630/58364011-61e53800-7e7b-11e9-9417-16cbb241ac2e.png)
-
-![commitsByHourScreenshot](https://user-images.githubusercontent.com/8818630/58364010-61e53800-7e7b-11e9-8711-a40b50aebf52.png)
-
-## Usage
-
-### Interactive
-
-git-quick-stats has a built-in interactive menu that can be executed as such:
-
-```bash
-git-quick-stats
-```
-
-Or
-
-```bash
-git quick-stats
-```
-
-### Non-interactive
-
-For those who prefer to utilize command-line options, `git-quick-stats` also has a non-interactive mode supporting both short and long options:
-
-```bash
-git-quick-stats <optional-command-to-execute-directly>
-```
-
-Or
-
-```bash
-git quick-stats <optional-command-to-execute-directly>
-```
-
-### Command-line arguments
-
-Possible arguments in short and long form:
-
-```bash
--r, --suggest-reviewers
-    show the best people to contact to review code
--T, --detailed-git-stats
-    give a detailed list of git stats
--R, --git-stats-by-branch
-    see detailed list of git stats by branch
--d, --commits-per-day
-    displays a list of commits per day
--m, --commits-by-month
-    displays a list of commits per month
--w, --commits-by-weekday
-    displays a list of commits per weekday
--o, --commits-by-hour
-    displays a list of commits per hour
--A, --commits-by-author-by-hour
-    displays a list of commits per hour by author
--a, --commits-per-author
-    displays a list of commits per author
--S, --my-daily-stats
-    see your current daily stats
--C, --contributors
-    see a list of everyone who contributed to the repo
--b, --branch-tree
-    show an ASCII graph of the git repo branch history
--D, --branches-by-date
-    show branches by date
--c, --changelogs
-    see changelogs
--L, --changelogs-by-author
-    see changelogs by author
--j, --json-output
-    save git log as a JSON formatted file to a specified area
--h, -?, --help
-    display this help text in the terminal
-```
-
-### Git log since and until
-
-You can set the variables `_GIT_SINCE` and/or `_GIT_UNTIL` before running `git-quick-stats` to limit the git log. These work similar to git's built-in `--since` and `--until` log options.
-
-```bash
-export _GIT_SINCE="2017-01-20"
-export _GIT_UNTIL="2017-01-22"
-```
-
-Once set, run `git quick-stats` as normal. Note that this affects all stats that parse the git log history until unset.
-
-### Git log limit
-
-You can set variable `_GIT_LIMIT` for limited output. It will affect the "changelogs" and "branch tree" options.
-
-```bash
-export _GIT_LIMIT=20
-```
-
-### Git pathspec
-
-You can exclude a directory from the stats by using [pathspec](https://git-scm.com/docs/gitglossary#gitglossary-aiddefpathspecapathspec)
-
-```bash
-export _GIT_PATHSPEC=':!directory'
-```
-
-You can also exclude files from the stats. Note that it works with any alphanumeric, glob, or regex that git respects.
-
-```bash
-export _GIT_PATHSPEC=':!package-lock.json'
-```
-
-### Color themes
-
-You can change to the legacy color scheme by toggling the variable `_MENU_THEME` between `default` and `legacy`
-
-```bash
-export _MENU_THEME=legacy
-```
-
-![legacyThemeScreenshot](https://user-images.githubusercontent.com/8818630/58364012-61e53800-7e7b-11e9-910a-aaff836260eb.png)
-
-## Installation
-
-### UNIX and Linux
-
-```bash
-git clone https://github.com/arzzen/git-quick-stats.git && cd git-quick-stats
-sudo make install
-```
-
-For uninstalling, open up the cloned directory and run
-
-```bash
-sudo make uninstall
-```
-
-For update/reinstall
-
-```bash
-sudo make reinstall
-```
-
-### macOS (homebrew)
-
-```bash
-brew install git-quick-stats
-```
-
-Or you can follow the UNIX and Linux instructions if you wish.
-
-### Windows
-
-If you are installing with Cygwin, use these scripts:
-
-* [installer](https://gist.github.com/arzzen/35e09866dfdadf2108b2420045739245)
-* [uninstaller](https://gist.github.com/arzzen/21c660014d0663b6c5710014714779d6)
-
-If you are wishing to use this with WSL, follow the UNIX and Linux instructions.
-
-### Docker
-
-You can use the Docker image provided:
-
-* Build: `docker build -t arzzen/git-quick-stats .`
-* Run interactive menu: `docker run --rm -it -v $(pwd):/git arzzen/git-quick-stats`
-* Docker pull command: `docker pull arzzen/git-quick-stats` [docker repository](https://hub.docker.com/r/arzzen/git-quick-stats)
-
-## System requirements
-
-* An OS with a Bash shell
-* Tools we use: awk ; basename ; cat ; column ; echo ; git ; grep ; head ; seq ; sort ; tput ; tr ; uniq ; wc
-
-### Dependencies
-
-* [`bsdmainutils`](https://packages.debian.org/sid/bsdmainutils) `apt install bsdmainutils`
-
-## FAQ
-
-*Q:* I get some errors after run git-quick-stats in cygwin like `/usr/local/bin/git-quick-stats: line 2: $'\r': command not found`
-
-*A:* You can run the dos2unix app in cygwin as follows: `/bin/dos2unix.exe /usr/local/bin/git-quick-stats`. This will convert the script from the CR-LF convention that Microsoft uses to the LF convention that UNIX, OS X, and Linux use. You should then should be able to run it as normal.
-
-## Contribution
-
-Want to contribute? Great! First, read this page.
-
-### Code reviews
-
-All submissions, including submissions by project members, require review.</br>
-We use GitHub pull requests for this purpose.
-
-### Some tips for good pull requests
-
-* Use our code </br>
-  When in doubt, try to stay true to the existing code of the project.
-* Write a descriptive commit message. What problem are you solving and what
-  are the consequences? Where and what did you test? Some good tips:
-  [here](http://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message)
-  and [here](https://www.kernel.org/doc/Documentation/SubmittingPatches).
-* If your PR consists of multiple commits which are successive improvements /
-  fixes to your first commit, consider squashing them into a single commit
-  (`git rebase -i`) such that your PR is a single commit on top of the current
-  HEAD. This make reviewing the code so much easier, and our history more
-  readable.
-
-### Formatting
-
-This documentation is written using standard [markdown syntax](https://help.github.com/articles/markdown-basics/). Please submit your changes using the same syntax.
-
-## Tests
-
-[![codecov](https://codecov.io/gh/arzzen/git-quick-stats/branch/master/graph/badge.svg)](https://codecov.io/gh/arzzen/git-quick-stats)
-
-```bash
-make test
-```
-
-## Licensing
-
-MIT see [LICENSE][] for the full license text.
-
-   [read this page]: http://github.com/arzzen/git-quick-stats/blob/master/docs/CONTRIBUTING.md
-   [landing page]: http://arzzen.github.io/git-quick-stats
-   [LICENSE]: https://github.com/arzzen/git-quick-stats/blob/master/LICENSE
-
-## Contributors
-
-This project exists thanks to all the people who contribute.
-<a href="https://github.com/arzzen/git-quick-stats/graphs/contributors"><img src="https://opencollective.com/git-quick-stats/contributors.svg?width=890&button=false" /></a>
-
-### Backers
-
-Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/git-quick-stats#backer)]
-
-<a href="https://opencollective.com/git-quick-stats#backers" target="_blank"><img src="https://opencollective.com/git-quick-stats/backers.svg?width=890"></a>
-
-### Sponsors
-
-Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/git-quick-stats#sponsor)]
-
-<a href="https://opencollective.com/git-quick-stats/sponsor/0/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/0/avatar.svg?v=1"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/1/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/1/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/2/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/2/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/3/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/3/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/4/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/4/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/5/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/5/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/6/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/6/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/7/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/7/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/8/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/8/avatar.svg"></a>
-<a href="https://opencollective.com/git-quick-stats/sponsor/9/website" target="_blank"><img src="https://opencollective.com/git-quick-stats/sponsor/9/avatar.svg"></a>
+# GIT quick statistics [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Simple%20and%20efficient%20way%20to%20access%20various%20statistics%20in%20git%20repository&url=https://github.com/arzzen/git-quick-stat&via=arzzen&hashtags=git,stats,tool,statistics,developers)
+
+[![Homebrew package](https://repology.org/badge/version-for-repo/homebrew/git-quick-stats.svg)](https://formulae.brew.sh/formula/git-quick-stats#default)
+
+> `git-quick-stats` is a simple and efficient way to access various statistics in a git repository.
+>
+> Any git repository may contain tons of information about commits, contributors, and files. Extracting this information is not always trivial, mostly because there are a gadzillion options to a gadzillion git commands - I don't think there is a single person alive who knows them all. Probably not even [Linus Torvalds](https://github.com/torvalds) himself :).
+
+![mainImageScreenshot](https://github.com/user-attachments/assets/7d8637a4-5a67-49f6-8724-ca7548b987c6)
+
+## Table of Contents
+
+[**Screenshots**](#screenshots)
+
+[**Usage**](#usage)
+
+- [**Interactive**](#interactive)
+- [**Non-interactive**](#non-interactive)
+- [**Command-line arguments**](#command-line-arguments)
+- [**Git log since and until**](#git-log-since-and-until)
+- [**Git log limit**](#git-log-limit)
+- [**Git log options**](#git-log-options)
+- [**Git pathspec**](#git-pathspec)
+- [**Git merge view strategy**](#git-merge-view-strategy)
+- [**Color themes**](#color-themes)
+
+[**Installation**](#installation)
+
+- [**UNIX and Linux**](#unix-and-linux)
+- [**macOS**](#macos-homebrew)
+- [**Windows**](#windows)
+- [**Docker**](#docker)
+
+[**System requirements**](#system-requirements)
+
+- [**Dependencies**](#dependencies)
+
+[**FAQ**](#faq)
+
+[**Contribution**](#contribution)
+
+- [**Code reviews**](#code-reviews)
+- [**Some tips for good pull requests**](#some-tips-for-good-pull-requests)
+- [**Formatting**](#formatting)
+
+[**Tests**](#tests)
+
+[**Licensing**](#licensing)
+
+[**Contributors**](#contributors)
+
+- [**Backers**](#backers)
+- [**Sponsors**](#sponsors)
+
+## Screenshots
+
+![commitsByWeekdayScreenshot](https://github.com/user-attachments/assets/3496d245-6385-47d1-878a-726e79100eb1)
+
+![commitsByHourScreenshot](https://github.com/user-attachments/assets/9f1d69d9-46e0-411d-a5ed-905ffdfb887a)
+
+![commitActivityScreenshot](https://github.com/user-attachments/assets/693fff31-65c7-4b9f-a011-6114a2d10a26)
+
+## Usage
+
+### Interactive
+
+`git-quick-stats` has a built-in interactive menu that can be executed as such:
+
+```bash
+git-quick-stats
+```
+
+Or
+
+```bash
+git quick-stats
+```
+
+### Non-interactive
+
+For those who prefer to utilize command-line options, `git-quick-stats` also has a non-interactive mode supporting both short and long options:
+
+```bash
+git-quick-stats <optional-command-to-execute-directly>
+```
+
+Or
+
+```bash
+git quick-stats <optional-command-to-execute-directly>
+```
+
+### Command-line arguments
+
+Possible arguments in short and long form:
+
+```bash
+GENERATE OPTIONS
+    -T, --detailed-git-stats
+        give a detailed list of git stats
+    -R, --git-stats-by-branch
+        see detailed list of git stats by branch
+    -c, --changelogs
+        see changelogs
+    -L, --changelogs-by-author
+        see changelogs by author
+    -S, --my-daily-stats
+        see your current daily stats
+    -V, --csv-output-by-branch
+        output daily stats by branch in CSV format
+    -j, --json-output
+        save git log as a JSON formatted file to a specified area
+
+LIST OPTIONS
+    -b, --branch-tree
+        show an ASCII graph of the git repo branch history
+    -D, --branches-by-date
+        show branches by date
+    -C, --contributors
+        see a list of everyone who contributed to the repo
+    -n, --new-contributors
+        list everyone who made their first contribution since a specified date
+    -a, --commits-per-author
+        displays a list of commits per author
+    -d, --commits-per-day
+        displays a list of commits per day
+    -m, --commits-by-month
+        displays a list of commits per month
+    -Y, --commits-by-year
+        displays a list of commits per year
+    -w, --commits-by-weekday
+        displays a list of commits per weekday
+    -W, --commits-by-author-by-weekday
+        displays a list of commits per weekday by author
+    -o, --commits-by-hour
+        displays a list of commits per hour
+    -A, --commits-by-author-by-hour
+        displays a list of commits per hour by author
+    -z, --commits-by-timezone
+        displays a list of commits per timezone
+    -Z, --commits-by-author-by-timezone
+        displays a list of commits per timezone by author
+
+CALENDAR OPTIONS
+    -k, --commits-calendar-by-author
+        shows a calendar heatmap of commits per day-of-week per month for a given author
+    -H, --commits-heatmap
+        shows a heatmap of commits per day-of-week per month for the last 30 days
+
+SUGGEST OPTIONS
+    -r, --suggest-reviewers
+        show the best people to contact to review code
+    -h, -?, --help
+        display this help text in the terminal
+```
+
+### Git log since and until
+
+You can set the variables `_GIT_SINCE` and/or `_GIT_UNTIL` before running `git-quick-stats` to limit the git log. These work similar to git's built-in `--since` and `--until` log options.
+
+```bash
+export _GIT_SINCE="2017-01-20"
+export _GIT_UNTIL="2017-01-22"
+```
+
+Once set, run `git quick-stats` as normal. Note that this affects all stats that parse the git log history until unset.
+
+### Git log limit
+
+You can set variable `_GIT_LIMIT` for limited output. It will affect the "changelogs" and "branch tree" options. The default limit is `10`.
+
+```bash
+export _GIT_LIMIT=20
+```
+
+### Git log options
+
+You can set `_GIT_LOG_OPTIONS` for [git log options](https://git-scm.com/docs/git-log#_options):
+
+```bash
+export _GIT_LOG_OPTIONS="--ignore-all-space --ignore-blank-lines"
+```
+
+### Git pathspec
+
+You can exclude a directory from the stats by using [pathspec](https://git-scm.com/docs/gitglossary#gitglossary-aiddefpathspecapathspec)
+
+```bash
+export _GIT_PATHSPEC=':!directory'
+```
+
+You can also exclude files from the stats. Note that it works with any alphanumeric, glob, or regex that git respects.
+
+```bash
+export _GIT_PATHSPEC=':!package-lock.json'
+```
+
+### Git merge view strategy
+
+You can set the variable `_GIT_MERGE_VIEW` to enable merge commits to be part of the stats by setting `_GIT_MERGE_VIEW` to `enable`. You can also choose to only show merge commits by setting `_GIT_MERGE_VIEW` to `exclusive`. Default is to not show merge commits. These work similar to git's built-in `--merges` and `--no-merges` log options.
+
+```bash
+export _GIT_MERGE_VIEW="enable"
+export _GIT_MERGE_VIEW="exclusive"
+```
+
+### Git branch
+
+You can set the variable `_GIT_BRANCH` to set the branch of the stats. Works with commands `--git-stats-by-branch` and `--csv-output-by-branch`.
+
+```bash
+export _GIT_BRANCH="master"
+```
+
+### Ignore authors
+
+You can set the variable `_GIT_IGNORE_AUTHORS` to filter out specific authors. It will affect the "All contributors", ""Suggested code reviewers" and "New contributors" options.
+
+```bash
+export _GIT_IGNORE_AUTHORS="(author@examle.com|username)"
+```
+
+### Sorting contribution stats
+
+You can sort contribution stats by field `name`, `commits`, `insertions`, `deletions`, or `lines` (total lines changed) and order (`asc`, `desc`). e.g.: `commits-desc`
+
+```bash
+export _GIT_SORT_BY="name-asc"
+```
+
+### Commit days
+
+You can set \_GIT_DAYS to set the number of days for the heatmap
+
+```bash
+export _GIT_DAYS=30
+```
+
+### Color themes
+
+You can change to the legacy color scheme by toggling the variable `_MENU_THEME` between `default` and `legacy`.
+You can completely disable the color theme by setting the `_MENU_THEME` variable to `none`.
+
+```bash
+export _MENU_THEME="legacy"
+# or
+export _MENU_THEME="none"
+```
+
+![legacyThemeScreenshot](https://github.com/user-attachments/assets/3b319c1a-827f-47b8-bbfa-b8b59a39deef)
+
+## Installation
+
+### Debian and Ubuntu
+
+If you are on at least Debian Bullseye or Ubuntu Focal you can use apt for installation:
+
+```bash
+apt install git-quick-stats
+```
+
+### UNIX and Linux
+
+```bash
+git clone https://github.com/git-quick-stats/git-quick-stats.git && cd git-quick-stats
+sudo make install
+```
+
+For uninstalling, open up the cloned directory and run
+
+```bash
+sudo make uninstall
+```
+
+For update/reinstall
+
+```bash
+sudo make reinstall
+```
+
+### macOS (homebrew)
+
+macOS requires GNU coreutils to be installed and for the non "g" aliased
+versions to be exported to your path. The following is an example of how to
+perform this if you are using Homebrew as your package manager.
+
+```bash
+brew install coreutils
+export PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH"
+```
+
+From there, you can install via Homebrew as follows:
+
+```bash
+brew install git-quick-stats
+```
+
+Or you can follow the UNIX and Linux instructions if you wish.
+
+If you would like to default to using the GNU coreutils (recommended), then you
+can add `export PATH="$HOMEBREW_PREFIX/opt/coreutils/libexec/gnubin:$PATH"` to
+your applicable `~/.bash_profile`, `~/.zprofile`, or other relevant profile
+based on the shell of your choice.
+
+### Windows
+
+If you are installing with Cygwin, use these scripts:
+
+- [installer](https://gist.github.com/arzzen/35e09866dfdadf2108b2420045739245)
+- [uninstaller](https://gist.github.com/arzzen/21c660014d0663b6c5710014714779d6)
+
+If you are wishing to use this with WSL, follow the UNIX and Linux instructions.
+
+### Docker
+
+You can use the Docker image provided:
+
+- Build: `docker build -t arzzen/git-quick-stats .`
+- Run interactive menu: `docker run --rm -it -v $(pwd):/git arzzen/git-quick-stats`
+- Docker pull command: `docker pull arzzen/git-quick-stats` [docker repository](https://hub.docker.com/r/arzzen/git-quick-stats)
+
+## System requirements
+
+- An OS with a Bash shell
+- Tools we use:
+
+```bash
+awk
+basename
+cat
+column
+date
+echo
+git
+grep
+head
+printf
+seq
+sort
+tput
+tr
+uniq
+```
+
+### Dependencies
+
+- [`bsdextrautils`](https://packages.debian.org/sid/bsdextrautils) `apt install bsdextrautils`
+- [`coreutils`](https://packages.debian.org/sid/coreutils) `apt install coreutils`
+- [`gawk`](https://packages.debian.org/sid/gawk) `apt install gawk`
+- [`grep`](https://packages.debian.org/sid/grep) `apt install grep`
+- [`ncurses-bin`](https://packages.debian.org/sid/ncurses-bin) `apt install ncurses-bin`
+
+## FAQ
+
+_Q:_ I get some errors after run git-quick-stats in cygwin like `/usr/local/bin/git-quick-stats: line 2: $'\r': command not found`
+
+_A:_ You can run the dos2unix app in cygwin as follows: `/bin/dos2unix.exe /usr/local/bin/git-quick-stats`. This will convert the script from the CR-LF convention that Microsoft uses to the LF convention that UNIX, OS X, and Linux use. You should then should be able to run it as normal.
+
+_Q:_ How they could be used in a project with many git projects and statistics would show a summary of all git projects?
+
+_A:_ If you want to include submodule logs, you can try using the following: `export _GIT_LOG_OPTIONS="-p --submodule=log"`
+(more info about [git log --submodule](https://git-scm.com/docs/git-log#Documentation/git-log.txt---submoduleltformatgt))
+
+## Contribution
+
+Want to contribute? Great! First, read this page.
+
+### Code reviews
+
+All submissions, including submissions by project members, require review.</br>
+We use GitHub pull requests for this purpose.
+
+### Some tips for good pull requests
+
+- Use our code </br>
+  When in doubt, try to stay true to the existing code of the project.
+- Write a descriptive commit message. What problem are you solving and what
+  are the consequences? Where and what did you test? Some good tips:
+  [here](http://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message)
+  and [here](https://www.kernel.org/doc/Documentation/SubmittingPatches).
+- If your PR consists of multiple commits which are successive improvements /
+  fixes to your first commit, consider squashing them into a single commit
+  (`git rebase -i`) such that your PR is a single commit on top of the current
+  HEAD. This make reviewing the code so much easier, and our history more
+  readable.
+
+### Formatting
+
+This documentation is written using standard [markdown syntax](https://help.github.com/articles/markdown-basics/). Please submit your changes using the same syntax.
+
+## Tests
+
+[![codecov](https://codecov.io/gh/arzzen/git-quick-stats/branch/master/graph/badge.svg)](https://codecov.io/gh/arzzen/git-quick-stats)
+
+```bash
+make test
+```
+
+## Licensing
+
+MIT see [LICENSE][] for the full license text.
+
+[read this page]: http://github.com/git-quick-stats/git-quick-stats/blob/master/.github/CONTRIBUTING.md
+[landing page]: https://git-quick-stats.sh
+[LICENSE]: https://github.com/git-quick-stats/git-quick-stats/blob/master/LICENSE
+
+## Contributors
+
+This project exists thanks to all the people who contribute.
+
+[![contributors](https://opencollective.com/git-quick-stats/contributors.svg?width=890&button=false)](https://github.com/git-quick-stats/git-quick-stats/graphs/contributors)

assets/base.css

@@ -1,552 +0,0 @@
-/*! normalize.css v3.0.2 | MIT License | git.io/normalize */
-
-/**
- * 1. Set default font family to sans-serif.
- * 2. Prevent iOS text size adjust after orientation change, without disabling
- *    user zoom.
- */
-
-html {
-  font-family: sans-serif; /* 1 */
-  -ms-text-size-adjust: 100%; /* 2 */
-  -webkit-text-size-adjust: 100%; /* 2 */
-}
-
-/**
- * Remove default margin.
- */
-
-body {
-  margin: 0;
-}
-
-/* HTML5 display definitions
-   ========================================================================== */
-
-/**
- * Correct `block` display not defined for any HTML5 element in IE 8/9.
- * Correct `block` display not defined for `details` or `summary` in IE 10/11
- * and Firefox.
- * Correct `block` display not defined for `main` in IE 11.
- */
-
-article,
-aside,
-details,
-figcaption,
-figure,
-footer,
-header,
-hgroup,
-main,
-menu,
-nav,
-section,
-summary {
-  display: block;
-}
-
-/**
- * 1. Correct `inline-block` display not defined in IE 8/9.
- * 2. Normalize vertical alignment of `progress` in Chrome, Firefox, and Opera.
- */
-
-audio,
-canvas,
-progress,
-video {
-  display: inline-block; /* 1 */
-  vertical-align: baseline; /* 2 */
-}
-
-/**
- * Prevent modern browsers from displaying `audio` without controls.
- * Remove excess height in iOS 5 devices.
- */
-
-audio:not([controls]) {
-  display: none;
-  height: 0;
-}
-
-/**
- * Address `[hidden]` styling not present in IE 8/9/10.
- * Hide the `template` element in IE 8/9/11, Safari, and Firefox < 22.
- */
-
-[hidden],
-template {
-  display: none;
-}
-
-/* Links
-   ========================================================================== */
-
-/**
- * Remove the gray background color from active links in IE 10.
- */
-
-a {
-  background-color: transparent;
-}
-
-/**
- * Improve readability when focused and also mouse hovered in all browsers.
- */
-
-a:active,
-a:hover {
-  outline: 0;
-}
-
-/* Text-level semantics
-   ========================================================================== */
-
-/**
- * Address styling not present in IE 8/9/10/11, Safari, and Chrome.
- */
-
-abbr[title] {
-  border-bottom: 1px dotted;
-}
-
-/**
- * Address style set to `bolder` in Firefox 4+, Safari, and Chrome.
- */
-
-b,
-strong {
-  font-weight: bold;
-}
-
-/**
- * Address styling not present in Safari and Chrome.
- */
-
-dfn {
-  font-style: italic;
-}
-
-/**
- * Address variable `h1` font-size and margin within `section` and `article`
- * contexts in Firefox 4+, Safari, and Chrome.
- */
-
-h1 {
-  font-size: 2em;
-  margin: 0.67em 0;
-}
-
-/**
- * Address styling not present in IE 8/9.
- */
-
-mark {
-  background: #ff0;
-  color: #000;
-}
-
-/**
- * Address inconsistent and variable font size in all browsers.
- */
-
-small {
-  font-size: 80%;
-}
-
-/**
- * Prevent `sub` and `sup` affecting `line-height` in all browsers.
- */
-
-sub,
-sup {
-  font-size: 75%;
-  line-height: 0;
-  position: relative;
-  vertical-align: baseline;
-}
-
-sup {
-  top: -0.5em;
-}
-
-sub {
-  bottom: -0.25em;
-}
-
-/* Embedded content
-   ========================================================================== */
-
-/**
- * Remove border when inside `a` element in IE 8/9/10.
- */
-
-img {
-  border: 0;
-}
-
-/**
- * Correct overflow not hidden in IE 9/10/11.
- */
-
-svg:not(:root) {
-  overflow: hidden;
-}
-
-/* Grouping content
-   ========================================================================== */
-
-/**
- * Address margin not present in IE 8/9 and Safari.
- */
-
-figure {
-  margin: 1em 40px;
-}
-
-/**
- * Address differences between Firefox and other browsers.
- */
-
-hr {
-  -moz-box-sizing: content-box;
-  box-sizing: content-box;
-  height: 0;
-}
-
-/**
- * Contain overflow in all browsers.
- */
-
-pre {
-  overflow: auto;
-}
-
-/**
- * Address odd `em`-unit font size rendering in all browsers.
- */
-
-code,
-kbd,
-pre,
-samp {
-  font-family: monospace, monospace;
-  font-size: 1em;
-}
-
-/* Forms
-   ========================================================================== */
-
-/**
- * Known limitation: by default, Chrome and Safari on OS X allow very limited
- * styling of `select`, unless a `border` property is set.
- */
-
-/**
- * 1. Correct color not being inherited.
- *    Known issue: affects color of disabled elements.
- * 2. Correct font properties not being inherited.
- * 3. Address margins set differently in Firefox 4+, Safari, and Chrome.
- */
-
-button,
-input,
-optgroup,
-select,
-textarea {
-  color: inherit; /* 1 */
-  font: inherit; /* 2 */
-  margin: 0; /* 3 */
-}
-
-/**
- * Address `overflow` set to `hidden` in IE 8/9/10/11.
- */
-
-button {
-  overflow: visible;
-}
-
-/**
- * Address inconsistent `text-transform` inheritance for `button` and `select`.
- * All other form control elements do not inherit `text-transform` values.
- * Correct `button` style inheritance in Firefox, IE 8/9/10/11, and Opera.
- * Correct `select` style inheritance in Firefox.
- */
-
-button,
-select {
-  text-transform: none;
-}
-
-/**
- * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio`
- *    and `video` controls.
- * 2. Correct inability to style clickable `input` types in iOS.
- * 3. Improve usability and consistency of cursor style between image-type
- *    `input` and others.
- */
-
-button,
-html input[type="button"], /* 1 */
-input[type="reset"],
-input[type="submit"] {
-  -webkit-appearance: button; /* 2 */
-  cursor: pointer; /* 3 */
-}
-
-/**
- * Re-set default cursor for disabled elements.
- */
-
-button[disabled],
-html input[disabled] {
-  cursor: default;
-}
-
-/**
- * Remove inner padding and border in Firefox 4+.
- */
-
-button::-moz-focus-inner,
-input::-moz-focus-inner {
-  border: 0;
-  padding: 0;
-}
-
-/**
- * Address Firefox 4+ setting `line-height` on `input` using `!important` in
- * the UA stylesheet.
- */
-
-input {
-  line-height: normal;
-}
-
-/**
- * It's recommended that you don't attempt to style these elements.
- * Firefox's implementation doesn't respect box-sizing, padding, or width.
- *
- * 1. Address box sizing set to `content-box` in IE 8/9/10.
- * 2. Remove excess padding in IE 8/9/10.
- */
-
-input[type="checkbox"],
-input[type="radio"] {
-  box-sizing: border-box; /* 1 */
-  padding: 0; /* 2 */
-}
-
-/**
- * Fix the cursor style for Chrome's increment/decrement buttons. For certain
- * `font-size` values of the `input`, it causes the cursor style of the
- * decrement button to change from `default` to `text`.
- */
-
-input[type="number"]::-webkit-inner-spin-button,
-input[type="number"]::-webkit-outer-spin-button {
-  height: auto;
-}
-
-/**
- * 1. Address `appearance` set to `searchfield` in Safari and Chrome.
- * 2. Address `box-sizing` set to `border-box` in Safari and Chrome
- *    (include `-moz` to future-proof).
- */
-
-input[type="search"] {
-  -webkit-appearance: textfield; /* 1 */
-  -moz-box-sizing: content-box;
-  -webkit-box-sizing: content-box; /* 2 */
-  box-sizing: content-box;
-}
-
-/**
- * Remove inner padding and search cancel button in Safari and Chrome on OS X.
- * Safari (but not Chrome) clips the cancel button when the search input has
- * padding (and `textfield` appearance).
- */
-
-input[type="search"]::-webkit-search-cancel-button,
-input[type="search"]::-webkit-search-decoration {
-  -webkit-appearance: none;
-}
-
-/**
- * Define consistent border, margin, and padding.
- */
-
-fieldset {
-  border: 1px solid #c0c0c0;
-  margin: 0 2px;
-  padding: 0.35em 0.625em 0.75em;
-}
-
-/**
- * 1. Correct `color` not being inherited in IE 8/9/10/11.
- * 2. Remove padding so people aren't caught out if they zero out fieldsets.
- */
-
-legend {
-  border: 0; /* 1 */
-  padding: 0; /* 2 */
-}
-
-/**
- * Remove default vertical scrollbar in IE 8/9/10/11.
- */
-
-textarea {
-  overflow: auto;
-}
-
-/**
- * Don't inherit the `font-weight` (applied by a rule above).
- * NOTE: the default cannot safely be changed in Chrome and Safari on OS X.
- */
-
-optgroup {
-  font-weight: bold;
-}
-
-/* Tables
-   ========================================================================== */
-
-/**
- * Remove most spacing between table cells.
- */
-
-table {
-  border-collapse: collapse;
-  border-spacing: 0;
-}
-
-td,
-th {
-  padding: 0;
-}
-
-
-.container {
-  position: relative;
-  width: 100%;
-  max-width: 960px;
-  margin: 0 auto;
-  padding: 0 20px;
-  box-sizing: border-box; }
-.column,
-.columns {
-  width: 100%;
-  float: left;
-  box-sizing: border-box; }
-
-@media (max-width: 1000px) {
-  .container {
-    margin: 30px;
-    width: 90%;
-    padding: 0;
-  }
-  .row .column, .row .columns {
-    float: none;
-    width: 100% !important;
-    margin: 0 0 30px 0;
-  }
-}
-
-/* For devices larger than 400px */
-@media (min-width: 400px) {
-  .container {
-    width: 85%;
-    padding: 0; }
-}
-
-/* For devices larger than 550px */
-@media (min-width: 550px) {
-  .container {
-    width: 80%; }
-  .column,
-  .columns {
-    margin-left: 4%; }
-  .column:first-child,
-  .columns:first-child {
-    margin-left: 0; }
-
-  .one.column,
-  .one.columns                    { width: 4.66666666667%; }
-  .two.columns                    { width: 13.3333333333%; }
-  .three.columns                  { width: 22%;            }
-  .four.columns                   { width: 30.6666666667%; }
-  .five.columns                   { width: 39.3333333333%; }
-  .six.columns                    { width: 48%;            }
-  .seven.columns                  { width: 56.6666666667%; }
-  .eight.columns                  { width: 65.3333333333%; }
-  .nine.columns                   { width: 74.0%;          }
-  .ten.columns                    { width: 82.6666666667%; }
-  .eleven.columns                 { width: 91.3333333333%; }
-  .twelve.columns                 { width: 100%; margin-left: 0; }
-
-  .one-third.column               { width: 30.6666666667%; }
-  .two-thirds.column              { width: 65.3333333333%; }
-
-  .one-half.column                { width: 48%; }
-
-  /* Offsets */
-  .offset-by-one.column,
-  .offset-by-one.columns          { margin-left: 8.66666666667%; }
-  .offset-by-two.column,
-  .offset-by-two.columns          { margin-left: 17.3333333333%; }
-  .offset-by-three.column,
-  .offset-by-three.columns        { margin-left: 26%;            }
-  .offset-by-four.column,
-  .offset-by-four.columns         { margin-left: 34.6666666667%; }
-  .offset-by-five.column,
-  .offset-by-five.columns         { margin-left: 43.3333333333%; }
-  .offset-by-six.column,
-  .offset-by-six.columns          { margin-left: 52%;            }
-  .offset-by-seven.column,
-  .offset-by-seven.columns        { margin-left: 60.6666666667%; }
-  .offset-by-eight.column,
-  .offset-by-eight.columns        { margin-left: 69.3333333333%; }
-  .offset-by-nine.column,
-  .offset-by-nine.columns         { margin-left: 78.0%;          }
-  .offset-by-ten.column,
-  .offset-by-ten.columns          { margin-left: 86.6666666667%; }
-  .offset-by-eleven.column,
-  .offset-by-eleven.columns       { margin-left: 95.3333333333%; }
-
-  .offset-by-one-third.column,
-  .offset-by-one-third.columns    { margin-left: 34.6666666667%; }
-  .offset-by-two-thirds.column,
-  .offset-by-two-thirds.columns   { margin-left: 69.3333333333%; }
-
-  .offset-by-one-half.column,
-  .offset-by-one-half.columns     { margin-left: 52%; }
-
-}
-
-.container:after,
-.row:after,
-.u-cf {
-  content: "";
-  display: table;
-  clear: both; }
-  
-
-
-@font-face {
-  font-family: 'Inter';
-  font-display: auto;
-  font-style:  normal;
-  font-weight: 400;
-  src: url("https://rsms.me/inter/font-files/Inter-Regular.woff2") format("woff2"),
-       url("https://rsms.me/inter/font-files/Inter-Regular.woff") format("woff");
-}
-
-@font-face {
-  font-family: 'Inter';
-  font-display: auto;
-  font-style:  normal;
-  font-weight: 500;
-  src: url("https://rsms.me/inter/font-files/Inter-Medium.woff2") format("woff2"),
-       url("https://rsms.me/inter/font-files/Inter-Medium.woff") format("woff");
-}

assets/icon-color.svg

@@ -1 +0,0 @@
-<svg data-v-29081953="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 300"><!----><defs data-v-29081953=""><!----></defs><rect data-v-29081953="" fill="#FFF7EC" x="0" y="0" width="300px" height="300px" class="logo-background-square"></rect><!----><defs data-v-29081953=""><linearGradient data-v-29081953="" gradientTransform="rotate(25)" id="b4bd9a4d-3879-4954-8296-66d4749af5c2" x1="0%" y1="0%" x2="100%" y2="0%"><stop data-v-29081953="" offset="0%" stop-color="#FF4B03" stop-opacity="1"></stop><stop data-v-29081953="" offset="100%" stop-color="#FCFF65" stop-opacity="1"></stop></linearGradient></defs><g data-v-29081953="" id="47723a31-5e2c-4996-a5a1-600c4efe3066" fill="url(#b4bd9a4d-3879-4954-8296-66d4749af5c2)" stroke="none" transform="matrix(2.749999761581421,0,0,2.749999761581421,12.500002622604121,12.500015735624721)"><path d="M83.338 49.999c-2.464 0-4.591 1.351-5.745 3.333H50v6.67h27.593c1.154 1.982 3.281 3.33 5.745 3.33a6.667 6.667 0 0 0 0-13.333zM83.338 23.332c-2.464 0-4.591 1.351-5.745 3.334H50v6.665h27.593c1.154 1.986 3.281 3.334 5.745 3.334A6.664 6.664 0 0 0 90 30a6.668 6.668 0 0 0-6.662-6.668zM23.333 53.332h19.999v6.67H23.333zM23.333 66.666h19.999v6.668H23.333zM23.333 40h19.999v6.668H23.333zM23.333 26.666h19.999v6.665H23.333zM63.336 63.332c-2.464 0-4.588 1.354-5.745 3.334H50v6.668h7.591c1.157 1.986 3.281 3.334 5.745 3.334A6.666 6.666 0 0 0 70.002 70a6.67 6.67 0 0 0-6.666-6.668zM70.004 36.665c-2.464 0-4.591 1.351-5.745 3.334H50v6.668h14.259c1.154 1.983 3.281 3.331 5.745 3.331a6.662 6.662 0 0 0 6.663-6.665 6.669 6.669 0 0 0-6.663-6.668z"></path><path d="M56.668 19.998A6.666 6.666 0 0 0 50 13.332H16.665A6.666 6.666 0 0 0 10 19.998V80a6.665 6.665 0 0 0 6.665 6.668H50A6.666 6.666 0 0 0 56.668 80H16.665V19.998h40.003z"></path></g><!----></svg>

assets/icon.svg

@@ -1 +0,0 @@
-<svg data-v-d3f97b9e="" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 65.45217292517833 60"><!----><!----><!----><!----><g data-v-d3f97b9e="" id="8575c8ef-d4bf-4990-a029-ca75ee806ebf" transform="matrix(0.8181520700454712,0,0,0.8181520700454712,-8.18152141571045,-10.90760326385498)" stroke="none" fill="black"><path d="M83.338 49.999c-2.464 0-4.591 1.351-5.745 3.333H50v6.67h27.593c1.154 1.982 3.281 3.33 5.745 3.33a6.667 6.667 0 0 0 0-13.333zM83.338 23.332c-2.464 0-4.591 1.351-5.745 3.334H50v6.665h27.593c1.154 1.986 3.281 3.334 5.745 3.334A6.664 6.664 0 0 0 90 30a6.668 6.668 0 0 0-6.662-6.668zM23.333 53.332h19.999v6.67H23.333zM23.333 66.666h19.999v6.668H23.333zM23.333 40h19.999v6.668H23.333zM23.333 26.666h19.999v6.665H23.333zM63.336 63.332c-2.464 0-4.588 1.354-5.745 3.334H50v6.668h7.591c1.157 1.986 3.281 3.334 5.745 3.334A6.666 6.666 0 0 0 70.002 70a6.67 6.67 0 0 0-6.666-6.668zM70.004 36.665c-2.464 0-4.591 1.351-5.745 3.334H50v6.668h14.259c1.154 1.983 3.281 3.331 5.745 3.331a6.662 6.662 0 0 0 6.663-6.665 6.669 6.669 0 0 0-6.663-6.668z"></path><path d="M56.668 19.998A6.666 6.666 0 0 0 50 13.332H16.665A6.666 6.666 0 0 0 10 19.998V80a6.665 6.665 0 0 0 6.665 6.668H50A6.666 6.666 0 0 0 56.668 80H16.665V19.998h40.003z"></path></g><!----></svg>

assets/style.css

@@ -1,139 +0,0 @@
-body {
-  font-family: "Inter", sans-serif;
-  font-size: 16px;
-  font-weight: 400;
-  line-height: 28px;
-}
-
-.container {
-  max-width: 1200px;
-}
-.header {
-  margin: 60px 0 90px 0;
-  text-align: left;
-}
-
-nav {
-  text-align: right;
-}
-nav a {
-  margin: 0 0 0 30px;
-}
-nav .github img {
-  max-width: 32px;
-  height: auto;
-  vertical-align: middle;
-  display: inline-block;
-}
-
-.features .columns {
-  margin-bottom: 30px;
-}
-
-.download a {
-  margin: 0 0 0 15px;
-}
-
-.footer {
-  padding-top: 30px;
-  margin: 30px 0;
-  border-top: 1px solid #ddd;
-  color: #777;
-}
-
-.button {
-  background: #7f2aff;
-  display: inline-block;
-  text-align: center;
-  font-weight: 500;
-  font-size: 1.3em;
-
-  color: #fff;
-  border-radius: 100px;
-  padding: 15px 30px;
-  min-width: 200px;
-}
-.button:hover {
-  background: #000;
-  color: #fff;
-}
-.notice {
-  background: #fafafa;
-  border-left: 4px solid #ddd;
-  color: #666;
-  padding: 5px 15px;
-}
-
-h1,
-h2,
-h3,
-h4,
-h5 {
-  font-weight: 400;
-  /*color: #7f2aff;*/
-  margin: 15px 0 15px 0;
-}
-h1 {
-  font-weight: 500;
-  font-size: 2.5em;
-  line-height: 1.5em;
-}
-h2 {
-  font-size: 2em;
-  line-height: 1.4em;
-}
-h3 {
-  font-size: 1.6em;
-  line-height: 1.6em;
-  color: #888;
-}
-section {
-  margin-bottom: 100px;
-}
-code {
-  color: #c63370;
-}
-a {
-  color: #c68933;
-  font-weight: bold;
-  text-decoration: none;
-}
-a:hover {
-  color: inherit;
-}
-img {
-  max-width: 100%;
-}
-.center {
-  text-align: center;
-}
-
-.logo {
-  padding-top: 3px;
-}
-
-@media screen and (max-width: 490px) {
-  .header {
-    margin: 0;
-  }
-  nav {
-    text-align: left;
-  }
-  nav a {
-    margin: 0 10px 0 0;
-  }
-  .container {
-    width: auto;
-    padding: 0;
-    margin: 30px;
-  }
-}
-
-.btn {
-  background-color: #0069d9;
-  color: white;
-  padding: 5px;
-  border-radius: 5px;
-  padding-left: 10px;
-  padding-right: 10px;
-}

git-quick-stats.1

@@ -0,0 +1,206 @@
+.TH git-quick-stats "1" "June 2025" "git-quick-stats" "User Commands"
+.SH NAME
+.B git\-quick\-stats
+\- Simple and efficient way to access various stats in a git repository.
+.SH SYNOPSIS
+.PP
+For non\-interactive mode:
+.B git\-quick\-stats [OPTIONS]
+.PP
+For interactive mode:
+.B git-quick-stats
+.PP
+.SH DESCRIPTION
+.PP
+Any git repository contains tons of information about commits, contributors,
+and files. Extracting this information is not always trivial, mostly because
+of a gadzillion options to a gadzillion git commands.
+This program allows you to see detailed information about a git repository.
+.PP
+.SH GENERATE OPTIONS
+.PP
+\fB\-h\fR, \-?, \fB\-\-help\fR
+.IP
+display this help text in the terminal
+.PP
+\fB\-T\fR, \fB\-\-detailed\-git\-stats\fR
+.IP
+give a detailed list of git stats
+.HP
+.PP
+\fB\-R\fR, \fB\-\-git\-stats\-by\-branch\fR
+.IP
+see detailed list of git stats by branch
+.HP
+.PP
+\fB\-c\fR, \fB\-\-changelogs\fR
+.IP
+see changelogs
+.HP
+.PP
+\fB\-L\fR, \fB\-\-changelogs\-by\-author\fR
+.IP
+see changelogs by author
+.HP
+.PP
+\fB\-S\fR, \fB\-\-my\-daily\-stats\fR
+.IP
+see your current daily stats
+.HP
+.PP
+\fB\-V\fR, \fB\-\-csv\-output\-by\-branch\fR
+.IP
+output daily stats by branch in CSV format
+.HP
+.PP
+\fB\-j\fR, \fB\-\-json\-output\fR
+.IP
+save git log as a JSON formatted file to a specified area
+.HP
+.SH LIST OPTIONS
+.PP
+\fB\-b\fR, \fB\-\-branch\-tree\fR
+.IP
+show an ASCII graph of the git repo branch history
+.HP
+.PP
+\fB\-D\fR, \fB\-\-branches\-by\-date\fR
+.IP
+show branches by date
+.HP
+.PP
+\fB\-C\fR, \fB\-\-contributors\fR
+.IP
+see a list of everyone who contributed to the repo
+.HP
+.PP
+\fB\-n\fR, \fB\-\-new\-contributors\fR
+.IP
+list everyone who made their first contribution since a specified date
+.HP
+.PP
+\fB\-a\fR, \fB\-\-commits\-per\-author\fR
+.IP
+displays a list of commits per author
+.HP
+.PP
+\fB\-d\fR, \fB\-\-commits\-per\-day\fR
+.IP
+displays a list of commits per day
+.HP
+.PP
+\fB\-m\fR, \fB\-\-commits\-by\-month\fR
+.IP
+displays a list of commits per month
+.HP
+.PP
+\fB\-Y\fR, \fB\-\-commits\-by\-year\fR
+.IP
+displays a list of commits per year
+.HP
+.PP
+\fB\-w\fR, \fB\-\-commits\-by\-weekday\fR
+.IP
+displays a list of commits per weekday
+.HP
+.PP
+\fB\-W\fR, \fB\-\-commits\-by\-author\-by\-weekday\fR
+.IP
+displays a list of commits per weekday by author
+.HP
+.PP
+\fB\-o\fR, \fB\-\-commits\-by\-hour\fR
+.IP
+displays a list of commits per hour
+.HP
+.PP
+\fB\-A\fR, \fB\-\-commits\-by\-author\-by\-hour\fR
+.IP
+displays a list of commits per hour by author
+.HP
+.PP
+\fB\-z\fR, \fB\-\-commits\-by\-timezone\fR
+.IP
+displays a list of commits per timezone
+.HP
+.PP
+\fB\-Z\fR, \fB\-\-commits\-by\-author\-by\-timezone\fR
+.IP
+displays a list of commits per timezone by author
+.HP
+.PP
+\fB\-\-activity\-calendar\fR
+.IP
+displays a calendar-style grid of commit activity per day-of-week and month for a selected author.
+.HP
+.SH SUGGEST OPTIONS
+.PP
+\fB\-r\fR, \fB\-\-suggest\-reviewers\fR
+.IP
+show the best people to contact to review code
+.HP
+.PP
+.SH CALENDAR OPTIONS
+.PP
+\fB\-k\fR, \fB\-\-commits\-calendar\-by\-author\fR outputs a visual grid of commit activity for a selected author, grouped by day-of-week (rows: Mon..Sun) and month (columns: Jan..Dec). Each cell is 3 characters wide, separated by one space.
+.PP
+.PP
+\fB\-H\fR, \fB\-\-commits\-heatmap\fR shows a heatmap of commits per day per hour for the last 30 days
+.PP
+.SH ADDITIONAL USAGE
+You can set _GIT_SINCE and _GIT_UNTIL to limit the git time log, example:
+.PP
+.B  export _GIT_SINCE="2017\-01\-20"
+.PP
+You can set _GIT_LIMIT for limited output log, example:
+.PP
+.B  export _GIT_LIMIT=20
+.PP
+You can set _GIT_LOG_OPTIONS for git log options, example:
+.PP
+.B  export _GIT_LOG_OPTIONS="--ignore-all-space --ignore-blank-lines"
+.PP
+You can exclude directories or files from the stats by using pathspec, example:
+.PP
+.B export _GIT_PATHSPEC=':!pattern'
+.PP
+You can set _GIT_MERGE_VIEW to show merge commits with normal commits, example:
+.PP
+.B  export _GIT_MERGE_VIEW="enable"
+.PP
+You can also set _GIT_MERGE_VIEW to only show merge commits, example:
+.PP
+.B  export _GIT_MERGE_VIEW="exclusive"
+.PP
+You can sort contribution stats by field "name", "commits", "insertions", "deletions", or "lines" (total lines changed) and order ("asc", "desc"). e.g.: "commits-desc"
+.PP
+.B  export _GIT_SORT_BY="name-asc"
+.PP
+You can change to the legacy color scheme by toggling the variable "_MENU_THEME" between "default" and "legacy". You can completely disable the color theme by setting the "_MENU_THEME" variable to "none", example:
+.PP
+.B export _MENU_THEME=legacy
+.PP
+or
+.B export _MENU_THEME=none
+.PP
+You can set _GIT_BRANCH to set the branch of the stats, example:
+.PP
+.B  export _GIT_BRANCH="master"
+.PP
+You can set _GIT_IGNORE_AUTHORS to filter out specific authors, example:
+.PP
+.B  export _GIT_IGNORE_AUTHORS="(author@examle.com|username)"
+.PP
+You can set _GIT_DAYS to set the number of days for the heatmap, example:
+.PP
+.B  export _GIT_DAYS=30"
+.
+.fi
+
+.PP
+.SH SEE ALSO
+.BR git (1)
+.PP
+Project homepage:
+.UR https://github.com/git-quick-stats/git-quick-stats
+.UE

index.html

@@ -1,366 +0,0 @@
-<!DOCTYPE html>
-<html>
-
-<head>
-    <meta http-equiv="content-type" content="text/html; charset=UTF-8">
-    <meta charset="utf-8">
-    <title>Git quick statistics is a simple and efficient way to access various statistics in git repository.</title>
-    <meta name="description"
-        content="▁▅▆▃▅ Any git repository may contain tons of information about commits, contributors, and files. Extracting this information is not always trivial, mostly because there are a gadzillion options to a gadzillion git commands – I don’t think there is a single person alive who knows them all. Probably not even Linus Torvalds himself :).">
-    <meta name="keywords" content="git, repository, github, statistics, linux, docker, windows">
-    <link href="assets/base.css" rel="stylesheet" type="text/css">
-    <link href="assets/style.css" rel="stylesheet" type="text/css">
-    <meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1">
-    <link rel="shortcut icon" href="assets/icon.svg" type="image/x-icon">
-    <script defer data-domain="git-quick-stats.sh" src="https://beacon.static-data.com/js/script.js"></script>
-</head>
-
-<body>
-    <div id="wrap" class="container">
-        <header class="header">
-            <div class="row">
-                <div class="logo six columns">
-                    <a href="https://git-quick-stats.sh/"><img width="40%" src="assets/logo.svg"
-                            alt="git-quick-stats logo"></a>
-                </div>
-                <nav class="six columns">
-                    <a href="#getting-started" class="github">Getting started</a>
-                    <a href="#docs" class="github">Docs</a>
-                    <a href="#support" class="github">Donate 🙌</a>
-                    <a href="https://github.com/arzzen/git-quick-stats" class="github">GitHub
-                        <img alt="github" src="assets/GitHub-Mark.png"></a>
-                </nav>
-            </div>
-        </header>
-        <section class="splash center">
-            <h1>
-                <span><u>Simple way</u> to access various <br>statistics in <u>git</u> repository. </span>
-            </h1>
-            <br>
-            <div class="center">
-                <p class="download">
-                    <strong>Installation</strong>
-                    <a href="https://github.com/arzzen/git-quick-stats#windows">Windows</a>
-                    <a href="https://github.com/arzzen/git-quick-stats#unix-and-linux">Linux</a>
-                    <a href="https://github.com/arzzen/git-quick-stats#macos-homebrew">macOS</a>
-                    <a href="https://github.com/arzzen/git-quick-stats#docker">Docker</a>
-                </p>
-
-                <p>
-                    <em>or you can install directly:</em>
-                    <br>
-                    <code>
-                           bash <(curl -s https://git-quick-stats.sh/install)
-                        </code>
-                </p>
-            </div>
-
-            <div class="center">
-                <img src="https://user-images.githubusercontent.com/8818630/154823670-f42a111b-45f4-47fc-aea7-80059827c8e6.png"
-                    alt="git quick stats">
-            </div>
-        </section>
-
-        <section class="features">
-            <h2 class="center">
-                <span>Features</span>
-            </h2>
-            <div class="row">
-                <div class="four columns">
-                    <h3>Multiplatform</h3>
-                    Works on Windows, Linux and macOS (or you can use the Docker image).
-                </div>
-                <div class="four columns">
-                    <h3>Contribution stats</h3>
-                    List of everyone who contributed to the repository.
-                </div>
-                <div class="four columns">
-                    <h3>Code reviewers</h3>
-                    Find the best people to contact to review code.
-                </div>
-            </div>
-            <div class="row">
-                <div class="four columns">
-                    <h3>Git changelogs</h3>
-                    Easy to fetch git changelogs.
-                </div>
-                <div class="four columns">
-                    <h3>Dependency</h3>
-                    You can run on every OS with a Bash shell.
-                </div>
-                <div class="four columns">
-                    <h3>Open source</h3>
-                    Git-quick-stats is free, open source software licensed under MIT.
-                </div>
-            </div>
-        </section>
-
-        <section>
-            <h2 class="center">
-                <span>More screenshots</span>
-            </h2>
-            <div class="row">
-                <div class="">
-                    <img src="https://user-images.githubusercontent.com/8818630/154823677-e34ca867-ae61-4755-bf89-c877f809c591.png"
-                        alt="git commits by weekday">
-                </div>
-                <div class="">
-                    <img src="https://user-images.githubusercontent.com/8818630/154823679-bdadc26c-c644-4a01-b625-85e330f85d41.png"
-                        alt="git commits by hour">
-                </div>
-            </div>
-        </section>
-
-        <section>
-            <h2 class="center" id="getting-started">Getting started</h2>
-            <ul>
-                <li>
-                    <strong>Installation</strong>
-                    <ul>
-                        <li>
-                            <a href="https://github.com/arzzen/git-quick-stats#windows">Windows</a>
-                        </li>
-                        <li>
-                            <a href="https://github.com/arzzen/git-quick-stats#unix-and-linux">Linux</a>
-                        </li>
-                        <li>
-                            <a href="https://github.com/arzzen/git-quick-stats#macos-homebrew">macOS</a>
-                        </li>
-                        <li>
-                            <a href="https://github.com/arzzen/git-quick-stats#docker">Docker</a>
-                        </li>
-                    </ul>
-                    <br>
-                </li>
-                <li><strong>Interactive usage</strong>
-                    <ul>
-                        <li>
-                            git-quick-stats has a built-in interactive menu that can be executed as such:
-                            <br>
-                            <code>git-quick-stats</code>
-                            <br>
-                            Or
-                            <br>
-                            <code>git quick-stats</code>
-                        </li>
-                    </ul>
-                </li><br>
-                <li><strong>Non-interactive usage</strong>
-                    <ul>
-                        <li>
-                            For those who prefer to utilize command-line options, git-quick-stats also has a
-                            non-interactive mode supporting both short and long options:
-                            <br>
-                            <code>git-quick-stats [optional-command-to-execute-directly]</code>
-                            <br>
-                            Or
-                            <br>
-                            <code>git quick-stats [optional-command-to-execute-directly]</code>
-                        </li>
-                        <li>
-                            Command-line arguments:
-                            <br>
-                            <code>-r, --suggest-reviewers</code>
-                            show the best people to contact to review code<br>
-                            <code>-T, --detailed-git-stats</code>
-                            - give a detailed list of git stats<br>
-                            <code>-R, --git-stats-by-branch</code>
-                            see detailed list of git stats by branch<br>
-                            <code>-d, --commits-per-day</code>
-                            displays a list of commits per day<br>
-                            <code>-m, --commits-by-month</code>
-                            displays a list of commits per month<br>
-                            <code>-w, --commits-by-weekday</code>
-                            displays a list of commits per weekday<br>
-                            <code>-o, --commits-by-hour</code>
-                            displays a list of commits per hour<br>
-                            <code>-A, --commits-by-author-by-hour</code>
-                            displays a list of commits per hour by author<br>
-                            <code>-a, --commits-per-author</code>
-                            displays a list of commits per author<br>
-                            <code>-S, --my-daily-stats</code>
-                            see your current daily stats<br>
-                            <code>-C, --contributors</code>
-                            see a list of everyone who contributed to the repo<br>
-                            <code>-b, --branch-tree</code>
-                            show an ASCII graph of the git repo branch history<br>
-                            <code>-D, --branches-by-date</code>
-                            show branches by date<br>
-                            <code>-c, --changelogs</code>
-                            see changelogs<br>
-                            <code>-L, --changelogs-by-author</code>
-                            see changelogs by author<br>
-                            <code>-j, --json-output</code>
-                            save git log as a JSON formatted file to a specified area<br>
-                            <code>-h, -?, --help</code>
-                            display this help text in the terminal<br>
-                        </li>
-                    </ul>
-                </li>
-            </ul>
-        </section>
-
-        <section>
-            <h2 class="center" id="docs">
-                <span>Documentation</span>
-            </h2>
-            <div>
-                <ul>
-                    <li><strong>Git log since and until</strong>
-                        <p>
-                            You can set the variables _GIT_SINCE and/or _GIT_UNTIL before running git-quick-stats to
-                            limit the git log. <br>
-                            These work similar to git's built-in --since and --until log options.
-                        </p>
-                        <code>
-                                export _GIT_SINCE="2017-01-20"<br>
-                                export _GIT_UNTIL="2017-01-22"
-                            </code>
-                        <p>
-                            Once set, run git quick-stats as normal. Note that this affects all stats that parse the git
-                            log history until unset.
-                        </p>
-                    </li>
-                    <li><strong>Git log limit</strong>
-                        <p>
-                            You can set variable _GIT_LIMIT for limited output. It will affect the "changelogs" and
-                            "branch tree" options.
-                        </p>
-                        <p>
-                            <code>
-                                    export _GIT_LIMIT=20
-                                </code>
-                        </p>
-                    </li>
-                    <li><strong>Git pathspec</strong>
-                        <p>
-                            You can exclude a directory from the stats by using pathspec
-                        </p>
-                        <code>
-                                export _GIT_PATHSPEC=':!directory'
-                            </code>
-                        <p>
-                            You can also exclude files from the stats. Note that it works with any alphanumeric, glob,
-                            or regex that git respects.
-                        </p>
-                        <p>
-                            <code>
-                                    export _GIT_PATHSPEC=':!package-lock.json'
-                                </code>
-                        </p>
-                    </li>
-                    <li>
-                        <strong>Git merge view strategy</strong>
-                        <p>
-                            You can set the variable _GIT_MERGE_VIEW to enable merge commits to be part of the stats by
-                            setting _GIT_MERGE_VIEW to enable. You can also choose to only show merge commits by setting
-                            _GIT_MERGE_VIEW to exclusive. Default is to not show merge commits. These work similar to
-                            git's built-in --merges and --no-merges log options.
-                        </p>
-                        <p>
-                            <code>
-                                    export _GIT_MERGE_VIEW="enable"<br>
-                                    export _GIT_MERGE_VIEW="exclusive"
-                                </code>
-                        </p>
-                    </li>
-                    <li><strong>Color themes</strong>
-                        <p>
-                            You can change to the legacy color scheme by toggling the variable _MENU_THEME between
-                            default and legacy
-                        </p>
-                        <p>
-                            <code>
-                                    export _MENU_THEME=legacy
-                                </code>
-                        </p>
-                    </li>
-                </ul>
-            </div>
-        </section>
-
-
-        <section>
-            <h2 class="center" id="support">
-                <span>Want to show your support?<br>
-                    Donate via Bitcoin or buy me coffee</span>
-            </h2>
-            <div>
-                <div class="center">
-                    If you or your company use this project or like what We're doing, <br>
-                    please consider backing us so We can continue maintaining and evolving this project and new ones.
-                    <br><br>
-                </div>
-                <div>
-                    <h3><strong>Why donate?</strong></h3>
-                    <p>Many people love this service and have asked to donate. If you want to
-                        kick in to help me
-                        cover those costs, that would be awesome!</p>
-                    <br>
-                </div>
-            </div>
-
-
-            <div>
-                <div>
-                    <h3><strong>Choose what you'd like to donate from the items below then click the button:</strong>
-                    </h3>
-
-                    <div class="col-lg-6 blog-details-content">
-                        <h3 class="mt-3 mb-1">If you'd prefer Crypto</h3>
-                        <div class="text">
-                            <br>
-                            <a href="https://nowpayments.io/donation?api_key=SMHBNKR-MYRMBFK-PHXAAHK-3GP6TZA" target="_blank"><img src="https://nowpayments.io/images/embeds/donation-button-black.svg" alt="Crypto donation button by NOWPayments"></a>
-                        </div>
-                    </div>
-                    <br>
-
-                    <div class="col-lg-8">
-                        <div class="mt-50">
-                            <h3 class="mt-3 mb-1">2€ — A large cappuccino 😍 at my local</h3>
-                            <p class="text">
-                                I'm in this for the long run. Things just work better with
-                                coffee! I like to grab a cappuccino from my local before
-                                beginning the things that take mental energy.
-                            </p><a href="https://ko-fi.com/lukasmestan" target="_blank" class="mt-1"><img
-                                    src="https://www.ko-fi.com/img/githubbutton_sm.svg"></a>
-                        </div>
-                    </div>
-                    <br>
-                    <div class="col-lg-8">
-                        <h3 class="mt-5 mb-1">Bill for .sh domain ⚡️</h3>
-                        <p class="text">
-                            The price for the .sh domain is close to € 60 per year, so
-                            support me with a monthly donation and help me continue my
-                            activities.
-                        </p><a href="https://opencollective.com/git-quick-stats/contribute/sponsor-8066/checkout"
-                            target="_blank" class="btn btn-primary btn-sm mt-1"><span class="pl-2">Donate 10€ /
-                                month</span></a>
-                    </div>
-                    <br>
-                    <div class="col-lg-8">
-                        <h3 class="mt-5 mb-1">Github sponsor</h3>
-                        <p class="text">
-                            The easiest way to support us financially is by buying or
-                            subscribing to one of our tiers. <br>If you'd like to make a
-                            donation to keep us going, support us via Github Sponsors.
-                            <br><iframe src="https://github.com/sponsors/arzzen/button" title="Sponsor arzzen"
-                                style="border: 0px none;" width="116" height="35"></iframe></p>
-                    </div>
-                </div>
-
-                <div>
-                    <h1 style="text-align: center;">Thank you for your support! 🙌</h1>
-
-                </div>
-
-            </div>
-        </section>
-
-        <footer class="footer">
-            © 2017-2021. All rights reserved
-        </footer>
-    </div>
-</body>
-
-</html>

install

@@ -1,80 +0,0 @@
-#!/usr/bin/env bash
-
-set -e +o pipefail
-
-url="https://git-quick-stats.sh"
-exit_with=0
-b="\033[0;36m"
-g="\033[0;32m"
-r="\033[0;31m"
-e="\033[0;90m"
-x="\033[0m"
-
-say() {
-  echo -e "$1"
-}
-
-show_title() {
-say "
-
-GIT-QUICK-STATS
-
-Simple way to access various statistics in git repository.
-Documentation at ${g}https://git-quick-stats.sh/#docs${x}
-"
-}
-
-show_help() {
-say "
-Interactive usage
-
-    git-quick-stats has a built-in interactive menu that can be executed as such:
-
-    ${b}git-quick-stats${x}
-    Or
-    ${b}git quick-stats${x}
-
-
-Non-interactive usage
-
-    For those who prefer to utilize command-line options, 
-    git-quick-stats also has a non-interactive mode supporting both short and long options:
-    
-    ${b}git-quick-stats [optional-command-to-execute-directly]${x}
-    Or
-    ${b}git quick-stats [optional-command-to-execute-directly]${x}
-
-    Command-line arguments:
-    -r, --suggest-reviewers show the best people to contact to review code
-    -T, --detailed-git-stats - give a detailed list of git stats
-    -R, --git-stats-by-branch see detailed list of git stats by branch
-    -d, --commits-per-day displays a list of commits per day
-    -m, --commits-by-month displays a list of commits per month
-    -w, --commits-by-weekday displays a list of commits per weekday
-    -o, --commits-by-hour displays a list of commits per hour
-    -A, --commits-by-author-by-hour displays a list of commits per hour by author
-    -a, --commits-per-author displays a list of commits per author
-    -S, --my-daily-stats see your current daily stats
-    -C, --contributors see a list of everyone who contributed to the repo
-    -b, --branch-tree show an ASCII graph of the git repo branch history
-    -D, --branches-by-date show branches by date
-    -c, --changelogs see changelogs
-    -L, --changelogs-by-author see changelogs by author
-    -j, --json-output save git log as a JSON formatted file to a specified area
-    -h, -?, --help display this help text in the terminal
-
-"
-}
-
-
-show_title
-
-say "Installing..."
-git clone -q https://github.com/arzzen/git-quick-stats.git && cd git-quick-stats
-sudo make install
-
-say ""
-
-exit ${exit_with};
-
-

tests/assert.sh

@@ -0,0 +1,223 @@
+#!/bin/bash
+# assert.sh 1.1 - bash unit testing framework
+# Copyright (C) 2009-2015 Robert Lehmann
+#
+# http://github.com/lehmannro/assert.sh
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+set -o nounset
+
+export DISCOVERONLY=${DISCOVERONLY:-}
+export DEBUG=${DEBUG:-}
+export STOP=${STOP:-}
+export INVARIANT=${INVARIANT:-}
+export CONTINUE=${CONTINUE:-}
+
+GREP=${GREP:-grep}
+
+args="$(getopt -n "$0" -l \
+    verbose,help,stop,discover,invariant,continue vhxdic $*)" \
+|| exit -1
+for arg in $args; do
+    case "$arg" in
+        -h)
+            echo "$0 [-vxidc]" \
+                "[--verbose] [--stop] [--invariant] [--discover] [--continue]"
+            echo "`sed 's/./ /g' <<< "$0"` [-h] [--help]"
+            exit 0;;
+        --help)
+            cat <<EOF
+Usage: $0 [options]
+Language-agnostic unit tests for subprocesses.
+
+Options:
+  -v, --verbose    generate output for every individual test case
+  -x, --stop       stop running tests after the first failure
+  -i, --invariant  do not measure timings to remain invariant between runs
+  -d, --discover   collect test suites only, do not run any tests
+  -c, --continue   do not modify exit code to test suite status
+  -h               show brief usage information and exit
+  --help           show this help message and exit
+EOF
+            exit 0;;
+        -v|--verbose)
+            DEBUG=1;;
+        -x|--stop)
+            STOP=1;;
+        -i|--invariant)
+            INVARIANT=1;;
+        -d|--discover)
+            DISCOVERONLY=1;;
+        -c|--continue)
+            CONTINUE=1;;
+    esac
+done
+
+_indent=$'\n\t' # local format helper
+
+_assert_reset() {
+    tests_ran=0
+    tests_failed=0
+    tests_errors=()
+    tests_starttime="$(date +%s%N)" # nanoseconds_since_epoch
+}
+
+assert_end() {
+    # assert_end [suite ..]
+    tests_endtime="$(date +%s%N)"
+    # required visible decimal place for seconds (leading zeros if needed)
+    local tests_time="$( \
+        printf "%010d" "$(( ${tests_endtime/%N/000000000}
+                            - ${tests_starttime/%N/000000000} ))")"  # in ns
+    tests="$tests_ran ${*:+$* }tests"
+    [[ -n "$DISCOVERONLY" ]] && echo "collected $tests." && _assert_reset && return
+    [[ -n "$DEBUG" ]] && echo
+    # to get report_time split tests_time on 2 substrings:
+    #   ${tests_time:0:${#tests_time}-9} - seconds
+    #   ${tests_time:${#tests_time}-9:3} - milliseconds
+    [[ -z "$INVARIANT" ]] \
+        && report_time=" in ${tests_time:0:${#tests_time}-9}.${tests_time:${#tests_time}-9:3}s" \
+        || report_time=
+
+    if [[ "$tests_failed" -eq 0 ]]; then
+        echo "all $tests passed$report_time."
+    else
+        for error in "${tests_errors[@]}"; do echo "$error"; done
+        echo "$tests_failed of $tests failed$report_time."
+    fi
+    tests_failed_previous=$tests_failed
+    [[ $tests_failed -gt 0 ]] && tests_suite_status=1
+    _assert_reset
+}
+
+assert() {
+    # assert <command> <expected stdout> [stdin]
+    (( tests_ran++ )) || :
+    [[ -z "$DISCOVERONLY" ]] || return 0
+    expected=$(echo -ne "${2:-}")
+    result="$(eval 2>/dev/null $1 <<< ${3:-})" || true
+    if [[ "$result" == "$expected" ]]; then
+        [[ -z "$DEBUG" ]] || echo -n .
+        return
+    fi
+    result="$(sed -e :a -e '$!N;s/\n/\\n/;ta' <<< "$result")"
+    [[ -z "$result" ]] && result="nothing" || result="\"$result\""
+    [[ -z "$2" ]] && expected="nothing" || expected="\"$2\""
+    _assert_fail "expected $expected${_indent}got $result" "$1" "${3:-}"
+}
+
+assert_raises() {
+    # assert_raises <command> <expected code> [stdin]
+    (( tests_ran++ )) || :
+    [[ -z "$DISCOVERONLY" ]] || return 0
+    status=0
+    (eval $1 <<< ${3:-}) > /dev/null 2>&1 || status=$?
+    expected=${2:-0}
+    if [[ "$status" -eq "$expected" ]]; then
+        [[ -z "$DEBUG" ]] || echo -n .
+        return
+    fi
+    _assert_fail "program terminated with code $status instead of $expected" "$1" "${3:-}"
+}
+
+assert_success() {
+    # assert_success <command>
+    assert_raises "$1" 0
+}
+
+# _assert_with_grep <grep modifiers> <command> <expected output...>
+_assert_with_grep() {
+    local grep_modifier="$1"
+    local output="$($2)"
+    local exitcode=0
+    shift 2
+
+    while [ $# != 0 ]; do
+        assert_raises "echo '$output' | $GREP $grep_modifier '$1'" $exitcode || return 1
+        shift
+    done
+}
+
+# assert_startswith <command> <expected start to stdout>
+assert_startswith() {
+	assert_success "[[ '$($1)' == '$2'* ]]"
+}
+
+# assert_endswith <command> <expected start to stdout>
+assert_endswith() {
+	assert_success "[[ '$($1)' == *'$2' ]]"
+}
+
+# assert_contains <command> <expected output...>
+assert_contains() {
+	_assert_with_grep '-F' "$@"
+}
+
+_assert_fail() {
+    # _assert_fail <failure> <command> <stdin>
+    [[ -n "$DEBUG" ]] && echo -n X
+    report="test #$tests_ran \"$2${3:+ <<< $3}\" failed:${_indent}$1"
+    if [[ -n "$STOP" ]]; then
+        [[ -n "$DEBUG" ]] && echo
+        echo "$report"
+        exit 1
+    fi
+    tests_errors[$tests_failed]="$report"
+    (( tests_failed++ )) || :
+}
+
+skip_if() {
+    # skip_if <command ..>
+    (eval $@) > /dev/null 2>&1 && status=0 || status=$?
+    [[ "$status" -eq 0 ]] || return
+    skip
+}
+
+skip() {
+    # skip  (no arguments)
+    shopt -q extdebug && tests_extdebug=0 || tests_extdebug=1
+    shopt -q -o errexit && tests_errexit=0 || tests_errexit=1
+    # enable extdebug so returning 1 in a DEBUG trap handler skips next command
+    shopt -s extdebug
+    # disable errexit (set -e) so we can safely return 1 without causing exit
+    set +o errexit
+    tests_trapped=0
+    trap _skip DEBUG
+}
+_skip() {
+    if [[ $tests_trapped -eq 0 ]]; then
+        # DEBUG trap for command we want to skip.  Do not remove the handler
+        # yet because *after* the command we need to reset extdebug/errexit (in
+        # another DEBUG trap.)
+        tests_trapped=1
+        [[ -z "$DEBUG" ]] || echo -n s
+        return 1
+    else
+        trap - DEBUG
+        [[ $tests_extdebug -eq 0 ]] || shopt -u extdebug
+        [[ $tests_errexit -eq 1 ]] || set -o errexit
+        return 0
+    fi
+}
+
+
+_assert_reset
+: ${tests_suite_status:=0}  # remember if any of the tests failed so far
+_assert_cleanup() {
+    local status=$?
+    # modify exit code if it's not already non-zero
+    [[ $status -eq 0 && -z $CONTINUE ]] && exit $tests_suite_status
+}
+trap _assert_cleanup EXIT

tests/commands_test.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+
+# Verify we are in a git repo. Create one if not
+# FIXME: All the paths are hardcoded currently and will break if anything
+# in this chain moves or gets executed elsewhere. Adjust all of these so
+# pathing does not matter as much such as creating a TOP variable that
+# does something like TOP=$(cd "$(dirname "$0")" || exit ; pwd -P)
+# or maybe leverages Make to handle these as test targets
+./tests/test-git/resetgit
+
+. tests/assert.sh -v
+
+src="./git-quick-stats"
+assert "$src fail" "Invalid argument: fail
+
+NAME
+    git-quick-stats - Simple and efficient way to access various stats in a git repo
+
+SYNOPSIS
+    For non-interactive mode: git-quick-stats [OPTIONS]
+    For interactive mode: git-quick-stats
+
+DESCRIPTION
+    Any git repository contains tons of information about commits, contributors,
+    and files. Extracting this information is not always trivial, mostly because
+    of a gadzillion options to a gadzillion git commands.
+    
+    This program allows you to see detailed information about a git repository.
+
+GENERATE OPTIONS
+    -T, --detailed-git-stats
+        give a detailed list of git stats
+    -R, --git-stats-by-branch
+        see detailed list of git stats by branch
+    -c, --changelogs
+        see changelogs
+    -L, --changelogs-by-author
+        see changelogs by author
+    -S, --my-daily-stats
+        see your current daily stats
+    -V, --csv-output-by-branch
+        output daily stats by branch in CSV format
+    -j, --json-output
+        save git log as a JSON formatted file to a specified area
+
+LIST OPTIONS
+    -b, --branch-tree
+        show an ASCII graph of the git repo branch history
+    -D, --branches-by-date
+        show branches by date
+    -C, --contributors
+        see a list of everyone who contributed to the repo
+    -n, --new-contributors
+        list everyone who made their first contribution since a specified date
+    -a, --commits-per-author
+        displays a list of commits per author
+    -d, --commits-per-day
+        displays a list of commits per day
+    -m, --commits-by-month
+        displays a list of commits per month
+    -Y, --commits-by-year
+        displays a list of commits per year
+    -w, --commits-by-weekday
+        displays a list of commits per weekday
+    -W, --commits-by-author-by-weekday
+        displays a list of commits per weekday by author
+    -o, --commits-by-hour
+        displays a list of commits per hour
+    -A, --commits-by-author-by-hour
+        displays a list of commits per hour by author
+    -z, --commits-by-timezone
+        displays a list of commits per timezone
+    -Z, --commits-by-author-by-timezone
+        displays a list of commits per timezone by author
+
+CALENDAR OPTIONS
+    -k, --commits-calendar-by-author
+        shows a calendar heatmap of commits per day-of-week per month for a given author
+    -H, --commits-heatmap
+        shows a heatmap of commits per day-of-week per month for the last 30 days
+
+SUGGEST OPTIONS
+    -r, --suggest-reviewers
+        show the best people to contact to review code
+    -h, -?, --help
+        display this help text in the terminal
+
+ADDITIONAL USAGE
+    You can set _GIT_SINCE and _GIT_UNTIL to limit the git time log
+        ex: export _GIT_SINCE=\"2017-01-20\"
+    You can set _GIT_LIMIT for limited output log
+        ex: export _GIT_LIMIT=20
+    You can set _GIT_LOG_OPTIONS for git log options
+        ex: export _GIT_LOG_OPTIONS=\"--ignore-all-space --ignore-blank-lines\"
+    You can exclude directories or files from the stats by using pathspec
+        ex: export _GIT_PATHSPEC=':!pattern'
+    You can set _GIT_MERGE_VIEW to view merge commits with normal commits
+        ex: export _GIT_MERGE_VIEW=enable
+    You can also set _GIT_MERGE_VIEW to only show merge commits
+        ex: export _GIT_MERGE_VIEW=exclusive
+    You can change to the legacy color scheme by toggling the variable \"_MENU_THEME\" between \"default\" and \"legacy\".
+    You can completely disable the color theme by setting the \"_MENU_THEME\" variable to \"none\".
+        ex: export _MENU_THEME=legacy
+    You can set _GIT_BRANCH to set the branch of the stats
+        ex: export _GIT_BRANCH=master
+    You can set _GIT_IGNORE_AUTHORS to filter out specific authors
+        ex: export _GIT_IGNORE_AUTHORS=\"(author1|author2)\"
+    You can sort contribution stats by field \"name\", \"commits\", \"insertions\", \"deletions\", or \"lines\" - total lines changed and order - \"asc\", \"desc\"
+        ex: export _GIT_SORT_BY=\"name-asc\"
+    You can set _GIT_DAYS to set the number of days for the heatmap
+        ex: export _GIT_DAYS=30"
+
+assert_raises "$src fail" 1
+
+assert_contains "$src --suggest-reviewers" "Suggested code reviewers (based on git history)"
+assert_success "$src --suggest-reviewers"
+
+assert_contains "$src --detailed-git-stats" "Contribution stats (by author) on the current branch"
+assert_success "$src --detailed-git-stats"
+
+assert_contains "$src --commits-per-day" "Git commits per date"
+assert_success "$src --commits-per-day"
+
+assert_startswith "$src --commits-by-year" "Git commits by year"
+assert_success "$src --commits-by-year"
+
+export LC_TIME=POSIX
+assert_startswith "$src --commits-by-year" "Git commits by year"
+assert_success "$src --commits-by-year"
+
+assert_end

tests/test-git/resetgit

@@ -0,0 +1,16 @@
+#!/bin/sh
+# Initialises a new local Git repo for test purpose if one does not exist already
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    {
+        git init
+        git config user.name "$(printf %s 'Test Git,\nfor test purpose')"
+        git config user.email "TestGit\o/@example.org"
+
+        printf 'test-git\n========\n' > README.md
+        git add README.md
+        git commit -m 'added readme (o\w/o)' -m 'in markdown, no \r\n, only \n' -m 'a very "simple" readme'
+        testChars="$(printf 'tab [%b] form feed [%b] line feed [%b] carriage return [%b]' '\x09' '\x0C' '\x0A' '\x0D')"
+        git notes add -m 'Some notes' -m 'out of ascii: été au cœur' -m "$testChars"
+        git log
+    } >/dev/null 2>&1
+fi