3.4 KiB
DrillSergeant
Get a tally of contributors' commits.
Written by Wyatt J. Miller, copyright 2022
Licensed by the Mozilla Public License v2.0 (see LICENSE)
Table of Contents
Overview
When I was in university, I wanted a program that would tally up my git commits in a certain project that I'm working on. Based on search engine ninja skills, I couldn't find a program that did this. I decided to scratch my own itch.
I present DrillSergeant, where you can get a tally of the contributors' commits in a certain project. Additionally, you can filter by branch to get commits by branch.
Usage
Please see the wiki for information.
Installation
There's are two forms of installation: releases and building from sources. This readme goes through both.
Releases
You may get releases from the releases page. This is the recommended way to start using DrillSergeant.
There will be three separate downloads: Windows (x86 64-bit), Linux (x86 64-bit), and Linux (ARM 64-bit), dubbed win64, linux64, and linuxaarch64 respectively.
Once downloaded and extracted, you can move it to your $PATH.
If you do not have any of these platforms, read on to source installation as that's the next best option.
Source
Prerequisites
You need the following to be able to build DrillSergeant:
- .NET 6 (available for Windows, macOS, and modern Linux distributions)
- git
Prepare
First, clone the repository with git:
git clone https://scm.wyattjmiller.com/wymiller/DrillSergeant
Then, change directories to where you've cloned DrillSergeant:
cd path/to/DrillSergeant
Build
Then, to build a full release of DrillSergeant (you can change the runtime to whatever fits your platform. You can learn more about this here):
dotnet publish DrillSergeant.csproj --configuration Release --framework net6.0 --output publish --self-contained True --runtime linux-x64 --verbosity Normal /property:PublishTrimmed=True /property:PublishSingleFile=True /property:IncludeNativeLibrariesForSelfExtract=True /property:DebugType=None /property:DebugSymbols=False
Then, you can find the binary in the publish/ directory. You can move this executable to somewhere in the $PATH or you make a new enviroment variable to be integrated into your $PATH.
Known Issues
- A user must be in the root of a git project in order for this program to run.
Next Steps/Contributing
- See the contributing file!
Troubleshooting
Please file a issue on the issue page and I will get back with you as soon as possible.
Attribution
Thank you to the developers, engineers, project managers, and contributors of the following projects - you make this program possible!