nwcommitaverages

Introduction

This packages consists of the following modules:

• nwcommitaverages is an application designed to calculate the average time between Git commits.
• nwcommitaveragescli is a command-line application built on the top of nwcommitaverages.

Pre-Requisites

In order to work, this library requires to be run against a local Git repository and that Git itself is installed on the machine.

Getting Started

I'll use Debian as operating system, but the concept is similar for Windows or Mac.

Procedure:

1. Install pip and venv:

sudo apt install python3-pip python3.12-venv

2. Create a virtual environment:

python3 -m venv /tmp/nwcommitaverages
source /tmp/nwcommitaverages/bin/activate

3. Download and install the package:

pip install nwcommitaverages

4. Enter in the interactive Python environment:

python3

Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

5. Try out if the library works:

from nwcommitaverages import CommitAverageCalculator

ca_calculator : CommitAverageCalculator = CommitAverageCalculator()

6. Exit from the interactive Python environment:

exit()

7. Try out if the CLI application works:

nwcommitaveragescli

8. Deactivate and delete the virtual environment:

deactivate
rm -rf /tmp/nwcommitaverages

9. Done!

Examples

To run it against the current folder (we assume it contains a git repository and that git itself is installed):

nwcommitaveragescli

*****************************************************************
'##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
 ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
 ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
 ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
 ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
 ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
 ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
**********************************************Version: 2.0.1*****

Folder:'/home'

+-------------+--------+-----------+---------------+------------+
| YearMonth   | Days   | Commits   | DailyAvgMin   | RefNames   |
+=============+========+===========+===============+============+
| 2025-05     | 2      | 29        | 16.71         |            |
+-------------+--------+-----------+---------------+------------+
| 2026-03     | 2      | 26        | 16.43         |            |
+-------------+--------+-----------+---------------+------------+
| 2026-04     | 1      | 4         | 73.76         |            |
+-------------+--------+-----------+---------------+------------+

To run it against another folder (which doesn't contain a git repository):

nwcommitaveragescli --folder_path /home/test

*****************************************************************
'##::: ##:'##:::::'##::'######:::::'###::::'##::::'##::'######:::
 ###:: ##: ##:'##: ##:'##... ##:::'## ##::: ##:::: ##:'##... ##::
 ####: ##: ##: ##: ##: ##:::..:::'##:. ##:: ##:::: ##: ##:::..:::
 ## ## ##: ##: ##: ##: ##:::::::'##:::. ##: ##:::: ##: ##::'####:
 ##. ####: ##: ##: ##: ##::::::: #########:. ##:: ##:: ##::: ##::
 ##:. ###: ##: ##: ##: ##::: ##: ##.... ##::. ## ##::: ##::: ##::
 ##::. ##:. ###. ###::. ######:: ##:::: ##:::. ###::::. ######:::
..::::..:::...::...::::......:::..:::::..:::::...::::::......::::
**********************************************Version: 2.0.1*****

Folder:'/home/test'

Command '['git', '-C', '/home/test', 'log', '--pretty=format:%cs;%ct;%D', '--reverse']' returned non-zero exit status 128.

Links

• Source: https://github.com/numbworks/nwcommitaverages
• License: https://github.com/numbworks/nwcommitaverages/blob/master/LICENSE

Total Downloads (PyPi)